rn-iconify 1.0.0 → 2.0.0

package/src/cli/types.ts

@@ -0,0 +1,187 @@
+/**
+ * CLI Types
+ * Type definitions for CLI commands and configuration
+ */
+
+/**
+ * Bundle command options
+ */
+export interface BundleOptions {
+  /**
+   * Source directory to analyze for icon usage
+   * @default './src'
+   */
+  src?: string;
+
+  /**
+   * Output file path for the bundle
+   * @default './assets/icons.bundle.json'
+   */
+  output?: string;
+
+  /**
+   * Auto-detect icons from source code
+   * @default true
+   */
+  auto?: boolean;
+
+  /**
+   * Manual list of icons to include (comma-separated or array)
+   * @example 'mdi:home,mdi:settings' or ['mdi:home', 'mdi:settings']
+   */
+  icons?: string | string[];
+
+  /**
+   * Icon patterns to exclude
+   */
+  exclude?: string[];
+
+  /**
+   * Verbose output
+   * @default false
+   */
+  verbose?: boolean;
+
+  /**
+   * Pretty print JSON output
+   * @default false
+   */
+  pretty?: boolean;
+}
+
+/**
+ * Analyze command options
+ */
+export interface AnalyzeOptions {
+  /**
+   * Source directory to analyze
+   * @default './src'
+   */
+  src?: string;
+
+  /**
+   * Output format
+   * @default 'table'
+   */
+  format?: 'table' | 'json' | 'markdown';
+
+  /**
+   * Show detailed file locations
+   * @default false
+   */
+  detailed?: boolean;
+
+  /**
+   * Verbose output
+   * @default false
+   */
+  verbose?: boolean;
+}
+
+/**
+ * Icon usage information from code analysis
+ */
+export interface IconUsage {
+  /**
+   * Full icon name (prefix:name)
+   */
+  icon: string;
+
+  /**
+   * Number of times used
+   */
+  count: number;
+
+  /**
+   * File locations where icon is used
+   */
+  locations: Array<{
+    file: string;
+    line: number;
+    column: number;
+  }>;
+}
+
+/**
+ * Analysis result
+ */
+export interface AnalysisResult {
+  /**
+   * Total number of unique icons
+   */
+  totalIcons: number;
+
+  /**
+   * Total usage count
+   */
+  totalUsage: number;
+
+  /**
+   * Icons grouped by prefix (icon set)
+   */
+  byPrefix: Record<
+    string,
+    {
+      count: number;
+      icons: string[];
+    }
+  >;
+
+  /**
+   * Detailed usage for each icon
+   */
+  icons: IconUsage[];
+
+  /**
+   * Files analyzed
+   */
+  filesAnalyzed: number;
+
+  /**
+   * Analysis timestamp
+   */
+  timestamp: string;
+}
+
+/**
+ * Bundle file structure
+ */
+export interface IconBundle {
+  /**
+   * Bundle version
+   */
+  version: string;
+
+  /**
+   * Generation timestamp
+   */
+  generatedAt: string;
+
+  /**
+   * Icons in the bundle
+   */
+  icons: Record<
+    string,
+    {
+      svg: string;
+      width: number;
+      height: number;
+    }
+  >;
+
+  /**
+   * Total icon count
+   */
+  count: number;
+}
+
+/**
+ * CLI exit codes
+ */
+export const EXIT_CODES = {
+  SUCCESS: 0,
+  ERROR: 1,
+  INVALID_ARGS: 2,
+  FILE_NOT_FOUND: 3,
+  NETWORK_ERROR: 4,
+} as const;

package/src/components/index.ts

@@ -2,7 +2,7 @@
  * Icon Set Components
  * Auto-generated - do not edit manually
  *
- * 212 icon sets available
+ * 200+ icon sets available
  */
 
 export { Mdi, type MdiIconName } from './Mdi';
@@ -232,3 +232,54 @@ export { Wi, type WiIconName } from './Wi';
 export { Wpf, type WpfIconName } from './Wpf';
 export { Zmdi, type ZmdiIconName } from './Zmdi';
 export { Zondicons, type ZondiconsIconName } from './Zondicons';
