jfs-components 0.0.78 → 0.0.79

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to this project are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.0.79] - 2026-05-30
+
+- Added `Attached` — positions a badge over main content at nine anchor points (corners, edges, center).
+- Added `PlanComparisonCard` — plan comparison table with column headers, feature rows, brand highlight, and cell values (text / cross / custom node).
+- Added `Slot` — token-driven vertical/horizontal layout container with `modes` cascade to children.
+- `Card` — new `header` slot above media (e.g. brand logo).
+- `ListItem` — new `trailing` slot; `endSlot` deprecated (still honored).
+- `FullscreenModal` — footer action stack now uses `Slot` instead of a raw `View`.
+
+---
+
 ## [0.0.78] - 2026-05-29
 
 - Added `ExpandableCheckbox` — checkbox row with collapsible long label and Read more / Read less toggle.

package/lib/commonjs/components/Attached/Attached.js

@@ -0,0 +1,144 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _JFSThemeProvider = require("../../design-tokens/JFSThemeProvider");
+var _reactUtils = require("../../utils/react-utils");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * Anchor point on the main content where the attached `badge` is centered.
+ * Mirrors the nine Figma `position` variants (corners, edge midpoints, center).
+ */
+
+const ZERO_SIZE = {
+  width: 0,
+  height: 0
+};
+
+/**
+ * Fraction (0 | 0.5 | 1) of the main content's width/height at which the badge
+ * center should sit, derived from the `position` anchor.
+ */
+function resolveAnchorFractions(position) {
+  const fx = position.includes('left') ? 0 : position.includes('right') ? 1 : 0.5;
+  const fy = position.startsWith('top') ? 0 : position.startsWith('bottom') ? 1 : 0.5;
+  return {
+    fx,
+    fy
+  };
+}
+
+/**
+ * Attached — overlays a small `badge` on top of arbitrary main content,
+ * centered on one of nine anchor points (corners, edge midpoints, or center).
+ *
+ * The badge straddles the chosen anchor regardless of either element's size:
+ * both the main content and the badge are measured via `onLayout`, then the
+ * badge is absolutely positioned so its center lands exactly on the anchor.
+ *
+ * @example
+ * ```tsx
+ * <Attached position="bottom-right" badge={<InstitutionBadge modes={modes} />} modes={modes}>
+ *   <IconCapsule iconName="ic_card" modes={modes} />
+ * </Attached>
+ * ```
+ */
+function Attached({
+  children,
+  badge,
+  position = 'bottom-right',
+  circular = true,
+  modes: propModes = _reactUtils.EMPTY_MODES,
+  style,
+  ...rest
+}) {
+  const {
+    modes: globalModes
+  } = (0, _JFSThemeProvider.useTokens)();
+  const modes = (0, _react.useMemo)(() => globalModes === _reactUtils.EMPTY_MODES && propModes === _reactUtils.EMPTY_MODES ? _reactUtils.EMPTY_MODES : {
+    ...globalModes,
+    ...propModes
+  }, [globalModes, propModes]);
+  const [mainSize, setMainSize] = (0, _react.useState)(ZERO_SIZE);
+  const [badgeSize, setBadgeSize] = (0, _react.useState)(ZERO_SIZE);
+  const onMainLayout = (0, _react.useCallback)(e => {
+    const {
+      width,
+      height
+    } = e.nativeEvent.layout;
+    setMainSize(prev => prev.width === width && prev.height === height ? prev : {
+      width,
+      height
+    });
+  }, []);
+  const onBadgeLayout = (0, _react.useCallback)(e => {
+    const {
+      width,
+      height
+    } = e.nativeEvent.layout;
+    setBadgeSize(prev => prev.width === width && prev.height === height ? prev : {
+      width,
+      height
+    });
+  }, []);
+  const mainChildren = (0, _react.useMemo)(() => children != null ? (0, _reactUtils.cloneChildrenWithModes)(children, modes) : null, [children, modes]);
+  const badgeChildren = (0, _react.useMemo)(() => badge != null ? (0, _reactUtils.cloneChildrenWithModes)(badge, modes) : null, [badge, modes]);
+  const badgePlacement = (0, _react.useMemo)(() => {
+    const {
+      fx,
+      fy
+    } = resolveAnchorFractions(position);
+    const measured = mainSize.width > 0 && badgeSize.width > 0;
+    let anchorX;
+    let anchorY;
+    if (circular) {
+      // Project the anchor onto the circle inscribed in the bounding box, so
+      // corner badges land on the circumference (45°) instead of the box corner.
+      const cx = mainSize.width / 2;
+      const cy = mainSize.height / 2;
+      const radius = Math.min(mainSize.width, mainSize.height) / 2;
+      const dx = (fx - 0.5) * 2; // -1 | 0 | 1
+      const dy = (fy - 0.5) * 2; // -1 | 0 | 1
+      const len = Math.hypot(dx, dy) || 1; // 'center' → 0, guard against /0
+      anchorX = cx + dx / len * radius;
+      anchorY = cy + dy / len * radius;
+    } else {
+      anchorX = mainSize.width * fx;
+      anchorY = mainSize.height * fy;
+    }
+    return {
+      position: 'absolute',
+      left: anchorX - badgeSize.width / 2,
+      top: anchorY - badgeSize.height / 2,
+      // Hide until both elements are measured to avoid a one-frame flash at (0,0).
+      opacity: measured ? 1 : 0
+    };
+  }, [position, circular, mainSize, badgeSize]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: [styles.container, style],
+    ...rest,
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      onLayout: onMainLayout,
+      children: mainChildren
+    }), badgeChildren != null && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: badgePlacement,
+      onLayout: onBadgeLayout,
+      pointerEvents: "box-none",
+      children: badgeChildren
+    })]
+  });
+}
+const styles = {
+  // alignSelf flex-start so the wrapper hugs the main content; anchors are then
+  // computed relative to the content size rather than a stretched parent.
+  container: {
+    position: 'relative',
+    alignSelf: 'flex-start'
+  }
+};
+var _default = exports.default = /*#__PURE__*/_react.default.memo(Attached);

