jfs-components 0.1.25 → 0.1.30

package/lib/module/components/AutoplayControl/AutoplayControl.js

@@ -0,0 +1,60 @@
+"use strict";
+
+import React, { useMemo } from 'react';
+import { Pressable } from 'react-native';
+import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
+import Icon from '../../icons/Icon';
+import { jsx as _jsx } from "react/jsx-runtime";
+function resolveAutoplayControlTokens(modes, disabled) {
+  const width = getVariableByName('autoplayControl/width', modes) ?? 36;
+  const height = getVariableByName('autoplayControl/height', modes) ?? 36;
+  const radiusRaw = getVariableByName('autoplayControl/radius', modes) ?? 9999;
+  const backgroundColor = getVariableByName('autoplayControl/background/color', modes) ?? '#ffffff';
+  const iconColor = getVariableByName('autoplayControl/icon/color', modes) ?? '#000000';
+  const borderRadius = radiusRaw === 9999 ? width / 2 : radiusRaw;
+  return {
+    containerStyle: {
+      width,
+      height,
+      borderRadius,
+      backgroundColor,
+      alignItems: 'center',
+      justifyContent: 'center',
+      opacity: disabled ? 0.5 : 1
+    },
+    iconColor
+  };
+}
+
+/**
+ * AutoplayControl is a button component that toggles between play and pause states.
+ * All styling values are resolved from Figma design tokens.
+ */
+export default function AutoplayControl({
+  state = 'pause',
+  modes,
+  onPress,
+  disabled = false,
+  style
+}) {
+  const tokens = useMemo(() => resolveAutoplayControlTokens(modes ?? {}, disabled), [modes, disabled]);
+  const iconName = state === 'play' ? 'ic_play' : 'ic_pause';
+  return /*#__PURE__*/_jsx(Pressable, {
+    onPress: disabled ? undefined : onPress,
+    disabled: disabled,
+    style: ({
+      pressed
+    }) => [tokens.containerStyle, pressed && {
+      opacity: 0.7
+    }, style],
+    accessibilityRole: "button",
+    accessibilityState: {
+      disabled
+    },
+    children: /*#__PURE__*/_jsx(Icon, {
+      name: iconName,
+      size: 24,
+      color: tokens.iconColor
+    })
+  });
+}

package/lib/module/components/Carousel/Carousel.js

