@progress/kendo-angular-inputs 19.1.1-develop.2 → 19.1.1

package/numerictextbox/numerictextbox.component.d.ts

@@ -14,6 +14,16 @@ import { SVGIcon } from '@progress/kendo-svg-icons';
 import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI NumericTextBox component for Angular]({% slug overview_numerictextbox %}).
+ *
+ * Use this component to allow users to input numeric values.
+ *
+ * @example
+ * ```html
+ * <kendo-numerictextbox [(ngModel)]="value"></kendo-numerictextbox>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link NumericTextBoxCustomMessagesComponent}.
  */
 export declare class NumericTextBoxComponent implements ControlValueAccessor, OnChanges, OnDestroy, Validator {
     private intl;
@@ -28,69 +38,68 @@ export declare class NumericTextBoxComponent implements ControlValueAccessor, On
      */
     focusableId: string;
     /**
-     * Determines whether the NumericTextBox is disabled ([see example]({% slug disabled_numerictextbox %})). To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_numerictextbox#toc-managing-the-numerictextbox-disabled-state-in-reactive-forms).
+     * When `true`, disables the `NumericTextBox`.
+     * To disable the component in reactive forms, see [Forms Support](slug:formssupport_numerictextbox#toc-managing-the-numerictextbox-disabled-state-in-reactive-forms).
+     *
+     * @default false
      */
     disabled: boolean;
     /**
-     * Determines whether the NumericTextBox is in its read-only state ([see example]({% slug readonly_numerictextbox %})).
+     * When `true`, makes the NumericTextBox read-only.
      *
      * @default false
      */
     readonly: boolean;
     /**
-     * Sets the title of the `input` element of the NumericTextBox.
+     * Sets the `title` attribute of the input element.
      */
     title: string;
     /**
-     * Specifies whether the value will be auto-corrected based on the minimum and maximum values
-     * ([see example]({% slug precision_numerictextbox %})).
+     * When `true`, the value is automatically corrected based on the minimum and maximum values ([see example]({% slug precision_numerictextbox %})).
      */
     autoCorrect: boolean;
     /**
-     * Specifies the number format which is used when the NumericTextBox is not focused
-     * ([see example]({% slug formats_numerictextbox %})).
-     * If `format` is set to `null` or `undefined`, the default format will be used.
+     * Specifies the number format used when the NumericTextBox is not focused ([see example]({% slug formats_numerictextbox %})).
+     * If `format` is `null` or `undefined`, the default format is used.
      */
     get format(): string | NumberFormatOptions | null | undefined;
     set format(value: string | NumberFormatOptions | null | undefined);
     /**
-     * Specifies the greatest value that is valid
-     * ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
+     * Sets the maximum valid value ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
      */
     max: number;
     /**
-     * Specifies the smallest value that is valid
-     * ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
+     * Sets the minimum valid value ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
      */
     min: number;
     /**
-     * Specifies the number of decimals that the user can enter when the input is focused
-     * ([see example]({% slug precision_numerictextbox %})).
+     * Specifies the number of decimals the user can enter when the input is focused ([see example]({% slug precision_numerictextbox %})).
      */
     decimals: number;
     /**
-     * Specifies the input placeholder.
+     * Sets the input placeholder.
      */
     placeholder: string;
     /**
-     * Specifies the value that is used to increment or decrement the component value
-     * ([see example]({% slug predefinedsteps_numerictextbox %})).
+     * Specifies the value used to increment or decrement the component value ([see example]({% slug predefinedsteps_numerictextbox %})).
+     *
+     * @default 1
      */
     step: number;
     /**
-     * Specifies whether the **Up** and **Down** spin buttons will be rendered
-     * ([see example]({% slug spinbuttons_numerictextbox %})).
+     * When `true`, renders the **Up** and **Down** spin buttons ([see example]({% slug spinbuttons_numerictextbox %})).
+     *
+     * @default true
      */
     spinners: boolean;
     /**
-     * Determines whether the built-in minimum or maximum validators are enforced when a form is validated.
+     * Enforces the built-in minimum and maximum validators during form validation.
      *
-     * > The 4.2.0 Angular version introduces the `min` and `max` validation directives. As a result, even if you set `rangeValidation`
-     * > to `false`, the built-in Angular validators will be executed.
+     * @default true
      */
     rangeValidation: boolean;
     /**
-     * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
+     * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
      */
     tabindex: number;
     /**
@@ -99,61 +108,51 @@ export declare class NumericTextBoxComponent implements ControlValueAccessor, On
     set tabIndex(tabIndex: number);
     get tabIndex(): number;
     /**
-     * Determines whether the value of the NumericTextBox will be changed via scrolling. Defaults to `true`.
+     * When `true`, enables changing the value with the mouse wheel.
      *
      * @default true
      */
     changeValueOnScroll: boolean;
     /**
-     * Determines whether the whole value will be selected when the NumericTextBox is clicked. Defaults to `true`.
+     * When `true`, enables selecting the entire value on click.
+     *
+     * @default true
      */
     selectOnFocus: boolean;
     /**
-     * Specifies the value of the NumericTextBox
-     * ([see example]({% slug formats_numerictextbox %})).
+     * Sets the value of the NumericTextBox ([see example]({% slug formats_numerictextbox %})).
      */
     value: number;
     /**
-     * Specifies the maximum number of characters the end user can type or paste in the input.
-     * The locale-specific decimal separator and negative sign (`-`) are included in the length of the value when present.
-     * The `maxlength` restriction is not applied to the length of the formatted value when the component is not focused.
+     * Sets the maximum number of characters the user can type or paste in the input.
+     * The locale-specific decimal separator and negative sign (`-`) count toward the length.
+     * The `maxlength` does not apply to the formatted value when the component is not focused.
      */
     maxlength: number;
     /**
-     * The size property specifies padding of the NumericTextBox internal input element
-     * ([see example]({% slug appearance_numerictextbox %}#toc-size)).
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * Sets the padding of the internal input element ([see example]({% slug appearance_numerictextbox %}#toc-size)).
+     *
+     * @default 'medium'
      */
     set size(size: InputSize);
     get size(): InputSize;
     /**
-     * The `rounded` property specifies the border radius of the NumericTextBox
-     * ([see example](slug:appearance_numerictextbox#toc-roundness)).
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * Sets the border radius of the NumericTextBox ([see example](slug:appearance_numerictextbox#toc-roundness)).
+     *
+     * @default 'medium'
      */
     set rounded(rounded: InputRounded);
     get rounded(): InputRounded;
     /**
-     * The `fillMode` property specifies the background and border styles of the NumericTextBox
-     * ([see example](slug:appearance_numerictextbox#toc-fill-mode)).
-     * The possible values are:
-     * * `flat`
-     * * `solid` (default)
-     * * `outline`
-     * * `none`
+     * Sets the background and border styles of the NumericTextBox ([see example](slug:appearance_numerictextbox#toc-fill-mode)).
+     *
+     * @default 'solid'
      */
     set fillMode(fillMode: InputFillMode);
     get fillMode(): InputFillMode;
     /**
-     * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
+     * Sets HTML attributes on the inner input element.
+     * The component ignores attributes that are essential for its functionality.
      */
     set inputAttributes(attributes: {
         [key: string]: string;
@@ -162,23 +161,23 @@ export declare class NumericTextBoxComponent implements ControlValueAccessor, On
         [key: string]: string;
     };
     /**
-     * Fires each time the user selects a new value ([see example](slug:events_numerictextbox)).
+     * Fires when the user selects a new value ([see example](slug:events_numerictextbox)).
      */
     valueChange: EventEmitter<any>;
     /**
-     * Fires each time the user focuses the NumericTextBox element ([see example](slug:events_numerictextbox)).
+     * Fires when the NumericTextBox element is focused ([see example](slug:events_numerictextbox)).
      */
     onFocus: EventEmitter<any>;
     /**
-     * Fires each time the NumericTextBox component gets blurred ([see example](slug:events_numerictextbox)).
+     * Fires when the `NumericTextBox` component gets blurred ([see example](slug:events_numerictextbox)).
      */
     onBlur: EventEmitter<any>;
     /**
-     * Fires each time the user focuses the `input` element.
+     * Fires when the input element is focused.
      */
     inputFocus: EventEmitter<any>;
     /**
-     * Fires each time the `input` element gets blurred.
+     * Fires when the input element gets blurred.
      */
     inputBlur: EventEmitter<any>;
     /**
@@ -291,18 +290,6 @@ export declare class NumericTextBoxComponent implements ControlValueAccessor, On
     setDisabledState(isDisabled: boolean): void;
     /**
      * Focuses the NumericTextBox.
-     *
-     * @example
-     * ```ts-no-run
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     *  <button (click)="numerictextbox.focus()">Focus NumericTextBox</button>
-     *  <kendo-numerictextbox #numerictextbox></kendo-numerictextbox>
-     * `
-     * })
-     * class AppComponent { }
-     * ```
      */
     focus(): void;
     /**
@@ -310,7 +297,7 @@ export declare class NumericTextBoxComponent implements ControlValueAccessor, On
      */
     blur(): void;
     /**
-     * Notifies the `NumericTextBoxComponent` that the input value should be changed.
+     * Notifies the NumericTextBoxComponent that the input value should be changed.
      * Can be used to update the input after setting the component properties directly.
      */
     notifyValueChange(): void;