+
+// Props type aliases for popular icon sets (convenience types)
+import type { IconProps } from '../types';
+import type { MdiIconName } from './Mdi';
+import type { HeroiconsIconName } from './Heroicons';
+import type { LucideIconName } from './Lucide';
+import type { PhIconName } from './Ph';
+import type { TablerIconName } from './Tabler';
+import type { FeatherIconName } from './Feather';
+import type { BiIconName } from './Bi';
+import type { Fa6SolidIconName } from './Fa6Solid';
+import type { Fa6RegularIconName } from './Fa6Regular';
+import type { Fa6BrandsIconName } from './Fa6Brands';
+import type { IonIconName } from './Ion';
+import type { RiIconName } from './Ri';
+
+/** Props for Mdi icon component */
+export type MdiProps = IconProps<MdiIconName>;
+
+/** Props for Heroicons icon component */
+export type HeroiconsProps = IconProps<HeroiconsIconName>;
+
+/** Props for Lucide icon component */
+export type LucideProps = IconProps<LucideIconName>;
+
+/** Props for Ph (Phosphor) icon component */
+export type PhProps = IconProps<PhIconName>;
+
+/** Props for Tabler icon component */
+export type TablerProps = IconProps<TablerIconName>;
+
+/** Props for Feather icon component */
+export type FeatherProps = IconProps<FeatherIconName>;
+
+/** Props for Bi (Bootstrap Icons) icon component */
+export type BiProps = IconProps<BiIconName>;
+
+/** Props for Fa6Solid icon component */
+export type Fa6SolidProps = IconProps<Fa6SolidIconName>;
+
+/** Props for Fa6Regular icon component */
+export type Fa6RegularProps = IconProps<Fa6RegularIconName>;
+
+/** Props for Fa6Brands icon component */
+export type Fa6BrandsProps = IconProps<Fa6BrandsIconName>;
+
+/** Props for Ion (Ionicons) icon component */
+export type IonProps = IconProps<IonIconName>;
+
+/** Props for Ri (Remix Icon) icon component */
+export type RiProps = IconProps<RiIconName>;

package/src/config/ConfigManager.ts