@@ -4,6 +4,8 @@ import React, { createContext, useContext, useRef, useState, useEffect, useCallb
 import { View, ScrollView, Animated, Pressable } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { EMPTY_MODES } from '../../utils/react-utils';
+import AutoplayControl from '../AutoplayControl/AutoplayControl';
+import NumberPagination from '../NumberPagination/NumberPagination';
 
 // ---------------------------------------------------------------------------
 // Context
@@ -37,9 +39,11 @@ export function Carousel({
   itemWidth: itemWidthProp,
   paddingHorizontal: paddingHorizontalProp,
   paddingVertical: paddingVerticalProp,
+  type = 'Default',
   onIndexChange,
   style
 }) {
+  const isNumbered = type === 'Numbered';
   // ---- Token resolution ----
   const tokenGap = parseFloat(getVariableByName('carousel/gap', modes));
   const gap = gapProp ?? tokenGap;
@@ -47,27 +51,43 @@ export function Carousel({
   const containerPaddingV = parseFloat(getVariableByName('carousel/padding/vertical', modes));
   // Outer container max height per Figma (`carousel/maxHeight`).
   const maxHeight = parseFloat(getVariableByName('carousel/maxHeight', modes));
+  // Gap between AutoplayControl and NumberPagination in the Numbered overlay.
+  const controlGap = parseFloat(getVariableByName('carouselControl/gap', modes));
+
   // Spacing between the cards row and the pagination dots uses `carousel/gap`.
   const paginationOffset = gap;
 
   // ---- Refs & state ----
   const scrollRef = useRef(null);
   const [activeIndex, setActiveIndex] = useState(0);
+  const activeIndexRef = useRef(0);
   const [containerWidth, setContainerWidth] = useState(0);
   const autoPlayTimer = useRef(null);
   const userInteracting = useRef(false);
+  // Guard: suppress handleScroll index updates during programmatic scrollTo
+  // animations so intermediate offsets don't flicker activeIndex back.
+  const programmaticScroll = useRef(false);
+  const programmaticTimer = useRef(null);
+  useEffect(() => {
+    activeIndexRef.current = activeIndex;
+  }, [activeIndex]);
+
+  // Interactive play/pause state for the Numbered variant.
+  const [isPlaying, setIsPlaying] = useState(autoPlay);
 
   // Flatten children so we can count items
   const items = useMemo(() => React.Children.toArray(children).filter(React.isValidElement), [children]);
   const totalItems = items.length;
 
-  // Effective item width: provided prop, or full container width minus peek offsets
+  // Effective item width: provided prop, or full container width minus peek offsets.
+  // For the Numbered variant the items are full-bleed (no peek padding).
   const effectiveItemWidth = useMemo(() => {
     if (itemWidthProp != null) return itemWidthProp;
     if (containerWidth === 0) return 0;
+    if (isNumbered) return containerWidth;
     // Full-width minus peekOffset on each side
     return containerWidth - containerPaddingH * 4;
-  }, [itemWidthProp, containerWidth, containerPaddingH]);
+  }, [itemWidthProp, containerWidth, containerPaddingH, isNumbered]);
 
   // Snap interval = item width + gap
   const snapInterval = effectiveItemWidth + gap;
@@ -81,6 +101,17 @@ export function Carousel({
     } else {
       targetIndex = Math.max(0, Math.min(index, totalItems - 1));
     }
+    // Lock out handleScroll during the animated scroll so intermediate
+    // offsets don't flicker activeIndex back to the old value.
+    if (animated) {
+      programmaticScroll.current = true;
+      if (programmaticTimer.current != null) {
+        clearTimeout(programmaticTimer.current);
+      }
+      programmaticTimer.current = setTimeout(() => {
+        programmaticScroll.current = false;
+      }, 500);
+    }
     scrollRef.current?.scrollTo({
       x: targetIndex * snapInterval,
       animated
@@ -95,6 +126,9 @@ export function Carousel({
   // ---- Scroll event handler ----
   const handleScroll = useCallback(event => {
     if (snapInterval === 0) return;
+    // Skip index recalculation during programmatic scrollTo animations
+    // to prevent the active indicator from flickering back to the old page.
+    if (programmaticScroll.current) return;
     const offsetX = event.nativeEvent.contentOffset.x;
     const newIndex = Math.round(offsetX / snapInterval);
     const clampedIndex = Math.max(0, Math.min(newIndex, totalItems - 1));
@@ -112,22 +146,19 @@ export function Carousel({
     }
   }, []);
   const startAutoPlay = useCallback(() => {
-    if (!autoPlay || totalItems <= 1) return;
+    if (!autoPlay && !isPlaying || totalItems <= 1) return;
+    if (!isPlaying) return;
     clearAutoPlay();
     autoPlayTimer.current = setInterval(() => {
       if (!userInteracting.current) {
-        setActiveIndex(prev => {
-          const next = loop ? (prev + 1) % totalItems : Math.min(prev + 1, totalItems - 1);
-          scrollRef.current?.scrollTo({
-            x: next * snapInterval,
-            animated: true
-          });
-          onIndexChange?.(next);
-          return next;
-        });
+        const prev = activeIndexRef.current;
+        const next = loop ? (prev + 1) % totalItems : Math.min(prev + 1, totalItems - 1);
+        // Route through scrollToIndex so the programmaticScroll guard
+        // suppresses intermediate handleScroll offsets during the animation.
+        scrollToIndex(next, true);
       }
     }, autoPlayInterval);
-  }, [autoPlay, totalItems, loop, snapInterval, autoPlayInterval, clearAutoPlay, onIndexChange]);
+  }, [autoPlay, isPlaying, totalItems, loop, autoPlayInterval, clearAutoPlay, scrollToIndex]);
   useEffect(() => {
     startAutoPlay();
     return clearAutoPlay;
@@ -138,8 +169,23 @@ export function Carousel({
   const handleScrollEndDrag = useCallback(() => {
     userInteracting.current = false;
     // Reset autoplay timer after interaction
-    if (autoPlay) startAutoPlay();
-  }, [autoPlay, startAutoPlay]);
+    if (autoPlay || isPlaying) startAutoPlay();
+  }, [autoPlay, isPlaying, startAutoPlay]);
+  const finishProgrammaticScroll = useCallback(event => {
+    programmaticScroll.current = false;
+    if (programmaticTimer.current != null) {
+      clearTimeout(programmaticTimer.current);
+      programmaticTimer.current = null;
+    }
+    if (snapInterval === 0) return;
+    const offsetX = event.nativeEvent.contentOffset.x;
+    const newIndex = Math.round(offsetX / snapInterval);
+    const clampedIndex = Math.max(0, Math.min(newIndex, totalItems - 1));
+    if (clampedIndex !== activeIndexRef.current) {
+      setActiveIndex(clampedIndex);
+      onIndexChange?.(clampedIndex);
+    }
+  }, [snapInterval, totalItems, onIndexChange]);
 
   // ---- Layout ----
   const handleLayout = useCallback(e => {
@@ -156,14 +202,37 @@ export function Carousel({
     goPrev
   }), [modes, activeIndex, totalItems, goTo, goNext, goPrev]);
 
+  // ---- Toggle handler for Numbered variant ----
+  const handleToggleAutoplay = useCallback(() => {
+    setIsPlaying(prev => {
+      if (prev) {
+        // Pausing
+        clearAutoPlay();
+        return false;
+      }
+      // Resuming — autoplay will restart via the effect
+      return true;
+    });
+  }, [clearAutoPlay]);
+
+  // Restart autoplay whenever isPlaying flips to true
+  useEffect(() => {
+    if (isPlaying) startAutoPlay();else clearAutoPlay();
+  }, [isPlaying, startAutoPlay, clearAutoPlay]);
+
   // ---- Render ----
   // Explicit padding props win verbatim; otherwise fall back to the
   // token-derived values (horizontal keeps its legacy ×2 "peek" multiplier).
-  const effectivePaddingH = paddingHorizontalProp ?? containerPaddingH;
-  const effectivePaddingV = paddingVerticalProp ?? containerPaddingV;
+  // Numbered variant is full-bleed: zero padding.
+  const effectivePaddingH = isNumbered ? 0 : paddingHorizontalProp ?? containerPaddingH;
+  const effectivePaddingV = isNumbered ? 0 : paddingVerticalProp ?? containerPaddingV;
   const outerStyle = {
     paddingVertical: effectivePaddingV,
-    maxHeight
+    maxHeight: isNumbered ? undefined : maxHeight,
+    // Numbered needs relative positioning for the floating controls overlay.
+    ...(isNumbered ? {
+      overflow: 'hidden'
+    } : {})
   };
   const contentContainerStyle = {
     paddingHorizontal: effectivePaddingH,
@@ -189,6 +258,7 @@ export function Carousel({
         scrollEventThrottle: 16,
         onScrollBeginDrag: handleScrollBeginDrag,
         onScrollEndDrag: handleScrollEndDrag,
+        onMomentumScrollEnd: finishProgrammaticScroll,
         children: items.map((child, index) => {
           // Strict slot box: width must be honored; never grow or shrink with
           // content, and clip anything that misbehaves (e.g. a child whose
@@ -225,11 +295,33 @@ export function Carousel({
             children: childWithModes
           }, index);
         })
-      }), showPagination && totalItems > 1 && /*#__PURE__*/_jsx(Pagination, {
+      }), !isNumbered && showPagination && totalItems > 1 && /*#__PURE__*/_jsx(Pagination, {
         modes: modes,
         style: {
           marginTop: paginationOffset
         }
+      }), isNumbered && showPagination && totalItems > 1 && /*#__PURE__*/_jsxs(View, {
+        style: {
+          position: 'absolute',
+          bottom: 12,
+          left: 0,
+          right: 0,
+          flexDirection: 'row',
+          justifyContent: 'center',
+          alignItems: 'center',
+          gap: controlGap
+        },
+        pointerEvents: "box-none",
+        children: [/*#__PURE__*/_jsx(AutoplayControl, {
+          state: isPlaying ? 'pause' : 'play',
+          onPress: handleToggleAutoplay,
+          modes: modes
+        }), /*#__PURE__*/_jsx(NumberPagination, {
+          activePage: activeIndex + 1,
+          totalPages: totalItems,
+          onPageChange: page => goTo(page - 1),
+          modes: modes
+        })]
       })]
     })
   });

package/lib/module/components/CompareTable/CompareTable.js

@@ -1,7 +1,7 @@
 "use strict";
 
-import React from 'react';
-import { View, Text, Pressable, Platform } from 'react-native';
+import React, { useCallback, useRef } from 'react';
+import { View, Text, Pressable, Platform, ScrollView } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import { EMPTY_MODES, cloneChildrenWithModes, resolveTruncation } from '../../utils/react-utils';
 import Accordion from '../Accordion/Accordion';
@@ -106,7 +106,8 @@ function CompareTable({
   maxColumns = 4,
   modes = EMPTY_MODES,
   style,
-  disableTruncation
+  disableTruncation,
+  columnWidth
 }) {
   // --- selection card tokens ------------------------------------------------
   const cardBg = getVariableByName('selectionCard/background/color', modes) ?? '#ffffff';
@@ -163,6 +164,70 @@ function CompareTable({
   const showAddCard = onAddColumn != null && columnCount < maxColumns;
   /** Grid columns shared by the selection-card row and every table row. */
   const gridColumnCount = columnCount + (showAddCard ? 1 : 0);
+  const showCardsRow = columnCount > 0 || showAddCard;
+
+  // --- fixed-width scroll mode -------------------------------------------
+  // `columnWidth` opts the component into scroll mode (see prop doc). In that
+  // mode the cards row and each section's table body are independent
+  // horizontal ScrollViews; their scroll events are chained so they move in
+  // lockstep, and the cards row pins to the top on the vertical axis.
+  const useFixedWidth = columnWidth != null;
+  /** Total scrollable content width shared by every horizontal surface. */
+  const contentWidth = useFixedWidth ? gridColumnCount * columnWidth : 0;
+  const cardsScrollRef = useRef(null);
+  const bodyScrollRefs = useRef(new Map());
+  // Stable per-section ref-callback instances so React doesn't detach/reattach
+  // on every render (which would churn the map and re-fire scrollTo).
+  const bodyRefCallbacks = useRef(new Map());
+  /** Last offset we synced everyone to. Echoed onScroll events reporting this
+   *  same value are ignored — this is what prevents feedback loops. */
+  const lastSyncX = useRef(0);
+  const applySync = useCallback((x, source) => {
+    if (Math.abs(x - lastSyncX.current) < 0.5) return;
+    lastSyncX.current = x;
+    if (source !== 'cards' && cardsScrollRef.current) {
+      cardsScrollRef.current.scrollTo({
+        x,
+        animated: false
+      });
+    }
+    bodyScrollRefs.current.forEach((ref, idx) => {
+      if (source === 'cards' || idx !== source) {
+        ref.scrollTo({
+          x,
+          animated: false
+        });
+      }
+    });
+  }, []);
+  const onCardsScroll = useCallback(e => {
+    applySync(e.nativeEvent.contentOffset.x, 'cards');
+  }, [applySync]);
+  const onBodyScroll = useCallback(idx => e => {
+    applySync(e.nativeEvent.contentOffset.x, idx);
+  }, [applySync]);
+  const getBodyRefCallback = useCallback(idx => {
+    let cb = bodyRefCallbacks.current.get(idx);
+    if (!cb) {
+      cb = ref => {
+        if (ref) {
+          bodyScrollRefs.current.set(idx, ref);
+          // Bring a freshly-expanded section's body into sync with
+          // the rest of the surfaces.
+          if (lastSyncX.current > 0) {
+            ref.scrollTo({
+              x: lastSyncX.current,
+              animated: false
+            });
+          }
+        } else {
+          bodyScrollRefs.current.delete(idx);
+        }
+      };
+      bodyRefCallbacks.current.set(idx, cb);
+    }
+    return cb;
+  }, []);
   const cardLabelStyle = {
     ...NO_WRAP_TEXT,
     color: cardLabelColor,
@@ -193,8 +258,12 @@ function CompareTable({
     fontWeight: toWeight(cellFontWeight)
   };
   const cardStyle = {
-    flex: 1,
-    minWidth: 0,
+    ...(useFixedWidth ? {
+      width: columnWidth
+    } : {
+      flex: 1,
+      minWidth: 0
+    }),
     minHeight: 147,
     backgroundColor: cardBg,
     borderRadius: cardRadius,
@@ -313,6 +382,7 @@ function CompareTable({
     return /*#__PURE__*/_jsx(Table.Cell, {
       modes: modes,
       flex: 1,
+      width: useFixedWidth ? columnWidth : undefined,
       align: "left",
       isLastColumn: isLastCol,
       isLastRow: isLastRow,
@@ -366,31 +436,126 @@ function CompareTable({
       })
     })]
   });
-  return /*#__PURE__*/_jsxs(View, {
-    style: [{
-      width: '100%',
-      backgroundColor: cardBg,
-      borderWidth: 1,
-      borderColor: '#e8e8e8',
-      overflow: 'hidden'
-    }, style],
-    children: [(columnCount > 0 || showAddCard) && /*#__PURE__*/_jsxs(View, {
+
+  // Render a single section in fixed-width scroll mode. Unlike `renderTable`
+  // (used in flex mode), the gray header row is rendered full-width OUTSIDE
+  // the body's horizontal ScrollView so it stays put horizontally (it does
+  // not slide with the cells) while still scrolling vertically with the table.
+  // The body rows live inside a horizontal ScrollView that is scroll-synced
+  // with the cards row and every other section's body.
+  const renderSection = (section, index) => /*#__PURE__*/_jsxs(Accordion, {
+    title: section.title,
+    defaultExpanded: section.defaultExpanded ?? index === 0,
+    modes: modes,
+    children: [section.header != null && /*#__PURE__*/_jsx(View, {
       style: {
-        flexDirection: 'row',
-        width: '100%'
+        width: '100%',
+        backgroundColor: headerBg,
+        paddingHorizontal: headerPaddingH,
+        paddingVertical: headerPaddingV,
+        borderBottomWidth: cellBorderSize,
+        borderBottomColor: cellBorderColor
       },
-      children: [columns.map(renderCard), showAddCard && renderAddCard()]
-    }), /*#__PURE__*/_jsx(View, {
+      children: /*#__PURE__*/_jsx(Text, {
+        style: headerTextStyle,
+        children: section.header
+      })
+    }), /*#__PURE__*/_jsx(ScrollView, {
+      ref: getBodyRefCallback(index),
+      horizontal: true,
+      showsHorizontalScrollIndicator: false,
+      scrollEventThrottle: 16,
+      onScroll: onBodyScroll(index),
+      children: /*#__PURE__*/_jsx(View, {
+        style: {
+          width: contentWidth
+        },
+        children: section.rows.map((row, rowIndex) => {
+          const isLastRow = rowIndex === section.rows.length - 1;
+          return /*#__PURE__*/_jsxs(View, {
+            style: {
+              flexDirection: 'row',
+              width: '100%'
+            },
+            children: [Array.from({
+              length: columnCount
+            }).map((_, colIndex) => renderTableCell(renderCellContent(row.values?.[colIndex], `${rowIndex}-${colIndex}`), colIndex, isLastRow, colIndex)), showAddCard && renderTableCell(null, gridColumnCount - 1, isLastRow, '__add_spacer__')]
+          }, row.key ?? rowIndex);
+        })
+      })
+    })]
+  }, section.key ?? section.title ?? index);
+  const outerStyle = {
+    width: '100%',
+    backgroundColor: cardBg,
+    borderWidth: 1,
+    borderColor: '#e8e8e8',
+    overflow: 'hidden'
+  };
+
+  // --- flex mode (columnWidth omitted): original behaviour, unchanged -------
+  if (!useFixedWidth) {
+    return /*#__PURE__*/_jsxs(View, {
+      style: [outerStyle, style],
+      children: [showCardsRow && /*#__PURE__*/_jsxs(View, {
+        style: {
+          flexDirection: 'row',
+          width: '100%'
+        },
+        children: [columns.map(renderCard), showAddCard && renderAddCard()]
+      }), /*#__PURE__*/_jsx(View, {
+        style: {
+          width: '100%'
+        },
+        children: sections.map((section, index) => /*#__PURE__*/_jsx(Accordion, {
+          title: section.title,
+          defaultExpanded: section.defaultExpanded ?? index === 0,
+          modes: modes,
+          children: renderTable(section)
+        }, section.key ?? section.title ?? index))
+      })]
+    });
+  }
+
+  // --- fixed-width scroll mode: chained horizontal sync + sticky cards -----
+  // The cards row (index 0) is a sticky header of the vertical ScrollView so
+  // it pins to the top while the sections scroll beneath. The cards row is
+  // itself a horizontal ScrollView, synced with every section body. For the
+  // vertical scroll (and thus the sticky behaviour) to engage, the host must
+  // give CompareTable a bounded height (e.g. a sized container or flex:1).
+  return /*#__PURE__*/_jsx(View, {
+    style: [outerStyle, style, {
+      flexDirection: 'column',
+      flex: 1
+    }],
+    children: /*#__PURE__*/_jsxs(ScrollView, {
       style: {
-        width: '100%'
+        width: '100%',
+        flex: 1
       },
-      children: sections.map((section, index) => /*#__PURE__*/_jsx(Accordion, {
-        title: section.title,
-        defaultExpanded: section.defaultExpanded ?? index === 0,
-        modes: modes,
-        children: renderTable(section)
-      }, section.key ?? section.title ?? index))
-    })]
+      stickyHeaderIndices: showCardsRow ? [0] : [],
+      showsVerticalScrollIndicator: false,
+      directionalLockEnabled: true,
+      children: [showCardsRow && /*#__PURE__*/_jsx(ScrollView, {
+        ref: cardsScrollRef,
+        horizontal: true,
+        showsHorizontalScrollIndicator: false,
+        scrollEventThrottle: 16,
+        onScroll: onCardsScroll,
+        children: /*#__PURE__*/_jsxs(View, {
+          style: {
+            flexDirection: 'row',
+            width: contentWidth
+          },
+          children: [columns.map(renderCard), showAddCard && renderAddCard()]
+        })
+      }), /*#__PURE__*/_jsx(View, {
+        style: {
+          width: '100%'
+        },
+        children: sections.map(renderSection)
+      })]
+    })
   });
 }
 export default CompareTable;