@nice2dev/ui-tools 1.0.10

package/dist/icon-tools.d.ts

@@ -0,0 +1,1023 @@
+/**
+ * @fileoverview PRO-28: Icons Professional Suite Types
+ *
+ * This module provides TypeScript types and interfaces for the comprehensive
+ * icon system including icon management, searching, editing, and cross-framework
+ * support.
+ *
+ * @module @nice2dev/ui-tools/icon-tools
+ */
+/**
+ * Icon style variants.
+ */
+export type IconStyle = 'solid' | 'outline' | 'duotone' | 'light' | 'thin' | 'bold' | 'filled' | 'regular' | 'brand';
+/**
+ * Icon size presets.
+ */
+export type IconSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl';
+/**
+ * Icon size in pixels.
+ */
+export type IconSizePixels = 12 | 14 | 16 | 18 | 20 | 24 | 28 | 32 | 36 | 40 | 48 | 56 | 64 | 72 | 96 | 128 | 192 | 256 | 512;
+/**
+ * Icon category for organization.
+ */
+export type IconCategory = 'action' | 'alert' | 'av' | 'communication' | 'content' | 'device' | 'editor' | 'file' | 'hardware' | 'image' | 'maps' | 'navigation' | 'notification' | 'places' | 'social' | 'toggle' | 'brand' | 'custom';
+/**
+ * Domain-specific icon categories.
+ */
+export type DomainCategory = 'business' | 'finance' | 'healthcare' | 'education' | 'manufacturing' | 'retail' | 'technology' | 'gaming' | 'science' | 'life-management' | 'creative' | 'legal' | 'hr' | 'logistics';
+/**
+ * Use case for icon selection.
+ */
+export type IconUseCase = 'toolbar' | 'menu' | 'button' | 'status' | 'cursor' | 'notification' | 'tab' | 'avatar' | 'decoration' | 'illustration' | 'logo' | 'favicon';
+/**
+ * Basic icon definition.
+ */
+export interface IconDefinition {
+    /** Unique icon ID */
+    id: string;
+    /** Icon name (kebab-case) */
+    name: string;
+    /** Display name */
+    displayName: string;
+    /** SVG path data */
+    path: string;
+    /** Alternative paths for composite icons */
+    paths?: string[];
+    /** Viewbox dimensions */
+    viewBox: string;
+    /** Default fill rule */
+    fillRule?: 'nonzero' | 'evenodd';
+    /** Default stroke properties */
+    stroke?: IconStrokeConfig;
+    /** Icon style */
+    style: IconStyle;
+    /** Available sizes */
+    sizes?: IconSizePixels[];
+}
+/**
+ * Stroke configuration for outline icons.
+ */
+export interface IconStrokeConfig {
+    /** Stroke width */
+    width: number;
+    /** Stroke line cap */
+    lineCap: 'butt' | 'round' | 'square';
+    /** Stroke line join */
+    lineJoin: 'miter' | 'round' | 'bevel';
+    /** Miter limit */
+    miterLimit?: number;
+}
+/**
+ * Extended icon metadata for search and organization.
+ */
+export interface IconMetadata extends IconDefinition {
+    /** Primary category */
+    category: IconCategory;
+    /** Secondary categories */
+    secondaryCategories?: IconCategory[];
+    /** Domain tags */
+    domains: DomainCategory[];
+    /** Use case tags */
+    useCases: IconUseCase[];
+    /** Style compatibility */
+    availableStyles: IconStyle[];
+    /** Recommended sizes */
+    recommendedSizes: IconSizePixels[];
+    /** Related icon IDs */
+    relatedIcons: string[];
+    /** Alternative names/aliases */
+    aliases: string[];
+    /** Localized names */
+    localizedNames: Record<string, string>;
+    /** Keywords for search */
+    keywords: string[];
+    /** Description */
+    description?: string;
+    /** Version added */
+    versionAdded: string;
+    /** Whether icon is deprecated */
+    deprecated?: boolean;
+    /** Replacement icon if deprecated */
+    replacement?: string;
+    /** License information */
+    license?: string;
+    /** Author/source */
+    author?: string;
+    /** Unicode codepoint (if in icon font) */
+    unicode?: string;
+}
+/**
+ * Icon usage statistics.
+ */
+export interface IconUsageStats {
+    /** Icon ID */
+    iconId: string;
+    /** Total usage count */
+    totalUsage: number;
+    /** Usage by project */
+    byProject: Record<string, number>;
+    /** Usage by component type */
+    byComponentType: Record<string, number>;
+    /** First used date */
+    firstUsed: string;
+    /** Last used date */
+    lastUsed: string;
+    /** Usage trend */
+    trend: 'increasing' | 'stable' | 'decreasing';
+}
+/**
+ * Icon set/collection definition.
+ */
+export interface IconSet {
+    /** Set identifier */
+    id: string;
+    /** Set name */
+    name: string;
+    /** Set description */
+    description: string;
+    /** Set version */
+    version: string;
+    /** Total icon count */
+    iconCount: number;
+    /** Available styles in this set */
+    styles: IconStyle[];
+    /** License */
+    license: IconLicense;
+    /** Author/organization */
+    author: string;
+    /** Website URL */
+    website?: string;
+    /** Documentation URL */
+    docsUrl?: string;
+    /** Icon prefix */
+    prefix: string;
+    /** Default style */
+    defaultStyle: IconStyle;
+    /** Categories available */
+    categories: IconCategory[];
+    /** Icons in this set */
+    icons: Record<string, IconDefinition>;
+}
+/**
+ * Icon license information.
+ */
+export interface IconLicense {
+    /** License name */
+    name: string;
+    /** SPDX identifier */
+    spdx?: string;
+    /** License URL */
+    url?: string;
+    /** Whether attribution is required */
+    attributionRequired: boolean;
+    /** Attribution text if required */
+    attributionText?: string;
+    /** Commercial use allowed */
+    commercialUse: boolean;
+    /** Modification allowed */
+    modification: boolean;
+}
+/**
+ * User-created icon collection.
+ */
+export interface UserIconCollection {
+    /** Collection ID */
+    id: string;
+    /** Collection name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Owner user ID */
+    ownerId: string;
+    /** Icon IDs in collection */
+    iconIds: string[];
+    /** Custom icon data (user-created icons) */
+    customIcons?: IconDefinition[];
+    /** Created date */
+    createdAt: string;
+    /** Last modified date */
+    modifiedAt: string;
+    /** Whether collection is public */
+    isPublic: boolean;
+    /** Tags for organization */
+    tags: string[];
+    /** Cover icon ID */
+    coverIconId?: string;
+}
+/**
+ * Icon search query.
+ */
+export interface IconSearchQuery {
+    /** Search text */
+    query: string;
+    /** Filter by category */
+    categories?: IconCategory[];
+    /** Filter by domain */
+    domains?: DomainCategory[];
+    /** Filter by use case */
+    useCases?: IconUseCase[];
+    /** Filter by style */
+    styles?: IconStyle[];
+    /** Filter by size availability */
+    sizes?: IconSizePixels[];
+    /** Filter by icon set */
+    sets?: string[];
+    /** Include deprecated icons */
+    includeDeprecated?: boolean;
+    /** Search mode */
+    mode?: 'exact' | 'fuzzy' | 'semantic';
+    /** Fuzzy match threshold (0-1) */
+    fuzzyThreshold?: number;
+    /** Sort by */
+    sortBy?: 'relevance' | 'name' | 'popularity' | 'recent';
+    /** Sort direction */
+    sortDir?: 'asc' | 'desc';
+    /** Page number */
+    page?: number;
+    /** Page size */
+    pageSize?: number;
+}
+/**
+ * Icon search result.
+ */
+export interface IconSearchResult {
+    /** Total matches */
+    total: number;
+    /** Current page */
+    page: number;
+    /** Page size */
+    pageSize: number;
+    /** Results */
+    results: IconSearchHit[];
+    /** Search suggestions */
+    suggestions?: string[];
+    /** Related searches */
+    relatedSearches?: string[];
+    /** Facets for filtering */
+    facets?: IconSearchFacets;
+}
+/**
+ * Individual search hit.
+ */
+export interface IconSearchHit {
+    /** Icon metadata */
+    icon: IconMetadata;
+    /** Relevance score (0-100) */
+    score: number;
+    /** Matched fields */
+    matchedFields: string[];
+    /** Highlighted name */
+    highlightedName?: string;
+    /** Matched keywords */
+    matchedKeywords?: string[];
+}
+/**
+ * Search facets for filtering.
+ */
+export interface IconSearchFacets {
+    /** Category counts */
+    categories: Record<IconCategory, number>;
+    /** Domain counts */
+    domains: Record<DomainCategory, number>;
+    /** Style counts */
+    styles: Record<IconStyle, number>;
+    /** Set counts */
+    sets: Record<string, number>;
+}
+/**
+ * Semantic search configuration (AI-powered).
+ */
+export interface SemanticSearchConfig {
+    /** Enable semantic search */
+    enabled: boolean;
+    /** Embedding model */
+    model: 'openai' | 'cohere' | 'local';
+    /** Similarity threshold */
+    threshold: number;
+    /** Maximum results to re-rank */
+    maxRerank: number;
+    /** Cache embeddings */
+    cacheEmbeddings: boolean;
+}
+/**
+ * Icon editor configuration.
+ */
+export interface IconEditorConfig {
+    /** Canvas size */
+    canvasSize: number;
+    /** Grid size */
+    gridSize: number;
+    /** Show grid */
+    showGrid: boolean;
+    /** Snap to grid */
+    snapToGrid: boolean;
+    /** Show guides */
+    showGuides: boolean;
+    /** Default stroke width */
+    defaultStrokeWidth: number;
+    /** Default fill color */
+    defaultFill: string;
+    /** Default stroke color */
+    defaultStroke: string;
+    /** Undo history limit */
+    undoLimit: number;
+    /** Auto-save interval (ms) */
+    autoSaveInterval?: number;
+}
+/**
+ * Icon editing operation.
+ */
+export interface IconEditOperation {
+    /** Operation type */
+    type: IconEditOperationType;
+    /** Operation parameters */
+    params: Record<string, unknown>;
+    /** Timestamp */
+    timestamp: string;
+}
+/**
+ * Types of edit operations.
+ */
+export type IconEditOperationType = 'add-path' | 'remove-path' | 'modify-path' | 'set-fill' | 'set-stroke' | 'transform' | 'flip-h' | 'flip-v' | 'rotate' | 'scale' | 'combine' | 'subtract' | 'intersect' | 'exclude' | 'simplify' | 'optimize';
+/**
+ * Icon transformation.
+ */
+export interface IconTransform {
+    /** Translation X */
+    translateX: number;
+    /** Translation Y */
+    translateY: number;
+    /** Scale X */
+    scaleX: number;
+    /** Scale Y */
+    scaleY: number;
+    /** Rotation in degrees */
+    rotate: number;
+    /** Rotation origin X */
+    originX: number;
+    /** Rotation origin Y */
+    originY: number;
+    /** Skew X */
+    skewX: number;
+    /** Skew Y */
+    skewY: number;
+}
+/**
+ * Color modification options.
+ */
+export interface IconColorOptions {
+    /** Primary color */
+    primary: string;
+    /** Secondary color (for duotone) */
+    secondary?: string;
+    /** Background color */
+    background?: string;
+    /** Opacity */
+    opacity: number;
+    /** Color mode */
+    colorMode: 'single' | 'gradient' | 'duotone';
+    /** Gradient configuration */
+    gradient?: IconGradient;
+}
+/**
+ * Gradient configuration for icons.
+ */
+export interface IconGradient {
+    /** Gradient type */
+    type: 'linear' | 'radial';
+    /** Gradient angle (for linear) */
+    angle?: number;
+    /** Gradient stops */
+    stops: GradientStop[];
+    /** Center X (for radial) */
+    cx?: number;
+    /** Center Y (for radial) */
+    cy?: number;
+    /** Radius (for radial) */
+    r?: number;
+}
+/**
+ * Gradient color stop.
+ */
+export interface GradientStop {
+    /** Offset (0-1) */
+    offset: number;
+    /** Color */
+    color: string;
+    /** Opacity */
+    opacity?: number;
+}
+/**
+ * Icon combination/composition.
+ */
+export interface IconComposition {
+    /** Base icon */
+    base: IconDefinition;
+    /** Overlay icon (badge) */
+    overlay?: IconDefinition;
+    /** Overlay position */
+    overlayPosition?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+    /** Overlay scale */
+    overlayScale?: number;
+    /** Overlay offset */
+    overlayOffset?: {
+        x: number;
+        y: number;
+    };
+    /** Whether to create cutout for overlay */
+    cutout?: boolean;
+}
+/**
+ * Icon set creation configuration.
+ */
+export interface IconSetCreatorConfig {
+    /** Set name */
+    name: string;
+    /** Set prefix */
+    prefix: string;
+    /** Selected icons */
+    icons: string[];
+    /** Custom naming rules */
+    naming: IconNamingConfig;
+    /** Export configuration */
+    export: IconSetExportConfig;
+    /** Include metadata */
+    includeMetadata: boolean;
+    /** Tree-shaking support */
+    treeShakeable: boolean;
+}
+/**
+ * Naming configuration for icon sets.
+ */
+export interface IconNamingConfig {
+    /** Case style */
+    caseStyle: 'camelCase' | 'PascalCase' | 'kebab-case' | 'snake_case';
+    /** Prefix to add */
+    prefix?: string;
+    /** Suffix to add */
+    suffix?: string;
+    /** Word replacements */
+    replacements?: Record<string, string>;
+    /** Remove words */
+    removeWords?: string[];
+}
+/**
+ * Icon set export configuration.
+ */
+export interface IconSetExportConfig {
+    /** Export formats */
+    formats: IconExportFormat[];
+    /** Output directory */
+    outputDir: string;
+    /** Generate index file */
+    generateIndex: boolean;
+    /** Generate TypeScript types */
+    generateTypes: boolean;
+    /** Generate CSS */
+    generateCSS: boolean;
+    /** Generate icon font */
+    generateFont: boolean;
+    /** Font configuration */
+    fontConfig?: IconFontConfig;
+    /** Sprite configuration */
+    spriteConfig?: IconSpriteConfig;
+}
+/**
+ * Icon export formats.
+ */
+export type IconExportFormat = 'svg' | 'png' | 'webp' | 'ico' | 'icns' | 'pdf' | 'jsx' | 'tsx' | 'vue' | 'svelte' | 'json' | 'css' | 'scss' | 'woff2' | 'ttf';
+/**
+ * Icon font generation configuration.
+ */
+export interface IconFontConfig {
+    /** Font family name */
+    fontName: string;
+    /** Class prefix */
+    classPrefix: string;
+    /** Unicode starting point */
+    unicodeStart: number;
+    /** Font formats to generate */
+    formats: ('woff2' | 'woff' | 'ttf' | 'eot' | 'svg')[];
+    /** Normalize icon sizes */
+    normalize: boolean;
+    /** Center icons */
+    centerHorizontally: boolean;
+    centerVertically: boolean;
+    /** Font height */
+    fontHeight: number;
+    /** Descent */
+    descent: number;
+    /** Round values */
+    round: number;
+}
+/**
+ * SVG sprite configuration.
+ */
+export interface IconSpriteConfig {
+    /** Sprite filename */
+    filename: string;
+    /** Symbol mode (versus inline) */
+    symbolMode: boolean;
+    /** Include style element */
+    includeStyle: boolean;
+    /** Namespace prefix */
+    symbolPrefix: string;
+}
+/**
+ * Icon preview configuration.
+ */
+export interface IconPreviewConfig {
+    /** Preview sizes */
+    sizes: IconSizePixels[];
+    /** Show in both themes */
+    showBothThemes: boolean;
+    /** Background options */
+    backgrounds: PreviewBackground[];
+    /** Show grid */
+    showGrid: boolean;
+    /** Grid color */
+    gridColor: string;
+    /** Animation preview */
+    animationPreview: boolean;
+    /** Compare mode */
+    compareMode: boolean;
+    /** Compare icons */
+    compareIcons?: string[];
+}
+/**
+ * Preview background options.
+ */
+export interface PreviewBackground {
+    /** Background name */
+    name: string;
+    /** Background color or image */
+    value: string;
+    /** Whether it's a pattern */
+    isPattern?: boolean;
+    /** Contrast for icon color suggestion */
+    suggestedIconColor?: string;
+}
+/**
+ * Animation preview configuration.
+ */
+export interface IconAnimationPreview {
+    /** Animation type */
+    type: IconAnimationType;
+    /** Duration in ms */
+    duration: number;
+    /** Easing function */
+    easing: string;
+    /** Iteration count */
+    iterations: number | 'infinite';
+    /** Direction */
+    direction: 'normal' | 'reverse' | 'alternate' | 'alternate-reverse';
+    /** Delay in ms */
+    delay: number;
+}
+/**
+ * Icon animation types.
+ */
+export type IconAnimationType = 'spin' | 'pulse' | 'bounce' | 'shake' | 'flip' | 'beat' | 'fade' | 'beat-fade' | 'spin-pulse' | 'custom';
+/**
+ * Favicon generation configuration.
+ */
+export interface FaviconGeneratorConfig {
+    /** Source icon */
+    sourceIcon: IconDefinition | string;
+    /** App name */
+    appName: string;
+    /** Short name */
+    shortName: string;
+    /** Theme color */
+    themeColor: string;
+    /** Background color */
+    backgroundColor: string;
+    /** Display mode */
+    display: 'standalone' | 'fullscreen' | 'minimal-ui' | 'browser';
+    /** Orientation */
+    orientation: 'any' | 'portrait' | 'landscape';
+    /** Start URL */
+    startUrl: string;
+    /** Sizes to generate */
+    sizes: FaviconSize[];
+    /** Generate manifest.json */
+    generateManifest: boolean;
+    /** Generate browserconfig.xml (Windows) */
+    generateBrowserConfig: boolean;
+    /** Output configuration */
+    output: FaviconOutputConfig;
+}
+/**
+ * Favicon sizes to generate.
+ */
+export interface FaviconSize {
+    /** Width */
+    width: number;
+    /** Height */
+    height: number;
+    /** Purpose */
+    purpose: 'any' | 'maskable' | 'monochrome' | 'favicon' | 'apple-touch';
+    /** Filename */
+    filename?: string;
+    /** Format */
+    format: 'png' | 'ico' | 'svg';
+}
+/**
+ * Standard favicon sizes.
+ */
+export declare const STANDARD_FAVICON_SIZES: FaviconSize[];
+/**
+ * Favicon output configuration.
+ */
+export interface FaviconOutputConfig {
+    /** Output directory */
+    outputDir: string;
+    /** Base path for URLs */
+    basePath: string;
+    /** Generate HTML link tags */
+    generateHtml: boolean;
+    /** Generate meta tags */
+    generateMeta: boolean;
+}
+/**
+ * Generated favicon result.
+ */
+export interface FaviconGenerationResult {
+    /** Generated files */
+    files: GeneratedFile[];
+    /** HTML to include */
+    html: string;
+    /** manifest.json content */
+    manifest?: Record<string, unknown>;
+    /** browserconfig.xml content */
+    browserConfig?: string;
+}
+/**
+ * Generated file information.
+ */
+export interface GeneratedFile {
+    /** Filename */
+    filename: string;
+    /** File path */
+    path: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    mimeType: string;
+    /** Dimensions if image */
+    dimensions?: {
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Framework-specific icon component configuration.
+ */
+export interface FrameworkIconConfig {
+    /** Component name */
+    componentName: string;
+    /** File extension */
+    fileExtension: string;
+    /** Import style */
+    importStyle: 'named' | 'default' | 'namespace';
+    /** Props interface name */
+    propsInterfaceName: string;
+    /** Supports tree-shaking */
+    treeShakeable: boolean;
+    /** SSR support */
+    ssrSupport: boolean;
+    /** TypeScript support */
+    typeScriptSupport: boolean;
+}
+/**
+ * React icon component props.
+ */
+export interface ReactIconProps {
+    /** Icon size */
+    size?: IconSize | number;
+    /** Icon color */
+    color?: string;
+    /** Additional class names */
+    className?: string;
+    /** Inline styles */
+    style?: React.CSSProperties;
+    /** Title for accessibility */
+    title?: string;
+    /** Description for accessibility */
+    desc?: string;
+    /** Whether icon is decorative (aria-hidden) */
+    decorative?: boolean;
+    /** Animation */
+    animation?: IconAnimationType;
+    /** Animation duration */
+    animationDuration?: number;
+    /** onClick handler */
+    onClick?: (event: React.MouseEvent) => void;
+}
+/**
+ * Vue icon component props.
+ */
+export interface VueIconProps {
+    /** Icon size */
+    size?: IconSize | number;
+    /** Icon color */
+    color?: string;
+    /** Additional class names */
+    class?: string;
+    /** Title for accessibility */
+    title?: string;
+    /** Animation */
+    animation?: IconAnimationType;
+}
+/**
+ * Angular icon component inputs.
+ */
+export interface AngularIconInputs {
+    /** Icon name */
+    name: string;
+    /** Icon size */
+    size: IconSize | number;
+    /** Icon color */
+    color: string;
+    /** Title for accessibility */
+    title: string;
+    /** Animation */
+    animation: IconAnimationType;
+}
+/**
+ * Web Component (Lit) icon properties.
+ */
+export interface WebComponentIconProps {
+    /** Icon name */
+    name: string;
+    /** Icon size */
+    size: IconSize | number;
+    /** Icon color */
+    color: string;
+    /** Title for accessibility */
+    title: string;
+}
+/**
+ * Blazor icon parameters.
+ */
+export interface BlazorIconParameters {
+    /** Icon name */
+    Name: string;
+    /** Icon size */
+    Size: IconSize | number;
+    /** Icon color */
+    Color: string;
+    /** CSS class */
+    CssClass: string;
+    /** Title for accessibility */
+    Title: string;
+}
+/**
+ * Flutter IconData equivalent.
+ */
+export interface FlutterIconData {
+    /** Codepoint */
+    codePoint: number;
+    /** Font family */
+    fontFamily: string;
+    /** Font package */
+    fontPackage: string;
+    /** Match text direction */
+    matchTextDirection: boolean;
+}
+/**
+ * Figma plugin configuration.
+ */
+export interface FigmaPluginConfig {
+    /** Plugin ID */
+    pluginId: string;
+    /** Sync configuration */
+    sync: FigmaSyncConfig;
+    /** Insert options */
+    insertOptions: FigmaInsertOptions;
+}
+/**
+ * Figma sync configuration.
+ */
+export interface FigmaSyncConfig {
+    /** Auto-sync enabled */
+    autoSync: boolean;
+    /** Sync interval in minutes */
+    syncInterval: number;
+    /** Which collections to sync */
+    collections: string[];
+    /** Sync direction */
+    direction: 'push' | 'pull' | 'both';
+}
+/**
+ * Figma insert options.
+ */
+export interface FigmaInsertOptions {
+    /** Insert as component */
+    asComponent: boolean;
+    /** Auto-layout */
+    autoLayout: boolean;
+    /** Default size */
+    defaultSize: number;
+    /** Maintain aspect ratio */
+    maintainAspectRatio: boolean;
+}
+/**
+ * Sketch plugin configuration.
+ */
+export interface SketchPluginConfig {
+    /** Plugin identifier */
+    identifier: string;
+    /** Library configuration */
+    library: SketchLibraryConfig;
+}
+/**
+ * Sketch library configuration.
+ */
+export interface SketchLibraryConfig {
+    /** Library name */
+    name: string;
+    /** Library path */
+    path: string;
+    /** Auto-update */
+    autoUpdate: boolean;
+}
+/**
+ * Icon analytics configuration.
+ */
+export interface IconAnalyticsConfig {
+    /** Enable analytics */
+    enabled: boolean;
+    /** Track usage */
+    trackUsage: boolean;
+    /** Track searches */
+    trackSearches: boolean;
+    /** Retention days */
+    retentionDays: number;
+    /** Anonymize data */
+    anonymize: boolean;
+}
+/**
+ * Icon analytics dashboard data.
+ */
+export interface IconAnalyticsDashboard {
+    /** Time period */
+    period: {
+        start: string;
+        end: string;
+    };
+    /** Total icons used */
+    totalIconsUsed: number;
+    /** Unique icons used */
+    uniqueIconsUsed: number;
+    /** Most used icons */
+    mostUsed: IconUsageStats[];
+    /** Least used icons */
+    leastUsed: IconUsageStats[];
+    /** Unused icons */
+    unusedIcons: string[];
+    /** Search analytics */
+    searchAnalytics: SearchAnalytics;
+    /** Missing icon requests */
+    missingIconRequests: MissingIconRequest[];
+}
+/**
+ * Search analytics data.
+ */
+export interface SearchAnalytics {
+    /** Total searches */
+    totalSearches: number;
+    /** Unique queries */
+    uniqueQueries: number;
+    /** Top queries */
+    topQueries: {
+        query: string;
+        count: number;
+    }[];
+    /** Zero-result queries */
+    zeroResultQueries: {
+        query: string;
+        count: number;
+    }[];
+    /** Average results per search */
+    avgResultsPerSearch: number;
+    /** Click-through rate */
+    clickThroughRate: number;
+}
+/**
+ * Missing icon request.
+ */
+export interface MissingIconRequest {
+    /** Requested icon name/description */
+    request: string;
+    /** Number of times requested */
+    count: number;
+    /** First requested date */
+    firstRequested: string;
+    /** Users who requested */
+    userCount: number;
+    /** Suggested alternatives */
+    suggestedAlternatives?: string[];
+}
+/**
+ * Cursor icon definition.
+ */
+export interface CursorIconDefinition extends IconDefinition {
+    /** Cursor type */
+    cursorType: CursorType;
+    /** Hotspot X coordinate */
+    hotspotX: number;
+    /** Hotspot Y coordinate */
+    hotspotY: number;
+    /** Animation frames (for animated cursors) */
+    frames?: CursorFrame[];
+    /** Frame rate for animation */
+    frameRate?: number;
+}
+/**
+ * Standard cursor types.
+ */
+export type CursorType = 'pointer' | 'crosshair' | 'move' | 'resize-n' | 'resize-s' | 'resize-e' | 'resize-w' | 'resize-ne' | 'resize-nw' | 'resize-se' | 'resize-sw' | 'resize-ns' | 'resize-ew' | 'resize-nesw' | 'resize-nwse' | 'text' | 'cell' | 'grab' | 'grabbing' | 'zoom-in' | 'zoom-out' | 'rotate' | 'draw' | 'brush' | 'eraser' | 'eyedropper' | 'bucket' | 'pen' | 'line' | 'rectangle' | 'ellipse' | 'wait' | 'progress' | 'not-allowed' | 'help' | 'context-menu' | 'custom';
+/**
+ * Cursor animation frame.
+ */
+export interface CursorFrame {
+    /** Frame icon/image */
+    icon: IconDefinition;
+    /** Frame duration in ms */
+    duration: number;
+}
+/**
+ * Desktop/high-DPI icon configuration.
+ */
+export interface DesktopIconConfig {
+    /** Base icon */
+    baseIcon: IconDefinition;
+    /** Sizes to generate */
+    sizes: IconSizePixels[];
+    /** High-DPI scales */
+    scales: (1 | 1.5 | 2 | 3 | 4)[];
+    /** Platform-specific exports */
+    platforms: DesktopIconPlatform[];
+}
+/**
+ * Desktop platform targets.
+ */
+export interface DesktopIconPlatform {
+    /** Platform name */
+    platform: 'windows' | 'macos' | 'linux';
+    /** Format */
+    format: 'ico' | 'icns' | 'png';
+    /** Sizes for this platform */
+    sizes: IconSizePixels[];
+    /** Output filename */
+    filename: string;
+}
+/**
+ * Windows ICO file generation.
+ */
+export interface WindowsIcoConfig {
+    /** Sizes to include */
+    sizes: (16 | 32 | 48 | 64 | 128 | 256)[];
+    /** Include 256-color versions */
+    include256Color: boolean;
+    /** Compression */
+    compress: boolean;
+}
+/**
+ * macOS ICNS file generation.
+ */
+export interface MacOSIcnsConfig {
+    /** Sizes to include */
+    sizes: (16 | 32 | 64 | 128 | 256 | 512 | 1024)[];
+    /** Include @2x versions */
+    includeRetina: boolean;
+}
+/**
+ * Thematic icon package definition.
+ */
+export interface ThematicIconPackage {
+    /** Package name */
+    name: string;
+    /** npm package name */
+    npmName: string;
+    /** Description */
+    description: string;
+    /** Total icon count */
+    iconCount: number;
+    /** Categories included */
+    categories: string[];
+    /** Domains covered */
+    domains: DomainCategory[];
+    /** Dependencies on other packages */
+    dependencies: string[];
+    /** Version */
+    version: string;
+}
+/**
+ * Available thematic packages.
+ */
+export declare const THEMATIC_PACKAGES: ThematicIconPackage[];
+//# sourceMappingURL=icon-tools.d.ts.map