import type { DocHeading, DocHeadingTree } from "./types.js";
export type { DocHeadingTree };
/**
 * Generate a Markdown-formatted table of contents from a document's heading hierarchy.
 *
 * @param projectRoot - Trusted project root.
 * @param filePath - Project-root-relative file path.
 * @returns Markdown TOC string with depth-based indentation.
 */
export declare function generateToc(projectRoot: string, filePath: string): string;
/**
 * Generate a heading outline returning both flat list and tree structure.
 *
 * @param projectRoot - Trusted project root.
 * @param filePath - Project-root-relative file path.
 * @returns Object with flat heading list and nested tree structure.
 */
export declare function generateOutline(projectRoot: string, filePath: string): {
    flat: DocHeading[];
    tree: DocHeadingTree[];
};
/**
 * Build a heading tree where children are nested under their parent headings.
 *
 * @param headings - Flat heading list in source order.
 * @returns Headings with nested structure via children arrays.
 */
export declare function buildHeadingTree(headings: DocHeading[]): DocHeadingTree[];
//# sourceMappingURL=hierarchy-ops.d.ts.map