import { SheetComment } from '../core/ir/sheet.js';
/**
 * Parse a legacy `xl/comments#.xml` part (§18.7.3/§18.7.6) into {@link SheetComment}s.
 * `authorId` indexes the `<authors>` list; the text is rich (`<r><t>`) so it
 * flattens like a shared string. Excel stores a bold "Author:\n" run at the head
 * of the text — stripped here so the resolved author is not shown twice.
 */
export declare function parseLegacyComments(data: Uint8Array): Array<SheetComment>;
/**
 * Parse `xl/persons/person.xml` into an `id → displayName` map, used to resolve
 * the authors of threaded comments.
 */
export declare function parsePersons(data: Uint8Array): Map<string, string>;
/**
 * Parse a modern `xl/threadedComments/threadedComment#.xml` part (a conversation)
 * into {@link SheetComment}s. Each entry is one message (replies share the `ref`);
 * `personId` resolves through `persons`. Entries are returned in document order so
 * a thread reads top to bottom.
 *
 * @param data    The threaded-comments part bytes.
 * @param persons The `id → displayName` map from {@link parsePersons}.
 */
export declare function parseThreadedComments(data: Uint8Array, persons: ReadonlyMap<string, string>): Array<SheetComment>;