import { AssetKind } from './assets.js';
/** What a missing asset is, in the terms an author would recognise. */
export interface MissingAsset {
    kind: AssetKind;
    /**
     * For generated assets, the producing tool — `latex-image`, `sageplot`,
     * `asymptote`, `prefigure` — which under managed directories is literally
     * the first path segment, and is also the `pretext generate` target. For
     * external assets, a coarse media word derived from the extension.
     */
    assetType: string;
    /** Basename, for display. */
    fileName: string;
}
/**
 * Classify an asset path. Generated paths are `<tool>/<name>` under managed
 * directories; a path with no directory segment predates that scheme, so there
 * is no tool name to report.
 */
export declare function describeAsset(kind: AssetKind, relPath: string): MissingAsset;
/** Render the placeholder as standalone SVG markup. */
export declare function missingAssetSvg(asset: MissingAsset): string;
/**
 * The placeholder as a `data:` URI, ready to drop into an `img` `src`.
 *
 * Percent-encoded rather than base64 so the `data-ptx-missing` marker stays
 * greppable in the emitted page (see the module comment), and so the payload
 * stays readable when someone views source. Only the characters that would
 * break a URI or an HTML attribute are escaped.
 */
export declare function missingAssetPlaceholder(kind: AssetKind, relPath: string): string;