import { Parent, RootContent, Root, Definition, FootnoteDefinition } from 'mdast';
import { Extension } from 'micromark-util-types';
import { Extension as Extension$1 } from 'mdast-util-from-markdown';

declare module 'mdast' {
    interface RootContentMap {
        htmlElement: HtmlElementNode;
    }
    interface PhrasingContentMap {
        htmlElement: HtmlElementNode;
    }
}
/**
 * 自定义 HTML 元素节点类型
 */
interface HtmlElementNode extends Parent {
    type: 'htmlElement';
    tagName: string;
    attrs: Record<string, string>;
    children: RootContent[];
    data?: {
        rawHtml?: string;
        parsed?: boolean;
        originalType?: string;
    };
}
/**
 * HTML 树扩展配置
 */
interface HtmlTreeExtensionOptions {
    /**
     * 标签黑名单 - 这些标签会被过滤掉（XSS 防护）
     * 默认包含危险标签：script, style, iframe, object, embed, form, input, button, textarea, select
     */
    tagBlacklist?: string[];
    /**
     * 属性黑名单 - 这些属性会被过滤掉（XSS 防护）
     * 默认包含所有 on* 事件属性和 javascript: 协议
     */
    attrBlacklist?: string[];
    /**
     * 协议黑名单 - URL 属性中禁止的协议
     * 默认包含 javascript:, vbscript:, data: (允许 data:image/)
     */
    protocolBlacklist?: string[];
    /**
     * 是否保留原始 HTML 在 data 中
     * 默认为 true
     */
    preserveRawHtml?: boolean;
    /**
     * 自定义标签处理器
     * 可以对特定标签进行自定义处理
     */
    tagHandlers?: Record<string, (node: HtmlElementNode) => HtmlElementNode | null>;
}

/**
 * Definition 映射类型
 */
interface DefinitionMap {
    [identifier: string]: Definition;
}
interface FootnoteDefinitionMap {
    [identifier: string]: FootnoteDefinition;
}
/**
 * 解析块的状态
 */
type BlockStatus = 'pending' | 'completed';
/**
 * AST 节点的通用接口（用于遍历）
 * 统一定义，避免各模块重复声明
 */
interface AstNode {
    type: string;
    value?: string;
    children?: AstNode[];
    [key: string]: unknown;
}
/**
 * 解析出的块
 */
interface ParsedBlock {
    /** 块的唯一 ID */
    id: string;
    /** 块状态 */
    status: BlockStatus;
    /** AST 节点 */
    node: RootContent;
    /** 原始文本起始位置（相对于完整文档） */
    startOffset: number;
    /** 原始文本结束位置 */
    endOffset: number;
    /** 原始文本内容 */
    rawText: string;
}
/**
 * 增量更新事件
 */
interface IncrementalUpdate {
    /** 新完成的块 */
    completed: ParsedBlock[];
    /** 更新的块（内容变化） */
    updated: ParsedBlock[];
    /** 当前正在解析中的块（可能不完整） */
    pending: ParsedBlock[];
    /** 完整的 AST（包含所有已解析的内容） */
    ast: Root;
    /** Definition 映射表（用于引用式图片和链接） */
    definitions: DefinitionMap;
    /** Footnote Definition 映射表 */
    footnoteDefinitions: FootnoteDefinitionMap;
    /** 脚注引用的出现顺序（用于渲染时排序） */
    footnoteReferenceOrder: string[];
}
/**
 * 容器语法配置
 */
interface ContainerConfig {
    /** 容器标记字符，默认 ':' */
    marker?: string;
    /** 最小标记长度，默认 3 */
    minMarkerLength?: number;
    /** 允许的容器名称（如 ['warning', 'info', 'youtube']），undefined 表示允许所有 */
    allowedNames?: string[];
}
/**
 * 解析器状态变化事件
 */
interface ParserState {
    /** 已完成的块 */
    completedBlocks: ParsedBlock[];
    /** 待处理的块 */
    pendingBlocks: ParsedBlock[];
    /** 完整的 Markdown 内容 */
    markdown: string;
    /** 完整的 AST */
    ast: Root;
    definitions: DefinitionMap;
    footnoteDefinitions: FootnoteDefinitionMap;
}
/**
 * 数学公式配置选项
 */
