@riverty/web-components 6.2.0 → 6.3.0

package/dist/types/components/textarea/textarea.d.ts

@@ -1,158 +0,0 @@
-import { EventEmitter } from '../../stencil-public-runtime';
-import type { TextareaResize } from './exports';
-export declare class RTextarea {
-    host: HTMLRTextareaElement;
-    /** Specifies the `id` of the `<form>` to which the element belongs */
-    form?: string;
-    /** Specifies if element must be ignored during validation of the form elements */
-    novalidate?: boolean;
-    /** Sets the `name` attribute on the underlying `<textarea>`, allowing the control
-     * to be identified during form submission. */
-    name: string;
-    /** Represents the current value of the `<textarea>`, reflecting the content entered
-     * by the user or provided programmatically. */
-    value?: string;
-    /** Specifies a short hint that describes the expected value of the `<textarea>`,
-     * displayed when it is empty. */
-    placeholder: string;
-    /** Defines the number of visible text lines in the `<textarea>`,
-     * controlling its vertical size. */
-    rows?: number;
-    /** Specifies the visible width of the `<textarea>` in terms
-     * of the number of characters. */
-    cols?: number;
-    /** Controls the resizability of the `<textarea>`, allowing
-     * or preventing the user from resizing it. */
-    resize: TextareaResize;
-    /** Indicates whether the `<textarea>` is disabled, preventing
-     * user interaction and input when set to true. */
-    disabled?: boolean;
-    /** Indicates whether the `<textarea>` is read-only, allowing focus and text selection
-     * while preventing the user from modifying its value. */
-    readonly?: boolean;
-    /** Optional text displayed below the `<textarea>`, providing
-     * additional context or guidance to the user. */
-    hint?: string;
-    /** Indicates that the `<textarea>` must be filled out
-     * before submitting the form. */
-    required?: boolean;
-    /** Custom message for `valueMissing` property of a ValidityState
-     * object (set by `required`) within Constrain Validation API. */
-    valueMissingMessage?: string;
-    /** Specifies the maximum number of characters allowed in the `<textarea>`,
-     * enforcing input length limits. */
-    maxlength?: number;
-    /** Specifies if the character counter should be visible.
-     *
-     * Note: The counter will only be rendered when a `maxlength` value is provided.
-     */
-    showCounter?: boolean;
-    /** Custom message when the character limit is reached to alert screen reader users. */
-    characterLimitReachedMessage: string;
-    /** Custom message for `tooLong` property of a ValidityState
-     * object (set by `maxlength`) within Constrain Validation API. */
-    tooLongMessage?: string;
-    /** Specifies the minimum number of characters required in the `<textarea>`,
-     * enforcing input length constraints. */
-    minlength?: number;
-    /** Set custom message for `tooShort` property of a ValidityState object
-     * (set by `minlength`) within Constrain Validation API */
-    tooShortMessage?: string;
-    /** Custom error message displayed for any validation failures in the `<textarea>`. */
-    customErrorMessage?: string;
-    /** Indicates whether the value of the `<textarea>`
-     * is valid based on validation rules. */
-    valid?: boolean;
-    /** Indicates whether the value of the `<textarea>`
-     * is invalid based on validation rules. */
-    invalid?: boolean;
-    /** Custom error message provided independently of the
-     * Constraint Validation API for the `<textarea>`. */
-    error?: string;
-    /** Text displayed as the label above the `<textarea>`,
-     * indicating its purpose to the user. */
-    label?: string;
-    /** Text of an additional marker in the label */
-    fieldIndicator?: string;
-    /** Custom validity state */
-    validityState: string;
-    /** Custom validity message */
-    validityMessage: string;
-    /** Emits `rChange` when component's value has been changed  */
-    rChange: EventEmitter<{
-        element: HTMLRTextareaElement;
-        value: any;
-    }>;
-    /** Emits `rInput` when component's value is changing */
-    rInput: EventEmitter<{
-        element: HTMLRTextareaElement;
-        value: any;
-    }>;
-    /** Emits `rReset` when component was reset to initial state by form reset */
-    rReset: EventEmitter<{
-        element: HTMLRTextareaElement;
-        value: any;
-    }>;
-    /** Emits event after each validation */
-    rValidate: EventEmitter<{
-        state: string;
-        message: string;
-    }>;
-    /** Sets the value of the element. */
-    setValue(value: string): Promise<void>;
-    /** Gets the value of the element. */
-    getValue(): Promise<string>;
-    /** Resets value and validity state to initial. */
-    reset(): Promise<void>;
-    /** Sets focus on the element. */
-    setFocus(): Promise<void>;
-    /** Removes focus from the element. */
-    setBlur(): Promise<void>;
-    /** Sets the start and end positions of the text selection. */
-    setSelectionRange(start: number, end: number, direction?: 'forward' | 'backward' | 'none'): Promise<void>;
-    /** Replaces the current text selection with a new string. */
-    setRangeText(replacement: string, start: number, end: number, selectionMode?: 'select' | 'start' | 'end' | 'preserve'): Promise<void>;
-    /** Validates an element, displays provided message in case value is invalid. */
-    setCustomValidity(message: string): Promise<void>;
-    /**
-     * Validates the textarea without triggering UI and returns a boolean indicating its validity.
-     * @returns A boolean indicating whether the textarea is valid.
-     */
-    checkValidity(): Promise<boolean>;
-    /** Validates an element and displays validity state. */
-    reportValidity(): Promise<void>;
-    /** Identify wrapping form element. */
-    private get parentFormEl();
-    private get ariaDescribedBy();
-    private get hasError();
-    private get hasValidationError();
-    private get hasMessage();
-    /**
-     * Determine whether this element should be ignored
-     * during Constraint Validation API validation.
-     * */
-    private get isNoValidate();
-    private get hasTrailingSlot();
-    /**
-     * Initial attributes state
-     * */
-    private initial;
-    /** Unique id */
-    private uniqueId;
-    private nativeElement?;
-    private characterLimitReachedAlert?;
-    private onInput;
-    private onChange;
-    private onSubmitForm;
-    private onResetForm;
-    private getValidityStateData;
-    private validateFormElement;
-    private contributeToFormData;
-    private get textareaSlotValue();
-    private connectFormEventListeners;
-    private disconnectFormEventListeners;
-    componentWillLoad(): void;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    render(): any;
-}

