/**
 * Documentation layer.
 *
 * {@link describeAssets} mutates each asset's `.description` in place using the
 * deterministic {@link heuristicDescribe} (AST/metadata only — no network, no
 * API keys). `onProgress(done, total)` fires after each asset is described.
 */
import type { Asset } from '../core/types';
/**
 * Describe every asset, mutating `asset.description` in place via the heuristic.
 * `onProgress(done, total)` fires after each asset is described.
 */
export declare function describeAssets(assets: Asset[], onProgress?: (done: number, total: number) => void): Promise<void>;