/**
 * DOCX reader — comments parsers.
 *
 * Split out from `docx-reader.ts` to keep that file's part-orchestration
 * scope manageable. We accept `parseParagraph` as an injected dependency
 * because the body paragraph parser still lives in `docx-reader.ts` (it
 * has many cross-references that would not be cheap to disentangle); a
 * direct import would form a cycle.
 */
import type { XmlElement } from "../../xml/types.js";
import type { CommentDef, Paragraph } from "../types.js";
import { type ReaderContext } from "./reader-context.js";
/** Parse `word/comments.xml` into a list of CommentDef. */
export declare function parseCommentsXml(xmlStr: string, ctx: ReaderContext, parseParagraph: (el: XmlElement, ctx: ReaderContext) => Paragraph): CommentDef[];
/**
 * Parse `word/commentsExtended.xml` into a paraId → metadata map.
 *
 * Modern Word stores comment "resolved" state and reply threading in a
 * sidecar part keyed by the paragraph id of each comment's first
 * paragraph. The reader merges this map into `CommentDef.done` /
 * `CommentDef.parentId` once both parts have been parsed.
 */
export declare function parseCommentsExtendedXml(xmlStr: string): Map<string, {
    done?: boolean;
    parentId?: string;
}>;