@genarou/blazir-icons 1.2.16 → 1.3.2

package/dist/plugin/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * blazir-icons — Vite / Rollup plugin
+ *
+ * Escanea tu código fuente en build-time y genera un registry mínimo
+ * que solo incluye los íconos que realmente usas.
+ *
+ * Compatible con: Vite, Rollup.
+ * Sin plugin: funciona exactamente igual que antes (registry completo).
+ *
+ * Uso en vite.config.ts:
+ *   import { blazirIconsPlugin } from '@genarou/blazir-icons/plugin'
+ *   plugins: [blazirIconsPlugin()]
+ */
+export interface BlazerIconsPluginOptions {
+    /**
+     * Directorio raíz del proyecto a escanear.
+     * Por defecto: process.cwd()
+     */
+    root?: string;
+    /**
+     * Extensiones a escanear. Por defecto: ['.svelte', '.ts', '.tsx', '.js', '.jsx']
+     */
+    extensions?: string[];
+}
+export declare function blazirIconsPlugin(options?: BlazerIconsPluginOptions): {
+    name: string;
+    enforce: "pre";
+    configResolved(config: {
+        root?: string;
+    }): void;
+    buildStart(): void;
+    resolveId(id: string, importer?: string): "\0virtual:blazir-icons/registry" | null | undefined;
+    load(id: string): string | undefined;
+    handleHotUpdate({ file, read, server }: {
+        file: string;
+        read: () => Promise<string>;
+        server: {
+            moduleGraph: {
+                getModuleById: (id: string) => unknown;
+                invalidateModule: (mod: unknown) => void;
+            };
+        };
+    }): void;
+    watchChange(id: string): void;
+};
+export default blazirIconsPlugin;

package/dist/plugin/index.js

