rn-iconify 2.2.0 → 3.0.0

package/lib/commonjs/IconRenderer.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.IconRenderer = IconRenderer;
+exports.IconRenderer = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _reactNativeSvg = require("react-native-svg");
@@ -12,19 +12,121 @@ var _IconifyAPI = require("./network/IconifyAPI");
 var _placeholder = require("./placeholder");
 var _useIconAnimation = require("./animated/useIconAnimation");
 var _config = require("./config");
+var _errors = require("./errors");
+var _AccessibilityProvider = require("./accessibility/AccessibilityProvider");
 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); }
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); } /**
  * IconRenderer - Core component for rendering SVG icons
- * Handles cache lookup, network fetching, and SVG rendering
+ * Handles cache lookup, network fetching, placeholders, and SVG rendering
+ *
+ * v3.0 rewrite:
+ * - useReducer state machine (eliminates impossible states)
+ * - SvgXml color prop (preserves multi-color icons)
+ * - React.memo + React.forwardRef
+ * - Stable loadIcon deps (only iconName triggers refetch)
+ * - Auto 44dp hitSlop for small icons
+ * - Typed IconLoadError
  */
-/**
- * Escape special characters for XML attribute values
- * Prevents XSS attacks when user input is used as color prop
- */
-function escapeXmlAttribute(value) {
-  return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;').replace(/'/g, '&apos;');
+// ---------------------------------------------------------------------------
+// State machine
+// ---------------------------------------------------------------------------
+
+const initialState = {
+  svg: null,
+  status: 'idle',
+  showFallback: false,
+  wasCacheHit: false,
+  error: null
+};
+function iconReducer(state, action) {
+  switch (action.type) {
+    case 'CACHE_HIT':
+      return {
+        svg: action.svg,
+        status: 'loaded',
+        showFallback: false,
+        wasCacheHit: true,
+        error: null
+      };
+    case 'FETCH_START':
+      return {
+        svg: null,
+        status: 'loading',
+        showFallback: false,
+        wasCacheHit: false,
+        error: null
+      };
+    case 'SHOW_FALLBACK':
+      if (state.status !== 'loading') return state;
+      return {
+        ...state,
+        showFallback: true
+      };
+    case 'FETCH_SUCCESS':
+      return {
+        svg: action.svg,
+        status: 'loaded',
+        showFallback: false,
+        wasCacheHit: false,
+        error: null
+      };
+    case 'FETCH_ERROR':
+      return {
+        svg: null,
+        status: 'error',
+        showFallback: true,
+        wasCacheHit: false,
+        error: action.error
+      };
+    case 'RESET':
+      return initialState;
+    default:
+      return state;
+  }
 }
