jfs-components 0.0.69 → 0.0.70

package/CHANGELOG.md

@@ -4,6 +4,26 @@ 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.70] - 2026-04-23
+
+### Fixed
+
+- **`MediaCard.Footer` blur on bare React Native:** `0.0.69` shipped the glass footer using `expo-blur`, which silently required consumers to integrate Expo Modules autolinking (`use_expo_modules!` in `Podfile`, `ExpoModulesPackage` on Android). Bare React Native apps that just installed the library and ran `pod install` hit two failures: a runtime "`Cannot read property 'BlurView' of undefined`" red box on Android and an iOS Xcode build failure after `pod install`. **Replaced `expo-blur` with [`@react-native-community/blur`](https://github.com/Kureev/react-native-blur)** — a regular React Native native module handled by standard autolinking. No Expo runtime required.
+
+### Changed
+
+- **`MediaCard.Footer` glass implementation:** Native blur now lives in a small platform-split helper, `MediaCard/GlassFill.tsx` (iOS + Android via the community blur module) and `MediaCard/GlassFill.web.tsx` (`backdrop-filter` via inline style). Metro picks the correct file per platform, so the web bundle never imports the native-only blur module. The Footer's API and design-token contract (`blur/minimal/background`, `blur/minimal`, `Contrast Context` mode) are unchanged.
+
+### Removed
+
+- **`expo-blur`** is no longer a runtime dependency.
+
+### Dependencies
+
+- **`@react-native-community/blur`** (`>=4.4.0`) added as a **peer dependency**. Consumers must install it once: `npm install @react-native-community/blur && cd ios && pod install`. On Expo, use `npx expo install @react-native-community/blur` and prebuild.
+
+---
+
 ## [0.0.69] - 2026-04-22
 
 ### Changed

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

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _reactNative = require("react-native");
+var _blur = require("@react-native-community/blur");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+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__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: [_reactNative.StyleSheet.absoluteFill, style],
+    pointerEvents: "none",
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_blur.BlurView, {
+      style: _reactNative.StyleSheet.absoluteFill,
+      blurType: blurType,
+      blurAmount: blurAmount,
+      reducedTransparencyFallbackColor: fallbackColor
+    }), overlayColor != null ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: [_reactNative.StyleSheet.absoluteFill, {
+        backgroundColor: overlayColor
+      }]
+    }) : null, _reactNative.Platform.OS === 'android' ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: [_reactNative.StyleSheet.absoluteFill, {
+        backgroundColor: 'rgba(255,255,255,0.03)',
+        opacity: 0.6
+      }]
+    }) : null]
+  });
+}
+var _default = exports.default = GlassFill;

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

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _reactNative = require("react-native");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+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__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    style: [_reactNative.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"
+  });
+}
+var _default = exports.default = GlassFill;

package/lib/commonjs/components/MediaCard/MediaCard.js

@@ -12,9 +12,9 @@ exports.Title = Title;
 exports.default = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
-var _expoBlur = require("expo-blur");
 var _figmaVariablesResolver = require("../../design-tokens/figma-variables-resolver");
 var _Image = _interopRequireDefault(require("../Image/Image"));
+var _GlassFill = _interopRequireDefault(require("./GlassFill"));
 var _reactUtils = require("../../utils/react-utils");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
@@ -136,20 +136,24 @@ function Title({
  * Glass Footer — pinned to the bottom of the card, **always** on top of the
  * Header (`zIndex: 2`).
  *
- * Glass implementation (April 2026 best practice for RN/Expo):
- *  - **iOS:** `expo-blur`'s `BlurView` renders a native `UIVisualEffectView`,
- *    so this is a real OS-level live blur of whatever's underneath. We pick
- *    `tint` from the Figma "Contrast Context" mode (`'dark'` / `'light'`)
- *    and a moderate intensity that matches the Figma `blur/minimal` token.
- *  - **Android:** the same `BlurView` with `experimentalBlurMethod="dimezisBlurView"`
- *    enables the hardware-accelerated `RenderEffect` blur on Android 12+.
- *    On older Android, expo-blur cleanly degrades to a tinted scrim — we
- *    layer a subtle noise/grain overlay on top so the surface still reads
- *    as "frosted glass" instead of a flat color.
- *  - **Web:** `BlurView` on web is implemented as `backdrop-filter: blur()`,
- *    which already worked in the previous version. Same component, same API.
+ * 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.
  *
- * Tokens still drive the tint color, blur radius and inner spacing.
+ * 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.
  */
 function Footer({
   children,
@@ -163,10 +167,14 @@ function Footer({
   const paddingVertical = parseFloat((0, _figmaVariablesResolver.getVariableByName)('cardMedia/footer/padding/vertical', modes) || '12');
 
   // Figma tokens:
-  //   blur/minimal/background -> tint laid over the native blur
-  //   blur/minimal            -> blur radius (px). expo-blur takes a 0-100
-  //                              "intensity" instead of px; we map roughly:
-  //                              intensity ≈ clamp(radius * 1.7, 0, 100).
+  //   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 = (0, _figmaVariablesResolver.getVariableByName)('blur/minimal/background', modes) || '#1414174a';
   const blurRadius = parseFloat((0, _figmaVariablesResolver.getVariableByName)('blur/minimal', modes) || '29');
   const intensity = Math.max(0, Math.min(100, Math.round(blurRadius * 1.7)));
@@ -187,22 +195,11 @@ function Footer({
       zIndex: 2
     }, style],
     pointerEvents: "box-none",
-    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_expoBlur.BlurView, {
-      style: _reactNative.StyleSheet.absoluteFill,
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_GlassFill.default, {
       tint: tint,
       intensity: intensity,
-      experimentalBlurMethod: "dimezisBlurView"
+      overlayColor: glassBgColor
     }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-      style: [_reactNative.StyleSheet.absoluteFill, {
-        backgroundColor: glassBgColor
-      }]
-    }), _reactNative.Platform.OS === 'android' ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
-      style: [_reactNative.StyleSheet.absoluteFill, {
-        backgroundColor: 'rgba(255,255,255,0.03)',
-        opacity: 0.6
-      }],
-      pointerEvents: "none"
-    }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
       style: {
         flexDirection: 'row',
         alignItems: 'center',