@progress/kendo-react-inputs 13.3.0-develop.9 → 13.4.0-develop.1

package/maskedtextbox/MaskedTextBoxProps.d.ts

@@ -0,0 +1,273 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { CustomComponent, FormComponentProps, InputsClassStructure } from '@progress/kendo-react-common';
+import { MaskedTextBox } from './MaskedTextBox.js';
+/**
+ * The arguments for a MaskedTextBox event.
+ */
+export interface MaskedTextBoxEvent {
+    /**
+     * A native DOM event.
+     */
+    nativeEvent: Event;
+    /**
+     * A React [`SyntheticEvent`](https://react.dev/learn/responding-to-events).
+     */
+    syntheticEvent: React.SyntheticEvent<HTMLElement>;
+    /**
+     * An event target.
+     */
+    target: MaskedTextBox;
+}
+/**
+ * The arguments for the `change` event of the MaskedTextBox.
+ */
+export interface MaskedTextBoxChangeEvent extends MaskedTextBoxEvent {
+    /**
+     * Specifies the start of the selection which will be set to the MaskedTextBox when it is updated.
+     */
+    selectionStart: number;
+    /**
+     * Specifies the end of the selection which will be set to the MaskedTextBox when it is updated.
+     */
+    selectionEnd: number;
+    /**
+     * The current value of the component.
+     */
+    value: any;
+}
+/**
+ * Represents the props of the [KendoReact MaskedTextBox component](https://www.telerik.com/kendo-react-ui/components/inputs/maskedtextbox).
+ */
+export interface MaskedTextBoxProps extends FormComponentProps {
+    /**
+     * Sets a class of the MaskedTextBox DOM element.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox className="custom-class" />
+     * ```
+     */
+    className?: string;
+    /**
+     * Sets additional CSS styles to the MaskedTextBox DOM element.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox style={{ color: 'red' }} />
+     * ```
+     */
+    style?: React.CSSProperties;
+    /**
+     * Specifies the value of the MaskedTextBox.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox value="123-45-6789" />
+     * ```
+     */
+    value?: string;
+    /**
+     * Specifies the initial value. Leaves the subsequent updates uncontrolled.
+     */
+    defaultValue?: string;
+    /**
+     * Specifies the input placeholder.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox placeholder="Enter text here" />
+     * ```
+     */
+    placeholder?: string;
+    /**
+     * Sets the title of the `input` element of the MaskedTextBox.
+     */
+    title?: string;
+    /**
+     * Represents the `dir` HTML attribute.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox dir="rtl" />
+     * ```
+     */
+    dir?: string;
+    /**
+     * Sets the `tabIndex` property of the MaskedTextBox.
+     */
+    tabIndex?: number;
+    /**
+     * Specifies the `accessKey` of the MaskedTextBox.
+     */
+    accessKey?: string;
+    /**
+     * Specifies the width of the MaskedTextBox.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox width="200px" />
+     * ```
+     */
+    width?: number | string;
+    /**
+     * Determines whether the MaskedTextBox is disabled.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox disabled={true} />
+     * ```
+     */
+    disabled?: boolean;
+    /**
+     * Renders a floating label for the MaskedTextBox.
+     */
+    label?: React.ReactNode;
+    /**
+     * Sets the `id` of the `input` DOM element.
+     */
+    id?: string;
+    /**
+     * Sets a custom prefix to the MaskedTextBox component.
+     */
+    prefix?: CustomComponent<any>;
+    /**
+     * Sets a custom suffix to the MaskedTextBox component.
+     */
+    suffix?: CustomComponent<any>;
+    /**
+     * 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;
+    /**
+     * Determines whether the MaskedTextBox is in its read-only state.
+     */
+    readonly?: boolean;
+    /**
+     * Represents a prompt character for the masked value. Defaults to `_`.
+     */
+    prompt?: string;
+    /**
+     * Indicates a character which represents an empty position in the raw value. Defaults to ` `.
+     */
+    promptPlaceholder?: string;
+    /**
+     * Indicates whether to include literals in the raw value. Defaults to `false`.
+     */
+    includeLiterals?: boolean;
+    /**
+     * Determines whether the built-in mask validator is enforced when a form is validated. Defaults to `true`.
+     */
+    maskValidation?: boolean;
+    /**
+     * Represents the current mask. If no mask is set, the component behaves as a standard `type="text"` input.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox mask="(999) 000-0000" />
+     * ```
+     */
+    mask?: string;
+    /**
+     * Represents the RegExp-based mask validation array.
+     */
+    rules?: {
+        [key: string]: RegExp;
+    };
+    /**
+     * Represents the beginning and ending of the selected portion of the input content that will be applied the next time when the MaskedTextBox is rendered.
+     */
+    selection?: {
+        start: number;
+        end: number;
+    };
+    /**
+     * Determines the event handler that will be fired when the user edits the value.
+     *
+     * @example
+     * ```jsx
+     * <MaskedTextBox onChange={(e) => console.log(e.value)} />
+     * ```
+     */
+    onChange?: (event: MaskedTextBoxChangeEvent) => void;
+    /**
+     * Fires each time the user focuses the MaskedTextBox.
+     */
+    onFocus?: (event: MaskedTextBoxEvent) => void;
+    /**
+     * Fires each time the MaskedTextBox gets blurred.
+     */
+    onBlur?: (event: MaskedTextBoxEvent) => void;
+    /**
+     * Configures the `size` of the MaskedTextBox.
+     *
+     * The available options are:
+     * - small
+     * - medium
+     * - large
+     *
+     * @default undefined (theme-controlled)
+     *
+     * @example
+     * ```tsx
+     * <MaskedTextBox size="large" />
+     * ```
+     */
+    size?: 'small' | 'medium' | 'large';
+    /**
+     * Configures the `roundness` of the MaskedTextBox.
+     *
+     * The available options are:
+     * - small
+     * - medium
+     * - large
+     * - full
+     *
+     * @default undefined (theme-controlled)
+     *
+     * @example
+     * ```tsx
+     * <MaskedTextBox rounded="full" />
+     * ```
+     */
+    rounded?: 'small' | 'medium' | 'large' | 'full';
+    /**
+     * Configures the `fillMode` of the MaskedTextBox.
+     *
+     * The available options are:
+     * - solid
+     * - outline
+     * - flat
+     *
+     * @default undefined (theme-controlled)
+     *
+     * @example
+     * ```tsx
+     * <MaskedTextBox fillMode="outline" />
+     * ```
+     */
+    fillMode?: 'solid' | 'flat' | 'outline';
+    /**
+     * Represents the `autoFocus` HTML attribute that will be applied to the input element of the MaskedTextBox. (Defaults to `false`)
+     */
+    autoFocus?: boolean;
+    /**
+     * @hidden
+     */
+    unstyled?: InputsClassStructure;
+    /**
+     * Sets the HTML attributes of the inner focusable input element.
+     * Attributes which are essential for certain component functionalities cannot be changed.
+     */
+    inputAttributes?: React.InputHTMLAttributes<HTMLInputElement>;
+}