interface MathOptions {
    /**
     * 启用 TeX 风格的公式分隔符 (default: `false`)
     *
     * 开启后同时支持：
     * - 行内公式：\(...\)
     * - 块级公式：\[...\]
     *
     * 这是 LaTeX/TeX 原生语法，MathJax 和 KaTeX 都支持。
     * 开启此选项可以兼容从 LaTeX 文档或学术 AI 工具输出的内容。
     *
     * @example
     * ```ts
     * // 启用 TeX 风格分隔符
     * const parser = createIncremarkParser({
     *   math: { tex: true }
     * })
     * ```
     */
    tex?: boolean;
}
/**
 * 解析器配置
 */
interface ParserOptions {
    /** 启用 GFM 扩展（表格、任务列表等） */
    gfm?: boolean;
    /**
     * 启用数学公式支持
     * - false/undefined: 禁用（默认）
     * - true: 启用数学公式解析（仅支持 $...$ 和 $$...$$ 语法）
     * - MathOptions: 启用并配置额外选项（如 LaTeX 风格的 \(...\) 和 \[...\] 语法）
     */
    math?: boolean | MathOptions;
    /**
     * 启用 ::: 容器语法支持（用于边界检测）
     * - false: 禁用（默认）
     * - true: 使用默认配置启用
     * - ContainerConfig: 使用自定义配置启用
     */
    containers?: boolean | ContainerConfig;
    /**
     * 启用 HTML 树转换
     * - false/undefined: 禁用（默认），HTML 节点保持原始 type: 'html' 格式
     * - true: 使用默认配置启用，将 HTML 节点转换为结构化的 htmlElement 节点
     * - HtmlTreeExtensionOptions: 使用自定义配置启用（可配置黑名单等）
     */
    htmlTree?: boolean | HtmlTreeExtensionOptions;
    /** 自定义块边界检测函数 */
    blockBoundaryDetector?: (content: string, position: number) => boolean;
    /** 自定义 micromark 扩展（如 directive） */
    extensions?: Extension[];
    /** 自定义 mdast 扩展（如 directiveFromMarkdown） */
    mdastExtensions?: Extension$1[];
    /** 状态变化回调 */
    onChange?: (state: ParserState) => void;
}
/**
 * 块上下文
 */
interface BlockContext {
    /** 当前是否在代码块中 */
    inFencedCode: boolean;
    /** 代码块的 fence 字符（` 或 ~） */
    fenceChar?: string;
    /** 代码块的 fence 长度 */
    fenceLength?: number;
    /** 当前列表嵌套深度 */
    listDepth: number;
    /** 当前引用嵌套深度 */
    blockquoteDepth: number;
    /** 当前是否在容器块中 */
    inContainer: boolean;
    /** 容器的标记长度 */
    containerMarkerLength?: number;
    /** 容器名称 */
    containerName?: string;
    /** 容器嵌套深度（支持嵌套容器） */
    containerDepth: number;
    /** 当前是否在列表中 */
    inList: boolean;
    /** 当前列表是否是有序列表 */
    listOrdered?: boolean;
    /** 当前列表的基础缩进 */
    listIndent?: number;
    /** 遇到空行后，列表可能结束（等待下一行确认） */
    listMayEnd?: boolean;
    /** 当前是否在脚注定义中 */
    inFootnote?: boolean;
    /** 脚注标识符 */
    footnoteIdentifier?: string;
}
/**
 * 容器检测结果
 */
interface ContainerMatch {
    /** 容器名称 */
    name: string;
    /** 标记长度（冒号数量） */
    markerLength: number;
    /** 是否是结束标记 */
    isEnd: boolean;
}

export type { AstNode as A, BlockStatus as B, ContainerConfig as C, DefinitionMap as D, FootnoteDefinitionMap as F, HtmlTreeExtensionOptions as H, IncrementalUpdate as I, MathOptions as M, ParsedBlock as P, ParserState as a, ParserOptions as b, BlockContext as c, ContainerMatch as d };