import * as React from "react";
export interface TOCItem {
    id: string;
    label: string;
    level: number;
    children?: TOCItem[];
}
export interface TableOfContentsProps extends React.HTMLAttributes<HTMLDivElement> {
    /**
     * Manual TOC items array
     */
    items?: TOCItem[];
    /**
     * Auto-detect headings from the page
     */
    autoDetect?: boolean;
    /**
     * CSS selector for headings to detect
     */
    headingSelector?: string;
    /**
     * Container element, ref, or selector to scope heading detection.
     * If provided, only headings within this container will be detected.
     * If not provided, searches the entire document (useful for full-page documents).
     */
    container?: HTMLElement | React.RefObject<HTMLElement | null> | string | null;
    /**
     * Scroll container element, ref, or selector for actual scrolling.
     * If not provided, uses the container prop or falls back to window scroll.
     * Useful when heading detection container is different from scroll container.
     */
    scrollContainer?: HTMLElement | React.RefObject<HTMLElement | null> | string | null;
    /**
     * Controlled active section ID (overrides scroll spy)
     */
    activeId?: string;
    /**
     * Callback when active section changes
     */
    onActiveChange?: (id: string | null) => void;
    /**
     * Offset for scroll positioning (useful for fixed headers)
     */
    scrollOffset?: number;
    /**
     * Enable smooth scrolling
     */
    smoothScroll?: boolean;
    /**
     * Enable automatic scroll spy
     */
    enableScrollSpy?: boolean;
    /**
     * Title to display above TOC
     */
    title?: string;
    /**
     * Visual variant of the TOC
     * - normal: Fumadocs-style with left border and animated thumb indicator
     * - circuit: Clerk-style with continuous line structure (simple linear paths)
     * - clerk: Enhanced Clerk-style with smooth corner radius and quadratic curves
     */
    variant?: "normal" | "circuit" | "clerk";
}
/**
 * Enhanced Table of Contents component with auto-detection and scroll spy
 *
 * Supports two visual variants:
 * - normal: Fumadocs-style with left border and animated thumb indicator
 * - circuit: Clerk-style with continuous line structure and SVG path
 *
 * Features:
 * - Auto-detect headings from DOM or accept manual items
 * - Scroll spy to highlight active section
 * - Smooth scrolling to sections
 * - Support for fixed headers with scroll offset
 *
 * @example
 * ```tsx
 * <TableOfContents autoDetect headingSelector="h2, h3" enableScrollSpy />
 * <TableOfContents variant="circuit" items={tocItems} />
 * ```
 */
declare const TableOfContents: React.ForwardRefExoticComponent<TableOfContentsProps & React.RefAttributes<HTMLDivElement>>;
export { TableOfContents };
//# sourceMappingURL=table-of-contents.d.ts.map