rn-iconify 1.0.0 → 2.0.0

package/lib/module/accessibility/utils.js

@@ -0,0 +1,221 @@
+/**
+ * Accessibility utility functions for rn-iconify
+ */
+
+/**
+ * Default label generator - converts icon names to readable labels
+ * Examples:
+ *   - "mdi:home" -> "home icon"
+ *   - "heroicons:user-circle" -> "user circle icon"
+ *   - "lucide:arrow-left" -> "arrow left icon"
+ */
+export function defaultLabelGenerator(iconName) {
+  // Extract icon name from prefix:name format
+  const parts = iconName.split(':');
+  const name = parts.length > 1 ? parts[1] : parts[0];
+
+  // Convert kebab-case and camelCase to readable text
+  const readable = name
+  // Insert space before capital letters (camelCase)
+  .replace(/([A-Z])/g, ' $1')
+  // Replace hyphens and underscores with spaces
+  .replace(/[-_]/g, ' ')
+  // Remove extra spaces
+  .replace(/\s+/g, ' ')
+  // Trim and lowercase
+  .trim().toLowerCase();
+  return `${readable} icon`;
+}
+
+/**
+ * Adjust color for high contrast mode
+ * Increases contrast by pushing colors toward black or white
+ */
+export function adjustForHighContrast(color) {
+  // Parse color
+  const rgb = parseColor(color);
+  if (!rgb) return color;
+
+  // Calculate luminance
+  const luminance = (0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b) / 255;
+
+  // Push toward black or white based on luminance
+  if (luminance > 0.5) {
+    // Light color - make it darker (black)
+    return '#000000';
+  } else {
+    // Dark color - make it lighter (white)
+    return '#FFFFFF';
+  }
+}
+
+/**
+ * Parse color string to RGB values
+ */
+function parseColor(color) {
+  // Handle hex colors
+  if (color.startsWith('#')) {
+    const hex = color.slice(1);
+    if (hex.length === 3) {
+      return {
+        r: parseInt(hex[0] + hex[0], 16),
+        g: parseInt(hex[1] + hex[1], 16),
+        b: parseInt(hex[2] + hex[2], 16)
+      };
+    }
+    if (hex.length === 6) {
+      return {
+        r: parseInt(hex.slice(0, 2), 16),
+        g: parseInt(hex.slice(2, 4), 16),
+        b: parseInt(hex.slice(4, 6), 16)
+      };
+    }
+  }
+
+  // Handle rgb/rgba colors
+  const rgbMatch = color.match(/rgba?\((\d+),\s*(\d+),\s*(\d+)/);
+  if (rgbMatch) {
+    return {
+      r: parseInt(rgbMatch[1], 10),
+      g: parseInt(rgbMatch[2], 10),
+      b: parseInt(rgbMatch[3], 10)
+    };
+  }
+
+  // Handle named colors (common ones)
+  const namedColors = {
+    black: {
+      r: 0,
+      g: 0,
+      b: 0
+    },
+    white: {
+      r: 255,
+      g: 255,
+      b: 255
+    },
+    red: {
+      r: 255,
+      g: 0,
+      b: 0
+    },
+    green: {
+      r: 0,
+      g: 128,
+      b: 0
+    },
+    blue: {
+      r: 0,
+      g: 0,
+      b: 255
+    },
+    yellow: {
+      r: 255,
+      g: 255,
+      b: 0
+    },
+    cyan: {
+      r: 0,
+      g: 255,
+      b: 255
+    },
+    magenta: {
+      r: 255,
+      g: 0,
+      b: 255
+    },
+    gray: {
+      r: 128,
+      g: 128,
+      b: 128
+    },
+    grey: {
+      r: 128,
+      g: 128,
+      b: 128
+    },
+    orange: {
+      r: 255,
+      g: 165,
+      b: 0
+    },
+    purple: {
+      r: 128,
+      g: 0,
+      b: 128
+    },
+    pink: {
+      r: 255,
+      g: 192,
+      b: 203
+    },
+    brown: {
+      r: 165,
+      g: 42,
+      b: 42
+    }
+  };
+  const lowerColor = color.toLowerCase();
+  if (namedColors[lowerColor]) {
+    return namedColors[lowerColor];
+  }
+  return null;
+}
+
+/**
+ * Check if a color meets WCAG contrast requirements against a background
+ */
+export function meetsContrastRequirement(foreground, background, level = 'AA') {
+  const fgRgb = parseColor(foreground);
+  const bgRgb = parseColor(background);
+  if (!fgRgb || !bgRgb) return true; // Assume it meets if we can't parse
+
+  const fgLuminance = getRelativeLuminance(fgRgb);
+  const bgLuminance = getRelativeLuminance(bgRgb);
+  const lighter = Math.max(fgLuminance, bgLuminance);
+  const darker = Math.min(fgLuminance, bgLuminance);
+  const contrastRatio = (lighter + 0.05) / (darker + 0.05);
+
+  // WCAG requirements for normal text
+  const requiredRatio = level === 'AAA' ? 7 : 4.5;
+  return contrastRatio >= requiredRatio;
+}
+
+/**
+ * Calculate relative luminance for WCAG calculations
+ */
+function getRelativeLuminance(rgb) {
+  const rsRGB = rgb.r / 255;
+  const gsRGB = rgb.g / 255;
+  const bsRGB = rgb.b / 255;
+  const r = rsRGB <= 0.03928 ? rsRGB / 12.92 : Math.pow((rsRGB + 0.055) / 1.055, 2.4);
+  const g = gsRGB <= 0.03928 ? gsRGB / 12.92 : Math.pow((gsRGB + 0.055) / 1.055, 2.4);
+  const b = bsRGB <= 0.03928 ? bsRGB / 12.92 : Math.pow((bsRGB + 0.055) / 1.055, 2.4);
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
+}
+
+/**
+ * Generate a high contrast alternative for a color
+ */
+export function getHighContrastAlternative(color, background = '#FFFFFF') {
+  const fgRgb = parseColor(color);
+  const bgRgb = parseColor(background);
+  if (!fgRgb || !bgRgb) return color;
+  const bgLuminance = getRelativeLuminance(bgRgb);
+
+  // If background is light, use black; if dark, use white
+  if (bgLuminance > 0.5) {
+    return '#000000';
+  } else {
+    return '#FFFFFF';
+  }
+}
+
+/**
+ * Calculate minimum touch target padding needed
+ */
+export function calculateTouchTargetPadding(iconSize, minTargetSize) {
+  if (iconSize >= minTargetSize) return 0;
+  return (minTargetSize - iconSize) / 2;
+}
+//# sourceMappingURL=utils.js.map

package/lib/module/accessibility/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defaultLabelGenerator","iconName","parts","split","name","length","readable","replace","trim","toLowerCase","adjustForHighContrast","color","rgb","parseColor","luminance","r","g","b","startsWith","hex","slice","parseInt","rgbMatch","match","namedColors","black","white","red","green","blue","yellow","cyan","magenta","gray","grey","orange","purple","pink","brown","lowerColor","meetsContrastRequirement","foreground","background","level","fgRgb","bgRgb","fgLuminance","getRelativeLuminance","bgLuminance","lighter","Math","max","darker","min","contrastRatio","requiredRatio","rsRGB","gsRGB","bsRGB","pow","getHighContrastAlternative","calculateTouchTargetPadding","iconSize","minTargetSize"],"sourceRoot":"../../../src","sources":["accessibility/utils.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/alias/Icon.js

@@ -0,0 +1,105 @@
+/**
+ * Generic Icon Component
+ * Renders any icon by full name (prefix:name) or alias
+ */
+
+import React from 'react';
+import { IconRenderer } from '../IconRenderer';
+import { useIconTheme } from '../theme';
+import { DEFAULT_ICON_THEME } from '../theme/types';
+import { useIconAliasContext } from './IconAliasContext';
+/**
+ * Generic Icon component that accepts any icon name or alias
+ *
+ * @example With full icon name
+ * ```tsx
+ * import { Icon } from 'rn-iconify';
+ *
+ * <Icon name="mdi:home" size={24} color="blue" />
+ * <Icon name="heroicons:user" size={24} />
+ * ```
+ *
+ * @example With aliases (requires IconAliasProvider)
+ * ```tsx
+ * import { Icon, IconAliasProvider } from 'rn-iconify';
+ *
+ * const aliases = {
+ *   back: 'mdi:arrow-left',
+ *   menu: 'heroicons:bars-3',
+ * };
+ *
+ * <IconAliasProvider aliases={aliases}>
+ *   <Icon name="back" size={24} />
+ *   <Icon name="menu" size={24} />
+ * </IconAliasProvider>
+ * ```
+ */
+export function Icon({
+  name,
+  size,
+  color,
+  width,
+  height,
+  style,
+  rotate,
+  flip,
+  fallback,
+  fallbackDelay,
+  placeholder,
+  placeholderColor,
+  placeholderDuration,
+  onLoad,
+  onError,
+  accessibilityLabel,
+  testID
+}) {
+  // Get theme defaults
+  const {
+    theme
+  } = useIconTheme();
+
+  // Get alias context
+  const {
+    resolveIcon
+  } = useIconAliasContext();
+
+  // Resolve the icon name (alias → full name)
+  const resolvedName = resolveIcon(name);
+
+  // Merge props with theme defaults (props take precedence)
+  const mergedSize = size ?? theme.size ?? DEFAULT_ICON_THEME.size;
+  const mergedColor = color ?? theme.color ?? DEFAULT_ICON_THEME.color;
+  const mergedRotate = rotate ?? theme.rotate ?? DEFAULT_ICON_THEME.rotate;
+  const mergedFlip = flip ?? theme.flip;
+  const mergedFallbackDelay = fallbackDelay ?? theme.fallbackDelay ?? DEFAULT_ICON_THEME.fallbackDelay;
+  const mergedPlaceholder = placeholder ?? theme.placeholder;
+  const mergedPlaceholderColor = placeholderColor ?? theme.placeholderColor ?? DEFAULT_ICON_THEME.placeholderColor;
+  const mergedPlaceholderDuration = placeholderDuration ?? theme.placeholderDuration ?? DEFAULT_ICON_THEME.placeholderDuration;
+
+  // Validate icon name format in development
+  if (__DEV__ && !resolvedName.includes(':')) {
+    console.warn(`[rn-iconify] Icon name "${name}" is not a valid icon name or registered alias. ` + `Expected format: "prefix:name" (e.g., "mdi:home") or a registered alias.`);
+  }
+  return /*#__PURE__*/React.createElement(IconRenderer, {
+    iconName: resolvedName,
+    size: mergedSize,
+    color: mergedColor,
+    width: width,
+    height: height,
+    style: style,
+    rotate: mergedRotate,
+    flip: mergedFlip,
+    fallback: fallback,
+    fallbackDelay: mergedFallbackDelay,
+    placeholder: mergedPlaceholder,
+    placeholderColor: mergedPlaceholderColor,
+    placeholderDuration: mergedPlaceholderDuration,
+    onLoad: onLoad,
+    onError: onError,
+    accessibilityLabel: accessibilityLabel ?? name,
+    testID: testID
+  });
+}
+Icon.displayName = 'Icon';
+export default Icon;
+//# sourceMappingURL=Icon.js.map

package/lib/module/alias/Icon.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","IconRenderer","useIconTheme","DEFAULT_ICON_THEME","useIconAliasContext","Icon","name","size","color","width","height","style","rotate","flip","fallback","fallbackDelay","placeholder","placeholderColor","placeholderDuration","onLoad","onError","accessibilityLabel","testID","theme","resolveIcon","resolvedName","mergedSize","mergedColor","mergedRotate","mergedFlip","mergedFallbackDelay","mergedPlaceholder","mergedPlaceholderColor","mergedPlaceholderDuration","__DEV__","includes","console","warn","createElement","iconName","displayName"],"sourceRoot":"../../../src","sources":["alias/Icon.tsx"],"mappings":"AAAA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,YAAY,QAAQ,iBAAiB;AAC9C,SAASC,YAAY,QAAQ,UAAU;AACvC,SAASC,kBAAkB,QAAQ,gBAAgB;AACnD,SAASC,mBAAmB,QAAQ,oBAAoB;AAGxD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,IAAIA,CAAC;EACnBC,IAAI;EACJC,IAAI;EACJC,KAAK;EACLC,KAAK;EACLC,MAAM;EACNC,KAAK;EACLC,MAAM;EACNC,IAAI;EACJC,QAAQ;EACRC,aAAa;EACbC,WAAW;EACXC,gBAAgB;EAChBC,mBAAmB;EACnBC,MAAM;EACNC,OAAO;EACPC,kBAAkB;EAClBC;AACgB,CAAC,EAAE;EACnB;EACA,MAAM;IAAEC;EAAM,CAAC,GAAGrB,YAAY,CAAC,CAAC;;EAEhC;EACA,MAAM;IAAEsB;EAAY,CAAC,GAAGpB,mBAAmB,CAAC,CAAC;;EAE7C;EACA,MAAMqB,YAAY,GAAGD,WAAW,CAAClB,IAAI,CAAC;;EAEtC;EACA,MAAMoB,UAAU,GAAGnB,IAAI,IAAIgB,KAAK,CAAChB,IAAI,IAAIJ,kBAAkB,CAACI,IAAI;EAChE,MAAMoB,WAAW,GAAGnB,KAAK,IAAIe,KAAK,CAACf,KAAK,IAAIL,kBAAkB,CAACK,KAAK;EACpE,MAAMoB,YAAY,GAAGhB,MAAM,IAAIW,KAAK,CAACX,MAAM,IAAIT,kBAAkB,CAACS,MAAM;EACxE,MAAMiB,UAAU,GAAGhB,IAAI,IAAIU,KAAK,CAACV,IAAI;EACrC,MAAMiB,mBAAmB,GACvBf,aAAa,IAAIQ,KAAK,CAACR,aAAa,IAAIZ,kBAAkB,CAACY,aAAa;EAC1E,MAAMgB,iBAAiB,GAAGf,WAAW,IAAIO,KAAK,CAACP,WAAW;EAC1D,MAAMgB,sBAAsB,GAC1Bf,gBAAgB,IAAIM,KAAK,CAACN,gBAAgB,IAAId,kBAAkB,CAACc,gBAAgB;EACnF,MAAMgB,yBAAyB,GAC7Bf,mBAAmB,IAAIK,KAAK,CAACL,mBAAmB,IAAIf,kBAAkB,CAACe,mBAAmB;;EAE5F;EACA,IAAIgB,OAAO,IAAI,CAACT,YAAY,CAACU,QAAQ,CAAC,GAAG,CAAC,EAAE;IAC1CC,OAAO,CAACC,IAAI,CACV,2BAA2B/B,IAAI,kDAAkD,GAC/E,0EACJ,CAAC;EACH;EAEA,oBACEN,KAAA,CAAAsC,aAAA,CAACrC,YAAY;IACXsC,QAAQ,EAAEd,YAAa;IACvBlB,IAAI,EAAEmB,UAAW;IACjBlB,KAAK,EAAEmB,WAAY;IACnBlB,KAAK,EAAEA,KAAM;IACbC,MAAM,EAAEA,MAAO;IACfC,KAAK,EAAEA,KAAM;IACbC,MAAM,EAAEgB,YAAa;IACrBf,IAAI,EAAEgB,UAAW;IACjBf,QAAQ,EAAEA,QAAS;IACnBC,aAAa,EAAEe,mBAAoB;IACnCd,WAAW,EAAEe,iBAAkB;IAC/Bd,gBAAgB,EAAEe,sBAAuB;IACzCd,mBAAmB,EAAEe,yBAA0B;IAC/Cd,MAAM,EAAEA,MAAO;IACfC,OAAO,EAAEA,OAAQ;IACjBC,kBAAkB,EAAEA,kBAAkB,IAAIf,IAAK;IAC/CgB,MAAM,EAAEA;EAAO,CAChB,CAAC;AAEN;AAEAjB,IAAI,CAACmC,WAAW,GAAG,MAAM;AAEzB,eAAenC,IAAI","ignoreList":[]}

package/lib/module/alias/IconAliasContext.js

@@ -0,0 +1,166 @@
+/**
+ * Icon Alias Context
+ * Provides alias resolution throughout the component tree
+ */
+
+import React, { createContext, useContext, useMemo, useCallback, useState } from 'react';
+/**
+ * Default context value (no aliases)
+ */
+const defaultContextValue = {
+  aliases: {},
+  resolveIcon: name => name,
+  isAlias: () => false,
+  registerAliases: () => {}
+};
+
+/**
+ * Icon Alias Context
+ */
+export const IconAliasContext = /*#__PURE__*/createContext(defaultContextValue);
+
+/**
+ * Hook to access icon alias context
+ *
+ * @example
+ * ```tsx
+ * const { resolveIcon, isAlias } = useIconAliasContext();
+ * const fullName = resolveIcon('back'); // 'mdi:arrow-left'
+ * ```
+ */
+export function useIconAliasContext() {
+  return useContext(IconAliasContext);
+}
+
+/**
+ * Hook to resolve an icon name (alias or full name)
+ *
+ * @example
+ * ```tsx
+ * const resolvedName = useResolveIcon('back'); // 'mdi:arrow-left'
+ * const resolvedName2 = useResolveIcon('mdi:home'); // 'mdi:home'
+ * ```
+ */
+export function useResolveIcon(name) {
+  const {
+    resolveIcon
+  } = useIconAliasContext();
+  return resolveIcon(name);
+}
+
+/**
+ * Check if a name is a full icon name (contains colon)
+ */
+function isFullIconName(name) {
+  return name.includes(':');
+}
+
+/**
+ * Validate icon name format
+ */
+function validateIconName(name, source) {
+  if (!name || typeof name !== 'string') {
+    console.warn(`[rn-iconify] Invalid icon name in ${source}: ${name}`);
+    return;
+  }
+  if (!isFullIconName(name)) {
+    console.warn(`[rn-iconify] Alias "${source}" should map to a full icon name (prefix:name format), got: "${name}"`);
+  }
+}
+
+/**
+ * Icon Alias Provider
+ * Provides alias resolution to all child components
+ *
+ * @example
+ * ```tsx
+ * const aliases = {
+ *   back: 'mdi:arrow-left',
+ *   menu: 'heroicons:bars-3',
+ * };
+ *
+ * <IconAliasProvider aliases={aliases}>
+ *   <App />
+ * </IconAliasProvider>
+ * ```
+ */
+export function IconAliasProvider({
+  aliases: initialAliases,
+  extend = true,
+  children
+}) {
+  const parentContext = useContext(IconAliasContext);
+  const [dynamicAliases, setDynamicAliases] = useState({});
+
+  // Merge aliases: parent (if extend) + initial + dynamic
+  const mergedAliases = useMemo(() => {
+    const base = extend ? {
+      ...parentContext.aliases
+    } : {};
+    return {
+      ...base,
+      ...initialAliases,
+      ...dynamicAliases
+    };
+  }, [parentContext.aliases, initialAliases, dynamicAliases, extend]);
+
+  // Validate aliases in development
+  if (__DEV__) {
+    Object.entries(initialAliases).forEach(([alias, iconName]) => {
+      validateIconName(iconName, alias);
+    });
+  }
+
+  // Resolve icon name
+  const resolveIcon = useCallback(name => {
+    // If it's already a full icon name, return as-is
+    if (isFullIconName(name)) {
+      return name;
+    }
+
+    // Look up in aliases
+    const resolved = mergedAliases[name];
+    if (resolved) {
+      return resolved;
+    }
+
+    // Not found - warn in dev and return original
+    if (__DEV__) {
+      console.warn(`[rn-iconify] Unknown icon alias "${name}". ` + `Use a full icon name (prefix:name) or register the alias.`);
+    }
+    return name;
+  }, [mergedAliases]);
+
+  // Check if name is a registered alias
+  const isAlias = useCallback(name => {
+    return name in mergedAliases;
+  }, [mergedAliases]);
+
+  // Register additional aliases at runtime
+  const registerAliases = useCallback(newAliases => {
+    if (__DEV__) {
+      Object.entries(newAliases).forEach(([alias, iconName]) => {
+        validateIconName(iconName, alias);
+      });
+    }
+    setDynamicAliases(prev => ({
+      ...prev,
+      ...newAliases
+    }));
+  }, []);
+  const contextValue = useMemo(() => ({
+    aliases: mergedAliases,
+    resolveIcon,
+    isAlias,
+    registerAliases
+  }), [mergedAliases, resolveIcon, isAlias, registerAliases]);
+  return /*#__PURE__*/React.createElement(IconAliasContext.Provider, {
+    value: contextValue
+  }, children);
+}
+
+/**
+ * Default export for convenience
+ */
+export default IconAliasProvider;
+//# sourceMappingURL=IconAliasContext.js.map

package/lib/module/alias/IconAliasContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useMemo","useCallback","useState","defaultContextValue","aliases","resolveIcon","name","isAlias","registerAliases","IconAliasContext","useIconAliasContext","useResolveIcon","isFullIconName","includes","validateIconName","source","console","warn","IconAliasProvider","initialAliases","extend","children","parentContext","dynamicAliases","setDynamicAliases","mergedAliases","base","__DEV__","Object","entries","forEach","alias","iconName","resolved","newAliases","prev","contextValue","createElement","Provider","value"],"sourceRoot":"../../../src","sources":["alias/IconAliasContext.tsx"],"mappings":"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","ignoreList":[]}