package/maskedtextbox/masking.service.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @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 class MaskingService {
+    rules: {
+        [key: string]: RegExp;
+    };
+    prompt: string;
+    mask: string;
+    promptPlaceholder: string;
+    includeLiterals: boolean;
+    maskTokens: any[];
+    unmaskTokens: any[];
+    rawTokens: any[];
+    validationTokens: any[];
+    update({ mask, prompt, promptPlaceholder, rules, includeLiterals }: any): void;
+    validationValue(maskedValue?: string): string;
+    rawValue(maskedValue?: string): string;
+    /**
+     * @hidden
+     */
+    maskRaw(rawValue?: string): string;
+    maskInput(input: string, control: string, splitPoint: number): any;
+    maskInRange(pasted: string, oldValue: string, start: number, end: number): any;
+    private maskRemoved;
+    private adjustPosition;
+    private maskInserted;
+    protected get maskTokenCreator(): {
+        [key: string]: Function;
+    };
+    protected get unmaskTokenCreator(): {
+        [key: string]: Function;
+    };
+    protected get rawTokenCreator(): {
+        [key: string]: Function;
+    };
+    protected get validationTokenCreator(): {
+        [key: string]: Function;
+    };
+    private tokenize;
+}

package/maskedtextbox/masking.service.mjs

@@ -6,7 +6,7 @@
  *-------------------------------------------------------------------------------------------
  */
 import { sequence as i, greedy as k } from "./parsing/combinators.mjs";
