jfs-components 0.1.2 → 0.1.8

package/lib/module/components/DropdownInput/DropdownInput.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import React, { forwardRef, useCallback, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
 import { Dimensions, Modal, Platform, Pressable, StyleSheet, Text, View } from 'react-native';
 import { useSafeAreaInsets } from 'react-native-safe-area-context';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
@@ -16,6 +16,12 @@ const IS_WEB = Platform.OS === 'web';
 // Types
 // ---------------------------------------------------------------------------
 
+/**
+ * Imperative handle exposed via `ref`. Lets the consumer drive the dropdown
+ * from outside — e.g. close it when an Android hardware/system button is
+ * pressed, or open it programmatically from a sibling control.
+ */
+
 // ---------------------------------------------------------------------------
 // Token resolution
 // ---------------------------------------------------------------------------
@@ -119,7 +125,7 @@ function collectOptionsFromChildren(children) {
 // Component
 // ---------------------------------------------------------------------------
 
-function DropdownInput({
+const DropdownInput = /*#__PURE__*/forwardRef(function DropdownInput({
   label,
   placeholder = 'Select an option',
   items,
@@ -150,7 +156,7 @@ function DropdownInput({
   accessibilityHint,
   onFocus,
   onBlur
-}) {
+}, ref) {
   // ---------------- Modes ----------------
   const {
     modes: globalModes
@@ -264,6 +270,32 @@ function DropdownInput({
     measure();
   }, [measure]);
 
+  // ---------------- Imperative handle ----------------
+  useImperativeHandle(ref, () => ({
+    open: () => {
+      if (isDisabled || isReadOnly) return;
+      measure();
+      setOpenState(true);
+    },
+    close: closeMenu,
+    toggle: () => {
+      if (isDisabled || isReadOnly) return;
+      measure();
+      toggleMenu();
+    },
+    focus: () => {
+      ;
+      triggerRef.current?.focus?.();
+    },
+    blur: () => {
+      ;
+      triggerRef.current?.blur?.();
+    },
+    measureInWindow: callback => {
+      triggerRef.current?.measureInWindow(callback);
+    }
+  }), [isDisabled, isReadOnly, measure, setOpenState, closeMenu, toggleMenu]);
+
   // ---------------- Popup positioning ----------------
   const [menuSize, setMenuSize] = useState(null);
   const handleMenuLayout = useCallback(e => {
@@ -558,7 +590,7 @@ function DropdownInput({
       })
     })]
   });
-}
+});
 const webNoOutline = {
   outlineStyle: 'none',
   outlineWidth: 0,

package/lib/module/components/FormField/FormField.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import React, { useCallback, useMemo, useState } from 'react';
+import React, { forwardRef, useCallback, useMemo, useState } from 'react';
 import { View, Text, TextInput as RNTextInput } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { useTokens } from '../../design-tokens/JFSThemeProvider';
@@ -156,7 +156,7 @@ function firstError(error) {
 // Component
 // ---------------------------------------------------------------------------
 
-function FormField({
+const FormField = /*#__PURE__*/forwardRef(function FormField({
   label,
   placeholder,
   value,
@@ -184,7 +184,7 @@ function FormField({
   accessibilityLabel,
   accessibilityHint,
   testID
-}) {
+}, ref) {
   // -- Form context integration -------------------------------------------
   const formCtx = useFormContext();
   const formError = name && formCtx ? firstError(formCtx.validationErrors[name]) : undefined;
@@ -341,6 +341,7 @@ function FormField({
         importantForAccessibility: "no",
         children: processedLeading
       }), /*#__PURE__*/_jsx(RNTextInput, {
+        ref: ref,
         style: [inputTextStyles, inputTextStyle],
         value: value ?? '',
         onChangeText: handleChangeText,
@@ -370,5 +371,5 @@ function FormField({
       modes: modes
     })]
   });
-}
+});
 export default FormField;

package/lib/module/components/InputSearch/InputSearch.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import React, { useState } from 'react';
+import React, { forwardRef, useState } from 'react';
 import { View, Text, Pressable } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { EMPTY_MODES } from '../../utils/react-utils';
@@ -48,7 +48,7 @@ function SupportText({
     })]
   });
 }
-export default function InputSearch({
+const InputSearch = /*#__PURE__*/forwardRef(function InputSearch({
   supportText = true,
   supportTextLabel = "Support Text",
   supportTextIcon = "ic_info",
@@ -63,7 +63,7 @@ export default function InputSearch({
   trailing,
   inputStyle,
   ...rest
-}) {
+}, ref) {
   const [isFocused, setIsFocused] = useState(false);
 
   // Hardcode InputState based on the state prop, ignoring any external InputState passed in modes
@@ -118,6 +118,7 @@ export default function InputSearch({
       gap: formFieldGap
     }, containerStyle],
     children: [/*#__PURE__*/_jsx(TextInput, {
+      ref: ref,
       placeholder: placeholder,
       value: value || '',
       onChangeText: onChangeText || (() => {}),
@@ -137,4 +138,5 @@ export default function InputSearch({
       modes: componentModes
     })]
   });
-}
+});
+export default InputSearch;

package/lib/module/components/NoteInput/NoteInput.js

@@ -1,15 +1,15 @@
 "use strict";
 
-import React, { useState, useRef } from 'react';
+import React, { forwardRef, useState, useRef } from 'react';
 import { View, TextInput as RNTextInput, Text, Pressable } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
-import { EMPTY_MODES } from '../../utils/react-utils';
+import { EMPTY_MODES, mergeRefs } from '../../utils/react-utils';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * NoteInput component representing an interactive "Add note" badge style field.
  * Allows the user to click, clears the placeholder text, and shows a blinking cursor when focused.
  */
-export default function NoteInput({
+const NoteInput = /*#__PURE__*/forwardRef(function NoteInput({
   value = '',
   placeholder = 'Add note',
   onChangeText,
@@ -20,7 +20,7 @@ export default function NoteInput({
   onFocus,
   onBlur,
   ...rest
-}) {
+}, ref) {
   const [internalFocused, setInternalFocused] = useState(false);
   const inputRef = useRef(null);
 
@@ -92,7 +92,7 @@ export default function NoteInput({
         importantForAccessibility: "no",
         children: internalFocused ? value || ' ' : value || placeholder
       }), /*#__PURE__*/_jsx(RNTextInput, {
-        ref: inputRef,
+        ref: mergeRefs(inputRef, ref),
         value: value,
         onChangeText: onChangeText,
         placeholder: internalFocused ? '' : placeholder,
@@ -112,4 +112,5 @@ export default function NoteInput({
       })]
     })
   });
-}
+});
+export default NoteInput;

package/lib/module/components/PdpCcCard/PdpCcCard.js

@@ -0,0 +1,267 @@
+"use strict";
+
+import React, { useMemo } from 'react';
+import { View, Text, Pressable, StyleSheet } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import { EMPTY_MODES, cloneChildrenWithModes } from '../../utils/react-utils';
+import Title from '../Title/Title';
+import Divider from '../Divider/Divider';
+import Button from '../Button/Button';
+import Image from '../Image/Image';
+import Icon from '../Icon/Icon';
+
+/**
+ * A single metric column inside the card's stats row: a small title, a bold
+ * value and an optional muted caption.
+ */
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * PdpCcCard — Figma node 5352:935 ("PDP cc card").
+ *
+ * A centered white product/PDP card composed from the shared design-system
+ * primitives so it stays in sync with the rest of the library:
+ *
+ *  - **Media** — a top image slot (`Image`, rounded via `image/radius`). Pass
+ *    `imageSource` for the default image or `media` for a full slot override.
+ *  - **Title** — a centered headline + subtitle rendered through the shared
+ *    {@link Title} component (`title/*`, `pageSubtitle/*` tokens).
+ *  - **Metrics** — a row of {@link PdpCcCardMetric} columns (title / value /
+ *    caption) separated by vertical `Divider`s (`metricdata/*` tokens).
+ *  - **CTA** — a small tonal {@link Button} (`Button / Size: S`,
+ *    `AppearanceBrand: Secondary`, `Emphasis: Medium`) with a leading icon.
+ *
+ * All defaults can be overridden via `modes`.
+ */
+function PdpCcCard({
+  imageSource,
+  imageWidth = 100,
+  imageHeight = 60,
+  media,
+  title = 'Title',
+  subtitle = 'Subtitle',
+  metrics = DEFAULT_METRICS,
+  buttonLabel = 'button',
+  buttonIcon = 'ic_add_circle',
+  onButtonPress,
+  button,
+  showButton = true,
+  onPress,
+  width = 344,
+  modes = EMPTY_MODES,
+  style,
+  accessibilityLabel
+}) {
+  const tokens = useMemo(() => resolveTokens(modes), [modes]);
+
+  // The CTA uses the brand "Secondary" appearance at "Medium" emphasis (lilac
+  // fill + purple label) and the small size — matching the design. A
+  // consumer-supplied `modes` value still wins via spread order.
+  const ctaModes = useMemo(() => ({
+    AppearanceBrand: 'Secondary',
+    Emphasis: 'Medium',
+    'Button / Size': 'S',
+    ...modes
+  }), [modes]);
+  const buttonForeground = useMemo(() => asStr(getVariableByName('button/foreground', ctaModes), '#5d00b5'), [ctaModes]);
+  const mediaNode = media ? cloneChildrenWithModes(media, modes) : /*#__PURE__*/_jsx(Image, {
+    imageSource: imageSource,
+    width: imageWidth,
+    height: imageHeight,
+    borderRadius: tokens.imageRadius,
+    resizeMode: "cover",
+    accessibilityElementsHidden: true,
+    importantForAccessibility: "no"
+  });
+  const ctaNode = button ? cloneChildrenWithModes(button, ctaModes) : /*#__PURE__*/_jsx(Button, {
+    label: buttonLabel,
+    modes: ctaModes,
+    onPress: onButtonPress,
+    leading: buttonIcon ? /*#__PURE__*/_jsx(Icon, {
+      iconName: buttonIcon,
+      size: tokens.buttonIconSize,
+      color: buttonForeground
+    }) : undefined
+  });
+  const content = /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(View, {
+      style: styles.mediaSlot,
+      children: mediaNode
+    }), /*#__PURE__*/_jsx(Title, {
+      title: title,
+      subtitle: subtitle,
+      textAlign: "Center",
+      modes: modes
+    }), metrics.length > 0 ? /*#__PURE__*/_jsx(View, {
+      style: styles.metricsRow,
+      children: metrics.map((metric, index) => /*#__PURE__*/_jsxs(React.Fragment, {
+        children: [index > 0 ? /*#__PURE__*/_jsx(Divider, {
+          direction: "vertical",
+          modes: modes,
+          style: styles.metricDivider
+        }) : null, /*#__PURE__*/_jsx(Metricdata, {
+          metric: metric,
+          tokens: tokens
+        })]
+      }, index))
+    }) : null, showButton ? ctaNode : null]
+  });
+  const containerStyle = useMemo(() => ({
+    ...tokens.container,
+    width
+  }), [tokens.container, width]);
+  if (onPress) {
+    return /*#__PURE__*/_jsx(Pressable, {
+      style: ({
+        pressed
+      }) => [containerStyle, pressed ? styles.pressed : null, style],
+      accessibilityRole: "button",
+      accessibilityLabel: accessibilityLabel ?? title,
+      onPress: onPress,
+      children: content
+    });
+  }
+  return /*#__PURE__*/_jsx(View, {
+    style: [containerStyle, style],
+    accessibilityLabel: accessibilityLabel,
+    children: content
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Metricdata — internal metric column (Figma node 5352:256)
+// ---------------------------------------------------------------------------
+
+function Metricdata({
+  metric,
+  tokens
+}) {
+  return /*#__PURE__*/_jsxs(View, {
+    style: tokens.metric,
+    children: [metric.title != null ? /*#__PURE__*/_jsx(Text, {
+      style: tokens.metricTitle,
+      children: metric.title
+    }) : null, metric.value != null ? /*#__PURE__*/_jsx(Text, {
+      style: tokens.metricValue,
+      children: metric.value
+    }) : null, metric.caption != null ? /*#__PURE__*/_jsx(Text, {
+      style: tokens.metricCaption,
+      children: metric.caption
+    }) : null]
+  });
+}
+
+// ---------------------------------------------------------------------------
+// Tokens / static styles
+// ---------------------------------------------------------------------------
+
+function asNum(raw, fallback) {
+  const n = typeof raw === 'number' ? raw : parseFloat(raw);
+  return Number.isFinite(n) ? n : fallback;
+}
+function asStr(raw, fallback) {
+  return raw != null ? String(raw) : fallback;
+}
+function resolveTokens(modes) {
+  // NOTE: token names are passed as string literals DIRECTLY to
+  // getVariableByName so the `extract-component-tokens` script can statically
+  // collect them for the generated docs. Do not refactor these into a helper
+  // that receives the name as a variable.
+  const background = asStr(getVariableByName('PDPcccard/bg/color', modes), '#ffffff');
+  const paddingHorizontal = asNum(getVariableByName('PDPcccard/padding/horizontal', modes), 16);
+  const paddingVertical = asNum(getVariableByName('PDPcccard/padding/vertical', modes), 20);
+  const gap = asNum(getVariableByName('PDPcccard/gap', modes), 12);
+  const imageRadius = asNum(getVariableByName('image/radius', modes), 8);
+  const buttonIconSize = asNum(getVariableByName('button/iconSize', modes), 16);
+  const metricGap = asNum(getVariableByName('metricdata/gap', modes), 4);
+  const metricPadH = asNum(getVariableByName('metricdata/padding/horizontal', modes), 10);
+  const metricPadV = asNum(getVariableByName('metricdata/padding/vertical', modes), 10);
+  const titleColor = asStr(getVariableByName('metricdata/title/color', modes), '#000000');
+  const titleSize = asNum(getVariableByName('metricdata/title/fontsize', modes), 12);
+  const titleFamily = asStr(getVariableByName('metricdata/title/fontfamily', modes), 'JioType Var');
+  const titleWeight = asStr(getVariableByName('metricdata/title/fontweight', modes), '400');
+  const valueColor = asStr(getVariableByName('metricdata/value/color', modes), '#000000');
+  const valueSize = asNum(getVariableByName('metricdata/value/fontsize', modes), 20);
+  const valueFamily = asStr(getVariableByName('metricdata/value/fontfamily', modes), 'JioType Var');
+  const valueWeight = asStr(getVariableByName('metricdata/value/fontweight', modes), '700');
+  const captionColor = asStr(getVariableByName('metricdata/caption/color', modes), '#777777');
+  const captionSize = asNum(getVariableByName('metricdata/caption/fontsize', modes), 12);
+  const captionFamily = asStr(getVariableByName('metricdata/caption/fontfamily', modes), 'JioType Var');
+  const captionWeight = asStr(getVariableByName('metricdata/caption/fontweight', modes), '500');
+  return {
+    container: {
+      backgroundColor: background,
+      paddingHorizontal,
+      paddingVertical,
+      gap,
+      flexDirection: 'column',
+      alignItems: 'center',
+      justifyContent: 'center'
+    },
+    imageRadius,
+    buttonIconSize,
+    metric: {
+      flex: 1,
+      gap: metricGap,
+      paddingHorizontal: metricPadH,
+      paddingVertical: metricPadV,
+      alignItems: 'center',
+      justifyContent: 'center'
+    },
+    metricTitle: {
+      color: titleColor,
+      fontSize: titleSize,
+      fontFamily: titleFamily,
+      fontWeight: titleWeight,
+      lineHeight: Math.round(titleSize * 1.2),
+      textAlign: 'center',
+      includeFontPadding: false
+    },
+    metricValue: {
+      color: valueColor,
+      fontSize: valueSize,
+      fontFamily: valueFamily,
+      fontWeight: valueWeight,
+      lineHeight: Math.round(valueSize * 1.2),
+      textAlign: 'center',
+      includeFontPadding: false
+    },
+    metricCaption: {
+      color: captionColor,
+      fontSize: captionSize,
+      fontFamily: captionFamily,
+      fontWeight: captionWeight,
+      lineHeight: Math.round(captionSize * 1.2),
+      textAlign: 'center',
+      includeFontPadding: false
+    }
+  };
+}
+const DEFAULT_METRICS = [{
+  title: 'Title',
+  value: 'Value',
+  caption: 'caption'
+}, {
+  title: 'Title',
+  value: 'Value',
+  caption: 'caption'
+}];
+const styles = StyleSheet.create({
+  mediaSlot: {
+    alignSelf: 'stretch',
+    alignItems: 'center',
+    justifyContent: 'center'
+  },
+  metricsRow: {
+    alignSelf: 'stretch',
+    flexDirection: 'row',
+    alignItems: 'stretch'
+  },
+  metricDivider: {
+    alignSelf: 'center',
+    height: '70%'
+  },
+  pressed: {
+    opacity: 0.92
+  }
+});
+export default PdpCcCard;