@progress/kendo-vue-inputs 8.0.3-develop.2 → 8.0.3-develop.4

package/rating/Rating.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { RatingChangeEvent, RatingItemMouseEvent, RatingKeyboardEvent } from './interfaces/RatingEvents';
+import { RatingFocusEvent } from './interfaces/RatingFocusEvent';
+import { RatingBlurEvent } from './interfaces/RatingBlurEvent';
+import { RatingActionDispatch } from './utils/rating-reducer';
+import { PropType } from 'vue';
+/**
+ * @hidden
+ */
+declare const Rating: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    min: {
+        type: PropType<number>;
+        default: number;
+    };
+    max: {
+        type: PropType<number>;
+        default: number;
+    };
+    step: {
+        type: PropType<number>;
+        default: number;
+    };
+    item: {
+        type: PropType<any>;
+    };
+    precision: {
+        type: PropType<"item" | "half">;
+        default: string;
+        validator: (value: 'item' | 'half') => any;
+    };
+    selection: {
+        type: PropType<"single" | "continues">;
+        default: string;
+        validator: (value: 'continues' | 'single') => any;
+    };
+    value: PropType<number>;
+    icon: PropType<string>;
+    svgIconOutline: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    svgIcon: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    tabIndex: PropType<number>;
+    disabled: PropType<boolean>;
+    readonly: PropType<boolean>;
+    id: PropType<string>;
+    half: PropType<boolean>;
+    defaultValue: PropType<number>;
+    label: PropType<string>;
+}>, {
+    inputRef: import('vue').Ref<any, any>;
+}, {
+    focused: boolean;
+    currentValue: any;
+    currentHovered: any;
+}, {
+    base(): number;
+    computedValue(): number;
+}, {
+    handleFocus(event: FocusEvent): void;
+    handleBlur(event: FocusEvent): void;
+    handleChange(newValue: number, event: PointerEvent): void;
+    handleKeyDown(event: KeyboardEvent): void;
+    handleItemClick(eventData: RatingItemMouseEvent): void;
+    handleMouseMove(eventData: RatingItemMouseEvent): void;
+    handleMouseLeave(eventData: RatingItemMouseEvent): void;
+    dispatchValue(action: RatingActionDispatch): void;
+    dispatchHover(action: RatingActionDispatch): void;
+}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (event: RatingChangeEvent) => true;
+    keydown: (event: RatingKeyboardEvent) => true;
+    focus: (event: RatingFocusEvent) => true;
+    blur: (event: RatingBlurEvent) => true;
+    click: (event: RatingItemMouseEvent) => true;
+    mouseleave: (event: RatingItemMouseEvent) => true;
+    mousemove: (event: RatingItemMouseEvent) => true;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    min: {
+        type: PropType<number>;
+        default: number;
+    };
+    max: {
+        type: PropType<number>;
+        default: number;
+    };
+    step: {
+        type: PropType<number>;
+        default: number;
+    };
+    item: {
+        type: PropType<any>;
+    };
+    precision: {
+        type: PropType<"item" | "half">;
+        default: string;
+        validator: (value: 'item' | 'half') => any;
+    };
+    selection: {
+        type: PropType<"single" | "continues">;
+        default: string;
+        validator: (value: 'continues' | 'single') => any;
+    };
+    value: PropType<number>;
+    icon: PropType<string>;
+    svgIconOutline: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    svgIcon: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    tabIndex: PropType<number>;
+    disabled: PropType<boolean>;
+    readonly: PropType<boolean>;
+    id: PropType<string>;
+    half: PropType<boolean>;
+    defaultValue: PropType<number>;
+    label: PropType<string>;
+}>> & Readonly<{
+    onClick?: (event: RatingItemMouseEvent) => any;
+    onBlur?: (event: RatingBlurEvent) => any;
+    onChange?: (event: RatingChangeEvent) => any;
+    onFocus?: (event: RatingFocusEvent) => any;
+    onKeydown?: (event: RatingKeyboardEvent) => any;
+    onMouseleave?: (event: RatingItemMouseEvent) => any;
+    onMousemove?: (event: RatingItemMouseEvent) => any;
+}>, {
+    selection: "single" | "continues";
+    step: number;
+    min: number;
+    max: number;
+    precision: "item" | "half";
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export { Rating };

package/rating/RatingItem.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { RatingItemMouseEvent } from './interfaces/RatingEvents';
+import { PropType } from 'vue';
+/**
+ * @hidden
+ */
+declare const RatingItem: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    id: PropType<string>;
+    tabIndex: PropType<number>;
+    half: PropType<boolean>;
+    title: PropType<string>;
+    icon: PropType<any>;
+    selected: PropType<boolean>;
+    hovered: PropType<boolean>;
+    onClick: PropType<(event: RatingItemMouseEvent) => void>;
+    onKeyDown: PropType<(event: KeyboardEvent) => void>;
+    onFocus: PropType<(event: FocusEvent) => void>;
+    onBlur: PropType<(event: FocusEvent) => void>;
+    onMouseEnter: PropType<(event: RatingItemMouseEvent) => void>;
+    svgIconOutline: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    svgIcon: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    haveSelectedValue: PropType<boolean>;
+    item: PropType<any>;
+    itemTemplate: PropType<any>;
+    dir: {
+        type: PropType<string>;
+        default: string;
+        validator: (value: string | undefined) => any;
+    };
+    value: {
+        type: PropType<number>;
+        required: true;
+    };
+}>, {
+    inputRef: import('vue').Ref<any, any>;
+}, {}, {
+    wrapperClass(): string;
+}, {
+    handleClick(event: PointerEvent): void;
+    handleMouseLeave(event: MouseEvent): void;
+    handleMouseMove(event: MouseEvent): void;
+    handleMouseEnter(event: MouseEvent): void;
+    handleKeyDown(event: KeyboardEvent): void;
+    handleFocus(event: FocusEvent): void;
+    handleBlur(event: FocusEvent): void;
+}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    click: (event: RatingItemMouseEvent) => true;
+    keydown: any;
+    focus: any;
+    blur: any;
+    mouseenter: (event: RatingItemMouseEvent) => true;
+    mouseleave: (event: RatingItemMouseEvent) => true;
+    mousemove: (event: RatingItemMouseEvent) => true;
+}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    id: PropType<string>;
+    tabIndex: PropType<number>;
+    half: PropType<boolean>;
+    title: PropType<string>;
+    icon: PropType<any>;
+    selected: PropType<boolean>;
+    hovered: PropType<boolean>;
+    onClick: PropType<(event: RatingItemMouseEvent) => void>;
+    onKeyDown: PropType<(event: KeyboardEvent) => void>;
+    onFocus: PropType<(event: FocusEvent) => void>;
+    onBlur: PropType<(event: FocusEvent) => void>;
+    onMouseEnter: PropType<(event: RatingItemMouseEvent) => void>;
+    svgIconOutline: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    svgIcon: PropType<import('@progress/kendo-vue-common').SVGIcon>;
+    haveSelectedValue: PropType<boolean>;
+    item: PropType<any>;
+    itemTemplate: PropType<any>;
+    dir: {
+        type: PropType<string>;
+        default: string;
+        validator: (value: string | undefined) => any;
+    };
+    value: {
+        type: PropType<number>;
+        required: true;
+    };
+}>> & Readonly<{
+    onClick?: (event: RatingItemMouseEvent) => any;
+    onBlur?: (...args: any[] | unknown[]) => any;
+    onFocus?: (...args: any[] | unknown[]) => any;
+    onKeydown?: (...args: any[] | unknown[]) => any;
+    onMouseenter?: (event: RatingItemMouseEvent) => any;
+    onMouseleave?: (event: RatingItemMouseEvent) => any;
+    onMousemove?: (event: RatingItemMouseEvent) => any;
+}>, {
+    dir: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export { RatingItem };

package/rating/interfaces/RatingBlurEvent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The arguments for the `onBlur` Rating event.
+ */
+export interface RatingBlurEvent {
+    /**
+     * The native FocusEvent from the DOM.
+     */
+    event: FocusEvent;
+}

package/rating/interfaces/RatingEvents.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents the return type of the RatingItemMouseEvent.
+ */
+export interface RatingItemMouseEvent {
+    /**
+     * The event of the RatingItemMouseEvent.
+     */
+    event: MouseEvent;
+    /**
+     * The target of the RatingItemMouseEvent.
+     */
+    target: Element;
+    /**
+     * @hidden
+     */
+    value?: number | null;
+}
+/**
+ * Represents the return type of the RatingKeyboardEvent.
+ */
+export interface RatingKeyboardEvent {
+    /**
+     * The current Rating value.
+     */
+    value: number;
+    /**
+     * The event of the RatingKeyboardEvent.
+     */
+    event: KeyboardEvent;
+}
+/**
+ * Represents the return type of RatingChangeEvent.
+ */
+export interface RatingChangeEvent {
+    /**
+     * The event of the RatingChangeEvent.
+     */
+    event: PointerEvent;
+    /**
+     * The target of the RatingChangeEvent.
+     */
+    target: HTMLSpanElement;
+    /**
+     * The current Rating value.
+     */
+    value: number;
+}

package/rating/interfaces/RatingFocusEvent.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The arguments for the `onFocus` Rating event.
+ */
+export interface RatingFocusEvent {
+    /**
+     * The native FocusEvent from the DOM.
+     */
+    event: FocusEvent;
+}

package/rating/interfaces/RatingItemProps.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SVGIcon } from '@progress/kendo-vue-common';
+import { RatingItemMouseEvent } from './RatingEvents';
+/**
+ * Represents the properties of [RatingItem](% slug api_inputs_ratingitem %) component.
+ */
+export interface RatingItemProps {
+    /**
+     * Sets the `id` property of the top div element of the RatingItem.
+     */
+    id?: string;
+    /**
+     * Sets the `tabIndex` attribute.
+     */
+    tabIndex?: number;
+    /**
+     * Determines if icon is partly selected.
+     */
+    half?: boolean;
+    /**
+     * Determines the RatingItem direction `ltr` - by default, or `rtl`.
+     */
+    dir?: string;
+    /**
+     * Sets the current value of the RatingItem, used in controlled mode.
+     */
+    value: number;
+    /**
+     * Sets the title of current RatingItem component. [See example]({% slug controlled_rating %})
+     */
+    title?: string;
+    /**
+     * Sets the icon of current RatingItem component. [See example]({% slug label_rating %})
+     */
+    icon?: any;
+    /**
+     * Sets custom Rating SVG icon.
+     */
+    svgIcon?: SVGIcon;
+    /**
+     * Sets custom Rating SVG icon.
+     */
+    svgIconOutline?: SVGIcon;
+    /**
+     * Determines if current RatingItem is selected. [See example]({% slug item_customization_ratingitem %})
+     */
+    selected?: boolean;
+    /**
+     * Determines if some of the RatingItems are selected.
+     *  [See example]({% slug item_customization_ratingitem %})
+     */
+    haveSelectedValue?: boolean;
+    /**
+     * Determines if current RatingItem is hovered.
+     */
+    hovered?: boolean;
+    /**
+     * @hidden
+     */
+    item?: any;
+    /**
+     * @hidden
+     */
+    itemTemplate?: any;
+    /**
+     * Triggered after `onClick` event. Gets outside access to the target element, the new value and the event type.
+     */
+    onClick?: (event: RatingItemMouseEvent) => void;
+    /**
+     * Triggered after `onKeyDown` event. Gets outside access to the target element, the new value and the event type.
+     */
+    onKeyDown?: (event: KeyboardEvent) => void;
+    /**
+     * Triggered after `onFocus` event. Gets outside access to the target element and the event type.
+     */
+    onFocus?: (event: FocusEvent) => void;
+    /**
+     * Triggered after `onBlur` event. Gets outside access to the target element and the event type.
+     */
+    onBlur?: (event: FocusEvent) => void;
+    /**
+     * Triggered after `onMouseEnter` event. Gets outside access to the target element and the event type.
+     */
+    onMouseEnter?: (event: RatingItemMouseEvent) => void;
+    /**
+     * Triggered after `onMouseLeave` event. Gets outside access to the target element and the event type.
+     */
+    onMouseLeave?: (event: RatingItemMouseEvent) => void;
+    /**
+     * Triggered after `onMouseMove` event. Gets outside access to the target element and the event type.
+     */
+    onMouseMove?: (event: RatingItemMouseEvent) => void;
+}

