export interface CacheStored<T = any> {
    v: string;
    ts: number;
    ttl: number;
    t: 'data' | 'markup';
    data: T;
    meta?: Record<string, any>;
}
export interface CacheGetResult<T = any> {
    data?: T;
    meta?: Record<string, any>;
    isExpired: boolean;
    isStale: boolean;
    ageMs: number;
    raw?: CacheStored<T>;
}
export interface CacheEventDetail {
    action: 'hit' | 'miss' | 'stale' | 'set' | 'purge' | 'error' | 'evict';
    key: string;
    namespace: string;
    info?: any;
}
interface CreateCacheOptions {
    namespace: string;
    version?: string;
    storage?: 'local' | 'session' | 'memory';
    prefix?: string;
    defaultTTL?: number;
    staleTTL?: number;
    maxEntries?: number;
    maxValueBytes?: number;
    serialize?: (v: any) => string;
    deserialize?: (s: string) => any;
    dispatchEvents?: boolean;
    target?: HTMLElement | Window;
}
interface GetOrSetOptions<T = any> {
    ttl?: number;
    meta?: Record<string, any>;
    staleWhileRevalidate?: boolean;
    type?: 'data' | 'markup';
    transform?: (fresh: any) => T;
}
export declare function createCache(options: CreateCacheOptions): {
    buildKey: (type: "data" | "markup", params: Record<string, any>) => string;
    get: <T>(key: string) => CacheGetResult<T>;
    set: <T>(key: string, type: "data" | "markup", data: T, cfg?: {
        ttl?: number;
        meta?: Record<string, any>;
    }) => void;
    getOrSet: <T>(key: string, type: "data" | "markup", fetcher: () => Promise<T>, opts?: GetOrSetOptions<T>) => Promise<T>;
    refresh: <T>(key: string, type: "data" | "markup", fetcher: () => Promise<T>, opts?: GetOrSetOptions<T>) => Promise<T>;
    purge: (key: string) => void;
    purgePattern: (pattern: RegExp | ((k: string) => boolean)) => void;
    clearNamespace: () => void;
    inflight: Map<string, Promise<any>>;
    keyForData: (params: Record<string, any>) => string;
    getData: <T>(params: Record<string, any>) => CacheGetResult<T>;
    setData: <T>(params: Record<string, any>, data: T, cfg?: {
        ttl?: number;
        meta?: Record<string, any>;
    }) => void;
    getOrSetData: <T>(params: Record<string, any>, fetcher: () => Promise<T>, opts?: GetOrSetOptions<T>) => Promise<T>;
    keyForMarkup: (params: Record<string, any>) => string;
    getMarkup: (params: Record<string, any>) => CacheGetResult<string>;
    setMarkup: (params: Record<string, any>, html: string, cfg?: {
        ttl?: number;
        meta?: Record<string, any>;
    }) => void;
    getOrSetMarkup: (params: Record<string, any>, producer: () => Promise<string>, opts?: GetOrSetOptions<string>) => Promise<string>;
};
export {};