jfs-components 0.0.68 → 0.0.70

package/lib/module/components/MediaCard/GlassFill.js

@@ -0,0 +1,57 @@
+"use strict";
+
+import React from 'react';
+import { View, StyleSheet, Platform } from 'react-native';
+import { BlurView } from '@react-native-community/blur';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const DEFAULT_FALLBACK_DARK = '#1414174a';
+const DEFAULT_FALLBACK_LIGHT = '#ffffff66';
+
+/**
+ * Glass / frosted surface for native (iOS + Android).
+ *
+ * Why this lives in its own platform-split file:
+ *   - `@react-native-community/blur` is a native-only module. Importing it on
+ *     web throws because the JS shim references native components that aren't
+ *     registered there. By using Metro's platform-extension resolution
+ *     (`GlassFill.tsx` for native, `GlassFill.web.tsx` for web), we keep the
+ *     web bundle free of any native-only imports.
+ *   - Centralizes the `intensity` (0–100) -> `blurAmount` (0–32) mapping so
+ *     callers can keep the Figma token semantics they already know.
+ *
+ * On iOS this is a real `UIVisualEffectView` (true OS-level live blur).
+ * On Android this uses the community blur view (RealtimeBlurView). On devices
+ * where realtime blur is unavailable, `reducedTransparencyFallbackColor` (and
+ * the explicit `overlayColor`) ensure the surface still renders as a
+ * translucent tinted scrim instead of disappearing.
+ */
+function GlassFill({
+  tint = 'dark',
+  intensity = 50,
+  overlayColor,
+  style
+}) {
+  const blurType = tint === 'light' ? 'light' : 'dark';
+  const blurAmount = Math.max(0, Math.min(32, Math.round(intensity * 0.32)));
+  const fallbackColor = overlayColor ?? (tint === 'light' ? DEFAULT_FALLBACK_LIGHT : DEFAULT_FALLBACK_DARK);
+  return /*#__PURE__*/_jsxs(View, {
+    style: [StyleSheet.absoluteFill, style],
+    pointerEvents: "none",
+    children: [/*#__PURE__*/_jsx(BlurView, {
+      style: StyleSheet.absoluteFill,
+      blurType: blurType,
+      blurAmount: blurAmount,
+      reducedTransparencyFallbackColor: fallbackColor
+    }), overlayColor != null ? /*#__PURE__*/_jsx(View, {
+      style: [StyleSheet.absoluteFill, {
+        backgroundColor: overlayColor
+      }]
+    }) : null, Platform.OS === 'android' ? /*#__PURE__*/_jsx(View, {
+      style: [StyleSheet.absoluteFill, {
+        backgroundColor: 'rgba(255,255,255,0.03)',
+        opacity: 0.6
+      }]
+    }) : null]
+  });
+}
+export default GlassFill;

package/lib/module/components/MediaCard/GlassFill.web.js

@@ -0,0 +1,43 @@
+"use strict";
+
+import React from 'react';
+import { View, StyleSheet } from 'react-native';
+import { jsx as _jsx } from "react/jsx-runtime";
+const DEFAULT_FALLBACK_DARK = '#1414174a';
+const DEFAULT_FALLBACK_LIGHT = '#ffffff66';
+
+/**
+ * Web counterpart of `GlassFill`.
+ *
+ * `@react-native-community/blur` does not ship a web implementation, so for
+ * the web bundle we render a translucent `View` with `backdrop-filter: blur()`
+ * — which is exactly how 0.0.67 and earlier shipped the glass effect on web.
+ * Native bundles pick up `GlassFill.tsx` instead via Metro's platform
+ * resolver; the web bundle picks up this file.
+ */
+function GlassFill({
+  tint = 'dark',
+  intensity = 50,
+  overlayColor,
+  style
+}) {
+  // Approximate mapping: intensity 0-100 -> ~0-30px CSS blur. Keeps parity
+  // with the native blur strength so the component looks roughly the same
+  // across platforms.
+  const blurPx = Math.max(0, Math.min(30, Math.round(intensity * 0.3)));
+  const tintColor = overlayColor ?? (tint === 'light' ? DEFAULT_FALLBACK_LIGHT : DEFAULT_FALLBACK_DARK);
+  return /*#__PURE__*/_jsx(View, {
+    style: [StyleSheet.absoluteFill, {
+      backgroundColor: tintColor
+    },
+    // backdrop-filter is a web-only CSS property; ignored by RN
+    // on native (we never bundle this file there anyway).
+    // @ts-ignore web-only style
+    {
+      backdropFilter: `blur(${blurPx}px)`,
+      WebkitBackdropFilter: `blur(${blurPx}px)`
+    }, style],
+    pointerEvents: "none"
+  });
+}
+export default GlassFill;