package/dist/types/components/toast/exports.d.ts

@@ -1,6 +0,0 @@
-export declare const toastStatusArray: readonly ["success", "warning", "error", "info"];
-export declare const toastActionTargetArray: readonly ["_blank", "_self", "_parent", "_top"];
-export declare const toastDismissModeArray: readonly ["auto", "manual"];
-export type ToastStatus = typeof toastStatusArray[number];
-export type ToastActionTarget = typeof toastActionTargetArray[number];
-export type ToastDismissMode = typeof toastDismissModeArray[number];

package/dist/types/components/toast/toast.d.ts

@@ -1,146 +0,0 @@
-import { EventEmitter } from '../../stencil-public-runtime';
-import { ToastActionTarget, ToastDismissMode, ToastStatus } from './exports';
-import { IconName } from '../icon/exports';
-export declare class Toast {
-    host: HTMLRToastElement;
-    /**
-     * Controls if toast is initially shown.
-     * */
-    open: boolean;
-    /** Defines the appearance of the dialog based on the message type.
-     * Options are: "info", "success", "warning", or "error".
-     * @default 'info' */
-    status: ToastStatus;
-    /** Sets role="alert" and will be announced to screen reader users */
-    announced: boolean;
-    /** Specifies an optional icon for the leading slot of the dialog. */
-    leadingIcon?: IconName;
-    /**
-     * Defines whether the leading icon is visible.
-     * @default true
-     * */
-    leadingIconVisible: boolean;
-    /** Specifies an optional icon for the trailing slot of the dialog.
-     * @default 'cross'
-     * */
-    trailingIcon: IconName;
-    /** Specifies the headline text for the alert, summarizing its message or purpose. */
-    headline: string;
-    /** Specifies the URL for the call-to-action link. */
-    href?: string;
-    /** Specifies the text content for the call-to-action link. */
-    action?: string;
-    /** Specifies the target for the linked URL when `href` is provided.
-     * Options are: "_blank", "_self", "_parent", or "_top".
-     * @default '_self' */
-    target: ToastActionTarget;
-    /** Specifies the time in miliseconds before the alert automatically collapses.
-     * @default 3000
-    */
-    delay?: number;
-    /**
-     * Defines the behavior of the component's dismissing.
-     * - `auto`: The component will be dismissed automatically after number of ms set by `delay` property.
-     * - `manual`: The component requires explicit user action to close.
-     * @default "manual"
-     */
-    dismissMode: ToastDismissMode;
-    /** Provides content for `aria-label` attribute of the dismiss button. */
-    dismissLabel: string;
-    /** Defines amount of time im miliseconds before toast is removed from DOM.
-     * @default 300
-     * */
-    delayBeforeRemoval: number;
-    private delayTimer;
-    private removalTimer;
-    private animationCompleted;
-    /**
-     * Indicates state of the Toast switching between hidden/shown.
-     * */
-    isOpen?: boolean;
-    /**
-     * Event shall be emmited on trailing icon click
-     * */
-    rClickToastTrailingIcon: EventEmitter;
-    /**
-     * Emitted when the toast is dismissed and scheduled for removal from the DOM.
-     * Fired by dismiss(), by the auto-dismiss timer (delay), and by the trailing
-     * dismiss button. Use this to react to permanent removal (contrast with
-     * toastHide which only hides without removal).
-     */
-    toastDismiss: EventEmitter;
-    /**
-     * Emitted when the toast transitions to an open (revealed) state and remains in the DOM.
-     * Fired by reveal(), by toggle() when the resulting state is open, and when the
-     * 'open' prop changes causing the toast to show. Not emitted by dismiss()
-     * (which removes the element) — use 'toastDismiss' for that case.
-     */
-    toastReveal: EventEmitter;
-    /**
-     * Emitted when the toast transitions to a hidden state but remains in the DOM.
-     * Fired by hide(), by toggle() when resulting state is hidden, and when the
-     * 'open' prop changes causing the toast to hide. Not emitted on dismiss()
-     * (which removes the element) — use 'toastDismiss' for that case.
-     */
-    toastHide: EventEmitter;
-    /**
-     * Emitted when the dismiss toast animation is complete
-     * and the element has fully disappeared from the view.
-     * Fired by dismiss(), by the auto-dismiss timer (delay), by changing open property, and by the trailing
-     * dismiss button.
-     */
-    toastDismissed: EventEmitter;
-    /**
-     * Dismisses the toast notification by setting it to a hidden state and then
-     * removing it from the DOM after a short delay. This can be used to manually
-     * hide the toast before the auto-dismiss timer expires.
-     */
-    dismiss(): Promise<void>;
-    /**
-     * Reveals the toast notification by setting it to a visible state.
-     * If the auto-dismiss delay is enabled, it will start the timer to
-     * automatically dismiss the toast after the specified duration.
-     */
-    reveal(): Promise<this>;
-    /**
-     * Hides toast, keeps it in dom.
-     * */
-    hide(): Promise<this>;
-    /**
-     * Toggles visibility of the toast.
-     * */
-    toggle(): Promise<this>;
-    /**
-     * Measures the natural height of toast and prepares it for reveal animation.
-     * This should be called on newly added toasts before they are revealed.
-     */
-    measureAndPrepareHeight(): Promise<void>;
-    handleOpenChange(): void;
-    /** Unique id for each accordion item/row */
-    private uniqueId;
-    private hasElContent;
-    private getElContent;
-    private get hasLeadingSlot();
-    private get hasLeading();
-    private get hasTrailingSlot();
-    private get isDismissManual();
-    private get hasTrailing();
-    private get hasContent();
-    private get hasActionLink();
-    private get hasActionSlot();
-    private get hasAction();
-    private get hasHeadlineSlot();
-    private get hasHeadline();
-    private get hasDelay();
-    private get isError();
-    private get leadingIconName();
-    private startDelayTimer;
-    private handleAnimationEnd;
-    private handleTrailingButtonClick;
-    private handleSlotChange;
-    componentWillLoad(): void;
-    componentDidLoad(): Promise<void>;
-    private updateHeightVariable;
-    disconnectedCallback(): void;
-    render(): any;
-}

