import type { LegacyComment } from './comments';
/** Parse a `xl/commentsN.xml` payload into a flat LegacyComment list. */
export declare function parseCommentsXml(bytes: Uint8Array | string): LegacyComment[];
/**
 * Serialise a LegacyComment array to a `xl/commentsN.xml` payload. Authors are
 * deduped: each unique `author` becomes one `<author>` entry, and comments
 * reference it by index.
 */
export declare function commentsToBytes(comments: ReadonlyArray<LegacyComment>): Uint8Array;
export declare function serializeComments(comments: ReadonlyArray<LegacyComment>): string;
/**
 * Bare-bones VML drawing payload Excel tolerates as a comment-shape
 * placeholder. We don't preserve the original VML shapes (stage-1 trade-off);
 * this stub guarantees the worksheet rels stay consistent.
 *
 * Excel won't open the file unless every legacy comment is paired with a
 * `<v:shape>` carrying `<x:ClientData ObjectType="Note">` plus the cell anchor
 * row/column — without those, Excel reports "removed Records: Comment from
 * /xl/comments1.xml" and silently drops them.
 *
 * The `<v:shapetype id="_x0000_t202">` / `<v:shape type="#_x0000_t202">` pair
 * mirrors what openpyxl's ShapeWriter emits.
 */
export declare function placeholderVmlDrawing(comments?: ReadonlyArray<LegacyComment>): Uint8Array;