package/numerictextbox.module.d.ts

@@ -7,34 +7,23 @@ import * as i1 from "./numerictextbox/numerictextbox.component";
 import * as i2 from "./numerictextbox/localization/custom-messages.component";
 import * as i3 from "@progress/kendo-angular-common";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the NumericTextBox component.
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the NumericTextBox component.
  *
- * @example
+ * Use this module to add the NumericTextBox component to your NgModule-based Angular application.
  *
- * ```ts-no-run
- * // Import the NumericTextBox module
+ * @example
+ * ```typescript
  * import { NumericTextBoxModule } from '@progress/kendo-angular-inputs';
- *
- * // The browser platform with a compiler
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
- *
  * import { NgModule } from '@angular/core';
- *
- * // Import the app component
+ * import { BrowserModule } from '@angular/platform-browser';
  * import { AppComponent } from './app.component';
  *
- * // Define the app module
- * _@NgModule({
- *     declarations: [AppComponent], // declare app component
- *     imports:      [BrowserModule, NumericTextBoxModule], // import NumericTextBox module
- *     bootstrap:    [AppComponent]
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, NumericTextBoxModule],
+ *   bootstrap: [AppComponent]
  * })
  * export class AppModule {}
- *
- * // Compile and launch the module
- * platformBrowserDynamic().bootstrapModule(AppModule);
- *
  * ```
  */
 export declare class NumericTextBoxModule {

package/otp.module.d.ts

@@ -0,0 +1,32 @@
+/**-----------------------------------------------------------------------------------------
+* Copyright © 2025 Progress Software Corporation. All rights reserved.
+* Licensed under commercial license. See LICENSE.md in the project root for more information
+*-------------------------------------------------------------------------------------------*/
+import * as i0 from "@angular/core";
+import * as i1 from "./otpinput/otpinput.component";
+import * as i2 from "./otpinput/localization/custom-messages.component";
+/**
+ * Defines the [NgModule](link:site.data.urls.angular['ngmoduleapi']) for the OTP Input component.
+ *
+ * Use this module to add the OTP Input component to your NgModule-based Angular application.
+ *
+ * @example
+ * ```typescript
+ * import { OTPInputModule } from '@progress/kendo-angular-inputs';
+ * import { NgModule } from '@angular/core';
+ * import { BrowserModule } from '@angular/platform-browser';
+ * import { AppComponent } from './app.component';
+ *
+ * @NgModule({
+ *   declarations: [AppComponent],
+ *   imports: [BrowserModule, OTPInputModule],
+ *   bootstrap: [AppComponent]
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class OTPInputModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<OTPInputModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<OTPInputModule, never, [typeof i1.OTPInputComponent, typeof i2.OTPInputCustomMessagesComponent], [typeof i1.OTPInputComponent, typeof i2.OTPInputCustomMessagesComponent]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<OTPInputModule>;
+}

package/otpinput/localization/custom-messages.component.d.ts

@@ -6,7 +6,9 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { OTPInputMessages } from './messages';
 import * as i0 from "@angular/core";
 /**
- * Custom component messages override default component messages.
+ * Provides custom messages for the OTP Input component.
+ *
+ * Use this component to override the default messages.
  */
 export declare class OTPInputCustomMessagesComponent extends OTPInputMessages {
     protected service: LocalizationService;

package/otpinput/models/otpinput-type.d.ts

@@ -3,8 +3,8 @@
 * Licensed under commercial license. See LICENSE.md in the project root for more information
 *-------------------------------------------------------------------------------------------*/
 /**
- * Represents the possible input `type` options of the OTP Input.
+ * Represents the input `type` options for the OTP Input.
  *
- * @default `text`
+ * @default 'text'
  */
 export type OTPInputType = 'text' | 'password' | 'number';

package/otpinput/models/separator-icon.d.ts

@@ -4,15 +4,20 @@
 *-------------------------------------------------------------------------------------------*/
 import { SVGIcon } from '@progress/kendo-angular-icons';
 /**
- * Represents the possible icon separators of the OTP Input.
+ * Represents the icon separator for the OTP Input.
+ *
+ * Use this interface to define a separator as an icon.
  */
 export interface OTPSeparatorIcon {
     /**
-     * Specifies the type of the separator icon.
+     * Sets the type of the separator icon.
+     *
      */
     type: 'svgIcon' | 'fontIcon' | 'iconClass';
     /**
-     * Specifies the icon to be displayed as a separator.
+     * Sets the icon to display as a separator.
+     *
+     * Use a string or an `SVGIcon`.
      */
     value: string | SVGIcon;
 }

package/otpinput/otpinput.component.d.ts

@@ -10,6 +10,19 @@ import { LocalizationService } from "@progress/kendo-angular-l10n";
 import { OTPInputType } from "./models/otpinput-type";
 import { OTPSeparatorIcon } from "./models/separator-icon";
 import * as i0 from "@angular/core";
+/**
+ * Represents the Kendo UI OTP Input component for Angular.
+ *
+ * Use the OTP Input to enter one-time passwords or verification codes.
+ *
+ * @example
+ * ```html
+ * <kendo-otpinput type="number" [(ngModel)]="otpValue"></kendo-otpinput>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link OTPInputCustomMessagesComponent}.
+ */
 export declare class OTPInputComponent implements ControlValueAccessor, OnInit, AfterViewInit, OnDestroy {
     hostElement: ElementRef;
     private cdr;
@@ -18,97 +31,78 @@ export declare class OTPInputComponent implements ControlValueAccessor, OnInit,
     private localizationService;
     private zone;
     /**
-     * Configures the total number of input fields.
+     * Sets the total number of input fields.
      *
      * @default 4
      */
     set length(value: number);
     get length(): number;
     /**
-     * Configures the input type.
+     * Sets the input type.
      *
-     * * The possible values are:
-     * * `text` (default)
-     * * `number`
-     * * `password`
      *
      * @default 'text'
      */
     type: OTPInputType;
     /**
-     * Configures whether the input fields are separate or adjacent to each other.
+     * Sets whether the input fields are separate or adjacent.
      *
      * @default true
      */
     spacing: boolean;
     /**
-     * Specifies the separator between groups of input fields.
-     *
-     * > The configuration can only be applied when `groupLength` is set.
+     * Sets the separator between groups of input fields. You can use this only when `groupLength` is set.
      */
     separator: string | OTPSeparatorIcon;
     /**
-     * Configures whether the component is enabled or disabled.
+     * When `true`, disables the OTPInput.
      *
      * @default false
      */
     disabled: boolean;
     /**
-     * Configures whether the component is readonly.
+     * When `true`, sets the OTPInput to read-only mode.
      *
      * @default false
      */
     readonly: boolean;
     /**
-     * Configures the placeholder of the input fields.
+     * Sets the placeholder for the input fields.
      */
     placeholder: string;
     /**
-     * Configures the length of the groups. If `groupLength` is a number, all groups will have the same length. If it's an array, each group can have a different length.
+     * Sets the length of the groups. If you set a number, all groups have the same length. If you set an array, each group can have a different length.
      */
     get groupLength(): number | Array<number>;
     set groupLength(length: number | Array<number>);
     /**
-     * Configures the value of the component. Unfilled input fields are represented with space.
+     * Sets the value of the component. Unfilled input fields are represented with а space.
      */
     get value(): string;
     set value(input: string);
     /**
-     * The `size` property specifies the padding of the input fields.
+     * Sets the padding of the input fields.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `none`
+     * @default 'medium'
      */
     set size(size: InputSize);
     get size(): InputSize;
     /**
-     * The `rounded` property specifies the border radius of the OTP Input.
+     * Sets the border radius of the OTP Input.
      *
-     * The possible values are:
-     * * `small`
-     * * `medium` (default)
-     * * `large`
-     * * `full`
-     * * `none`
+     * @default 'medium'
      */
     set rounded(rounded: InputRounded);
     get rounded(): InputRounded;
     /**
-     * The `fillMode` property specifies the background and border styles of the OTP Input.
+     * Sets the background and border styles of the OTP Input.
      *
-     * The possible values are:
-     * * `flat`
-     * * `solid` (default)
-     * * `outline`
-     * * `none`
+     * @default 'solid'
      */
     set fillMode(fillMode: InputFillMode);
     get fillMode(): InputFillMode;
     /**
-     * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
+     * Sets the HTML attributes of the inner input element. You cannot change attributes that are required for the component to work.
      */
     set inputAttributes(attributes: {
         [key: string]: string;
@@ -117,18 +111,17 @@ export declare class OTPInputComponent implements ControlValueAccessor, OnInit,
         [key: string]: string;
     };
     /**
-     * Fires each time the value is changed by the user&mdash;
-     * When the value of the component is programmatically changed to `ngModel` or `formControl`
-     * through its API or form binding, the `valueChange` event is not triggered because it
-     * might cause a mix-up with the built-in `valueChange` mechanisms of the `ngModel` or `formControl` bindings.
+     * Fires when the user changes the value.
+     *
+     * This event does not fire when you change the value programmatically or through form bindings.
      */
     valueChange: EventEmitter<any>;
     /**
-     * Fires each time the user focuses the OTP Input.
+     * Fires when the user focuses the OTP Input.
      */
     onFocus: EventEmitter<any>;
     /**
-     * Fires each time the user blurs the OTP Input.
+     * Fires when the user blurs the OTP Input.
      */
     onBlur: EventEmitter<any>;
     wrapperClass: boolean;
@@ -218,6 +211,8 @@ export declare class OTPInputComponent implements ControlValueAccessor, OnInit,
      */
     set isFocused(value: boolean);
     /**
+     * Returns `true` if the component has groups.
+     *
      * @hidden
      */
     get hasGroups(): boolean;
@@ -246,7 +241,9 @@ export declare class OTPInputComponent implements ControlValueAccessor, OnInit,
      */
     fillInputs(text: string, start?: number, replaceLast?: boolean): void;
     /**
-     * Focuses the OTP Input.
+     * Focuses the OTP Input at the specified index provided as an argument.
+     *
+     * @param index The index of the input to focus.
      */
     focus(index?: number): void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-inputs",
-  "version": "19.1.1-develop.2",
+  "version": "19.1.1",
   "description": "Kendo UI for Angular Inputs Package - Everything you need to build professional form functionality (Checkbox, ColorGradient, ColorPalette, ColorPicker, FlatColorPicker, FormField, MaskedTextBox, NumericTextBox, RadioButton, RangeSlider, Slider, Switch, TextArea, and TextBox Components)",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -28,7 +28,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1749196595,
+      "publishDate": 1749540069,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -40,20 +40,20 @@
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-drawing": "^1.21.0",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.1.1-develop.2",
-    "@progress/kendo-angular-common": "19.1.1-develop.2",
-    "@progress/kendo-angular-utils": "19.1.1-develop.2",
-    "@progress/kendo-angular-navigation": "19.1.1-develop.2",
-    "@progress/kendo-angular-dialog": "19.1.1-develop.2",
-    "@progress/kendo-angular-intl": "19.1.1-develop.2",
-    "@progress/kendo-angular-l10n": "19.1.1-develop.2",
-    "@progress/kendo-angular-popup": "19.1.1-develop.2",
-    "@progress/kendo-angular-icons": "19.1.1-develop.2",
+    "@progress/kendo-angular-buttons": "19.1.1",
+    "@progress/kendo-angular-common": "19.1.1",
+    "@progress/kendo-angular-utils": "19.1.1",
+    "@progress/kendo-angular-navigation": "19.1.1",
+    "@progress/kendo-angular-dialog": "19.1.1",
+    "@progress/kendo-angular-intl": "19.1.1",
+    "@progress/kendo-angular-l10n": "19.1.1",
+    "@progress/kendo-angular-popup": "19.1.1",
+    "@progress/kendo-angular-icons": "19.1.1",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.1-develop.2",
+    "@progress/kendo-angular-schematics": "19.1.1",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-draggable": "^3.0.0",
     "@progress/kendo-inputs-common": "^3.1.0"

package/radiobutton/radiobutton.component.d.ts

@@ -7,6 +7,18 @@ import { ControlValueAccessor } from '@angular/forms';
 import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { RadioCheckBoxBase } from '../common/radio-checkbox.base';
 import * as i0 from "@angular/core";
+/**
+ * Represents the Kendo UI RadioButton component.
+ * Use this component to create a styled radio button in your Angular application.
+ *
+ * @example
+ * ```html
+ * <kendo-radiobutton
+ *   [checked]="true"
+ *   (checkedChange)="onCheckedChange($event)">
+ * </kendo-radiobutton>
+ * ```
+ */
 export declare class RadioButtonComponent extends RadioCheckBoxBase implements ControlValueAccessor, OnInit, AfterViewInit, OnDestroy {
     protected renderer: Renderer2;
     hostElement: ElementRef;
@@ -23,12 +35,9 @@ export declare class RadioButtonComponent extends RadioCheckBoxBase implements C
      */
     checked: boolean;
     /**
-     * Fires each time the checked state is changed.
-     * When the state of the component is programmatically changed to `ngModel` or `formControl`
-     * through its API or form binding, the `checkedStateChange` event is not triggered because it
-     * might cause a mix-up with the built-in mechanisms of the `ngModel` or `formControl` bindings.
-     *
-     * Used to provide a two-way binding for the `checked` property.
+     * Fires when the checked state changes.
+     * The event does not fire when you change the state through `ngModel` or `formControl` bindings.
+     * Use this event for two-way binding of the `checked` property.
      */
     checkedChange: EventEmitter<boolean>;
     private subs;