package/dist/types/components/toast-group/exports.d.ts

@@ -1,2 +0,0 @@
-export declare const toastGroupVariantArray: readonly ["floating", "inline"];
-export type ToastGroupVariant = typeof toastGroupVariantArray[number];

package/dist/types/components/toast-group/toast-group.d.ts

@@ -1,9 +0,0 @@
-export declare class ToastGroup {
-    host: HTMLRToastGroupElement;
-    private observer;
-    private get hasChildren();
-    private updateHiddenState;
-    private observeSlotContentChange;
-    componentWillLoad(): void;
-    render(): any;
-}

package/dist/types/components/tooltip/exports.d.ts

@@ -1,6 +0,0 @@
-export declare const TooltipHorizontalPositionArray: readonly ["left", "right"];
-export declare const TooltipVerticalPositionArray: readonly ["top", "bottom"];
-export declare const TooltipPositionArray: readonly ["left", "right", "top", "bottom"];
-export type TooltipHorizontalPosition = typeof TooltipHorizontalPositionArray[number];
-export type TooltipVerticalPosition = typeof TooltipVerticalPositionArray[number];
-export type TooltipPosition = typeof TooltipPositionArray[number];

package/dist/types/components/tooltip/tooltip.d.ts

@@ -1,131 +0,0 @@
-import { EventEmitter } from '../../stencil-public-runtime';
-import { TooltipHorizontalPosition, TooltipVerticalPosition, TooltipPosition } from './exports';
-export declare class Tooltip {
-    element: HTMLRTooltipElement;
-    /** Tooltip display text */
-    text: string;
-    /** Specifies tooltip position */
-    position: TooltipPosition;
-    positionState: string;
-    arrowPositionState: string;
-    isShown: boolean;
-    /**
-     * Tooltip focus event  */
-    rTooltipFocus: EventEmitter<{
-        element: HTMLRTooltipElement;
-    }>;
-    private uniqueId;
-    private tooltip;
-    private arrow;
-    /**
-     * Watch on position value change and update tooltip position if needed
-     */
-    handleVerticalPosition(): void;
-    /**
-     * Listen on window scroll and update tooltip position if needed
-     */
-    handleScrolling(): void;
-    /**
-     * Listen on window resizing and update tooltip position if needed
-     */
-    handleResizing(): void;
-    /**
-     * Listen on window keydown and hide tooltip if needed
-     */
-    handleKeydown(event: any): void;
-    /**
-     * Parent with non visible overflow
-     */
-    get overflowedParent(): HTMLElement;
-    get arrowWidth(): number;
-    get arrowHeight(): number;
-    get tooltipContainerWidth(): number;
-    get tooltipContainerHeight(): number;
-    /**
-     * Available space at the top
-     */
-    get top(): number;
-    /**
-     * Available space on the left
-     */
-    get left(): number;
-    get isOnScreen(): boolean;
-    /**
-     * Available space at the bottom
-     */
-    get bottom(): number;
-    /**
-     * Available space on the right
-     */
-    get right(): number;
-    /**
-     * Defines which horizontal placement is available
-     */
-    get horizontalPlacement(): TooltipHorizontalPosition;
-    /**
-     * Defines which vertical placement is available
-     */
-    get verticalPlacement(): TooltipVerticalPosition;
-    /**
-     * Checks if there is enough space for placing tooltip vertically
-     */
-    get isEnoughSpaceVertically(): boolean;
-    /**
-     * Checks if there is enough space for placing tooltip horizontally
-     */
-    get isEnoughSpaceHorizontally(): boolean;
-    get activeElement(): Element;
-    /**
-     * Gets the actual interactive element (button/link) from within r-button or r-icon-button shadow DOM,
-     * or returns the element itself if it's already interactive
-     */
-    private getInteractiveElement;
-    /**
-     * Define position state
-     */
-    componentWillLoad(): void;
-    /**
-     * Listen to active child element
-     */
-    componentDidLoad(): void;
-    /**
-     * Finds first element's parent with not visible overflow.
-     * @param element -- parent element
-     * @param initEl -- initial(child) element
-     */
-    private findOverflowParent;
-    /**
-     * Checks the alternative tooltip position.
-     * For example: If defined position is "top" and there is no free space for this position at the top of the component,
-     * first it checks available vertical space to place tooltip at the bottom.
-     * If there is no available space at the bottom, it checks the available space horizontally and sets it horizontally.
-     */
-    private getAlternativePosition;
-    /**
-     * Set correct tooltip position.
-     * First it checks the available space for a defined position and then sets the new one based on the available space.
-     */
-    private setCorrectPosition;
-    private getOffsetLeft;
-    private alignTooltipPosition;
-    private alignArrowPosition;
-    private alignPosition;
-    /**
-     * Adjusts arrow correct position.
-     * For bottom & top tooltip positions there are 3 possible arrow.
-     * For right & left tooltip positions there is only one position = "center".
-     */
-    private adjustArrowPosition;
-    /**
-     * Listen on hovering tooltip element and update tooltip position if needed
-     */
-    private handleHover;
-    /**
-     * Listen on focusing tooltip element and update tooltip position if needed
-     */
-    private handleFocus;
-    private showTooltip;
-    private removeTooltip;
-    private handleScroll;
-    render(): any;
-}