import { TextAlignment } from '../../../Types/TextAlignment';
import { TextOverflow } from '../../../Types/TextOverflow';
import { CustomElement } from '../../Abstracts/CustomElement';
import type { IHintElementProps } from './IHintElementProps';
declare const HintElement_base: (abstract new (...args: Array<any>) => import("../../../Behaviors/Themeable").IThemeableProps) & (abstract new (...args: Array<any>) => import("../../../Behaviors/TextFormattable").ITextFormattableProps) & typeof CustomElement & import("../../../Behaviors/Themeable").IThemeableCtor;
/**
 * Hint - Supplementary text providing guidance, context, or additional information.
 *
 * @description
 * The Hint element displays subtle, informative text to guide users, explain features, or provide
 * context for form fields and UI controls. Supports text alignment, truncation/wrapping, and custom
 * formatting. Typically styled with reduced visual weight (smaller font, muted color) to distinguish
 * it from primary content. Commonly used below input fields, alongside buttons, in tooltips, or as
 * descriptive captions for complex UI elements.
 *
 * @name Hint
 * @element mosaik-hint
 * @category Primitives
 *
 * @csspart text - The rendered hint text element
 *
 * @dependency {TextElement} - Text rendering component
 *
 * @example
 * Basic hint for an input field:
 * ```html
 * <label for="username">Username</label>
 * <input id="username" type="text">
 * <mosaik-hint text="Must be 3-20 characters, alphanumeric only"></mosaik-hint>
 * ```
 *
 * @example
 * Hint with custom alignment and wrapping:
 * ```html
 * <mosaik-hint
 *   text="This is a longer explanation that might need to wrap to multiple lines."
 *   alignment="center"
 *   text-overflow="wrap">
 * </mosaik-hint>
 * ```
 *
 * @example
 * Truncated hint with ellipsis:
 * ```html
 * <mosaik-hint
 *   text="This is a very long hint that will be truncated with an ellipsis if it exceeds the available space"
 *   text-overflow="truncate">
 * </mosaik-hint>
 * ```
 *
 * @example
 * Hint with formatted text:
 * ```html
 * <mosaik-hint
 *   id="passwordHint"
 *   text="Password strength: {strength}"
 *   alignment="left">
 * </mosaik-hint>
 *
 * <script>
 *   const hint = document.getElementById('passwordHint');
 *   hint.formatter = (text) => text.replace('{strength}', 'Medium');
 * </script>
 * ```
 *
 * @public
 */
export declare class HintElement extends HintElement_base implements IHintElementProps {
    private _text;
    private _alignment;
    private _textOverflow;
    /**
     * @public
     */
    constructor();
    /**
     * Returns the `is` property.
     *
     * @public
     * @static
     * @readonly
    */
    static get is(): string;
    /**
     * Gets or sets the `text` property.
     *
     * @public
     * @attr
     */
    get text(): string;
    set text(value: string);
    /**
     * Gets or sets the `textOverflow` property.
     *
     * @public
     * @attr
     */
    get textOverflow(): TextOverflow;
    set textOverflow(value: TextOverflow);
    /**
     * Gets or sets the `alignment` property.
     *
     * Possible values are:
     * * `center` - centers the text horizontally within the element
     * * `justify` - stretches the text to fill the width of the element, adjusting spacing as needed
     * * `left` - aligns the text to the left edge of the element (default)
     * * `right` - aligns the text to the right edge of the element
     *
     * @public
     * @attr
     */
    get alignment(): TextAlignment;
    set alignment(value: TextAlignment);
}
/**
 * @public
 */
export declare namespace HintElement {
    type Props = IHintElementProps;
}
/**
 * @public
 */
declare global {
    interface HTMLElementTagNameMap {
        'mosaik-hint': HintElement;
    }
}
export {};
//# sourceMappingURL=HintElement.d.ts.map