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 root - The root part.
 * @csspart text - The rendered hint text element
 *
 * @cssprop {String} --hint-background-color - The background color CSS custom property.
 * @cssprop {String} --hint-border-color - The border color CSS custom property.
 * @cssprop {String} --hint-border-radius - The border radius CSS custom property.
 * @cssprop {String} --hint-border-style - The border style CSS custom property.
 * @cssprop {String} --hint-border-width - The border width CSS custom property.
 * @cssprop {String} --hint-font-family - The font family CSS custom property.
 * @cssprop {String} --hint-font-letter-spacing - The font letter spacing CSS custom property.
 * @cssprop {String} --hint-font-line-height - The font line height CSS custom property.
 * @cssprop {String} --hint-font-size - The font size CSS custom property.
 * @cssprop {String} --hint-font-text-decoration - The font text decoration CSS custom property.
 * @cssprop {String} --hint-font-text-transform - The font text transform CSS custom property.
 * @cssprop {String} --hint-font-weight - The font weight CSS custom property.
 * @cssprop {String} --hint-foreground-color - The foreground color CSS custom property.
 * @cssprop {String} --hint-gap - The gap CSS custom property.
 * @cssprop {String} --hint-padding-bottom - The padding bottom CSS custom property.
 * @cssprop {String} --hint-padding-left - The padding left CSS custom property.
 * @cssprop {String} --hint-padding-right - The padding right CSS custom property.
 * @cssprop {String} --hint-padding-top - The padding top CSS custom property.
 * @cssprop {String} --hint-shadow - The shadow CSS custom property.
 * @cssprop {String} --hint-shadow-blur - The shadow blur CSS custom property.
 * @cssprop {String} --hint-shadow-color - The shadow color CSS custom property.
 * @cssprop {String} --hint-shadow-offset-x - The shadow offset x CSS custom property.
 * @cssprop {String} --hint-shadow-offset-y - The shadow offset y CSS custom property.
 * @cssprop {String} --hint-shadow-spread - The shadow spread CSS custom property.
 * @cssprop {String} --hint-transition-duration - The transition duration CSS custom property.
 * @cssprop {String} --hint-transition-mode - The transition mode CSS custom property.
 * @cssprop {String} --hint-transition-property - The transition property CSS custom property.
 * @cssprop {String} --hint-translate - The translate CSS custom property.
 *
 * @dependency mosaik-text - The Text element.
 *
 * @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 wrapping and alignment:
 * ```html
 * <mosaik-hint
 *   id="wrappedHint"
 *   text="This is a longer explanation that might need to wrap to multiple lines."
 *   text-overflow="wrap">
 * </mosaik-hint>
 * <script>
 *   document.getElementById('wrappedHint').alignment = 'center';
 * </script>
 * ```
 *
 * @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>
 * ```
 *
 * @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