rn-iconify 1.0.0 → 2.0.0

package/lib/typescript/babel/ast-utils.d.ts

@@ -0,0 +1,52 @@
+/**
+ * AST Utilities
+ * Helper functions for working with Babel AST nodes
+ */
+import type * as BabelTypes from '@babel/types';
+import type { NodePath } from '@babel/core';
+/**
+ * Get the component name from a JSX opening element
+ * Handles: <Mdi />, <Heroicons />, etc.
+ */
+export declare function getComponentName(node: BabelTypes.JSXOpeningElement, t: typeof BabelTypes): string | null;
+/**
+ * Get the value of the 'name' attribute from a JSX element
+ * Handles: name="home", name='home'
+ * Returns null for dynamic values: name={iconName}
+ */
+export declare function getNameAttribute(node: BabelTypes.JSXOpeningElement, t: typeof BabelTypes): string | null;
+/**
+ * Check if a call expression is calling a specific function by name
+ * Handles: prefetchIcons([...])
+ */
+export declare function isCallTo(path: NodePath<BabelTypes.CallExpression>, functionName: string, t: typeof BabelTypes): boolean;
+/**
+ * Extract string values from an array expression
+ * Handles: ['mdi:home', 'mdi:settings']
+ * Skips dynamic values
+ */
+export declare function extractArrayStrings(node: BabelTypes.Node | null | undefined, t: typeof BabelTypes): string[];
+/**
+ * Get location info from a node
+ */
+export declare function getNodeLocation(node: BabelTypes.Node): {
+    line: number;
+    column: number;
+};
+/**
+ * Check if an icon name matches a pattern (supports wildcards)
+ * @example matchesPattern('mdi:home', 'mdi:*') => true
+ * @example matchesPattern('mdi:home', 'mdi:home') => true
+ * @example matchesPattern('mdi:home', 'heroicons:*') => false
+ */
+export declare function matchesPattern(iconName: string, pattern: string): boolean;
+/**
+ * Check if an icon should be included based on include/exclude patterns
+ */
+export declare function shouldIncludeIcon(iconName: string, include?: string[], exclude?: string[]): boolean;
+/**
+ * Validate icon name format
+ * Valid format: prefix:name (e.g., mdi:home)
+ */
+export declare function isValidIconName(name: string): boolean;
+//# sourceMappingURL=ast-utils.d.ts.map

package/lib/typescript/babel/ast-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-utils.d.ts","sourceRoot":"","sources":["../../../src/babel/ast-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,KAAK,UAAU,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,CAAC,iBAAiB,EAClC,CAAC,EAAE,OAAO,UAAU,GACnB,MAAM,GAAG,IAAI,CAcf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,CAAC,iBAAiB,EAClC,CAAC,EAAE,OAAO,UAAU,GACnB,MAAM,GAAG,IAAI,CAuCf;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC,EACzC,YAAY,EAAE,MAAM,EACpB,CAAC,EAAE,OAAO,UAAU,GACnB,OAAO,CAUT;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,CAAC,IAAI,GAAG,IAAI,GAAG,SAAS,EACxC,CAAC,EAAE,OAAO,UAAU,GACnB,MAAM,EAAE,CAyBV;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKvF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAmBzE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAoBrD"}

package/lib/typescript/babel/cache-writer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Cache Writer
+ * Fetches collected icons from Iconify API and writes them to a cache file
+ * Runs in Node.js environment during build time
+ */
+import type { IconBundle, BabelPluginOptions } from './types';
+/**
+ * Iconify API response structure
+ */
+interface IconifyAPIResponse {
+    prefix: string;
+    icons: Record<string, {
+        body: string;
+        width?: number;
+        height?: number;
+        left?: number;
+        top?: number;
+        hFlip?: boolean;
+        vFlip?: boolean;
+        rotate?: number;
+    }>;
+    width?: number;
+    height?: number;
+}
+/**
+ * Build SVG string from Iconify icon data
+ * @internal Exported for testing
+ */
+export declare function buildSvg(data: IconifyAPIResponse['icons'][string], defaultWidth?: number, defaultHeight?: number): {
+    svg: string;
+    width: number;
+    height: number;
+};
+/**
+ * Group icons by prefix
+ * @internal Exported for testing
+ */
+export declare function groupIconsByPrefix(iconNames: string[]): Map<string, string[]>;
+/**
+ * Fetch all icons and create bundle
+ */
+export declare function fetchAndCreateBundle(iconNames: string[], options: BabelPluginOptions): Promise<IconBundle>;
+/**
+ * Write bundle to file
+ */
+export declare function writeBundleToFile(bundle: IconBundle, outputPath: string, verbose: boolean): void;
+/**
+ * Generate icon bundle from collected icons
+ */
+export declare function generateBundle(iconNames: string[], options: BabelPluginOptions, projectRoot: string): Promise<void>;
+/**
+ * Check if bundle file exists and is valid
+ */
+export declare function isBundleValid(outputPath: string, projectRoot: string): boolean;
+export {};
+//# sourceMappingURL=cache-writer.d.ts.map

