/**
 * @file Console divider and separator utilities. Provides various line styles
 *   for visual separation in CLI output.
 */
export interface DividerOptions {
    /**
     * Width of the divider line in characters.
     *
     * @default 55
     */
    width?: number | undefined;
    /**
     * Character to repeat for the divider line.
     *
     * @default '═'
     */
    char?: string | undefined;
    /**
     * Optional color function to apply to the divider. Accepts a function from
     * `yoctocolors` or similar.
     */
    color?: ((text: string) => string) | undefined;
}
/**
 * Create a divider line with custom character and width. Returns a string of
 * repeated characters for visual separation.
 *
 * @example
 *   ;```ts
 *   console.log(divider()) // Default: 55 '═' characters
 *   console.log(divider({ char: '-', width: 40 }))
 *   console.log(divider({ char: '·', width: 30 }))
 *   ```
 *
 * @param options - Divider formatting options.
 *
 * @returns Divider string
 */
export declare function divider(options?: DividerOptions): string;
/**
 * Common divider style presets. Provides quick access to popular divider
 * styles.
 *
 * @example
 *   ;```ts
 *   console.log(dividers.thick()) // ═══════...
 *   console.log(dividers.thin()) // ───────...
 *   console.log(dividers.dotted()) // ·······...
 *   ```
 */
export declare const dividers: {
    /**
     * Thick double-line divider using `═`
     */
    readonly thick: () => string;
    /**
     * Thin single-line divider using `─`
     */
    readonly thin: () => string;
    /**
     * Double-line divider (alias for thick)
     */
    readonly double: () => string;
    /**
     * Simple single dash divider using `-`
     */
    readonly single: () => string;
    /**
     * Dotted divider using `·`
     */
    readonly dotted: () => string;
    /**
     * Dashed divider using `╌`
     */
    readonly dashed: () => string;
    /**
     * Wave divider using `~`
     */
    readonly wave: () => string;
    /**
     * Star divider using `*`
     */
    readonly star: () => string;
    /**
     * Diamond divider using `◆`
     */
    readonly diamond: () => string;
    /**
     * Arrow divider using `→`
     */
    readonly arrow: () => string;
};
/**
 * Print a divider line directly to console.
 *
 * @example
 *   ;```ts
 *   printDivider() // Prints default divider
 *   printDivider({ char: '─', width: 60 })
 *   ```
 *
 * @param options - Divider formatting options.
 */
export declare function printDivider(options?: DividerOptions): void;
/**
 * Print a dotted divider line. Convenience function using `·` character.
 *
 * @example
 *   ;```ts
 *   printDottedDivider()
 *   // ·······················································
 *   ```
 */
export declare function printDottedDivider(): void;
/**
 * Print a section break with spacing directly to console.
 *
 * @example
 *   ;```ts
 *   console.log('Previous section')
 *   printSectionBreak()
 *   console.log('Next section')
 *   ```
 *
 * @param options - Divider formatting options.
 */
export declare function printSectionBreak(options?: DividerOptions): void;
/**
 * Print a thick divider line (default style). Convenience function using `═`
 * character.
 *
 * @example
 *   ;```ts
 *   printThickDivider()
 *   // ═══════════════════════════════════════════════════
 *   ```
 */
export declare function printThickDivider(): void;
/**
 * Print a thin divider line. Convenience function using `─` character.
 *
 * @example
 *   ;```ts
 *   printThinDivider()
 *   // ───────────────────────────────────────────────────
 *   ```
 */
export declare function printThinDivider(): void;
/**
 * Create a section break with blank lines before and after the divider. Useful
 * for creating visual separation between major sections.
 *
 * @example
 *   ;```ts
 *   console.log('Previous section')
 *   console.log(sectionBreak())
 *   console.log('Next section')
 *   // Output:
 *   // Previous section
 *   //
 *   // ═══════════════════════════════════════════════════
 *   //
 *   // Next section
 *   ```
 *
 * @param options - Divider formatting options.
 *
 * @returns Section break string with newlines
 */
export declare function sectionBreak(options?: DividerOptions): string;