-function IconRenderer({
+
+// ---------------------------------------------------------------------------
+// PressableWrapper — extracted and memoized
+// ---------------------------------------------------------------------------
+
+const PressableWrapper = /*#__PURE__*/_react.default.memo(function PressableWrapper({
+  onPress,
+  onLongPress,
+  onPressIn,
+  onPressOut,
+  disabled,
+  pressedStyle,
+  hitSlop,
+  children
+}) {
+  return /*#__PURE__*/_react.default.createElement(_reactNative.Pressable, {
+    onPress: onPress,
+    onLongPress: onLongPress,
+    onPressIn: onPressIn,
+    onPressOut: onPressOut,
+    disabled: disabled,
+    hitSlop: hitSlop,
+    accessibilityRole: "button",
+    accessibilityState: {
+      disabled
+    },
+    style: pressedStyle ? ({
+      pressed
+    }) => [pressed && pressedStyle] : undefined
+  }, children);
+});
+
+// ---------------------------------------------------------------------------
+// MIN_TOUCH_TARGET for automatic hitSlop
+// ---------------------------------------------------------------------------
+
+const MIN_TOUCH_TARGET = 44;
+
+// ---------------------------------------------------------------------------
+// IconRenderer component
+// ---------------------------------------------------------------------------
+
+const IconRenderer = exports.IconRenderer = /*#__PURE__*/_react.default.memo(/*#__PURE__*/_react.default.forwardRef(function IconRenderer({
   iconName,
   size = 24,
   color = '#000000',
@@ -58,20 +160,30 @@ function IconRenderer({
   animationDelay,
   autoPlay = true,
   onAnimationComplete
-}) {
+}, ref) {
   // Resolve defaults from config
   const defaultsConfig = _config.ConfigManager.getDefaultsConfig();
   const effectivePlaceholder = placeholder !== undefined ? placeholder : defaultsConfig.placeholder !== false ? defaultsConfig.placeholder : undefined;
   const fadeIn = defaultsConfig.fadeIn;
   const fadeInDuration = defaultsConfig.fadeInDuration;
-  const [svg, setSvg] = (0, _react.useState)(null);
-  const [state, setState] = (0, _react.useState)('idle');
-  const [showFallback, setShowFallback] = (0, _react.useState)(false);
-  const [wasCacheHit, setWasCacheHit] = (0, _react.useState)(false);
+
+  // State machine
+  const [state, dispatch] = (0, _react.useReducer)(iconReducer, initialState);
+
+  // Refs for callback stability (these never invalidate loadIcon)
   const mountedRef = (0, _react.useRef)(true);
-  const fallbackTimerRef = (0, _react.useRef)(null);
   const abortControllerRef = (0, _react.useRef)(null);
-  const isLoadingRef = (0, _react.useRef)(false);
+  const fallbackTimerRef = (0, _react.useRef)(null);
+  const onLoadRef = (0, _react.useRef)(onLoad);
+  const onErrorRef = (0, _react.useRef)(onError);
+  const fallbackRef = (0, _react.useRef)(fallback);
+  const effectivePlaceholderRef = (0, _react.useRef)(effectivePlaceholder);
+
+  // Keep refs up to date
+  onLoadRef.current = onLoad;
+  onErrorRef.current = onError;
+  fallbackRef.current = fallback;
+  effectivePlaceholderRef.current = effectivePlaceholder;
 
   // Fade-in animation value
   const fadeAnim = (0, _react.useRef)(new _reactNative.Animated.Value(0)).current;
@@ -80,12 +192,22 @@ function IconRenderer({
   const iconWidth = propWidth ?? size;
   const iconHeight = propHeight ?? size;
 
-  // Animation hook
+  // Auto hitSlop for accessibility (44dp minimum touch target)
+  const hitSlop = (0, _react.useMemo)(() => Math.max(0, (MIN_TOUCH_TARGET - Math.min(iconWidth, iconHeight)) / 2), [iconWidth, iconHeight]);
+
+  // Accessibility context (optional — works without AccessibilityProvider)
+  const a11y = (0, _AccessibilityProvider.useAccessibility)();
+  const reduceMotion = a11y?.shouldDisableAnimations() ?? false;
+
+  // Auto-generate accessibility label from icon name when not provided
+  const resolvedA11yLabel = accessibilityLabel ?? a11y?.getLabel(iconName);
+
+  // Animation hook — disabled when user prefers reduced motion
   const {
     animatedStyle,
     hasAnimation
   } = (0, _useIconAnimation.useIconAnimation)({
-    animation: animate,
+    animation: reduceMotion ? undefined : animate,
     duration: animationDuration,
     loop: animationLoop,
     easing: animationEasing,
@@ -94,8 +216,11 @@ function IconRenderer({
     onComplete: onAnimationComplete
   });
 
-  // Load icon
-  const loadIcon = (0, _react.useCallback)(async () => {
+  // ------------------------------------------------------------------
+  // loadIcon — deps are only [iconName, fadeIn, fadeInDuration, fadeAnim]
+  // Callbacks and fallback are read from refs → never invalidate this
+  // ------------------------------------------------------------------
+  const loadIcon = (0, _react.useCallback)(() => {
     if (!iconName) return;
 
     // Cancel any previous request
@@ -104,80 +229,92 @@ function IconRenderer({
     }
     abortControllerRef.current = new AbortController();
 
+    // Clear previous fallback timer
+    if (fallbackTimerRef.current) {
+      clearTimeout(fallbackTimerRef.current);
+      fallbackTimerRef.current = null;
+    }
+
     // 1. Check cache first (synchronous)
     const cached = _CacheManager.CacheManager.get(iconName);
     if (cached) {
-      if (mountedRef.current) {
-        setSvg(cached);
-        setState('loaded');
-        setWasCacheHit(true);
-        isLoadingRef.current = false;
-        fadeAnim.setValue(1); // No fade for cache hits
-        onLoad?.();
-      }
+      dispatch({
+        type: 'CACHE_HIT',
+        svg: cached
+      });
+      fadeAnim.setValue(1); // No fade for cache hits
+      onLoadRef.current?.();
       return;
     }
 
-    // 2. Set loading state and start fallback timer
-    setState('loading');
-    isLoadingRef.current = true;
-    setWasCacheHit(false);
+    // 2. Set loading state
+    dispatch({
+      type: 'FETCH_START'
+    });
+
+    // 3. Start fallback timer or show immediately
     if (fallbackDelay > 0) {
       fallbackTimerRef.current = setTimeout(() => {
-        if (mountedRef.current && isLoadingRef.current) {
-          setShowFallback(true);
+        if (mountedRef.current) {
+          dispatch({
+            type: 'SHOW_FALLBACK'
+          });
         }
       }, fallbackDelay);
-    } else if (fallback || effectivePlaceholder !== undefined) {
-      setShowFallback(true);
+    } else if (fallbackRef.current || effectivePlaceholderRef.current !== undefined) {
+      dispatch({
+        type: 'SHOW_FALLBACK'
+      });
     }
 
-    // 3. Fetch from network
-    try {
-      const fetchedSvg = await (0, _IconifyAPI.fetchIcon)(iconName, abortControllerRef.current.signal);
-      if (mountedRef.current) {
-        _CacheManager.CacheManager.set(iconName, fetchedSvg);
-        setSvg(fetchedSvg);
-        setState('loaded');
-        isLoadingRef.current = false;
-        setShowFallback(false);
-
-        // Fade-in for non-cached icons
-        if (fadeIn) {
-          fadeAnim.setValue(0);
-          _reactNative.Animated.timing(fadeAnim, {
-            toValue: 1,
-            duration: fadeInDuration,
-            useNativeDriver: true
-          }).start();
-        } else {
-          fadeAnim.setValue(1);
-        }
-        onLoad?.();
+    // 4. Fetch from network (async, fire-and-forget from useCallback's perspective)
+    const controller = abortControllerRef.current;
+    (0, _IconifyAPI.fetchIcon)(iconName, controller.signal).then(fetchedSvg => {
+      if (!mountedRef.current) return;
+      _CacheManager.CacheManager.set(iconName, fetchedSvg);
+      dispatch({
+        type: 'FETCH_SUCCESS',
+        svg: fetchedSvg
+      });
+
+      // Fade-in for non-cached icons
+      if (fadeIn) {
+        fadeAnim.setValue(0);
+        _reactNative.Animated.timing(fadeAnim, {
+          toValue: 1,
+          duration: fadeInDuration,
+          useNativeDriver: true
+        }).start();
+      } else {
+        fadeAnim.setValue(1);
       }
-    } catch (error) {
+      onLoadRef.current?.();
+    }).catch(error => {
       if (error instanceof Error && error.name === 'AbortError') {
         return;
       }
-      if (mountedRef.current) {
-        setState('error');
-        isLoadingRef.current = false;
-        onError?.(error instanceof Error ? error : new Error(String(error)));
-      }
-    }
-  }, [iconName, fallback, fallbackDelay, onLoad, onError, effectivePlaceholder, fadeIn, fadeInDuration, fadeAnim]);
+      if (!mountedRef.current) return;
+      const typedError = error instanceof _errors.IconLoadError ? error : error instanceof Error ? error : new _errors.IconLoadError('NETWORK', String(error));
+      dispatch({
+        type: 'FETCH_ERROR',
+        error: typedError
+      });
+      onErrorRef.current?.(typedError);
+    });
+  }, [iconName, fallbackDelay, fadeIn, fadeInDuration, fadeAnim]);
 
   // Effect to load icon
   (0, _react.useEffect)(() => {
     mountedRef.current = true;
+    dispatch({
+      type: 'RESET'
+    });
     loadIcon();
     return () => {
       mountedRef.current = false;
-      isLoadingRef.current = false;
       if (fallbackTimerRef.current) {
         clearTimeout(fallbackTimerRef.current);
       }
-      // Abort any in-flight requests on unmount
       if (abortControllerRef.current) {
         abortControllerRef.current.abort();
       }
@@ -205,58 +342,45 @@ function IconRenderer({
     return transforms.length > 0 ? transforms : undefined;
   }, [rotate, flip]);
 
-  // Memoize colorized SVG to avoid recalculating on every render
-  const colorizedSvg = (0, _react.useMemo)(() => {
-    if (!svg) return null;
-    const safeColor = escapeXmlAttribute(color);
-    return svg.replace(/currentColor/g, safeColor).replace(/<svg/, `<svg fill="${safeColor}"`);
-  }, [svg, color]);
-
-  // Determine if we should show placeholder/fallback
-  const shouldShowPlaceholder = state === 'loading' && showFallback || state === 'error';
-
-  // Whether to use fade-in wrapper (only for non-cached, non-animated icons)
-  const useFadeIn = fadeIn && !wasCacheHit && state === 'loaded' && !hasAnimation;
-
-  // Check if icon should be pressable
+  // Determine rendering flags
+  const shouldShowPlaceholder = state.status === 'loading' && state.showFallback || state.status === 'error';
+  const useFadeIn = fadeIn && !state.wasCacheHit && state.status === 'loaded' && !hasAnimation;
   const isPressable = !!(onPress || onLongPress);
 
-  // NativeWind className support - conditional spread to avoid TS errors
+  // NativeWind className support
   const nativeWindProps = className ? {
     className
   } : {};
 
-  /**
-   * Wraps content with Pressable if onPress/onLongPress is provided
-   */
-  const wrapWithPressable = content => {
+  // ------------------------------------------------------------------
+  // Helper: wrap content with PressableWrapper if interactive
+  // ------------------------------------------------------------------
+  const wrapContent = content => {
     if (!isPressable) return content;
-    return /*#__PURE__*/_react.default.createElement(_reactNative.Pressable, {
+    return /*#__PURE__*/_react.default.createElement(PressableWrapper, {
       onPress: onPress,
       onLongPress: onLongPress,
       onPressIn: onPressIn,
       onPressOut: onPressOut,
       disabled: disabled,
-      accessibilityRole: "button",
-      accessibilityState: {
-        disabled
-      },
-      style: ({
-        pressed
-      }) => [pressed && pressedStyle]
+      pressedStyle: pressedStyle,
+      hitSlop: hitSlop
     }, content);
   };
 
-  // Render placeholder or fallback during loading/error
+  // ------------------------------------------------------------------
+  // Render: placeholder / fallback during loading or error
+  // ------------------------------------------------------------------
   if (shouldShowPlaceholder) {
-    // Priority: effectivePlaceholder (includes config default) > fallback
     if (effectivePlaceholder !== undefined) {
-      return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+      return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+        ref: ref,
         style: [{
           width: iconWidth,
           height: iconHeight
         }, style],
-        accessibilityLabel: accessibilityLabel,
+        accessibilityLabel: resolvedA11yLabel,
+        accessibilityRole: "image",
         testID: testID
       }, nativeWindProps), /*#__PURE__*/_react.default.createElement(_placeholder.PlaceholderFactory, {
         type: effectivePlaceholder,
@@ -266,92 +390,100 @@ function IconRenderer({
         duration: placeholderDuration
       })));
     }
-
-    // Fallback for backwards compatibility (deprecated)
     if (fallback) {
-      return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+      return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+        ref: ref,
         style: [{
           width: iconWidth,
           height: iconHeight
         }, style],
-        accessibilityLabel: accessibilityLabel,
+        accessibilityLabel: resolvedA11yLabel,
+        accessibilityRole: "image",
         testID: testID
       }, nativeWindProps), fallback));
     }
-
-    // Return empty view if no placeholder/fallback
-    return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+    return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+      ref: ref,
       style: [{
         width: iconWidth,
         height: iconHeight
       }, style],
-      accessibilityLabel: accessibilityLabel,
+      accessibilityLabel: resolvedA11yLabel,
+      accessibilityRole: "image",
       testID: testID
     }, nativeWindProps)));
   }
 
-  // Render icon
-  if (colorizedSvg) {
-    // Render with animation wrapper if animation is enabled
+  // ------------------------------------------------------------------
+  // Render: loaded SVG
+  // Uses SvgXml's native `color` prop instead of regex replacement.
+  // This preserves multi-color icons (color only replaces currentColor).
+  // ------------------------------------------------------------------
+  if (state.svg) {
+    const svgElement = /*#__PURE__*/_react.default.createElement(_reactNativeSvg.SvgXml, {
+      xml: state.svg,
+      width: iconWidth,
+      height: iconHeight,
+      color: color
+    });
+
+    // With animation
     if (hasAnimation) {
-      return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.Animated.View, _extends({
+      return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.Animated.View, _extends({
+        ref: ref,
         style: [styles.container, {
           width: iconWidth,
           height: iconHeight,
           transform: transformStyle
         }, style, animatedStyle],
-        accessibilityLabel: accessibilityLabel,
+        accessibilityLabel: resolvedA11yLabel,
         accessibilityRole: "image",
         testID: testID
-      }, nativeWindProps), /*#__PURE__*/_react.default.createElement(_reactNativeSvg.SvgXml, {
-        xml: colorizedSvg,
-        width: iconWidth,
-        height: iconHeight
-      })));
+      }, nativeWindProps), svgElement));
     }
 
-    // Render without animation (with optional fade-in)
+    // With fade-in (non-cached network fetch)
     if (useFadeIn) {
-      return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.Animated.View, _extends({
+      return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.Animated.View, _extends({
+        ref: ref,
         style: [styles.container, {
           width: iconWidth,
           height: iconHeight,
           transform: transformStyle,
           opacity: fadeAnim
         }, style],
-        accessibilityLabel: accessibilityLabel,
+        accessibilityLabel: resolvedA11yLabel,
         accessibilityRole: "image",
         testID: testID
-      }, nativeWindProps), /*#__PURE__*/_react.default.createElement(_reactNativeSvg.SvgXml, {
-        xml: colorizedSvg,
-        width: iconWidth,
-        height: iconHeight
-      })));
+      }, nativeWindProps), svgElement));
     }
-    return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+
+    // Static render (cache hit or fade disabled)
+    return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+      ref: ref,
       style: [styles.container, {
         width: iconWidth,
         height: iconHeight,
         transform: transformStyle
       }, style],
-      accessibilityLabel: accessibilityLabel,
+      accessibilityLabel: resolvedA11yLabel,
       accessibilityRole: "image",
       testID: testID
-    }, nativeWindProps), /*#__PURE__*/_react.default.createElement(_reactNativeSvg.SvgXml, {
-      xml: colorizedSvg,
-      width: iconWidth,
-      height: iconHeight
-    })));
+    }, nativeWindProps), svgElement));
   }
 