package/lib/typescript/babel/cache-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-writer.d.ts","sourceRoot":"","sources":["../../../src/babel/cache-writer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAW9D;;GAEG;AACH,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CACX,MAAM,EACN;QACE,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CACF,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoBD;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EACzC,YAAY,SAAK,EACjB,aAAa,SAAK,GACjB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgChD;AAmED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAc7E;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAwCrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAehG;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE,kBAAkB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAwCf;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAgB9E"}

package/lib/typescript/babel/collector.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Icon Collector
+ * Singleton that collects icons across all files during the build process
+ */
+import type { CollectedIcon, BabelPluginOptions } from './types';
+/**
+ * Icon collection state
+ * Uses a singleton pattern since Babel plugin runs in a single process
+ */
+declare class IconCollector {
+    /**
+     * Map of icon name -> collection info
+     * Using Map to track first occurrence location
+     */
+    private icons;
+    /**
+     * Set of processed files to track progress
+     */
+    private processedFiles;
+    /**
+     * Options from plugin configuration
+     */
+    private options;
+    /**
+     * Whether bundle generation has been triggered
+     */
+    private bundleGenerated;
+    /**
+     * Start time for performance tracking
+     */
+    private startTime;
+    /**
+     * Initialize the collector with options
+     * Called at the start of each build
+     */
+    initialize(options: BabelPluginOptions): void;
+    /**
+     * Reset collector state
+     * Should be called at the start of each build
+     */
+    reset(): void;
+    /**
+     * Add an icon to the collection
+     */
+    add(iconName: string, file: string, line: number, column: number): boolean;
+    /**
+     * Mark a file as processed
+     */
+    markFileProcessed(filename: string): void;
+    /**
+     * Check if a file has been processed
+     */
+    isFileProcessed(filename: string): boolean;
+    /**
+     * Check if there are any collected icons
+     */
+    hasIcons(): boolean;
+    /**
+     * Get all collected icon names
+     */
+    getIconNames(): string[];
+    /**
+     * Get all collected icons with their metadata
+     */
+    getAllIcons(): CollectedIcon[];
+    /**
+     * Get icon count
+     */
+    getCount(): number;
+    /**
+     * Get processed file count
+     */
+    getProcessedFileCount(): number;
+    /**
+     * Get icons grouped by prefix
+     */
+    getIconsByPrefix(): Map<string, string[]>;
+    /**
+     * Mark bundle as generated
+     */
+    markBundleGenerated(): void;
+    /**
+     * Check if bundle has been generated
+     */
+    isBundleGenerated(): boolean;
+    /**
+     * Get elapsed time since initialization
+     */
+    getElapsedTime(): number;
+    /**
+     * Get current options
+     */
+    getOptions(): BabelPluginOptions;
+    /**
+     * Print summary (for verbose mode)
+     */
+    printSummary(): void;
+}
+/**
+ * Singleton instance
+ */
+export declare const collector: IconCollector;
+/**
+ * Export class for testing
+ */
+export { IconCollector };
+//# sourceMappingURL=collector.d.ts.map

