/**
 * Chat 消息标记语法解析工具。
 *
 * 关键点（中文）
 * - 统一处理 frontmatter metadata 与 `<file>` 附件标签。
 * - 解析结果保留 `segments[]`，用于按正文与附件的真实顺序发送。
 */
import type { ChatMessageFileTag, ChatMessageFileType, ChatMessageSegment, ParsedChatMessageMarkup } from "./ChatMessageMarkupTypes.js";
/**
 * 归一化附件类型。
 */
export declare function normalize_chat_message_file_type(value: unknown): ChatMessageFileType;
/**
 * 提取 frontmatter metadata。
 */
export declare function extract_chat_message_frontmatter(params: {
    source: string;
}): {
    metadata: Record<string, unknown>;
    body: string;
};
/**
 * 提取 `<file>` 标签，并保留正文/附件的真实顺序。
 */
export declare function extract_chat_message_segments(source: string): ChatMessageSegment[];
/**
 * 提取 `<file>` 标签列表。
 */
export declare function extract_chat_message_file_tags(source: string): ChatMessageFileTag[];
/**
 * 移除正文中的 `<file>` 标签，仅保留文本段。
 */
export declare function strip_chat_message_file_tags(source: string): string;
/**
 * 渲染一条标准化 `<file>` 标签。
 */
export declare function render_chat_message_file_tag(file: ChatMessageFileTag): string;
/**
 * 把附件列表渲染回统一的 `<file>` 文本块。
 */
export declare function build_chat_message_file_block(files: ChatMessageFileTag[]): string;
/**
 * 把片段重建成统一消息文本。
 */
export declare function build_chat_message_text(params: {
    body_text?: string;
    files?: ChatMessageFileTag[];
    segments?: ChatMessageSegment[];
}): string;
/**
 * 统一解析一段 chat 消息文本。
 */
export declare function parse_chat_message_markup(source: string): ParsedChatMessageMarkup;
//# sourceMappingURL=ChatMessageMarkup.d.ts.map