package/rating/interfaces/RatingProps.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { FormComponentProps, SVGIcon } from '@progress/kendo-vue-common';
+import { RatingKeyboardEvent, RatingItemMouseEvent, RatingChangeEvent } from './RatingEvents';
+/**
+ * Represents the properties of [Rating](% slug overview_rating %) component.
+ */
+export interface RatingProps extends FormComponentProps {
+    /**
+     * Sets the `id` property of the top div element of the Rating.
+     */
+    id?: string;
+    /**
+     * Sets additional classes to the Rating.
+     */
+    className?: string;
+    /**
+     * Sets the `tabIndex` attribute.
+     */
+    tabIndex?: number;
+    /**
+     * Sets additional CSS styles to the Rating.
+     */
+    style?: any;
+    /**
+     * Represents the rendered Rating item.
+     */
+    item?: any;
+    /**
+     * Sets the current value of the Rating, used in controlled mode. [See example]({% slug item_customization_ratingitem %})
+     */
+    value?: number;
+    /**
+     * Sets the default value of the Rating, used in uncontrolled mode. [See example]({% slug controlled_rating %})
+     */
+    defaultValue?: number;
+    /**
+     * Sets the min possible icon value or star value in the main use-case.
+     */
+    min?: number;
+    /**
+     * Sets the max possible icon value or star value in the main use-case.
+     */
+    max?: number;
+    /**
+     * Sets the step value between the min and max value.
+     */
+    step?: number;
+    /**
+     * Determines the Rating direction `ltr` - by default, or `rtl`.
+     */
+    dir?: string;
+    /**
+     * Determines if the Rating has a label and is it a custom one.
+     */
+    label?: string;
+    /**
+     * Sets the `readonly` mode of the Rating, if it is set to `true`. [See example]({% slug label_rating %})
+     */
+    readonly?: boolean;
+    /**
+     * Sets the `disabled` mode of the Rating, if it is set to `true`. [See example]({% slug readonly_rating %})
+     */
+    disabled?: boolean;
+    /**
+     * Sets custom Rating icon, by default - star. [See example]({% slug disabled_rating %})
+     */
+    icon?: string;
+    /**
+     * Sets custom Rating SVG icon.
+     */
+    svgIcon?: SVGIcon;
+    /**
+     * Sets custom Rating SVG icon.
+     */
+    svgIconOutline?: SVGIcon;
+    /**
+     * Determines the selection mode. By default set to `continues`. [See example]({% slug icon_rating %})
+     */
+    selection?: 'continues' | 'single';
+    /**
+     * Determines the precision of the Rating. By default set to `item`. [See example]({% slug selection_rating %})
+     */
+    precision?: 'half' | 'item';
+    /**
+     * Determines if value represents half icon -> true, or not -> false. [See example]({% slug precision_rating %})
+     */
+    half?: boolean;
+    /**
+     * Identifies the element(s) which will describe the component, similar to [HTML aria-describedby attribute](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/ARIA_Techniques/Using_the_aria-describedby_attribute).
+     * For example these elements could contain error or hint message.
+     */
+    ariaDescribedBy?: string;
+    /**
+     * Identifies the element(s) which will label the component.
+     */
+    ariaLabelledBy?: string;
+    /**
+     * Triggered after value change. Gets outside access to the target element, the new value and the event type.
+     */
+    onChange?: (event: RatingChangeEvent) => void;
+    /**
+     * Triggered after `onClick` event. Gets outside access to the target element, the new value and the event type.
+     */
+    onClick?: (event: RatingItemMouseEvent) => void;
+    /**
+     * Triggered after `onKeyDown` event. Gets outside access to the target element, the new value and the event type.
+     */
+    onKeyDown?: (event: RatingKeyboardEvent) => void;
+    /**
+     * Triggered after `onFocus` event. Gets outside access to the target element and the event type.
+     */
+    onFocus?: (event: FocusEvent) => void;
+    /**
+     * Triggered after `onBlur` event. Gets outside access to the target element and the event type.
+     */
+    onBlur?: (event: FocusEvent) => void;
+}

