import { ImageMeta } from './image-meta'; /** * 模板入参类型: * - `string`:被解释为 base64(识别为 base64 形式)或文件路径(识别为路径形式) * - `Buffer`:图像字节流(PNG / JPG / BMP),自动转 base64 */ export type Template = string | Buffer; /** resolveTemplate 返回结果,含 base64 + 可选 meta */ export interface ResolvedTemplate { base64: string; meta: ImageMeta | null; } /** * 规范化模板入参为 base64 字符串 + meta 信息。 * * 启发式: * 1. `Buffer` → 直接 `toString('base64')`,无 meta * 2. 字符串带路径分隔符或图像扩展名 → 读文件 + 加载同名 .meta.json * 3. 字符串纯 base64 字符 → 直接返回,无 meta * 4. 其它(包含空格 / 非法字符)→ 抛错 * * @throws Error 当入参既非合法 base64 也非可读文件路径 */ export declare function resolveTemplate(t: Template): Promise;