-import { literal as d, mask as T, unliteral as p, unmask as f, rawLiteral as m, rawMask as c, token as u } from "./parsing/parsers.mjs";
+import { mask as d, literal as T, unmask as p, unliteral as f, rawMask as m, rawLiteral as c, token as u } from "./parsing/parsers.mjs";
 class C {
   constructor() {
     this.rules = {}, this.prompt = "_", this.mask = "", this.promptPlaceholder = " ", this.includeLiterals = !1, this.maskTokens = [], this.unmaskTokens = [], this.rawTokens = [], this.validationTokens = [];
@@ -79,28 +79,28 @@ class C {
   get maskTokenCreator() {
     const { prompt: e, promptPlaceholder: s } = this;
     return {
-      literal: (t) => d(t),
-      mask: (t) => T({ prompt: e, promptPlaceholder: s })(t)
+      literal: (t) => T(t),
+      mask: (t) => d({ prompt: e, promptPlaceholder: s })(t)
     };
   }
   get unmaskTokenCreator() {
     return {
-      literal: (e) => p(e),
-      mask: (e) => f(this.prompt)(e)
+      literal: (e) => f(e),
+      mask: (e) => p(this.prompt)(e)
     };
   }
   get rawTokenCreator() {
     const { prompt: e, promptPlaceholder: s, includeLiterals: t } = this;
     return {
-      literal: (r) => m(t),
-      mask: (r) => c({ prompt: e, promptPlaceholder: s })
+      literal: (r) => c(t),
+      mask: (r) => m({ prompt: e, promptPlaceholder: s })
     };
   }
   get validationTokenCreator() {
     const { prompt: e } = this;
     return {
-      literal: (s) => m(!1),
-      mask: (s) => c({ prompt: e, promptPlaceholder: "" })
+      literal: (s) => c(!1),
+      mask: (s) => m({ prompt: e, promptPlaceholder: "" })
     };
   }
   tokenize() {

package/maskedtextbox/parsing/combinators.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
+ *-------------------------------------------------------------------------------------------
+ */
+import { Parser } from './parsers.js';
+/**
+ * @hidden
+ */
+export declare const sequence: (list: any) => any;
+/**
+ * @hidden
+ */
+export declare const greedy: (parser: any) => Parser;

package/maskedtextbox/parsing/parsers.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
+ *-------------------------------------------------------------------------------------------
+ */
+import { Result } from './result.js';
+import { Stream } from './stream.js';
+/**
+ * @hidden
+ */
+export declare class Parser {
+    private parse;
+    constructor(parse: Function);
+    run(input: Stream | string, control?: string): Result;
+    map(f: Function): Parser;
+    chain(f: Function): Parser;
+    isLiteral(c: string): boolean;
+}
+/**
+ * @hidden
+ */
+export declare const mask: (args: {
+    prompt: any;
+    promptPlaceholder: any;
+}) => (rule: any) => Parser;
+/**
+ * @hidden
+ */
+export declare const literal: (_token: any) => Parser;
+/**
+ * @hidden
+ */
+export declare const unmask: (prompt: any) => (rule: any) => Parser;
+/**
+ * @hidden
+ */
+export declare const unliteral: (_token: any) => Parser;
+/**
+ * @hidden
+ */
+export declare const token: (rules: any, creator: any) => Parser;
+/**
+ * @hidden
+ */
+export declare const rawMask: (args: {
+    prompt: any;
+    promptPlaceholder: any;
+}) => Parser;
+/**
+ * @hidden
+ */
+export declare const rawLiteral: (includeLiterals: any) => Parser;

package/maskedtextbox/parsing/result.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Stream } from './stream.js';
+/**
+ * @hidden
+ */
+export declare enum ResultType {
+    Literal = 0,
+    Mask = 1,
+    Undefined = 2
+}
+/**
+ * @hidden
+ */
+export declare class Result {
+    private value;
+    private rest;
+    type: ResultType;
+    constructor(value: any, rest: Stream, type?: ResultType);
+    map(fn: Function): Result;
+    chain(fn: Function): Result;
+    fold(s: Function, _?: Function): Result;
+    concat(r: Result): Result;
+    toString(): string;
+}

package/maskedtextbox/parsing/stream.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @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 class Stream {
+    private input;
+    private control;
+    private inputCursor;
+    private controlCursor;
+    constructor(input?: any[], control?: any[]);
+    eof(): boolean;
+    next(): {
+        char: string;
+        control: string;
+    };
+    peek(): {
+        char: string;
+        control: string;
+    };
+    eat_input(): void;
+    eat_control(): void;
+    eat(): void;
+}

package/maskedtextbox/utils.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { MaskedTextBoxProps } from './MaskedTextBoxProps.js';
+/**
+ * @hidden
+ */
+declare const defaultRules: {
+    [key: string]: RegExp;
+};
+/**
+ * @hidden
+ */
+declare const returnFalse: () => boolean;
+/**
+ * @hidden
+ */
+declare const maskingChanged: (prev: MaskedTextBoxProps, next: MaskedTextBoxProps) => boolean;
+export { defaultRules, maskingChanged, returnFalse };

package/messages/index.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @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 numericIncreaseValue = "numerictextbox.increment";
+/**
+ * @hidden
+ */
+export declare const numericDecreaseValue = "numerictextbox.decrement";
+/**
+ * @hidden
+ */
+export declare const sliderIncreaseValue = "slider.increment";
+/**
+ * @hidden
+ */
+export declare const sliderDecreaseValue = "slider.decrement";
+/**
+ * @hidden
+ */
+export declare const sliderDragTitle = "slider.dragTitle";
+/**
+ * @hidden
+ */
+export declare const colorGradientR = "colorGradient.r";
+/**
+ * @hidden
+ */
+export declare const colorGradientG = "colorGradient.g";
+/**
+ * @hidden
+ */
+export declare const colorGradientB = "colorGradient.b";
+/**
+ * @hidden
+ */
+export declare const colorGradientA = "colorGradient.a";
+/**
+ * @hidden
+ */
+export declare const colorGradientHex = "colorGradient.hex";
+/**
+ * @hidden
+ */
+export declare const colorGradientContrastRatio = "colorGradient.contrastRatio";
+/**
+ * @hidden
+ */
+export declare const colorGradientAALevel = "colorGradient.colorGradientAALevel";
+/**
+ * @hidden
+ */
+export declare const colorGradientAAALevel = "colorGradient.colorGradientAAALevel";
+/**
+ * @hidden
+ */
+export declare const colorGradientPass = "colorGradient.colorGradientPass";
+/**
+ * @hidden
+ */
+export declare const colorGradientFail = "colorGradient.colorGradientFail";
+/**
+ * @hidden
+ */
+export declare const colorGradientHueSliderLabel = "colorGradient.hueSliderLabel";
+/**
+ * @hidden
+ */
+export declare const colorGradientAlphaSliderLabel = "colorGradient.alphaSliderLabel";
+/**
+ * @hidden
+ */
+export declare const colorGradientToggleInputsButton = "colorGradient.toggleInputsButton";
+/**
+ * @hidden
+ */
+export declare const flatColorPickerCancelBtn = "flatColorPicker.cancelBtn";
+/**
+ * @hidden
+ */
+export declare const flatColorPickerApplyBtn = "flatColorPicker.applyBtn";
+/**
+ * @hidden
+ */
+export declare const flatColorPickerColorGradientBtn = "flatColorPicker.colorGradientBtn";
+/**
+ * @hidden
+ */
+export declare const flatColorPickerColorPaletteBtn = "flatColorPicker.colorPaletteBtn";
+/**
+ * @hidden
+ */
+export declare const flatColorPickerClearBtn = "flatColorPicker.clearBtn";
+/**
+ * @hidden
+ */
+export declare const colorPickerAdaptiveTitle = "colorPicker.adaptiveTitle";
+/**
+ * @hidden
+ */
+export declare const checkboxValidation = "checkbox.validation";
+/**
+ * @hidden
+ */
+export declare const checkboxOptionalText = "checkbox.optionalText";
+/**
+ * @hidden
+ */
+export declare const radioButtonValidation = "radioButton.validation";
+/**
+ * @hidden
+ */
+export declare const switchValidation = "switch.validation";
+/**
+ * @hidden
+ */
+export declare const colorPickerDropdownButtonAriaLabel = "colorPicker.dropdownButtonAriaLabel";
+/**
+ * @hidden
+ */
+export declare const ratingAriaLabel = "rating.ariaLabel";
+/**
+ * @hidden
+ */
+export declare const signatureClear = "signature.clear";
+/**
+ * @hidden
+ */
+export declare const signatureMaximize = "signature.maximize";
+/**
+ * @hidden
+ */
+export declare const signatureMinimize = "signature.minimize";
+/**
+ * @hidden
+ */
+export declare const messages: {
+    "numerictextbox.increment": string;
+    "numerictextbox.decrement": string;
+    "slider.increment": string;
+    "slider.decrement": string;
+    "slider.dragTitle": string;
+    "colorGradient.r": string;
+    "colorGradient.g": string;
+    "colorGradient.b": string;
+    "colorGradient.a": string;
+    "colorGradient.hex": string;
+    "colorGradient.contrastRatio": string;
+    "colorGradient.colorGradientAALevel": string;
+    "colorGradient.colorGradientAAALevel": string;
+    "colorGradient.colorGradientPass": string;
+    "colorGradient.colorGradientFail": string;
+    "colorGradient.hueSliderLabel": string;
+    "colorGradient.alphaSliderLabel": string;
+    "colorGradient.toggleInputsButton": string;
+    "flatColorPicker.cancelBtn": string;
+    "flatColorPicker.applyBtn": string;
+    "flatColorPicker.colorGradientBtn": string;
+    "flatColorPicker.colorPaletteBtn": string;
+    "flatColorPicker.clearBtn": string;
+    "colorPicker.adaptiveTitle": string;
+    "checkbox.validation": string;
+    "checkbox.optionalText": string;
+    "radioButton.validation": string;
+    "switch.validation": string;
+    "colorPicker.dropdownButtonAriaLabel": string;
+    "rating.ariaLabel": string;
+    "signature.clear": string;
+    "signature.maximize": string;
+    "signature.minimize": string;
+};