package/lib/typescript/babel/collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/babel/collector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGjE;;;GAGG;AACH,cAAM,aAAa;IACjB;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAyC;IAEtD;;OAEG;IACH,OAAO,CAAC,cAAc,CAA0B;IAEhD;;OAEG;IACH,OAAO,CAAC,OAAO,CAA0B;IAEzC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAkB;IAEzC;;OAEG;IACH,OAAO,CAAC,SAAS,CAAa;IAE9B;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;IAS7C;;;OAGG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAoC1E;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;OAEG;IACH,WAAW,IAAI,aAAa,EAAE;IAI9B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,qBAAqB,IAAI,MAAM;IAI/B;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAczC;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;OAEG;IACH,iBAAiB,IAAI,OAAO;IAI5B;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,UAAU,IAAI,kBAAkB;IAIhC;;OAEG;IACH,YAAY,IAAI,IAAI;CAcrB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,eAAsB,CAAC;AAE7C;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/lib/typescript/babel/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * rn-iconify Babel Plugin
+ *
+ * Build-time icon bundling for 0ms first render.
+ *
+ * @example
+ * ```js
+ * // babel.config.js
+ * module.exports = {
+ *   presets: ['module:@react-native/babel-preset'],
+ *   plugins: ['rn-iconify/babel'],
+ * };
+ * ```
+ *
+ * @example With options
+ * ```js
+ * // babel.config.js
+ * module.exports = {
+ *   presets: ['module:@react-native/babel-preset'],
+ *   plugins: [
+ *     ['rn-iconify/babel', {
+ *       include: ['mdi:*', 'heroicons:*'],
+ *       exclude: ['mdi:test-*'],
+ *       outputPath: '.rn-iconify-cache',
+ *       verbose: true,
+ *     }]
+ *   ],
+ * };
+ * ```
+ */
+import { createRnIconifyPlugin, resetPluginState } from './plugin';
+import type { BabelPluginOptions } from './types';
+export type { BabelPluginOptions };
+export type { CollectedIcon, IconBundle, BabelPluginState } from './types';
+export { collector } from './collector';
+export { resetPluginState };
+export { COMPONENT_PREFIX_MAP, PREFIX_COMPONENT_MAP, VALID_COMPONENTS, VALID_PREFIXES, getFilenameFromState, getFilenameFromFile, } from './types';
+/**
+ * Default export for Babel plugin
+ * This is what Babel will import when you add 'rn-iconify/babel' to your config
+ */
+export default createRnIconifyPlugin;
+/**
+ * Named export for explicit importing
+ */
+export { createRnIconifyPlugin };
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/babel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/babel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACnC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAG3E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AAEjB;;;GAGG;AACH,eAAe,qBAAqB,CAAC;AAErC;;GAEG;AACH,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/lib/typescript/babel/plugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Babel Plugin Visitor
+ * Main visitor logic for the rn-iconify Babel plugin
+ */
+import type { PluginObj, types as BabelTypes } from '@babel/core';
+import type { BabelPluginState } from './types';
+/**
+ * Create the rn-iconify Babel plugin
+ */
+export declare function createRnIconifyPlugin(babel: {
+    types: typeof BabelTypes;
+}): PluginObj<BabelPluginState>;
+/**
+ * Reset plugin state (for testing)
+ */
+export declare function resetPluginState(): void;
+//# sourceMappingURL=plugin.d.ts.map

package/lib/typescript/babel/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/babel/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,SAAS,CAAC;AA2DpE;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,KAAK,EAAE,OAAO,UAAU,CAAC;CAC1B,GAAG,SAAS,CAAC,gBAAgB,CAAC,CA0K9B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAQvC"}