package/lib/module/components/MediaCard/MediaCard.js

@@ -1,20 +1,30 @@
 "use strict";
 
 import React, { createContext, useContext } from 'react';
-import { View, Text, StyleSheet, Platform } from 'react-native';
+import { View, Text, StyleSheet } from 'react-native';
 import { getVariableByName } from '../../design-tokens/figma-variables-resolver';
 import Image from '../Image/Image';
+import GlassFill from './GlassFill';
 import { EMPTY_MODES } from '../../utils/react-utils';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const MediaCardContext = /*#__PURE__*/createContext({});
 /**
  * MediaCard component implementation from Figma node 1241:4140.
  *
- * Features a background media slot, a large title, and a glass-morphism footer.
- *
- * The background can be supplied either as `imageSource` (preferred — uses
- * the shared `<Image>` primitive under the hood) or as a custom `media` node
- * for non-image backgrounds.
+ * Layout contract (important — read this before editing):
+ *  - The **background** (image or custom `media`) is the only child in
+ *    normal flow. It dictates the card's height — typically via
+ *    `aspectRatio` on the inner `<Image>`. There is no `minHeight`.
+ *  - `Header` and `Footer` are **absolutely positioned overlays**:
+ *      - `Header` pinned to top-left/right with safe padding.
+ *      - `Footer` pinned to bottom-left/right with `zIndex: 2` so it sits
+ *        on top of the header (and on top of the image). This guarantees
+ *        the footer never moves no matter how many lines the title wraps
+ *        to — the title may overflow the header bounds, but the footer's
+ *        position is a function of the card box, not the title.
+ *  - `pointerEvents="box-none"` is applied so taps still land on the
+ *    interactive elements inside the overlays without the wrapper itself
+ *    capturing them.
  */
 export function MediaCard({
   imageSource,
@@ -25,21 +35,11 @@ export function MediaCard({
   style
 }) {
   const radius = parseFloat(getVariableByName('cardMedia/radius', modes) || '24');
-
-  // No magic minHeight, no aspectRatio on the container. The card simply
-  // hugs whatever the background renders at: the <Image> sits in normal
-  // flow with `aspectRatio: ratio`, so its rendered height becomes the
-  // card's height. Header and Footer are absolutely positioned overlays
-  // and don't contribute to layout.
   const containerStyle = {
     borderRadius: radius,
     overflow: 'hidden',
     position: 'relative'
   };
-
-  // `media` wins as an escape hatch (gradient/video/etc.). Otherwise we
-  // delegate to the shared <Image> for image-source backgrounds. The
-  // background renders in normal flow so its height drives the card.
   const background = media ?? (imageSource != null ? /*#__PURE__*/_jsx(Image, {
     imageSource: imageSource,
     ratio: ratio,
@@ -67,33 +67,26 @@ export function MediaCard({
 // ----------------------------------------------------------------------------
 
 /**
- * Header/Title Wrapper
- * It seems the title is just floating at the top with padding.
- * Figma: "title wrap" p-[16px]
+ * Header overlay — pinned to the top of the card. Title content can wrap to
+ * any number of lines without affecting the footer's position; if it grows
+ * taller than the card, the card's `overflow: 'hidden'` clips it.
+ *
+ * Default `padding: 16` matches the Figma "title wrap" spec.
  */
 export function Header({
   children,
   style
 }) {
-  // NOTE: the previous `flex: 1` shorthand expanded on Yoga (Android) to
-  // `{ flexGrow: 1, flexShrink: 1, flexBasis: 0 }`. With `flexBasis: 0` the
-  // Header has *no intrinsic floor*, so when MediaCard is placed inside a
-  // height-unbounded parent — e.g. a Carousel slot whose contentContainer
-  // is `alignItems: 'flex-start'` — Yoga's first measurement pass sizes
-  // the Header at 0 and the card's overall height becomes non-deterministic.
-  // On native this manifests as the card "over-stretching" vertically (the
-  // same Yoga foot-gun we fixed in `CardCTA` rightWrap). Web hides it
-  // because browsers honor `min-height: auto` on flex items. Use explicit
-  // `flexGrow / flexShrink: 0 / flexBasis: 'auto'` so the Header is sized
-  // to its content as a floor and only grows to consume the extra space
-  // contributed by `MediaCard`'s `minHeight: 308`.
   return /*#__PURE__*/_jsx(View, {
     style: [{
+      position: 'absolute',
+      top: 0,
+      left: 0,
+      right: 0,
       padding: 16,
-      flexGrow: 1,
-      flexShrink: 0,
-      flexBasis: 'auto'
+      zIndex: 1
     }, style],
+    pointerEvents: "box-none",
     children: children
   });
 }
@@ -128,8 +121,27 @@ export function Title({
 }
 
 /**
- * Glass Footer Component
- * Tokens: cardMedia/footer/*, glass/minimal, blur/minimal
+ * Glass Footer — pinned to the bottom of the card, **always** on top of the
+ * Header (`zIndex: 2`).
+ *
+ * Glass implementation:
+ *  - **iOS / Android:** `<GlassFill>` (this folder) wraps
+ *    `@react-native-community/blur`'s `BlurView`. iOS gets a real
+ *    `UIVisualEffectView` (live OS blur); Android gets the community
+ *    `RealtimeBlurView` with a token-driven tinted scrim fallback for
+ *    devices where realtime blur is unavailable.
+ *  - **Web:** the platform-extension file `GlassFill.web.tsx` renders a
+ *    translucent View with `backdrop-filter: blur()` — Metro picks the
+ *    correct file automatically, so the web bundle never imports the
+ *    native-only blur module.
+ *
+ * Why we don't use `expo-blur`: it requires Expo Modules autolinking on the
+ * consumer side (`use_expo_modules!` / `ExpoModulesPackage`), which silently
+ * breaks bare React Native apps that just install this library and run
+ * `pod install`. `@react-native-community/blur` is a regular RN native
+ * module — autolinking handles it with no additional setup.
+ *
+ * Tokens still drive the tint color, blur intensity and inner spacing.
  */
 export function Footer({
   children,
@@ -142,28 +154,49 @@ export function Footer({
   const paddingHorizontal = parseFloat(getVariableByName('cardMedia/footer/padding/horizontal', modes) || '16');
   const paddingVertical = parseFloat(getVariableByName('cardMedia/footer/padding/vertical', modes) || '12');
 
-  // Glass Effect
-  // Figma:
-  // blur/minimal/background: "#1414174a"
-  // blur/minimal: 29
+  // Figma tokens:
+  //   blur/minimal/background -> tint laid over the live blur, also used
+  //                              as the iOS reduced-transparency fallback.
+  //   blur/minimal            -> blur radius (px). The community BlurView
+  //                              uses `blurAmount` (~0-32). `GlassFill`
+  //                              accepts a 0-100 "intensity" (kept compat
+  //                              with the previous expo-blur scale) and
+  //                              maps it internally — here we convert the
+  //                              token's radius to that intensity scale.
   const glassBgColor = getVariableByName('blur/minimal/background', modes) || '#1414174a';
   const blurRadius = parseFloat(getVariableByName('blur/minimal', modes) || '29');
-  const containerStyle = {
-    flexDirection: 'row',
-    alignItems: 'center',
-    gap,
-    paddingHorizontal,
-    paddingVertical,
-    backgroundColor: glassBgColor,
-    // Web-specific backdrop filter for glass effect
-    // @ts-ignore
-    ...(Platform.OS === 'web' ? {
-      backdropFilter: `blur(${blurRadius}px)`
-    } : {})
-  };
-  return /*#__PURE__*/_jsx(View, {
-    style: [containerStyle, style],
-    children: children
+  const intensity = Math.max(0, Math.min(100, Math.round(blurRadius * 1.7)));
+
+  // Pick the iOS/Android material tint from "Contrast Context" mode so the
+  // glass adapts to dark/light backgrounds the same way the Figma tokens do.
+  const contrast = modes['Contrast Context'] || 'on dark';
+  const tint = contrast === 'on light' ? 'light' : 'dark';
+  return /*#__PURE__*/_jsxs(View, {
+    style: [{
+      position: 'absolute',
+      left: 0,
+      right: 0,
+      bottom: 0,
+      overflow: 'hidden',
+      // zIndex 2 ensures Footer always paints above Header,
+      // regardless of which is rendered first in the tree.
+      zIndex: 2
+    }, style],
+    pointerEvents: "box-none",
+    children: [/*#__PURE__*/_jsx(GlassFill, {
+      tint: tint,
+      intensity: intensity,
+      overlayColor: glassBgColor
+    }), /*#__PURE__*/_jsx(View, {
+      style: {
+        flexDirection: 'row',
+        alignItems: 'center',
+        gap,
+        paddingHorizontal,
+        paddingVertical
+      },
+      children: children
+    })]
   });
 }