-  // Show placeholder immediately if set (no delay), otherwise empty view
-  if (effectivePlaceholder !== undefined && state === 'loading') {
-    return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+  // ------------------------------------------------------------------
+  // Render: initial loading (before fallback delay)
+  // ------------------------------------------------------------------
+  if (effectivePlaceholder !== undefined && state.status === 'loading') {
+    return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+      ref: ref,
       style: [{
         width: iconWidth,
         height: iconHeight
       }, style],
-      accessibilityLabel: accessibilityLabel,
+      accessibilityLabel: resolvedA11yLabel,
+      accessibilityRole: "image",
       testID: testID
     }, nativeWindProps), /*#__PURE__*/_react.default.createElement(_placeholder.PlaceholderFactory, {
       type: effectivePlaceholder,
@@ -362,16 +494,18 @@ function IconRenderer({
     })));
   }
 
-  // Return empty view while loading (before fallback delay)
-  return wrapWithPressable(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+  // Empty view while loading
+  return wrapContent(/*#__PURE__*/_react.default.createElement(_reactNative.View, _extends({
+    ref: ref,
     style: [{
       width: iconWidth,
       height: iconHeight
     }, style],
-    accessibilityLabel: accessibilityLabel,
+    accessibilityLabel: resolvedA11yLabel,
+    accessibilityRole: "image",
     testID: testID
   }, nativeWindProps)));
-}
+}));
 const styles = _reactNative.StyleSheet.create({
   container: {
     alignItems: 'center',

package/lib/commonjs/accessibility/AccessibilityProvider.js

@@ -88,19 +88,18 @@ function AccessibilityProvider({
     };
   }, []);
 
-  // Listen for high contrast preference (iOS only, via bold text as proxy)
+  // Listen for inverted colors (best available system proxy for high contrast)
   (0, _react.useEffect)(() => {
     const checkHighContrast = async () => {
       try {
-        // Use bold text as a proxy for high contrast preference
-        const isBoldText = await _reactNative.AccessibilityInfo.isBoldTextEnabled();
-        setIsHighContrast(isBoldText);
+        const isInverted = await _reactNative.AccessibilityInfo.isInvertColorsEnabled();
+        setIsHighContrast(isInverted);
       } catch {
-        // Ignore errors on unsupported platforms
+        // Ignore errors on unsupported platforms (Android, old RN)
       }
     };
     checkHighContrast();
-    const subscription = _reactNative.AccessibilityInfo.addEventListener('boldTextChanged', setIsHighContrast);
+    const subscription = _reactNative.AccessibilityInfo.addEventListener('invertColorsChanged', setIsHighContrast);
     return () => {
       subscription?.remove();
     };