package/lib/commonjs/components/Card/Card.js

@@ -20,9 +20,11 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * Card component implementation from Figma node 765:6186.
  * 
  * Supports a `media` slot (with aspect ratio) and a content area.
+ * Supports an optional `header` slot (e.g. a brand logo), a `media` slot
+ * (with aspect ratio) and a content area.
  * Usage:
  * ```tsx
- * <Card media={<Image source={...} />} modes={modes}>
+ * <Card header={<GoldLogo />} media={<Image source={...} />} modes={modes}>
  *   <Card.SupportText>Support text</Card.SupportText>
  *   <Card.Title>Title</Card.Title>
  *   <Card.SupportText>Support text</Card.SupportText>
@@ -30,6 +32,7 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
  * ```
  */
 function Card({
+  header,
   media,
   children,
   modes = _reactUtils.EMPTY_MODES,
@@ -57,6 +60,14 @@ function Card({
       ...modes
     }
   }) : media;
+
+  // Clone header to pass modes if it's a valid element
+  const headerWithModes = /*#__PURE__*/(0, _react.isValidElement)(header) ? /*#__PURE__*/(0, _react.cloneElement)(header, {
+    modes: {
+      ...header.props.modes,
+      ...modes
+    }
+  }) : header;
   const containerStyle = {
     backgroundColor,
     borderColor,
@@ -67,6 +78,15 @@ function Card({
     paddingVertical,
     overflow: 'hidden' // Ensure border radius clips content
   };
+
+  // Header wrap uses fixed padding from Figma (no dedicated tokens defined).
+  const headerWrapperStyle = {
+    width: '100%',
+    flexDirection: 'row',
+    alignItems: 'flex-start',
+    paddingHorizontal: 12,
+    paddingVertical: 16
+  };
   const mediaWrapperStyle = {
     width: '100%',
     aspectRatio: mediaAspectRatio,
@@ -87,7 +107,10 @@ function Card({
     },
     children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
       style: [containerStyle, style],
-      children: [media && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      children: [header && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+        style: headerWrapperStyle,
+        children: headerWithModes
+      }), media && /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
         style: mediaWrapperStyle,
         children: mediaWithModes
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {

package/lib/commonjs/components/FullscreenModal/FullscreenModal.js

@@ -14,6 +14,7 @@ var _Button = _interopRequireDefault(require("../Button/Button"));
 var _Disclaimer = _interopRequireDefault(require("../Disclaimer/Disclaimer"));
 var _IconButton = _interopRequireDefault(require("../IconButton/IconButton"));
 var _ActionFooter = _interopRequireDefault(require("../ActionFooter/ActionFooter"));
+var _Slot = _interopRequireDefault(require("../Slot/Slot"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
@@ -274,8 +275,9 @@ function FullscreenModal({
   if (footer) {
     footerContent = footer;
   } else if (primaryActionLabel) {
-    footerContent = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-      style: footerColumnStyle,
+    footerContent = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_Slot.default, {
+      layoutDirection: "vertical",
+      modes: modes,
       children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_Button.default, {
         label: primaryActionLabel,
         modes: modes,
@@ -340,10 +342,6 @@ const scrollViewStyle = {
 const scrollContentStyle = {
   flexGrow: 1
 };
-const footerColumnStyle = {
-  width: '100%',
-  gap: 8
-};
 const fullWidthStyle = {
   width: '100%'
 };

package/lib/commonjs/components/ListItem/ListItem.js

@@ -21,9 +21,10 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 const IS_IOS = _reactNative.Platform.OS === 'ios';
 const PRESS_DELAY = IS_IOS ? 130 : 0;
 
-// Forced modes for the endSlot — `Context: 'ListItem'` can never be
-// overridden by external modes. Frozen so identity is stable across renders.
-const END_SLOT_FORCED_MODES = Object.freeze({
+// Forced modes for the leading/trailing slots — `Context: 'ListItem'` can
+// never be overridden by external modes. Frozen so identity is stable across
+// renders. Applied to both slots so they cascade modes identically.
+const SLOT_FORCED_MODES = Object.freeze({
   Context: 'ListItem'
 });
 
@@ -38,7 +39,7 @@ const pressedOverlayStyle = {
 // ---------------------------------------------------------------------------
 
 function resolveListItemTokens(modes) {
-  // Modes used to cascade into slot children (leading / supportSlot / endSlot).
+  // Modes used to cascade into slot children (leading / supportSlot / trailing).
   // We do NOT inject an `AppearanceBrand` default here: slot content such as
   // Buttons or Badges carry their own intended appearance, so forcing one onto
   // them would be surprising.
@@ -137,9 +138,11 @@ const verticalSupportTextOverride = {
  *  - **design-token driven styling** via `getVariableByName` and `modes`
  *
  * Wherever the Figma layer name contains "Slot", this component exposes a
- * dedicated React "slot" prop:
+ * dedicated React "slot" prop. The leading and trailing edges share a
+ * symmetric `leading` / `trailing` slot API:
+ *  - Slot "leading" → `leading`
  *  - Slot "support text" → `supportSlot`
- *  - Slot "end" → `endSlot`
+ *  - Slot "trailing" → `trailing`
  *
  * @component
  * @param {Object} props
@@ -147,9 +150,9 @@ const verticalSupportTextOverride = {
  * @param {string} [props.title='Title'] - Primary title used in the horizontal layout.
  * @param {string} [props.supportText='Support Text'] - Support text used in both layouts when `supportSlot` is not provided.
  * @param {boolean} [props.showSupportText=true] - Toggles rendering of the support text in Horizontal layout.
- * @param {React.ReactNode} [props.leading] - Optional leading element. Defaults to `IconCapsule`.
+ * @param {React.ReactNode} [props.leading] - Optional leading slot. Defaults to `IconCapsule`.
  * @param {React.ReactNode} [props.supportSlot] - Optional custom slot used instead of the default support text block.
- * @param {React.ReactNode} [props.endSlot] - Optional custom trailing slot (Figma Slot "end").
+ * @param {React.ReactNode} [props.trailing] - Optional trailing slot (Figma Slot "trailing"). Horizontal layout only.
  * @param {boolean} [props.navArrow=true] - Whether to show NavArrow on the far right (Horizontal layout only).
  * @param {Object} [props.modes={}] - Modes object passed to `getVariableByName` for all design tokens.
  * @param {Function} [props.onPress] - When provided, the entire item becomes pressable (navigation variant).
@@ -178,6 +181,7 @@ function ListItemImpl({
   showSupportText = true,
   leading,
   supportSlot,
+  trailing,
   endSlot,
   navArrow = true,
   modes = _reactUtils.EMPTY_MODES,
@@ -215,7 +219,7 @@ function ListItemImpl({
   // Process leading slot to pass modes to children. Memoized on
   // (leading, resolvedModes) so a parent re-render doesn't re-walk the tree.
   const leadingElement = (0, _react.useMemo)(() => {
-    const processed = leading ? (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(leading), tokens.resolvedModes) : [];
+    const processed = leading ? (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(leading), tokens.resolvedModes, SLOT_FORCED_MODES) : [];
     if (processed.length === 0) {
       return /*#__PURE__*/(0, _jsxRuntime.jsx)(_IconCapsule.default, {
         modes: tokens.resolvedModes,
@@ -229,11 +233,14 @@ function ListItemImpl({
     const processed = (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(supportSlot), tokens.resolvedModes);
     return processed.length === 1 ? processed[0] : processed;
   }, [supportSlot, tokens.resolvedModes]);
-  const processedEndSlot = (0, _react.useMemo)(() => {
-    if (!endSlot) return null;
-    const processed = (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(endSlot), tokens.resolvedModes, END_SLOT_FORCED_MODES);
+
+  // `trailing` wins; `endSlot` is the deprecated alias kept for back-compat.
+  const trailingContent = trailing ?? endSlot;
+  const processedTrailing = (0, _react.useMemo)(() => {
+    if (!trailingContent) return null;
+    const processed = (0, _reactUtils.cloneChildrenWithModes)(_react.default.Children.toArray(trailingContent), tokens.resolvedModes, SLOT_FORCED_MODES);
     return processed.length === 1 ? processed[0] : processed;
-  }, [endSlot, tokens.resolvedModes]);
+  }, [trailingContent, tokens.resolvedModes]);
   const renderSupportContent = () => {
     if (processedSupportSlot) return processedSupportSlot;
 
@@ -279,9 +286,9 @@ function ListItemImpl({
           numberOfLines: 1,
           children: title
         }), showSupportText && renderSupportContent()]
-      }), processedEndSlot ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      }), processedTrailing ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
         style: tokens.trailingWrapperStyle,
-        children: processedEndSlot
+        children: processedTrailing
       }) : null, navArrow && /*#__PURE__*/(0, _jsxRuntime.jsx)(_NavArrow.default, {
         direction: "Forward",
         modes: tokens.resolvedModes