@@ -0,0 +1,327 @@
+/**
+ * blazir-icons — Vite / Rollup plugin
+ *
+ * Escanea tu código fuente en build-time y genera un registry mínimo
+ * que solo incluye los íconos que realmente usas.
+ *
+ * Compatible con: Vite, Rollup.
+ * Sin plugin: funciona exactamente igual que antes (registry completo).
+ *
+ * Uso en vite.config.ts:
+ *   import { blazirIconsPlugin } from '@genarou/blazir-icons/plugin'
+ *   plugins: [blazirIconsPlugin()]
+ */
+import { readFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// MAPA COMPLETO: clave del registry → nombre del archivo .svelte
+// (necesario porque no siempre coinciden, e.g. search → MagnifiyingGlass)
+// ============================================================================
+const ICON_FILE_MAP = {
+    ai: 'Ai',
+    alternate: 'Alternate',
+    animatedArrowLeft: 'AnimatedArrowLeft',
+    attachment: 'Attachment',
+    bag: 'Bag',
+    bank: 'Bank',
+    bell: 'Bell',
+    blaze: 'Blaze',
+    book: 'Book',
+    box: 'Box',
+    boxAdd: 'BoxAdd',
+    building: 'Building',
+    calendar: 'Calendar',
+    calendarEdit: 'CalendarEdit',
+    calendarPlus: 'CalendarPlus',
+    cart: 'Cart',
+    category: 'Category',
+    categoryAdd: 'CategoryAdd',
+    categorySearch: 'CategorySearch',
+    chart: 'Chart',
+    chartDoc: 'ChartDoc',
+    chat: 'Chat',
+    check: 'Check',
+    checkList: 'CheckList',
+    checkO: 'CheckO',
+    chevronDown: 'ChevronDown',
+    chevronUpDown: 'ChevronUpDown',
+    circleCheck: 'CircleCheck',
+    circleExclamation: 'CircleExclamation',
+    circleExclamationO: 'CircleExclamationOutlined',
+    circleInfo: 'CircleInfo',
+    circleInfoO: 'CircleInfoOutlined',
+    circleQuestion: 'CircleQuestion',
+    circleQuestionO: 'CircleQuestionOutlined',
+    close: 'Close',
+    colors: 'Colors',
+    contact: 'Contact',
+    copy: 'Copy',
+    costIcon: 'CostIcon',
+    csv: 'Csv',
+    dashboard: 'Dashboard',
+    dashboardO: 'DashboardOutlined',
+    db: 'Db',
+    download: 'Download',
+    downloadAnimated: 'DownloadAnimated',
+    edit: 'Edit',
+    editOutline: 'EditOutline',
+    email: 'Email',
+    emailAnimated: 'EmailAnimated',
+    enterprise: 'Enterprise',
+    error: 'Error',
+    errorO: 'ErrorO',
+    excel: 'Excel',
+    excelAnimated: 'ExcelAnimated',
+    exchange: 'Exchange',
+    eye: 'Eye',
+    eyeOff: 'EyeOff',
+    favorites: 'Favorites',
+    file: 'File',
+    fileUpdateAnimated: 'FileUploadAnimated',
+    filter: 'FilterOutline',
+    filterOutline: 'FilterOutline',
+    fingerprint: 'Fingerprint',
+    folder: 'Folder',
+    form: 'Form',
+    formatListGroup: 'FormatListGroup',
+    group: 'Group',
+    hamburguer: 'Hamburguer',
+    handShake: 'HandShake',
+    heart: 'Heart',
+    height: 'Height',
+    home: 'Home',
+    image: 'Image',
+    imageAnimated: 'ImageAnimated',
+    key: 'Key',
+    list: 'List',
+    listDots: 'ListDots',
+    loadingDots: 'LoadingDots',
+    loadingRegular: 'RegularSpinner',
+    location: 'Location',
+    locationAnimated: 'LocationAnimated',
+    lock: 'Lock',
+    lockOpen: 'LockOpen',
+    logout: 'Logout',
+    lose: 'Lose',
+    magnifyingGlass: 'MagnifiyingGlass',
+    measure: 'Measure',
+    money: 'Money',
+    moon: 'Moon',
+    more: 'More',
+    notes: 'Notes',
+    objectGroup: 'ObjectGroup',
+    pay: 'Pay',
+    pdf: 'Pdf',
+    phone: 'Phone',
+    plus: 'Plus',
+    png: 'Png',
+    pointSale: 'PointSale',
+    powerPoint: 'PowerPoint',
+    print: 'Print',
+    product: 'Product',
+    profit: 'Profit',
+    project: 'Project',
+    refresh: 'Update',
+    reset: 'Reset',
+    rightArrow: 'RightArrow',
+    rocket: 'Rocket',
+    safeSolid: 'SafeSolid',
+    save: 'Save',
+    scan: 'Scan',
+    search: 'MagnifiyingGlass',
+    security: 'Security',
+    send: 'Send',
+    server: 'Server',
+    settings: 'Settings',
+    share: 'Share',
+    sharedFolder: 'SharedFolder',
+    shield: 'Shield',
+    sidebar: 'Sidebar',
+    squareChart: 'SquareChart',
+    star: 'Star',
+    sun: 'Sun',
+    supervisor: 'Supervisor',
+    swap: 'Swap',
+    table: 'Table',
+    tags: 'Tags',
+    team: 'Team',
+    timer: 'Timer',
+    tools: 'Tools',
+    trash: 'Trash',
+    trashOutline: 'TrashOutline',
+    truck: 'Truck',
+    truckReturn: 'TruckReturn',
+    upArrow: 'UpArrow',
+    upDownArrow: 'UpDownArrow',
+    upload: 'Upload',
+    uploadAnimated: 'UploadAnimated',
+    uploadLoader: 'UploadLoader',
+    user: 'User',
+    userTie: 'UserTie',
+    wallet: 'Wallet',
+    warehouse: 'Warehouse',
+    warning: 'Warning',
+    word: 'Word',
+    world: 'World',
+    xml: 'Xml',
+    zip: 'Zip',
+};
+const ALL_KEYS = new Set(Object.keys(ICON_FILE_MAP));
+// ============================================================================
+// PATRONES DE DETECCIÓN
+// ============================================================================
+// Detecta: name="check" | name='check' | name={"check"} | name={'check'}
+const STATIC_RE = /\bname=(?:"([a-zA-Z][a-zA-Z0-9]*)"|'([a-zA-Z][a-zA-Z0-9]*)'|\{["']([a-zA-Z][a-zA-Z0-9]*)["']\})/g;
+// Detecta uso dinámico: name={expr} (no string literal)
+const DYNAMIC_RE = /\bname=\{(?!["'])/;
+// ID del módulo virtual que reemplaza al registry completo
+const VIRTUAL_ID = 'virtual:blazir-icons/registry';
+const RESOLVED_ID = '\0virtual:blazir-icons/registry';
+// ============================================================================
+// PLUGIN
+// ============================================================================
+export function blazirIconsPlugin(options = {}) {
+    const detected = new Set();
+    let hasDynamic = false;
+    let scanned = false;
+    let root = options.root ?? process.cwd();
+    const extensions = options.extensions ?? ['.svelte', '.ts', '.tsx', '.js', '.jsx'];
+    // --------------------------------------------------------------------------
+    // Extrae nombres de íconos de un bloque de código fuente
+    // --------------------------------------------------------------------------
+    function scanContent(content) {
+        STATIC_RE.lastIndex = 0;
+        for (const m of content.matchAll(STATIC_RE)) {
+            const name = m[1] ?? m[2] ?? m[3];
+            if (name && ALL_KEYS.has(name))
+                detected.add(name);
+        }
+        if (!hasDynamic && DYNAMIC_RE.test(content)) {
+            hasDynamic = true;
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Escanea recursivamente un directorio (ignora node_modules, .git, dist)
+    // --------------------------------------------------------------------------
+    const SKIP_DIRS = new Set(['node_modules', '.git', 'dist', '.svelte-kit', '.vite', 'build']);
+    function scanDir(dir) {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!SKIP_DIRS.has(entry.name))
+                    scanDir(full);
+            }
+            else if (entry.isFile() && extensions.some((ext) => entry.name.endsWith(ext))) {
+                try {
+                    scanContent(readFileSync(full, 'utf-8'));
+                }
+                catch {
+                    // archivo ilegible — ignorar
+                }
+            }
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Asegura que el scan se haya hecho al menos una vez
+    // --------------------------------------------------------------------------
+    function ensureScanned() {
+        if (scanned)
+            return;
+        scanned = true;
+        scanDir(root);
+    }
+    // --------------------------------------------------------------------------
+    // Genera el código del registry mínimo
+    // --------------------------------------------------------------------------
+    function generateRegistry() {
+        const lines = [];
+        const entries = [];
+        for (const key of detected) {
+            const file = ICON_FILE_MAP[key];
+            if (!file)
+                continue;
+            lines.push(`import _${key} from '@genarou/blazir-icons/icons/${file}';`);
+            entries.push(`  ${key}: _${key}`);
+        }
+        lines.push(`\nexport const iconRegistry = {\n${entries.join(',\n')}\n};`);
+        lines.push(`export type IconName = keyof typeof iconRegistry;`);
+        lines.push(`export type IconComponent = any;`);
+        return lines.join('\n');
+    }
+    // --------------------------------------------------------------------------
+    // Plugin object (compatible con Vite y Rollup)
+    // --------------------------------------------------------------------------
+    return {
+        name: 'blazir-icons',
+        enforce: 'pre',
+        // Vite: captura el root configurado
+        configResolved(config) {
+            if (config.root)
+                root = config.root;
+        },
+        // Prod build: escanear todos los archivos antes de comenzar
+        buildStart() {
+            ensureScanned();
+        },
+        // Intercepta la importación del registry desde Icon.svelte
+        resolveId(id, importer) {
+            if (id === VIRTUAL_ID)
+                return RESOLVED_ID;
+            // Solo interceptar cuando podemos optimizar:
+            // - el importer es Icon.svelte de blazir-icons
+            // - el id es el registry
+            const isRegistryImport = (id.includes('registry') || id === './icons/registry.js') &&
+                importer?.includes('blazir-icons') &&
+                importer?.includes('Icon.svelte');
+            if (isRegistryImport) {
+                ensureScanned();
+                // Si hay uso dinámico o no detectamos nada → dejar pasar (registry completo)
+                if (hasDynamic || detected.size === 0)
+                    return null;
+                return RESOLVED_ID;
+            }
+        },
+        // Genera el módulo virtual con solo los íconos detectados
+        load(id) {
+            if (id !== RESOLVED_ID)
+                return;
+            ensureScanned();
+            return generateRegistry();
+        },
+        // Vite dev server: re-escanear archivos modificados
+        handleHotUpdate({ file, read, server }) {
+            if (!file.includes('node_modules') && extensions.some((ext) => file.endsWith(ext))) {
+                read().then((content) => {
+                    const prevSize = detected.size;
+                    const prevDynamic = hasDynamic;
+                    scanContent(content);
+                    // Si se detectaron nuevos íconos o cambió el estado dinámico → invalidar el módulo virtual
+                    if (detected.size !== prevSize || hasDynamic !== prevDynamic) {
+                        const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
+                        if (mod)
+                            server.moduleGraph.invalidateModule(mod);
+                    }
+                });
+            }
+        },
+        // Rollup watch mode: re-escanear archivos modificados
+        watchChange(id) {
+            if (!id.includes('node_modules') && extensions.some((ext) => id.endsWith(ext))) {
+                try {
+                    scanContent(readFileSync(id, 'utf-8'));
+                }
+                catch {
+                    // ignorar archivos ilegibles
+                }
+            }
+        },
+    };
+}
+export default blazirIconsPlugin;

package/dist/smart-cache.d.ts

@@ -0,0 +1,35 @@
+import type { IconProps } from './types.js';
+export declare class LRU<K, V> {
+    private readonly max;
+    private readonly map;
+    constructor(max: number);
+    get(key: K): V | undefined;
+    set(key: K, val: V): void;
+    has(key: K): boolean;
+    get size(): number;
+    clear(): void;
+}
+/**
+ * Devuelve un objeto FROZEN y ESTABLE para la combinación (preset, variant).
+ *
+ * Garantías:
+ * - Mismos argumentos → EXACTAMENTE la misma referencia (Object.is === true)
+ * - El objeto es inmutable (Object.freeze)
+ * - Sin TTL: la validez es estructural (los presets son constantes de módulo)
+ */
+export declare function getPresetVariantMerge(preset: string | undefined, variant: string | undefined): Readonly<Partial<IconProps>>;
+/**
+ * Retorna true si todos los valores de props son primitivos seguros para cache.
+ * Complejidad: O(n) donde n = número de props.
+ */
+export declare function arePropsStable(props: Record<string, unknown>): boolean;
+/**
+ * Construye una clave estructural para el cache completo de props.
+ * Solo incluye props primitivas y estables.
+ *
+ * ⚠️ Solo llamar cuando arePropsStable() === true.
+ */
+export declare function buildStructuralKey(props: Record<string, unknown>): string;
+export declare function getCachedMergedProps(key: string): Readonly<IconProps> | undefined;
+export declare function setCachedMergedProps(key: string, props: Readonly<IconProps>): void;
+export declare function toSizePx(s: number | string): string;

package/dist/smart-cache.js

@@ -0,0 +1,192 @@
+// src/lib/smart-cache.ts
+// Cache adaptativo inteligente para blazir-icons
+// Diseñado para máxima estabilidad referencial y rendimiento en listas grandes
+import { iconPresets, iconVariants } from './presets.js';
+// ============================================================================
+// MICRO-LRU — O(1) get/set con Map de inserción-orden como cola
+// Map en V8 mantiene orden de inserción; delete + re-insert = mover al final
+// ============================================================================
+export class LRU {
+    constructor(max) {
+        this.max = max;
+        this.map = new Map();
+    }
+    get(key) {
+        if (!this.map.has(key))
+            return undefined;
+        // Promover a "más reciente": delete + re-insert
+        const val = this.map.get(key);
+        this.map.delete(key);
+        this.map.set(key, val);
+        return val;
+    }
+    set(key, val) {
+        if (this.map.has(key)) {
+            this.map.delete(key);
+        }
+        else if (this.map.size >= this.max) {
+            // Evictar el LRU (primer elemento = menos reciente)
+            this.map.delete(this.map.keys().next().value);
+        }
+        this.map.set(key, val);
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    get size() {
+        return this.map.size;
+    }
+    clear() {
+        this.map.clear();
+    }
+}
+// ============================================================================
+// CACHE PRESET × VARIANT
+//
+// Propósito: devolver EXACTAMENTE la misma referencia de objeto para la misma
+// combinación (preset, variant). Esto permite que $derived en Icon.svelte NO
+// cree nuevos objetos si preset/variant no cambiaron.
+//
+// Bounds: len(presets) × len(variants) ≈ 12 × 8 = 96 entradas máximo.
+// → No necesita evicción. Plain Map, determinista.
+// ============================================================================
+const _pvCache = new Map();
+/**
+ * Devuelve un objeto FROZEN y ESTABLE para la combinación (preset, variant).
+ *
+ * Garantías:
+ * - Mismos argumentos → EXACTAMENTE la misma referencia (Object.is === true)
+ * - El objeto es inmutable (Object.freeze)
+ * - Sin TTL: la validez es estructural (los presets son constantes de módulo)
+ */
+export function getPresetVariantMerge(preset, variant) {
+    // Usar \x01 como separador para evitar colisiones "ab|c" vs "a|bc"
+    const key = `${preset ?? '\x00'}\x01${variant ?? '\x00'}`;
+    const hit = _pvCache.get(key);
+    if (hit)
+        return hit;
+    const pp = preset
+        ? (iconPresets[preset] ?? {})
+        : {};
+    const vp = variant
+        ? (iconVariants[variant] ?? {})
+        : {};
+    // Orden: variant gana sobre preset (igual que el merge original)
+    const merged = Object.freeze({ ...pp, ...vp });
+    _pvCache.set(key, merged);
+    return merged;
+}
+// ============================================================================
+// DETECCIÓN DE ESTABILIDAD DE PROPS
+//
+// Props "estables": todos sus valores son primitivos (string, number, boolean)
+// Props "inestables": contienen objetos, funciones o arrays
+//
+// Solo las props estables son candidatas al cache estructural completo.
+// ============================================================================
+/**
+ * Props que SIEMPRE son inestables (objetos, funciones, arrays).
+ * Si aparecen en los props del usuario → no cachear el resultado completo.
+ */
+const UNSTABLE_KEYS = new Set([
+    'actions',
+    'effects',
+    'attrs',
+    'parentHoverContext',
+    'children',
+]);
+/**
+ * Props excluidas del cache key (se pasan al hijo pero no afectan
+ * a la merge de base, o son strings que varían libremente).
+ */
+const SKIP_IN_KEY = new Set([
+    'style',
+    'class',
+    'className',
+    'actions',
+    'effects',
+    'attrs',
+    'parentHoverContext',
+    'children',
+    // preset/variant se resuelven por separado (ya están en baseProps)
+    'preset',
+    'variant',
+    // lazy es meta-prop de Icon.svelte, no llega al hijo
+    'lazy',
+]);
+/**
+ * Retorna true si todos los valores de props son primitivos seguros para cache.
+ * Complejidad: O(n) donde n = número de props.
+ */
+export function arePropsStable(props) {
+    for (const k in props) {
+        if (UNSTABLE_KEYS.has(k))
+            return false;
+        const v = props[k];
+        if (v !== null && v !== undefined && typeof v === 'object')
+            return false;
+        if (typeof v === 'function')
+            return false;
+    }
+    return true;
+}
+// ============================================================================
+// CLAVE ESTRUCTURAL
+//
+// Clave determinista derivada de las props primitivas (excluye las inestables
+// y las meta-props). Las claves se ordenan alfabéticamente para asegurar
+// que dos objetos con las mismas props en distinto orden generen la misma clave.
+// ============================================================================
+/**
+ * Construye una clave estructural para el cache completo de props.
+ * Solo incluye props primitivas y estables.
+ *
+ * ⚠️ Solo llamar cuando arePropsStable() === true.
+ */
+export function buildStructuralKey(props) {
+    const parts = [];
+    // Ordenar para determinismo (orden de props puede variar)
+    const keys = Object.keys(props).sort();
+    for (const k of keys) {
+        if (SKIP_IN_KEY.has(k))
+            continue;
+        const v = props[k];
+        if (v === undefined)
+            continue;
+        // Separador: \x02 es poco probable en valores reales
+        parts.push(`${k}\x02${v}`);
+    }
+    return parts.join('\x03');
+}
+// ============================================================================
+// CACHE COMPLETO DE MERGED PROPS (LRU, solo props estables)
+//
+// Scope: global (compartido entre instancias del mismo componente).
+// Esto es correcto porque la función de merge es pura cuando los inputs
+// son solo primitivos.
+//
+// Tamaño: 128 entradas. Para listas con M iconos distintos: hasta 128 configs
+// únicas se cachean. Más allá, el LRU evicta las menos usadas.
+// ============================================================================
+const _mergedPropsCache = new LRU(128);
+export function getCachedMergedProps(key) {
+    return _mergedPropsCache.get(key);
+}
+export function setCachedMergedProps(key, props) {
+    _mergedPropsCache.set(key, props);
+}
+// ============================================================================
+// ESTABILIDAD REFERENCIAL PARA SIZE
+//
+// El tamaño de la caja se deriva de (p.size ?? preset.size ?? variant.size).
+// Cacheamos el string resultado para evitar crear nuevos strings en cada render.
+// ============================================================================
+const _sizeStringCache = new Map();
+export function toSizePx(s) {
+    const hit = _sizeStringCache.get(s);
+    if (hit)
+        return hit;
+    const result = typeof s === 'number' ? `${s}px` : s;
+    _sizeStringCache.set(s, result);
+    return result;
+}

package/dist/types.d.ts

@@ -34,6 +34,14 @@ export interface IconProps {
     elastic?: boolean;
     hoverColor?: string;
     activeColor?: string;
+    /** Apaga el icono visualmente (opacity 0.4) y bloquea hover/pointer-events. */
+    disabled?: boolean;
+    /** Reemplaza el icono con un spinner hasta que sea false. Reutiliza la animación spin interna. */
+    loading?: boolean;
+    /** Texto del tooltip. Se muestra al hacer hover sobre el icono. */
+    tooltip?: string;
+    /** Delay antes de mostrar el tooltip en ms. Default: 0 (instantáneo). */
+    tooltipDelay?: number;
     parentHoverContext?: {
         hovered: boolean;
     } | null;
@@ -53,9 +61,18 @@ export interface IconProps {
     effects?: IconEffectOptions;
     children?: any;
     mode?: IconMode;
-    /** Duración genérica de transiciones/hover (ms o '200ms'/'0.2s'). */
+    /**
+     * Velocidad de transición hover — preset semántico.
+     * - `"instant"` → 0ms
+     * - `"fast"`    → 120ms
+     * - `"normal"`  → 250ms  ← default
+     * - `"slow"`    → 400ms
+     * - `"sluggish"` → 600ms
+     */
+    hoverSpeed?: "instant" | "fast" | "normal" | "slow" | "sluggish";
+    /** Duración exacta de la transición hover (ms o '300ms'/'0.3s'). Prevalece sobre hoverSpeed. */
     transitionMs?: number | string;
-    /** Easing para transiciones/hover. */
+    /** Easing CSS para la transición hover. Ej: 'ease', 'ease-in-out', 'cubic-bezier(...)'. */
     transitionEasing?: string;
 }
 export type { IconName } from "./icons/registry";

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,25 @@
+/**
+ * sanitize.ts — Lightweight SVG sanitizer. Zero dependencies.
+ *
+ * Browser: uses the native DOMParser with image/svg+xml for robust, spec-compliant parsing.
+ * SSR:     regex-based fallback that strips the most dangerous vectors.
+ *
+ * Threat model (SVG inner content — not the <svg> tag itself):
+ *   ✗ <script> blocks
+ *   ✗ <foreignObject> — embeds arbitrary HTML
+ *   ✗ <iframe>, <object>, <embed>, <link>, <base>
+ *   ✗ Event handlers  — on*, xlink:actuate, etc.
+ *   ✗ javascript: / vbscript: / data: URIs in href / src / action
+ *   ✗ CSS expression() / javascript: in style attributes
+ */
+/**
+ * Sanitizes raw SVG inner markup against XSS vectors.
+ *
+ * Safe to call with content from external APIs or user input.
+ * For static, trusted SVG strings defined in your own code, pass
+ * `sanitize={false}` to `CustomIcon` to skip the overhead entirely.
+ *
+ * @param raw - SVG inner markup (paths, circles, etc. — not the <svg> tag)
+ * @returns Sanitized SVG markup string, empty string on parse failure
+ */
+export declare function sanitizeSvg(raw: string): string;