/** 与 Vite transform `map` 字段兼容的 decoded JSON source map。 */
export interface RawSourceMapJson {
    version?: number;
    mappings: string;
    sources?: string[];
    sourcesContent?: (string | null)[];
    names?: string[];
    file?: string;
    sourceRoot?: string;
}
export declare function normalizeSourceMapInput(map: unknown): RawSourceMapJson | null;
/**
 * 自左向右：maps[0] 为「最新一步」产物 → 上一步；maps[last] 为第一步输入（通常为 Vite 传入的模块文本）。
 * 与 `@ampproject/remapping` 约定一致。
 */
export declare function composeVitePluginSourceMaps(maps: (RawSourceMapJson | null | undefined)[]): RawSourceMapJson | null;
/** 将本插件产出 map（输出 → 当前 transform 输入）再接上 Vite 传入的 combined map（输入 → 更上游源码）。 */
export declare function appendUpstreamSourceMap(pluginMap: RawSourceMapJson | null | undefined, viteCombined: unknown): RawSourceMapJson | null;