import { TNode, Value } from '@tempots/dom';
/**
 * Orientation of the divider line.
 *
 * - `'horizontal'` - Horizontal separator (default)
 * - `'vertical'` - Vertical separator
 */
export type DividerOrientation = 'horizontal' | 'vertical';
/**
 * Visual style variant of the divider line.
 *
 * - `'solid'` - Solid line (default)
 * - `'dashed'` - Dashed line
 * - `'dotted'` - Dotted line
 */
export type DividerVariant = 'solid' | 'dashed' | 'dotted';
/**
 * Visual weight/prominence of the divider.
 *
 * - `'subtle'` - Lighter, less prominent
 * - `'default'` - Standard prominence
 * - `'strong'` - Darker, more prominent
 */
export type DividerTone = 'subtle' | 'default' | 'strong';
/**
 * Alignment of the label text in a labeled divider.
 *
 * - `'left'` - Label aligned to the left
 * - `'center'` - Label centered (default)
 * - `'right'` - Label aligned to the right
 */
export type DividerLabelAlign = 'left' | 'center' | 'right';
/**
 * Configuration options for the {@link Divider} component.
 */
export interface DividerOptions {
    /** Orientation of the divider. @default 'horizontal' */
    orientation?: Value<DividerOrientation>;
    /** Line style variant. @default 'solid' */
    variant?: Value<DividerVariant>;
    /** Visual prominence level. @default 'default' */
    tone?: Value<DividerTone>;
    /** Optional label to display in the middle of the divider. */
    label?: TNode;
    /** Alignment of the label text. @default 'center' */
    labelAlign?: Value<DividerLabelAlign>;
}
/**
 * A visual separator component for dividing content sections.
 * Can be horizontal or vertical, with optional label text centered (or aligned)
 * within the divider line.
 *
 * @param options - Configuration for orientation, style, tone, and label
 * @returns A semantic `<hr>` element or a labeled container with divider lines
 *
 * @example
 * ```typescript
 * // Simple horizontal divider
 * Divider()
 * ```
 *
 * @example
 * ```typescript
 * // Divider with centered label
 * Divider({ label: 'OR' })
 * ```
 *
 * @example
 * ```typescript
 * // Vertical divider
 * Divider({ orientation: 'vertical' })
 * ```
 *
 * @example
 * ```typescript
 * // Dashed divider with label aligned left
 * Divider({
 *   variant: 'dashed',
 *   label: 'Section Break',
 *   labelAlign: 'left'
 * })
 * ```
 */
export declare function Divider({ orientation, variant, tone, label, labelAlign, }?: DividerOptions): import("@tempots/dom").Renderable;
