/**
 * DesignSystemError
 *
 * Unified error class for the design system package.
 * Provides consistent error handling with error codes and context.
 */
export declare class DesignSystemError extends Error {
    /**
     * Error code for categorization
     */
    readonly code: string;
    /**
     * Additional context about the error
     */
    readonly context?: Record<string, any>;
    /**
     * Timestamp when error was created
     */
    readonly timestamp: Date;
    /**
     * Error category for grouping
     */
    readonly category: ErrorCategory;
    /**
     * Operation that failed
     */
    readonly operation?: string;
    /**
     * Original error cause
     */
    readonly cause?: unknown;
    /**
     * Whether operation can be retried
     */
    readonly retryable: boolean;
    constructor(message: string, code: string, context?: Record<string, any>, metadata?: ErrorMetadata);
    /**
     * Convert error to JSON for logging/debugging
     */
    toJSON(): Record<string, any>;
    /**
     * Get user-friendly error message
     */
    getUserMessage(): string;
}
/**
 * Common error codes used across the design system
 */
export declare const ErrorCodes: {
    readonly FILE_NOT_FOUND: "FILE_NOT_FOUND";
    readonly FILE_READ_ERROR: "FILE_READ_ERROR";
    readonly FILE_WRITE_ERROR: "FILE_WRITE_ERROR";
    readonly FILE_DELETE_ERROR: "FILE_DELETE_ERROR";
    readonly DIRECTORY_CREATE_ERROR: "DIRECTORY_CREATE_ERROR";
    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
    readonly STORAGE_FULL: "STORAGE_FULL";
    readonly NETWORK_ERROR: "NETWORK_ERROR";
    readonly TIMEOUT_ERROR: "TIMEOUT_ERROR";
    readonly API_ERROR: "API_ERROR";
    readonly MEDIA_PICKER_ERROR: "MEDIA_PICKER_ERROR";
    readonly MEDIA_SAVE_ERROR: "MEDIA_SAVE_ERROR";
    readonly IMAGE_LOAD_ERROR: "IMAGE_LOAD_ERROR";
    readonly CACHE_ERROR: "CACHE_ERROR";
    readonly STORAGE_ERROR: "STORAGE_ERROR";
    readonly INVALID_INPUT: "INVALID_INPUT";
    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
    readonly THEME_LOAD_ERROR: "THEME_LOAD_ERROR";
    readonly THEME_SAVE_ERROR: "THEME_SAVE_ERROR";
    readonly UNKNOWN_ERROR: "UNKNOWN_ERROR";
    readonly INITIALIZATION_ERROR: "INITIALIZATION_ERROR";
};
export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
/**
 * Error Categories for grouping related errors
 */
export declare enum ErrorCategory {
    FILESYSTEM = "FILESYSTEM",
    NETWORK = "NETWORK",
    MEDIA = "MEDIA",
    STORAGE = "STORAGE",
    CACHE = "CACHE",
    IMAGE = "IMAGE",
    VALIDATION = "VALIDATION",
    THEME = "THEME",
    PERMISSION = "PERMISSION",
    INITIALIZATION = "INITIALIZATION",
    UNKNOWN = "UNKNOWN"
}
/**
 * Error metadata for rich context
 */
export interface ErrorMetadata {
    category?: ErrorCategory;
    operation?: string;
    key?: string;
    cause?: unknown;
    retryable?: boolean;
    userMessage?: string;
}