package/lib/typescript/babel/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Babel Plugin Types
+ * Type definitions for the rn-iconify Babel plugin
+ */
+import type { NodePath } from '@babel/core';
+import type { JSXOpeningElement, CallExpression } from '@babel/types';
+/**
+ * Plugin options that can be passed in babel.config.js
+ */
+export interface BabelPluginOptions {
+    /**
+     * Patterns for icons to include (supports wildcards)
+     * @example ['mdi:*', 'heroicons:user']
+     */
+    include?: string[];
+    /**
+     * Patterns for icons to exclude
+     * @example ['mdi:test-*']
+     */
+    exclude?: string[];
+    /**
+     * Output directory for the generated cache
+     * @default '.rn-iconify-cache'
+     */
+    outputPath?: string;
+    /**
+     * Enable verbose logging during build
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Disable the plugin (useful for debugging)
+     * @default false
+     */
+    disabled?: boolean;
+}
+/**
+ * Babel file object structure (for pre/post hooks)
+ */
+export interface BabelFile {
+    opts: {
+        filename?: string;
+        root?: string;
+    };
+}
+/**
+ * Plugin state passed between visitors
+ * Matches Babel's internal state structure
+ * Note: filename and file may not always be present depending on Babel version/config
+ */
+export interface BabelPluginState {
+    opts: BabelPluginOptions;
+    filename?: string;
+    file?: BabelFile;
+}
+/**
+ * Helper to safely extract filename from visitor state
+ */
+export declare function getFilenameFromState(state: BabelPluginState): string;
+/**
+ * Helper to safely extract filename from any object (pre/post hooks or visitor state)
+ * Uses type guards to safely access nested properties
+ */
+export declare function getFilename(obj: unknown): string;
+/**
+ * Alias for getFilename - used in pre/post hooks where file object is passed
+ * This is a more descriptive name for when working with BabelFile objects
+ */
+export declare function getFilenameFromFile(file: unknown): string;
+/**
+ * Collected icon information
+ */
+export interface CollectedIcon {
+    /**
+     * Full icon name (prefix:name)
+     */
+    name: string;
+    /**
+     * Source file where the icon was found
+     */
+    file: string;
+    /**
+     * Line number in source
+     */
+    line: number;
+    /**
+     * Column number in source
+     */
+    column: number;
+}
+/**
+ * Icon bundle structure (matches CLI output)
+ */
+export interface IconBundle {
+    version: string;
+    generatedAt: string;
+    icons: Record<string, {
+        svg: string;
+        width: number;
+        height: number;
+    }>;
+    count: number;
+}
+/**
+ * JSX visitor function type
+ */
+export type JSXVisitor = (path: NodePath<JSXOpeningElement>, state: BabelPluginState) => void;
+/**
+ * Call expression visitor function type
+ */
+export type CallVisitor = (path: NodePath<CallExpression>, state: BabelPluginState) => void;
+/**
+ * Complete mapping of React component names to Iconify prefixes
+ * This covers all 200+ icon sets available in rn-iconify
+ */
+export declare const COMPONENT_PREFIX_MAP: Record<string, string>;
+/**
+ * Reverse map: prefix -> component name
+ */
+export declare const PREFIX_COMPONENT_MAP: Record<string, string>;
+/**
+ * Set of all valid component names for fast lookup
+ */
+export declare const VALID_COMPONENTS: Set<string>;
+/**
+ * Set of all valid prefixes for fast lookup
+ */
+export declare const VALID_PREFIXES: Set<string>;
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/babel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/babel/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE;QACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAyCD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAYpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAiBhD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CACX,MAAM,EACN;QACE,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CACF,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE9F;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE5F;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsevD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAQvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,aAA6C,CAAC;AAE3E;;GAEG;AACH,eAAO,MAAM,cAAc,aAA+C,CAAC"}

package/lib/typescript/bundle/index.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Offline Bundle Module
+ * Provides functionality to load pre-bundled icons at runtime
+ */
+/**
+ * Icon bundle structure (matches CLI output)
+ */
+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;
+}
+/**
+ * Bundle loading result
+ */
+export interface BundleLoadResult {
+    /**
+     * Number of icons loaded
+     */
+    loaded: number;
+    /**
+     * Number of icons skipped (already cached)
+     */
+    skipped: number;
+    /**
+     * Total icons in bundle
+     */
+    total: number;
+    /**
+     * Bundle version
+     */
+    version: string;
+    /**
+     * Load time in milliseconds
+     */
+    loadTimeMs: number;
+}
+/**
+ * Load an offline icon bundle into the cache
+ *
+ * This function should be called early in your app initialization
+ * to pre-populate the icon cache with bundled icons.
+ *
+ * Icons loaded from the bundle are immediately available without
+ * network requests, providing instant rendering.
+ *
+ * @param bundle - The icon bundle object (from JSON import)
+ * @param options - Loading options
+ * @returns Result with load statistics
+ *
+ * @example
+ * ```tsx
+ * // In your app entry point (App.tsx or index.js)
+ * import { loadOfflineBundle } from 'rn-iconify';
+ * import iconBundle from './assets/icons.bundle.json';
+ *
+ * // Load bundle on app start
+ * const result = loadOfflineBundle(iconBundle);
+ * console.log(`Loaded ${result.loaded} icons in ${result.loadTimeMs}ms`);
+ *
+ * // Or with options
+ * loadOfflineBundle(iconBundle, {
+ *   skipExisting: true,  // Don't overwrite existing cache entries
+ *   verbose: true,       // Log loading progress
+ * });
+ * ```
+ */
+export declare function loadOfflineBundle(bundle: IconBundle, options?: {
+    /**
+     * Skip icons that are already in cache
+     * @default true
+     */
+    skipExisting?: boolean;
+    /**
+     * Log loading progress
+     * @default false
+     */
+    verbose?: boolean;
+}): BundleLoadResult;
+/**
+ * Async version of loadOfflineBundle
+ *
+ * Useful for loading large bundles without blocking the main thread.
+ * Uses setTimeout to yield to the event loop periodically.
+ *
+ * @param bundle - The icon bundle object
+ * @param options - Loading options
+ * @returns Promise resolving to load result
+ *
+ * @example
+ * ```tsx
+ * import { loadOfflineBundleAsync } from 'rn-iconify';
+ * import iconBundle from './assets/icons.bundle.json';
+ *
+ * async function initApp() {
+ *   const result = await loadOfflineBundleAsync(iconBundle, {
+ *     batchSize: 100,  // Process 100 icons per batch
+ *     verbose: true,
+ *   });
+ *   console.log(`Loaded ${result.loaded} icons`);
+ * }
+ * ```
+ */
+export declare function loadOfflineBundleAsync(bundle: IconBundle, options?: {
+    /**
+     * Skip icons that are already in cache
+     * @default true
+     */
+    skipExisting?: boolean;
+    /**
+     * Log loading progress
+     * @default false
+     */
+    verbose?: boolean;
+    /**
+     * Number of icons to process per batch
+     * @default 50
+     */
+    batchSize?: number;
+    /**
+     * Progress callback
+     */
+    onProgress?: (loaded: number, total: number) => void;
+}): Promise<BundleLoadResult>;
+/**
+ * Check if a bundle is compatible with this version of rn-iconify
+ *
+ * @param bundle - The icon bundle object
+ * @returns true if compatible
+ */
+export declare function isBundleCompatible(bundle: IconBundle): boolean;
+/**
+ * Get bundle statistics
+ *
+ * @param bundle - The icon bundle object
+ * @returns Statistics about the bundle
+ */
+export declare function getBundleStats(bundle: IconBundle): {
+    iconCount: number;
+    prefixes: string[];
+    estimatedSizeBytes: number;
+    generatedAt: Date;
+};
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/bundle/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/bundle/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CACX,MAAM,EACN;QACE,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CACF,CAAC;IAEF;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IACP;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACd,GACL,gBAAgB,CA2ClB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IACP;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACjD,GACL,OAAO,CAAC,gBAAgB,CAAC,CAqD3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAa9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,IAAI,CAAC;CACnB,CAgBA"}