package/rating/utils/main.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export declare const toRound: (num: number, base: number) => number;
+/**
+ * @hidden
+ */
+export declare const getRemainder: (x: number, y: number) => number;
+/**
+ * @hidden
+ */
+export declare const isHalf: (index: number, value: number, step: number) => boolean;
+/**
+ * @hidden
+ */
+export declare const isSelected: (index: number, value: number | null, step: number, selection: 'single' | 'continues') => boolean;
+/**
+ * @hidden
+ */
+export declare const calcIsFirstHalf: (dir: string, rect: any, clientX: number) => boolean;
+/**
+ * @hidden
+ */
+export declare const isCorrectValue: (min: number, max: number, step: number, value: number) => boolean;

package/rating/utils/rating-reducer.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * @hidden
+ */
+export declare enum RATING_ACTION {
+    select = "select",
+    deselect = "deselect",
+    increase = "increase",
+    decrease = "decrease",
+    min = "min",
+    max = "max",
+    reset = "reset"
+}
+/**
+ * @hidden
+ */
+export type RatingActionDispatch = {
+    type: RATING_ACTION;
+    payload?: number;
+    event?: any;
+};
+/**
+ * @hidden
+ */
+export type RatingAction = {
+    min: number;
+    max: number;
+    step?: number;
+};
+/**
+ * @hidden
+ */
+export declare const ratingReducer: (state: any, action: RatingAction & RatingActionDispatch) => any;