/**
 * Cache key generation utilities for DocShell
 *
 * Cache key should change when output could change:
 * - absolute path + mtime_ns + size
 * - converter id/version
 * - normalization version
 * - config knobs that affect output
 */
import type { CacheKey, DocShellConfig } from '../types/index.js';
export declare const NORM_VERSION = "1.0.0";
/**
 * Get extractor signature for a file type
 */
export declare function getExtractorSig(filepath: string): string;
/**
 * Generate config signature for cache key
 */
export declare function getConfigSig(config: DocShellConfig, filepath: string): string;
/**
 * Generate cache key for a file
 */
export declare function generateCacheKey(filepath: string, config: DocShellConfig): CacheKey;
/**
 * Convert cache key to hash for blob filename
 */
export declare function cacheKeyToHash(key: CacheKey): string;
/**
 * Check if a cache key matches a file's current state
 */
export declare function isCacheKeyValid(key: CacheKey, filepath: string, config: DocShellConfig): boolean;