package/lib/typescript/cache/CacheManager.d.ts

@@ -1,16 +1,63 @@
 /**
- * Cache Manager - Orchestrates memory and disk cache
- * Priority: Memory Cache → Disk Cache → Native Cache → Network
+ * Cache Manager - Orchestrates memory, bundled, and disk cache
+ * Priority: Memory Cache → Bundled Icons → Disk Cache → Native Cache → Network
  *
  * Integrates with native module for background prefetching when available
  */
+/**
+ * Bundled icon data structure
+ */
+interface BundledIconData {
+    svg: string;
+    width: number;
+    height: number;
+}
+/**
+ * Bundle structure from Babel plugin
+ */
+interface IconBundle {
+    version: string;
+    generatedAt: string;
+    icons: Record<string, BundledIconData>;
+    count: number;
+}
 declare class CacheManagerImpl {
     /**
      * Track in-flight prefetch operations to prevent race conditions
      */
     private prefetchingIcons;
     /**
-     * Get icon SVG from cache (memory first, then disk)
+     * Bundled icons from Babel plugin (loaded at app start)
+     * These are icons that were detected during build time
+     */
+    private bundledIcons;
+    /**
+     * Whether bundled icons have been initialized
+     */
+    private bundledIconsInitialized;
+    /**
+     * Initialize bundled icons from the Babel plugin cache
+     * This should be called automatically on first access
+     */
+    initBundledIcons(): void;
+    /**
+     * Load bundled icons from a custom bundle object
+     * Useful for manual bundle loading or testing
+     *
+     * @param bundle The icon bundle to load
+     * @returns Number of icons loaded
+     */
+    loadBundle(bundle: IconBundle): number;
+    /**
+     * Check if an icon is in the bundled cache
+     */
+    hasBundled(iconName: string): boolean;
+    /**
+     * Get bundled icons count
+     */
+    getBundledCount(): number;
+    /**
+     * Get icon SVG from cache (memory first, then bundled, then disk)
      * @returns SVG string or null if not cached
      */
     get(iconName: string): string | null;
@@ -19,7 +66,7 @@ declare class CacheManagerImpl {
      */
     set(iconName: string, svg: string): void;
     /**
-     * Check if icon exists in any cache
+     * Check if icon exists in any cache (memory, bundled, or disk)
      */
     has(iconName: string): boolean;
     /**
@@ -39,6 +86,7 @@ declare class CacheManagerImpl {
      */
     getStats(): {
         memoryCount: number;
+        bundledCount: number;
         diskCount: number;
         diskSizeBytes: number;
     };