@@ -0,0 +1,196 @@
+/**
+ * ConfigManager - Global configuration manager for rn-iconify
+ * Handles API settings, cache configuration, and performance options
+ */
+
+import type {
+  IconifyConfig,
+  IconifyAPIConfig,
+  CacheConfig,
+  PerformanceConfig,
+  ResolvedConfig,
+} from './types';
+import { DEFAULT_CONFIG } from './types';
+
+/**
+ * Deep merge two objects
+ */
+function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>): T {
+  const result = { ...target };
+
+  for (const key in source) {
+    if (Object.prototype.hasOwnProperty.call(source, key)) {
+      const sourceValue = source[key];
+      const targetValue = result[key];
+
+      if (
+        sourceValue !== undefined &&
+        typeof sourceValue === 'object' &&
+        sourceValue !== null &&
+        !Array.isArray(sourceValue) &&
+        typeof targetValue === 'object' &&
+        targetValue !== null &&
+        !Array.isArray(targetValue)
+      ) {
+        result[key] = deepMerge(
+          targetValue as Record<string, unknown>,
+          sourceValue as Record<string, unknown>
+        ) as T[Extract<keyof T, string>];
+      } else if (sourceValue !== undefined) {
+        result[key] = sourceValue as T[Extract<keyof T, string>];
+      }
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Global configuration state
+ */
+let currentConfig: ResolvedConfig = { ...DEFAULT_CONFIG };
+let configChangeListeners: Array<(config: ResolvedConfig) => void> = [];
+
+/**
+ * ConfigManager class for managing rn-iconify configuration
+ */
+export const ConfigManager = {
+  /**
+   * Get the current configuration
+   */
+  getConfig(): ResolvedConfig {
+    return currentConfig;
+  },
+
+  /**
+   * Get API configuration
+   */
+  getAPIConfig(): Required<IconifyAPIConfig> {
+    return currentConfig.api;
+  },
+
+  /**
+   * Get cache configuration
+   */
+  getCacheConfig(): Required<CacheConfig> {
+    return currentConfig.cache;
+  },
+
+  /**
+   * Get performance configuration
+   */
+  getPerformanceConfig(): Required<PerformanceConfig> {
+    return currentConfig.performance;
+  },
+
+  /**
+   * Update configuration
+   * Merges with existing configuration
+   */
+  setConfig(config: IconifyConfig): void {
+    currentConfig = {
+      api: deepMerge(currentConfig.api, config.api ?? {}),
+      cache: deepMerge(currentConfig.cache, config.cache ?? {}),
+      performance: deepMerge(currentConfig.performance, config.performance ?? {}),
+    };
+
+    // Notify listeners
+    configChangeListeners.forEach((listener) => listener(currentConfig));
+  },
+
+  /**
+   * Reset configuration to defaults
+   */
+  resetConfig(): void {
+    currentConfig = { ...DEFAULT_CONFIG };
+    configChangeListeners.forEach((listener) => listener(currentConfig));
+  },
+
+  /**
+   * Subscribe to configuration changes
+   * Returns unsubscribe function
+   */
+  onConfigChange(listener: (config: ResolvedConfig) => void): () => void {
+    configChangeListeners.push(listener);
+    return () => {
+      configChangeListeners = configChangeListeners.filter((l) => l !== listener);
+    };
+  },
+
+  /**
+   * Check if using custom API server
+   */
+  isCustomServer(): boolean {
+    return currentConfig.api.apiUrl !== DEFAULT_CONFIG.api.apiUrl;
+  },
+
+  /**
+   * Get the API base URL
+   */
+  getAPIUrl(): string {
+    return currentConfig.api.apiUrl;
+  },
+};
+
+/**
+ * Configure rn-iconify globally
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { configure } from 'rn-iconify';
+ *
+ * configure({
+ *   api: {
+ *     apiUrl: 'https://icons.mycompany.com',
+ *     timeout: 10000,
+ *   },
+ * });
+ * ```
+ *
+ * @example With authentication
+ * ```tsx
+ * configure({
+ *   api: {
+ *     apiUrl: 'https://api.mycompany.com/icons',
+ *     headers: {
+ *       'Authorization': 'Bearer your-token',
+ *       'X-API-Key': 'your-api-key',
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * @example Self-hosted Iconify server
+ * ```tsx
+ * configure({
+ *   api: {
+ *     // Self-hosted Iconify API
+ *     apiUrl: 'https://iconify.mycompany.com',
+ *     timeout: 5000,
+ *     retries: 3,
+ *   },
+ *   performance: {
+ *     enabled: true,
+ *   },
+ * });
+ * ```
+ */
+export function configure(config: IconifyConfig): void {
+  ConfigManager.setConfig(config);
+}
+
+/**
+ * Reset configuration to defaults
+ */
+export function resetConfiguration(): void {
+  ConfigManager.resetConfig();
+}
+
+/**
+ * Get current configuration
+ */
+export function getConfiguration(): ResolvedConfig {
+  return ConfigManager.getConfig();
+}
+
+export default ConfigManager;

package/src/config/index.ts

@@ -0,0 +1,34 @@
+/**
+ * Configuration Module
+ * Provides global configuration for rn-iconify
+ *
+ * @example
+ * ```tsx
+ * import { configure } from 'rn-iconify';
+ *
+ * // Configure custom API server
+ * configure({
+ *   api: {
+ *     apiUrl: 'https://icons.mycompany.com',
+ *     headers: { 'Authorization': 'Bearer token' },
+ *   },
+ * });
+ * ```
+ */
+
+// Types
+export type {
+  IconifyConfig,
+  IconifyAPIConfig,
+  CacheConfig,
+  PerformanceConfig,
+  ResolvedConfig,
+} from './types';
+
+export { DEFAULT_CONFIG } from './types';
+
+// ConfigManager
+export { ConfigManager, configure, resetConfiguration, getConfiguration } from './ConfigManager';
+
+// Default export
+export { configure as default } from './ConfigManager';

package/src/config/types.ts

@@ -0,0 +1,149 @@
+/**
+ * Configuration types for rn-iconify
+ */
+
+/**
+ * API configuration options
+ */
+export interface IconifyAPIConfig {
+  /**
+   * Base URL for the Iconify API
+   * @default 'https://api.iconify.design'
+   */
+  apiUrl?: string;
+
+  /**
+   * Request timeout in milliseconds
+   * @default 30000
+   */
+  timeout?: number;
+
+  /**
+   * Number of retry attempts on failure
+   * @default 2
+   */
+  retries?: number;
+
+  /**
+   * Delay between retries in milliseconds
+   * @default 1000
+   */
+  retryDelay?: number;
+
+  /**
+   * Custom headers to include in API requests
+   */
+  headers?: Record<string, string>;
+
+  /**
+   * Enable/disable request logging
+   * @default false
+   */
+  logging?: boolean;
+}
+
+/**
+ * Cache configuration options
+ */
+export interface CacheConfig {
+  /**
+   * Maximum number of icons in memory cache
+   * @default 500
+   */
+  maxMemoryItems?: number;
+
+  /**
+   * Enable/disable disk cache (MMKV)
+   * @default true
+   */
+  enableDiskCache?: boolean;
+
+  /**
+   * Disk cache key prefix
+   * @default 'rn-iconify:'
+   */
+  diskCachePrefix?: string;
+}
+
+/**
+ * Performance monitoring configuration
+ */
+export interface PerformanceConfig {
+  /**
+   * Enable performance monitoring
+   * @default false
+   */
+  enabled?: boolean;
+
+  /**
+   * Track individual icon load times
+   * @default true
+   */
+  trackLoadTimes?: boolean;
+
+  /**
+   * Track cache hit/miss rates
+   * @default true
+   */
+  trackCacheStats?: boolean;
+
+  /**
+   * Maximum number of entries to keep in history
+   * @default 1000
+   */
+  maxHistorySize?: number;
+}
+
+/**
+ * Complete configuration object
+ */
+export interface IconifyConfig {
+  /**
+   * API configuration
+   */
+  api?: IconifyAPIConfig;
+
+  /**
+   * Cache configuration
+   */
+  cache?: CacheConfig;
+
+  /**
+   * Performance monitoring configuration
+   */
+  performance?: PerformanceConfig;
+}
+
+/**
+ * Resolved configuration with all defaults applied
+ */
+export interface ResolvedConfig {
+  api: Required<IconifyAPIConfig>;
+  cache: Required<CacheConfig>;
+  performance: Required<PerformanceConfig>;
+}
+
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG: ResolvedConfig = {
+  api: {
+    apiUrl: 'https://api.iconify.design',
+    timeout: 30000,
+    retries: 2,
+    retryDelay: 1000,
+    headers: {},
+    logging: false,
+  },
+  cache: {
+    maxMemoryItems: 500,
+    enableDiskCache: true,
+    diskCachePrefix: 'rn-iconify:',
+  },
+  performance: {
+    enabled: false,
+    trackLoadTimes: true,
+    trackCacheStats: true,
+    maxHistorySize: 1000,
+  },
+};

package/src/createIconSet.tsx

@@ -4,6 +4,8 @@
 
 import React from 'react';
 import { IconRenderer } from './IconRenderer';
+import { useIconTheme } from './theme';
+import { DEFAULT_ICON_THEME } from './theme/types';
 import type { IconProps } from './types';
 
 /**
@@ -54,20 +56,47 @@ export function createIconSet<T extends string>(
    */
   function IconComponent({
     name,
-    size = 24,
-    color = '#000000',
+    size,
+    color,
     width,
     height,
     style,
-    rotate = 0,
+    rotate,
     flip,
     fallback,
-    fallbackDelay = 0,
+    fallbackDelay,
+    placeholder,
+    placeholderColor,
+    placeholderDuration,
     onLoad,
     onError,
     accessibilityLabel,
     testID,
+    // Animation props
+    animate,
+    animationDuration,
+    animationLoop,
+    animationEasing,
+    animationDelay,
+    autoPlay,
+    onAnimationComplete,
   }: IconProps<T>) {
+    // Get theme defaults
+    const { theme } = useIconTheme();
+
+    // 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;
+
     // Runtime validation for icon name
     if (__DEV__ && !(name in iconNames)) {
       console.warn(
@@ -83,19 +112,29 @@ export function createIconSet<T extends string>(
     return (
       <IconRenderer
         iconName={iconName}
-        size={size}
-        color={color}
+        size={mergedSize}
+        color={mergedColor}
         width={width}
         height={height}
         style={style}
-        rotate={rotate}
-        flip={flip}
+        rotate={mergedRotate}
+        flip={mergedFlip}
         fallback={fallback}
-        fallbackDelay={fallbackDelay}
+        fallbackDelay={mergedFallbackDelay}
+        placeholder={mergedPlaceholder}
+        placeholderColor={mergedPlaceholderColor}
+        placeholderDuration={mergedPlaceholderDuration}
         onLoad={onLoad}
         onError={onError}
         accessibilityLabel={accessibilityLabel ?? name}
         testID={testID}
+        animate={animate}
+        animationDuration={animationDuration}
+        animationLoop={animationLoop}
+        animationEasing={animationEasing}
+        animationDelay={animationDelay}
+        autoPlay={autoPlay}
+        onAnimationComplete={onAnimationComplete}
       />
     );
   }