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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/checkbox/checkbox.component.d.ts +15 -13
  2. package/checkbox/checkbox.directive.d.ts +8 -15
  3. package/checkbox/checked-state.d.ts +5 -1
  4. package/checkbox.module.d.ts +9 -20
  5. package/colorpicker/color-gradient.component.d.ts +26 -26
  6. package/colorpicker/color-input.component.d.ts +18 -18
  7. package/colorpicker/color-palette.component.d.ts +28 -29
  8. package/colorpicker/colorpicker.component.d.ts +53 -69
  9. package/colorpicker/events/active-color-click-event.d.ts +10 -14
  10. package/colorpicker/events/cancel-event.d.ts +1 -1
  11. package/colorpicker/events/close-event.d.ts +1 -1
  12. package/colorpicker/events/open-event.d.ts +1 -1
  13. package/colorpicker/flatcolorpicker.component.d.ts +26 -29
  14. package/colorpicker/localization/custom-messages.component.d.ts +9 -1
  15. package/colorpicker/localization/messages.d.ts +29 -29
  16. package/colorpicker/models/palette-settings.d.ts +0 -3
  17. package/colorpicker/models/tile-size.d.ts +6 -0
  18. package/colorpicker.module.d.ts +18 -2
  19. package/common/models/fillmode.d.ts +4 -1
  20. package/common/models/rounded.d.ts +8 -2
  21. package/common/models/size.d.ts +4 -1
  22. package/common/models/type.d.ts +3 -1
  23. package/common/radio-checkbox.base.d.ts +0 -7
  24. package/directives.d.ts +216 -18
  25. package/esm2022/checkbox/checkbox.component.mjs +15 -13
  26. package/esm2022/checkbox/checkbox.directive.mjs +8 -15
  27. package/esm2022/checkbox.module.mjs +9 -20
  28. package/esm2022/colorpicker/color-gradient.component.mjs +26 -26
  29. package/esm2022/colorpicker/color-input.component.mjs +21 -21
  30. package/esm2022/colorpicker/color-palette.component.mjs +28 -29
  31. package/esm2022/colorpicker/colorpicker.component.mjs +53 -69
  32. package/esm2022/colorpicker/events/active-color-click-event.mjs +10 -14
  33. package/esm2022/colorpicker/events/cancel-event.mjs +1 -1
  34. package/esm2022/colorpicker/events/close-event.mjs +1 -1
  35. package/esm2022/colorpicker/events/open-event.mjs +1 -1
  36. package/esm2022/colorpicker/flatcolorpicker.component.mjs +26 -29
  37. package/esm2022/colorpicker/localization/custom-messages.component.mjs +9 -1
  38. package/esm2022/colorpicker/localization/messages.mjs +29 -29
  39. package/esm2022/colorpicker.module.mjs +18 -2
  40. package/esm2022/common/radio-checkbox.base.mjs +0 -7
  41. package/esm2022/directives.mjs +216 -18
  42. package/esm2022/formfield/error.component.mjs +9 -6
  43. package/esm2022/formfield/formfield.component.mjs +24 -20
  44. package/esm2022/formfield/hint.component.mjs +8 -5
  45. package/esm2022/formfield.module.mjs +9 -20
  46. package/esm2022/index.mjs +1 -0
  47. package/esm2022/inputs.module.mjs +9 -21
  48. package/esm2022/maskedtextbox/maskedtextbox.component.mjs +46 -88
  49. package/esm2022/maskedtextbox.module.mjs +9 -20
  50. package/esm2022/numerictextbox/localization/custom-messages.component.mjs +13 -1
  51. package/esm2022/numerictextbox/localization/messages.mjs +2 -2
  52. package/esm2022/numerictextbox/numerictextbox.component.mjs +57 -70
  53. package/esm2022/numerictextbox.module.mjs +9 -20
  54. package/esm2022/otp.module.mjs +44 -0
  55. package/esm2022/otpinput/localization/custom-messages.component.mjs +3 -1
  56. package/esm2022/otpinput/otpinput.component.mjs +39 -42
  57. package/esm2022/package-metadata.mjs +2 -2
  58. package/esm2022/radiobutton/radiobutton.component.mjs +15 -6
  59. package/esm2022/radiobutton/radiobutton.directive.mjs +6 -10
  60. package/esm2022/radiobutton.module.mjs +8 -18
  61. package/esm2022/rangeslider/localization/custom-messages.component.mjs +11 -1
  62. package/esm2022/rangeslider/rangeslider.component.mjs +12 -16
  63. package/esm2022/rangeslider.module.mjs +7 -18
  64. package/esm2022/rating/directives/rating-hovered-item.directive.mjs +11 -3
  65. package/esm2022/rating/directives/rating-item.directive.mjs +10 -3
  66. package/esm2022/rating/directives/rating-selected-item.directive.mjs +12 -3
  67. package/esm2022/rating/rating.component.mjs +23 -20
  68. package/esm2022/rating.module.mjs +7 -18
  69. package/esm2022/shared/input-separator.component.mjs +10 -15
  70. package/esm2022/shared/textarea.directive.mjs +5 -6
  71. package/esm2022/signature/events/close-event.mjs +1 -1
  72. package/esm2022/signature/localization/custom-messages.component.mjs +1 -1
  73. package/esm2022/signature/signature.component.mjs +52 -51
  74. package/esm2022/signature.module.mjs +7 -18
  75. package/esm2022/slider/localization/custom-messages.component.mjs +1 -1
  76. package/esm2022/slider/slider.component.mjs +18 -19
  77. package/esm2022/slider.module.mjs +7 -18
  78. package/esm2022/sliders-common/label-template.directive.mjs +9 -19
  79. package/esm2022/sliders-common/slider-base.mjs +47 -29
  80. package/esm2022/switch/events/blur-event.mjs +1 -1
  81. package/esm2022/switch/events/focus-event.mjs +1 -1
  82. package/esm2022/switch/localization/custom-messages.component.mjs +1 -1
  83. package/esm2022/switch/switch.component.mjs +32 -43
  84. package/esm2022/switch.module.mjs +7 -18
  85. package/esm2022/textarea/textarea-prefix.component.mjs +11 -13
  86. package/esm2022/textarea/textarea-suffix.component.mjs +11 -13
  87. package/esm2022/textarea/textarea.component.mjs +40 -103
  88. package/esm2022/textarea.module.mjs +7 -18
  89. package/esm2022/textbox/localization/custom-messages.component.mjs +1 -1
  90. package/esm2022/textbox/textbox-prefix.directive.mjs +9 -13
  91. package/esm2022/textbox/textbox-suffix.directive.mjs +10 -14
  92. package/esm2022/textbox/textbox.component.mjs +41 -112
  93. package/esm2022/textbox/textbox.directive.mjs +2 -2
  94. package/esm2022/textbox.module.mjs +7 -18
  95. package/fesm2022/progress-kendo-angular-inputs.mjs +1207 -1280
  96. package/formfield/error.component.d.ts +9 -6
  97. package/formfield/formfield.component.d.ts +24 -20
  98. package/formfield/hint.component.d.ts +8 -5
  99. package/formfield/models/message-align.d.ts +3 -1
  100. package/formfield/models/orientation.d.ts +3 -0
  101. package/formfield/models/show-options.d.ts +5 -7
  102. package/formfield.module.d.ts +9 -20
  103. package/index.d.ts +1 -0
  104. package/inputs.module.d.ts +9 -21
  105. package/maskedtextbox/maskedtextbox.component.d.ts +46 -88
  106. package/maskedtextbox.module.d.ts +9 -20
  107. package/numerictextbox/localization/custom-messages.component.d.ts +13 -1
  108. package/numerictextbox/localization/messages.d.ts +2 -2
  109. package/numerictextbox/numerictextbox.component.d.ts +57 -70
  110. package/numerictextbox.module.d.ts +9 -20
  111. package/otp.module.d.ts +32 -0
  112. package/otpinput/localization/custom-messages.component.d.ts +3 -1
  113. package/otpinput/models/otpinput-type.d.ts +2 -2
  114. package/otpinput/models/separator-icon.d.ts +8 -3
  115. package/otpinput/otpinput.component.d.ts +39 -42
  116. package/package.json +12 -12
  117. package/radiobutton/radiobutton.component.d.ts +15 -6
  118. package/radiobutton/radiobutton.directive.d.ts +6 -10
  119. package/radiobutton.module.d.ts +8 -18
  120. package/rangeslider/localization/custom-messages.component.d.ts +11 -1
  121. package/rangeslider/rangeslider-value.type.d.ts +2 -2
  122. package/rangeslider/rangeslider.component.d.ts +12 -16
  123. package/rangeslider.module.d.ts +7 -18
  124. package/rating/directives/rating-hovered-item.directive.d.ts +11 -3
  125. package/rating/directives/rating-item.directive.d.ts +10 -3
  126. package/rating/directives/rating-selected-item.directive.d.ts +12 -3
  127. package/rating/models/precision.d.ts +1 -2
  128. package/rating/models/selection.d.ts +1 -2
  129. package/rating/rating.component.d.ts +21 -18
  130. package/rating.module.d.ts +7 -18
  131. package/shared/input-separator.component.d.ts +10 -15
  132. package/shared/textarea.directive.d.ts +5 -6
  133. package/signature/events/close-event.d.ts +1 -1
  134. package/signature/localization/custom-messages.component.d.ts +1 -1
  135. package/signature/signature.component.d.ts +52 -51
  136. package/signature.module.d.ts +7 -18
  137. package/slider/localization/custom-messages.component.d.ts +1 -1
  138. package/slider/slider.component.d.ts +18 -19
  139. package/slider.module.d.ts +7 -18
  140. package/sliders-common/label-template.directive.d.ts +9 -19
  141. package/sliders-common/slider-base.d.ts +47 -29
  142. package/sliders-common/title-callback.d.ts +19 -3
  143. package/switch/events/blur-event.d.ts +1 -1
  144. package/switch/events/focus-event.d.ts +1 -1
  145. package/switch/localization/custom-messages.component.d.ts +1 -1
  146. package/switch/switch.component.d.ts +32 -43
  147. package/switch.module.d.ts +7 -18
  148. package/textarea/models/adornments-orientation.d.ts +3 -3
  149. package/textarea/models/flow.d.ts +3 -3
  150. package/textarea/models/resize.d.ts +6 -7
  151. package/textarea/textarea-prefix.component.d.ts +11 -13
  152. package/textarea/textarea-suffix.component.d.ts +11 -13
  153. package/textarea/textarea.component.d.ts +40 -103
  154. package/textarea.module.d.ts +7 -18
  155. package/textbox/localization/custom-messages.component.d.ts +1 -1
  156. package/textbox/textbox-prefix.directive.d.ts +9 -13
  157. package/textbox/textbox-suffix.directive.d.ts +10 -14
  158. package/textbox/textbox.component.d.ts +41 -112
  159. package/textbox/textbox.directive.d.ts +2 -2
  160. package/textbox.module.d.ts +7 -18
@@ -554,33 +554,23 @@ const packageMetadata = {
554
554
  productName: 'Kendo UI for Angular',
555
555
  productCode: 'KENDOUIANGULAR',
556
556
  productCodes: ['KENDOUIANGULAR'],
557
- publishDate: 1749196595,
558
- version: '19.1.1-develop.2',
557
+ publishDate: 1749804176,
558
+ version: '19.1.2-develop.1',
559
559
  licensingDocsUrl: 'https://www.telerik.com/kendo-angular-ui/my-license/'
560
560
  };
561
561
 
562
562
  /**
563
- * Represents the template for the labels of the Slider.
564
- * To define the labels template, nest an `<ng-template>` tag with the `kendoSliderLabelTemplate` directive inside
565
- * the `<kendo-slider>` tag. The template context is passed to the `label` value.
563
+ * Represents the template for Slider labels.
564
+ * To define a labels template, nest an `<ng-template>` tag with the `kendoSliderLabelTemplate` directive inside
565
+ * the `<kendo-slider>` tag. The template context provides the `value`.
566
566
  *
567
567
  * @example
568
- * ```ts-no-run
569
- *
570
- * _@Component({
571
- * selector: 'my-app',
572
- * template: `
573
- * <kendo-slider [largeStep]="2">
574
- * <ng-template kendoSliderLabelTemplate let-value="value">
575
- * <b>{{value}}</b>
576
- * </ng-template>
577
- * </kendo-slider>
578
- * `
579
- * })
580
- *
581
- * class AppComponent {
582
- * }
583
- *
568
+ * ```html
569
+ * <kendo-slider [largeStep]="2">
570
+ * <ng-template kendoSliderLabelTemplate let-value="value">
571
+ * <p>{{ value }}</p>
572
+ * </ng-template>
573
+ * </kendo-slider>
584
574
  * ```
585
575
  */
586
576
  class LabelTemplateDirective {
@@ -612,77 +602,95 @@ class SliderBase {
612
602
  changeDetector;
613
603
  hostElement;
614
604
  /**
615
- * Defines the title of the ticks ([see example]({% slug ticks_slider %}#toc-titles)). The default title
616
- * for each tick is its Slider value. If you use a callback function, the function accepts an argument
617
- * that holds the value of the component and returns a string with the new title.
605
+ * Sets the title for the ticks.
606
+ * The default title for each tick is its Slider value.
607
+ * If you use a callback function, the function receives the component value and returns a string for the new title [see example]({% slug ticks_slider %}#toc-titles).
618
608
  */
619
609
  title = identity;
620
610
  /**
621
- * Denotes the location of the tick marks in the Slider ([see example]({% slug ticks_slider %}#toc-placement)).
611
+ * Sets the location of the tick marks in the Slider [see example]({% slug ticks_slider %}#toc-placement).
622
612
  *
623
- * The available options are:
624
- * * `before`&mdash;The tick marks are located to the top side of the horizontal track or to the left side of a vertical track.
625
- * * `after`&mdash;The tick marks are located to the bottom side of the horizontal track or to the right side of the vertical track.
626
- * * `both`&mdash; (Default) The tick marks are located on both sides of the track.
627
- * * `none`&mdash;The tick marks are not visible. The actual elements are not added to the DOM tree.
613
+ * The options are:
614
+ * - `before` – Shows tick marks above a horizontal track or left of a vertical track.
615
+ * - `after` – Shows tick marks below a horizontal track or right of a vertical track.
616
+ * - `both` Shows tick marks on both sides of the track.
617
+ * - `none` – Hides tick marks and removes them from the DOM.
618
+ *
619
+ * @default 'both'
628
620
  */
629
621
  tickPlacement = 'both';
630
622
  /**
631
- * If `vertical` is set to `true`, the orientation of the Slider changes from horizontal to vertical
632
- * ([see example]({% slug orientation_slider %})).
623
+ * When `true`. renders a vertical Slider [see example]({% slug orientation_slider %}).
624
+ *
625
+ * @default false
633
626
  */
634
627
  vertical = false;
635
628
  /**
636
- * The minimum value of the Slider ([see example]({% slug predefinedsteps_slider %}#toc-small-steps)).
637
- * The attribute accepts both integers and floating-point numbers.
629
+ * Sets the minimum value of the Slider.
630
+ * Accepts integers and floating-point numbers [see example]({% slug predefinedsteps_slider %}#toc-small-steps).
631
+ *
632
+ * @default 0
638
633
  */
639
634
  min = 0;
640
635
  /**
641
- * The maximum value of the Slider ([see example]({% slug predefinedsteps_slider %}#toc-small-steps)).
642
- * The attribute accepts both integers and floating-point numbers.
636
+ * Sets the maximum value of the Slider.
637
+ * Accepts integers and floating-point numbers [see example]({% slug predefinedsteps_slider %}#toc-small-steps).
638
+ *
639
+ * @default 10
643
640
  */
644
641
  max = 10;
645
642
  /**
646
- * The step value of the Slider ([see example]({% slug predefinedsteps_slider %}#toc-small-steps)).
647
- * Accepts positive values only. Can be an integer or a floating-point number.
643
+ * Sets the step value of the Slider.
644
+ * Accepts only positive values.
645
+ * Can be an integer or a floating-point number [see example]({% slug predefinedsteps_slider %}#toc-small-steps).
646
+ *
647
+ * @default 1
648
648
  */
649
649
  smallStep = 1;
650
650
  /**
651
- * Specifies that every n<sup>th</sup> tick will be large and will have a label
652
- * ([see example]({% slug predefinedsteps_slider %}#toc-large-steps)).
653
- * Accepts positive integer values only.
651
+ * Sets every n<sup>th</sup> tick as large and shows a label for it [see example]({% slug predefinedsteps_slider %}#toc-large-steps).
652
+ *
653
+ * @default null
654
654
  */
655
655
  largeStep = null;
656
656
  /**
657
- * Sets the width between each two ticks along the track ([see example]({% slug ticks_slider %}#toc-width)). The value
658
- * has to be set in pixels. If no `fixedTickWidth` is provided, the Slider automatically adjusts the tick width to
659
- * accommodate the elements within the size of the component.
657
+ * Sets the width between two ticks along the track, in pixels.
658
+ * If you do not set `fixedTickWidth`, the Slider adjusts the tick width automatically [see example]({% slug ticks_slider %}#toc-width).
659
+ *
660
660
  */
661
661
  fixedTickWidth;
662
662
  /**
663
- * Determines whether the Slider is disabled ([see example]({% slug disabledstate_slider %})). To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_slider#toc-managing-the-slider-disabled-state-in-reactive-forms).
663
+ * When `true`, disables the Slider.
664
+ * To disable the component in reactive forms, see [Forms Support](slug:formssupport_slider#toc-managing-the-slider-disabled-state-in-reactive-forms) [see example]({% slug disabledstate_slider %}).
665
+ *
666
+ * @default false
664
667
  */
665
668
  disabled = false;
666
669
  /**
667
- * Determines whether the Slider is in its read-only state ([see example]({% slug readonly_slider %})).
670
+ * When `true`, sets the Slider to read-only [see example]({% slug readonly_slider %}).
668
671
  *
669
672
  * @default false
670
673
  */
671
674
  readonly = false;
672
675
  /**
673
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the Slider.
676
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the Slider.
677
+ *
678
+ * @default 0
674
679
  */
675
680
  tabindex = 0;
676
681
  /**
677
- * Fires each time the user focuses the component.
682
+ * Fires when the user focuses the component.
683
+ *
678
684
  */
679
685
  onFocus = new EventEmitter();
680
686
  /**
681
- * Fires each time the component is blurred.
687
+ * Fires when the component is blurred.
688
+ *
682
689
  */
683
690
  onBlur = new EventEmitter();
684
691
  /**
685
- * Fires each time the user selects a new value.
692
+ * Fires when the user selects a new value.
693
+ *
686
694
  */
687
695
  valueChange = new EventEmitter();
688
696
  direction;
@@ -1065,6 +1073,14 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1065
1073
  const PRESSED$1 = 'k-pressed';
1066
1074
  /**
1067
1075
  * Represents the [Kendo UI Slider component for Angular]({% slug overview_slider %}).
1076
+ *
1077
+ * @example
1078
+ * ```html
1079
+ * <kendo-slider [min]="0" [max]="10" [smallStep]="1" [(ngModel)]="value"></kendo-slider>
1080
+ * ```
1081
+ *
1082
+ * @remarks
1083
+ * Supported children components are: {@link SliderCustomMessagesComponent}.
1068
1084
  */
1069
1085
  class SliderComponent extends SliderBase {
1070
1086
  localization;
@@ -1078,7 +1094,7 @@ class SliderComponent extends SliderBase {
1078
1094
  */
1079
1095
  focusableId = `k-${guid()}`;
1080
1096
  /**
1081
- * Changes the `title` attribute of the drag handle so that it can be localized.
1097
+ * Changes the `title` attribute of the drag handle. Use this property to localize the drag handle title.
1082
1098
  */
1083
1099
  dragHandleTitle;
1084
1100
  /**
@@ -1086,8 +1102,9 @@ class SliderComponent extends SliderBase {
1086
1102
  */
1087
1103
  incrementTitle;
1088
1104
  /**
1089
- * Determines if the animation will be played on value change.
1090
- * Regardless of this setting, no animation will be played during the initial rendering.
1105
+ * Determines if the component animates when the value changes.
1106
+ * The component does not animate during initial rendering.
1107
+ * @default true
1091
1108
  */
1092
1109
  animate = true;
1093
1110
  /**
@@ -1095,13 +1112,15 @@ class SliderComponent extends SliderBase {
1095
1112
  */
1096
1113
  decrementTitle;
1097
1114
  /**
1098
- * Renders the arrow side buttons of the Slider ([see example]({% slug sidebuttons_slider %}#toc-hidden-state)).
1099
- * When `showButtons` is set to `false`, the buttons are not displayed.
1115
+ * Shows or hides the arrow side buttons of the Slider ([see example]({% slug sidebuttons_slider %}#toc-hidden-state)).
1116
+ * When you set `showButtons` to `false`, the component does not display the buttons.
1117
+ * @default true
1100
1118
  */
1101
1119
  showButtons = true;
1102
1120
  /**
1103
- * The current value of the Slider when it is initially displayed.
1104
- * The component can use either NgModel or the `value` binding but not both of them at the same time.
1121
+ * Sets the current value of the Slider when it first appears.
1122
+ * Use either `ngModel` or the `value` binding, but not both at the same time.
1123
+ * @default 0
1105
1124
  */
1106
1125
  value = this.min;
1107
1126
  /**
@@ -1151,18 +1170,6 @@ class SliderComponent extends SliderBase {
1151
1170
  }
1152
1171
  /**
1153
1172
  * Focuses the Slider.
1154
- *
1155
- * @example
1156
- * ```ts-no-run
1157
- * _@Component({
1158
- * selector: 'my-app',
1159
- * template: `
1160
- * <button (click)="slider.focus()">Focus</button>
1161
- * <kendo-slider #slider></kendo-slider>
1162
- * `
1163
- * })
1164
- * class AppComponent { }
1165
- * ```
1166
1173
  */
1167
1174
  focus() {
1168
1175
  if (!this.disabled) {
@@ -1815,7 +1822,16 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
1815
1822
 
1816
1823
  const PRESSED = 'k-pressed';
1817
1824
  /**
1818
- * Represents the [Kendo UI RangeSlider component for Angular]({% slug overview_rangeslider %}).
1825
+ * Represents the Kendo UI RangeSlider component for Angular.
1826
+ * Use this component to let users select a range of values.
1827
+ *
1828
+ * @example
1829
+ * ```html
1830
+ * <kendo-rangeslider [value]="[10, 50]" [min]="0" [max]="100"></kendo-rangeslider>
1831
+ * ```
1832
+ *
1833
+ * @remarks
1834
+ * Supported children components are: {@link RangeSliderCustomMessagesComponent}.
1819
1835
  */
1820
1836
  class RangeSliderComponent extends SliderBase {
1821
1837
  localization;
@@ -1826,7 +1842,7 @@ class RangeSliderComponent extends SliderBase {
1826
1842
  hostElement;
1827
1843
  /**
1828
1844
  * Sets the range value of the RangeSlider.
1829
- * The component can use either NgModel or the `value` binding but not both of them at the same time.
1845
+ * Use either `ngModel` or the `value` binding, but not both at the same time.
1830
1846
  */
1831
1847
  value;
1832
1848
  draghandleStart;
@@ -1860,19 +1876,6 @@ class RangeSliderComponent extends SliderBase {
1860
1876
  /**
1861
1877
  * Focuses the RangeSlider.
1862
1878
  *
1863
- * @example
1864
- * ```ts-no-run
1865
- * _@Component({
1866
- * selector: 'my-app',
1867
- * template: `
1868
- * <div>
1869
- * <button class="k-button" (click)="slider.focus()">Focus</button>
1870
- * </div>
1871
- * <kendo-rangeslider #slider></kendo-rangeslider>
1872
- * `
1873
- * })
1874
- * class AppComponent { }
1875
- * ```
1876
1879
  */
1877
1880
  focus() {
1878
1881
  this.focusChangedProgrammatically = true;
@@ -1880,7 +1883,7 @@ class RangeSliderComponent extends SliderBase {
1880
1883
  this.focusChangedProgrammatically = false;
1881
1884
  }
1882
1885
  /**
1883
- * Blurs the RangeSlider.
1886
+ * Removes focus from the RangeSlider.
1884
1887
  */
1885
1888
  blur() {
1886
1889
  this.focusChangedProgrammatically = true;
@@ -2480,6 +2483,14 @@ const DEFAULT_THUMB_ROUNDED = 'full';
2480
2483
  const DEFAULT_TRACK_ROUNDED = 'full';
2481
2484
  /**
2482
2485
  * Represents the [Kendo UI Switch component for Angular]({% slug overview_switch %}).
2486
+ *
2487
+ * @example
2488
+ * ```html
2489
+ * <kendo-switch [(ngModel)]="checked"></kendo-switch>`
2490
+ * ```
2491
+ *
2492
+ * @remarks
2493
+ * Supported children components are: {@link SwitchCustomMessagesComponent}.
2483
2494
  */
2484
2495
  class SwitchComponent {
2485
2496
  renderer;
@@ -2498,17 +2509,19 @@ class SwitchComponent {
2498
2509
  return `k-${guid()}`;
2499
2510
  }
2500
2511
  /**
2501
- * Sets the **On** label ([see example]({% slug labels_switch %})).
2502
- * Takes precedence over the [custom messages component]({% slug api_inputs_switchcustommessagescomponent %}).
2512
+ * Set the **On** label.
2513
+ * This label takes precedence over the [custom messages component]({% slug api_inputs_switchcustommessagescomponent %}).
2514
+ * [See example]({% slug labels_switch %}).
2503
2515
  */
2504
2516
  onLabel;
2505
2517
  /**
2506
- * Sets the **Off** label ([see example]({% slug labels_switch %})).
2507
- * Takes precedence over the [custom messages component]({% slug api_inputs_switchcustommessagescomponent %}).
2518
+ * Set the **Off** label.
2519
+ * This label takes precedence over the [custom messages component]({% slug api_inputs_switchcustommessagescomponent %}).
2520
+ * [See example]({% slug labels_switch %}).
2508
2521
  */
2509
2522
  offLabel;
2510
2523
  /**
2511
- * Sets the value of the Switch when it is initially displayed.
2524
+ * Sets the value of the Switch when it first appears.
2512
2525
  */
2513
2526
  set checked(value) {
2514
2527
  this.setHostClasses(value);
@@ -2518,27 +2531,27 @@ class SwitchComponent {
2518
2531
  return this._checked;
2519
2532
  }
2520
2533
  /**
2521
- * Determines whether the Switch is disabled ([see example]({% slug disabled_switch %})). To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_switch#toc-managing-the-switch-disabled-state-in-reactive-forms).
2534
+ * When `true`, disables the Switch.
2535
+ * [See example]({% slug disabled_switch %}).
2536
+ * To disable the component in reactive forms, see [Forms Support](slug:formssupport_switch#toc-managing-the-switch-disabled-state-in-reactive-forms).
2537
+ * @default false
2522
2538
  */
2523
2539
  disabled = false;
2524
2540
  /**
2525
- * Determines whether the Switch is in its read-only state ([see example]({% slug readonly_switch %})).
2526
- *
2541
+ * When `true`, sets the Switch to read-only.
2542
+ * [See example]({% slug readonly_switch %}).
2527
2543
  * @default false
2528
2544
  */
2529
2545
  readonly = false;
2530
2546
  /**
2531
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the Switch.
2547
+ * Set the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the Switch.
2548
+ * @default 0
2532
2549
  */
2533
2550
  tabindex = 0;
2534
2551
  /**
2535
- * Specifies the width and height of the Switch.
2552
+ * Sets the size of the Switch.
2536
2553
  *
2537
- * The possible values are:
2538
- * * `small`
2539
- * * `medium` (default)
2540
- * * `large`
2541
- * * `none`
2554
+ * @default "medium"
2542
2555
  */
2543
2556
  set size(size) {
2544
2557
  const newSize = size ? size : DEFAULT_SIZE$e;
@@ -2549,14 +2562,9 @@ class SwitchComponent {
2549
2562
  return this._size;
2550
2563
  }
2551
2564
  /**
2552
- * Specifies the border radius of the Switch thumb.
2565
+ * Sets the border radius of the Switch.
2553
2566
  *
2554
- * The possible values are:
2555
- * * `full` (default)
2556
- * * `small`
2557
- * * `medium`
2558
- * * `large`
2559
- * * `none`
2567
+ * @default "full"
2560
2568
  */
2561
2569
  set thumbRounded(thumbRounded) {
2562
2570
  const newThumbRounded = thumbRounded ? thumbRounded : DEFAULT_THUMB_ROUNDED;
@@ -2567,14 +2575,9 @@ class SwitchComponent {
2567
2575
  return this._thumbRounded;
2568
2576
  }
2569
2577
  /**
2570
- * Specifies the border radius of the Switch track.
2578
+ * Sets the border radius of the Switch track.
2571
2579
  *
2572
- * The possible values are:
2573
- * * `full` (default)
2574
- * * `small`
2575
- * * `medium`
2576
- * * `large`
2577
- * * `none`
2580
+ * @default "full"
2578
2581
  */
2579
2582
  set trackRounded(trackRounded) {
2580
2583
  const newTrackRounded = trackRounded ? trackRounded : DEFAULT_TRACK_ROUNDED;
@@ -2594,15 +2597,15 @@ class SwitchComponent {
2594
2597
  return this.tabindex;
2595
2598
  }
2596
2599
  /**
2597
- * Fires each time the Switch component is focused as a result of user interaction.
2600
+ * Fires when the user focuses the Switch.
2598
2601
  */
2599
2602
  onFocus = new EventEmitter();
2600
2603
  /**
2601
- * Fires each time the Switch component is blurred as a result of user interaction.
2604
+ * Fires when the user blurs the Switch.
2602
2605
  */
2603
2606
  onBlur = new EventEmitter();
2604
2607
  /**
2605
- * Fires each time the user selects a new value.
2608
+ * Fires when the value of the Switch changes.
2606
2609
  */
2607
2610
  valueChange = new EventEmitter();
2608
2611
  direction;
@@ -2708,17 +2711,6 @@ class SwitchComponent {
2708
2711
  /**
2709
2712
  * Focuses the Switch.
2710
2713
  *
2711
- * @example
2712
- * ```ts-no-run
2713
- * _@Component({
2714
- * selector: 'my-app',
2715
- * template: `
2716
- * <button (click)="switch.focus()">Focus</button>
2717
- * <kendo-switch #switch></kendo-switch>
2718
- * `
2719
- * })
2720
- * class AppComponent { }
2721
- * ```
2722
2714
  */
2723
2715
  focus() {
2724
2716
  if (!this.hostElement) {
@@ -3058,10 +3050,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
3058
3050
 
3059
3051
  /**
3060
3052
  * Represents the [Kendo UI TextBox directive]({% slug overview_textbox %}) for the Inputs components for Angular.
3061
- * Used to style the textbox of any `input` element.
3053
+ * Use this directive to style the textbox of any `input` element.
3062
3054
  *
3063
3055
  * @example
3064
- * ```ts-no-run
3056
+ * ```html
3065
3057
  * <input kendoTextBox />
3066
3058
  * <input kendoTextBox type="email" />
3067
3059
  * <input kendoTextBox type="password" />
@@ -3176,11 +3168,10 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
3176
3168
  }] } });
3177
3169
 
3178
3170
  /**
3179
- * Represents the [Kendo UI TextArea directive for the Inputs components for Angular]({% slug overview_textarea %}).
3180
- * Provides floating labels to `textarea` elements.
3171
+ * Represents the Kendo UI TextArea directive for the Inputs components for Angular.
3181
3172
  *
3182
3173
  * @example
3183
- * ```ts-no-run
3174
+ * ```html
3184
3175
  * <textarea kendoTextArea></textarea>
3185
3176
  * ```
3186
3177
  */
@@ -3194,18 +3185,18 @@ class TextAreaDirective {
3194
3185
  autofillClass = true;
3195
3186
  direction;
3196
3187
  /**
3197
- * Fires each time the textarea value is changed.
3188
+ * Fires when the TextArea value changes.
3198
3189
  */
3199
3190
  valueChange = new EventEmitter();
3200
3191
  /**
3201
- * Specifies if the `textarea` element will resize its height automatically
3192
+ * Sets whether the `textarea` element resizes its height automatically
3202
3193
  * ([see example](slug:textarea_sizing#toc-auto-resizing)).
3203
3194
  *
3204
3195
  * @default false
3205
3196
  */
3206
3197
  autoSize = false;
3207
3198
  /**
3208
- * Specifies the textarea value.
3199
+ * Sets the textarea value.
3209
3200
  */
3210
3201
  value;
3211
3202
  /**
@@ -3597,26 +3588,21 @@ var ArrowDirection;
3597
3588
  })(ArrowDirection || (ArrowDirection = {}));
3598
3589
 
3599
3590
  /**
3600
- * Specifies a separator in the content of components like the TextArea and the TextBox. ([see examples]({% slug adornments_textbox %}#toc-separator)).
3591
+ * Represents a separator in the content of components like TextArea and TextBox. ([see examples]({% slug adornments_textbox %}#toc-separator)).
3592
+ *
3601
3593
  * @example
3602
- * ```ts-no-run
3603
- * _@Component({
3604
- * selector: 'my-app',
3605
- * template: `
3606
- * <kendo-textbox>
3607
- * <ng-template kendoTextBoxSuffixTemplate>
3608
- * <kendo-input-separator></kendo-input-separator>
3609
- * <button kendoButton look="clear" icon="image"></button>
3610
- * </ng-template>
3611
- * </kendo-textbox>
3612
- * `
3613
- * })
3614
- * class AppComponent {}
3594
+ * ```html
3595
+ * <kendo-textbox>
3596
+ * <ng-template kendoTextBoxSuffixTemplate>
3597
+ * <kendo-input-separator></kendo-input-separator>
3598
+ * <button kendoButton icon="image"></button>
3599
+ * </ng-template>
3600
+ * </kendo-textbox>
3615
3601
  * ```
3616
3602
  */
3617
3603
  class InputSeparatorComponent {
3618
3604
  /**
3619
- * Specifies the orientation of the separator. Applicable for the adornments of the [`TextAreaComponent`](slug:api_inputs_textareacomponent).
3605
+ * Sets the orientation of the separator. Use this for the adornments of the [`TextAreaComponent`](slug:api_inputs_textareacomponent).
3620
3606
  *
3621
3607
  * @default 'vertical'
3622
3608
  */
@@ -3750,11 +3736,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
3750
3736
  */
3751
3737
  class NumericTextBoxMessages extends ComponentMessages {
3752
3738
  /**
3753
- * The title of the **Decrement** button of the NumericTextBox.
3739
+ * Sets the title of the **Decrement** button in the NumericTextBox.
3754
3740
  */
3755
3741
  decrement;
3756
3742
  /**
3757
- * The title of the **Increment** button of the NumericTextBox.
3743
+ * Sets the title of the **Increment** button in the NumericTextBox.
3758
3744
  */
3759
3745
  increment;
3760
3746
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: NumericTextBoxMessages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -3817,6 +3803,16 @@ const DEFAULT_ROUNDED$8 = 'medium';
3817
3803
  const DEFAULT_FILL_MODE$6 = 'solid';
3818
3804
  /**
3819
3805
  * Represents the [Kendo UI NumericTextBox component for Angular]({% slug overview_numerictextbox %}).
3806
+ *
3807
+ * Use this component to allow users to input numeric values.
3808
+ *
3809
+ * @example
3810
+ * ```html
3811
+ * <kendo-numerictextbox [(ngModel)]="value"></kendo-numerictextbox>
3812
+ * ```
3813
+ *
3814
+ * @remarks
3815
+ * Supported children components are: {@link NumericTextBoxCustomMessagesComponent}.
3820
3816
  */
3821
3817
  class NumericTextBoxComponent {
3822
3818
  intl;
@@ -3831,28 +3827,29 @@ class NumericTextBoxComponent {
3831
3827
  */
3832
3828
  focusableId = `k-${guid()}`;
3833
3829
  /**
3834
- * 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).
3830
+ * When `true`, disables the `NumericTextBox`.
3831
+ * To disable the component in reactive forms, see [Forms Support](slug:formssupport_numerictextbox#toc-managing-the-numerictextbox-disabled-state-in-reactive-forms).
3832
+ *
3833
+ * @default false
3835
3834
  */
3836
3835
  disabled = false;
3837
3836
  /**
3838
- * Determines whether the NumericTextBox is in its read-only state ([see example]({% slug readonly_numerictextbox %})).
3837
+ * When `true`, makes the NumericTextBox read-only.
3839
3838
  *
3840
3839
  * @default false
3841
3840
  */
3842
3841
  readonly = false;
3843
3842
  /**
3844
- * Sets the title of the `input` element of the NumericTextBox.
3843
+ * Sets the `title` attribute of the input element.
3845
3844
  */
3846
3845
  title = '';
3847
3846
  /**
3848
- * Specifies whether the value will be auto-corrected based on the minimum and maximum values
3849
- * ([see example]({% slug precision_numerictextbox %})).
3847
+ * When `true`, the value is automatically corrected based on the minimum and maximum values ([see example]({% slug precision_numerictextbox %})).
3850
3848
  */
3851
3849
  autoCorrect = false;
3852
3850
  /**
3853
- * Specifies the number format which is used when the NumericTextBox is not focused
3854
- * ([see example]({% slug formats_numerictextbox %})).
3855
- * If `format` is set to `null` or `undefined`, the default format will be used.
3851
+ * Specifies the number format used when the NumericTextBox is not focused ([see example]({% slug formats_numerictextbox %})).
3852
+ * If `format` is `null` or `undefined`, the default format is used.
3856
3853
  */
3857
3854
  get format() {
3858
3855
  const format = this._format;
@@ -3862,43 +3859,41 @@ class NumericTextBoxComponent {
3862
3859
  this._format = value;
3863
3860
  }
3864
3861
  /**
3865
- * Specifies the greatest value that is valid
3866
- * ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
3862
+ * Sets the maximum valid value ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
3867
3863
  */
3868
3864
  max;
3869
3865
  /**
3870
- * Specifies the smallest value that is valid
3871
- * ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
3866
+ * Sets the minimum valid value ([see example]({% slug precision_numerictextbox %}#toc-value-ranges)).
3872
3867
  */
3873
3868
  min;
3874
3869
  /**
3875
- * Specifies the number of decimals that the user can enter when the input is focused
3876
- * ([see example]({% slug precision_numerictextbox %})).
3870
+ * Specifies the number of decimals the user can enter when the input is focused ([see example]({% slug precision_numerictextbox %})).
3877
3871
  */
3878
3872
  decimals = null;
3879
3873
  /**
3880
- * Specifies the input placeholder.
3874
+ * Sets the input placeholder.
3881
3875
  */
3882
3876
  placeholder;
3883
3877
  /**
3884
- * Specifies the value that is used to increment or decrement the component value
3885
- * ([see example]({% slug predefinedsteps_numerictextbox %})).
3878
+ * Specifies the value used to increment or decrement the component value ([see example]({% slug predefinedsteps_numerictextbox %})).
3879
+ *
3880
+ * @default 1
3886
3881
  */
3887
3882
  step = 1;
3888
3883
  /**
3889
- * Specifies whether the **Up** and **Down** spin buttons will be rendered
3890
- * ([see example]({% slug spinbuttons_numerictextbox %})).
3884
+ * When `true`, renders the **Up** and **Down** spin buttons ([see example]({% slug spinbuttons_numerictextbox %})).
3885
+ *
3886
+ * @default true
3891
3887
  */
3892
3888
  spinners = true;
3893
3889
  /**
3894
- * Determines whether the built-in minimum or maximum validators are enforced when a form is validated.
3890
+ * Enforces the built-in minimum and maximum validators during form validation.
3895
3891
  *
3896
- * > The 4.2.0 Angular version introduces the `min` and `max` validation directives. As a result, even if you set `rangeValidation`
3897
- * > to `false`, the built-in Angular validators will be executed.
3892
+ * @default true
3898
3893
  */
3899
3894
  rangeValidation = true;
3900
3895
  /**
3901
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
3896
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
3902
3897
  */
3903
3898
  tabindex = 0;
3904
3899
  /**
@@ -3911,34 +3906,31 @@ class NumericTextBoxComponent {
3911
3906
  return this.tabindex;
3912
3907
  }
3913
3908
  /**
3914
- * Determines whether the value of the NumericTextBox will be changed via scrolling. Defaults to `true`.
3909
+ * When `true`, enables changing the value with the mouse wheel.
3915
3910
  *
3916
3911
  * @default true
3917
3912
  */
3918
3913
  changeValueOnScroll = true;
3919
3914
  /**
3920
- * Determines whether the whole value will be selected when the NumericTextBox is clicked. Defaults to `true`.
3915
+ * When `true`, enables selecting the entire value on click.
3916
+ *
3917
+ * @default true
3921
3918
  */
3922
3919
  selectOnFocus = true;
3923
3920
  /**
3924
- * Specifies the value of the NumericTextBox
3925
- * ([see example]({% slug formats_numerictextbox %})).
3921
+ * Sets the value of the NumericTextBox ([see example]({% slug formats_numerictextbox %})).
3926
3922
  */
3927
3923
  value = null;
3928
3924
  /**
3929
- * Specifies the maximum number of characters the end user can type or paste in the input.
3930
- * The locale-specific decimal separator and negative sign (`-`) are included in the length of the value when present.
3931
- * The `maxlength` restriction is not applied to the length of the formatted value when the component is not focused.
3925
+ * Sets the maximum number of characters the user can type or paste in the input.
3926
+ * The locale-specific decimal separator and negative sign (`-`) count toward the length.
3927
+ * The `maxlength` does not apply to the formatted value when the component is not focused.
3932
3928
  */
3933
3929
  maxlength;
3934
3930
  /**
3935
- * The size property specifies padding of the NumericTextBox internal input element
3936
- * ([see example]({% slug appearance_numerictextbox %}#toc-size)).
3937
- * The possible values are:
3938
- * * `small`
3939
- * * `medium` (default)
3940
- * * `large`
3941
- * * `none`
3931
+ * Sets the padding of the internal input element ([see example]({% slug appearance_numerictextbox %}#toc-size)).
3932
+ *
3933
+ * @default 'medium'
3942
3934
  */
3943
3935
  set size(size) {
3944
3936
  const newSize = size ? size : DEFAULT_SIZE$d;
@@ -3949,13 +3941,9 @@ class NumericTextBoxComponent {
3949
3941
  return this._size;
3950
3942
  }
3951
3943
  /**
3952
- * The `rounded` property specifies the border radius of the NumericTextBox
3953
- * ([see example](slug:appearance_numerictextbox#toc-roundness)).
3954
- * The possible values are:
3955
- * * `small`
3956
- * * `medium` (default)
3957
- * * `large`
3958
- * * `none`
3944
+ * Sets the border radius of the NumericTextBox ([see example](slug:appearance_numerictextbox#toc-roundness)).
3945
+ *
3946
+ * @default 'medium'
3959
3947
  */
3960
3948
  set rounded(rounded) {
3961
3949
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$8;
@@ -3966,13 +3954,9 @@ class NumericTextBoxComponent {
3966
3954
  return this._rounded;
3967
3955
  }
3968
3956
  /**
3969
- * The `fillMode` property specifies the background and border styles of the NumericTextBox
3970
- * ([see example](slug:appearance_numerictextbox#toc-fill-mode)).
3971
- * The possible values are:
3972
- * * `flat`
3973
- * * `solid` (default)
3974
- * * `outline`
3975
- * * `none`
3957
+ * Sets the background and border styles of the NumericTextBox ([see example](slug:appearance_numerictextbox#toc-fill-mode)).
3958
+ *
3959
+ * @default 'solid'
3976
3960
  */
3977
3961
  set fillMode(fillMode) {
3978
3962
  const newFillMode = fillMode ? fillMode : DEFAULT_FILL_MODE$6;
@@ -3983,7 +3967,8 @@ class NumericTextBoxComponent {
3983
3967
  return this._fillMode;
3984
3968
  }
3985
3969
  /**
3986
- * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
3970
+ * Sets HTML attributes on the inner input element.
3971
+ * The component ignores attributes that are essential for its functionality.
3987
3972
  */
3988
3973
  set inputAttributes(attributes) {
3989
3974
  if (isObjectPresent(this.parsedAttributes)) {
@@ -3999,23 +3984,23 @@ class NumericTextBoxComponent {
3999
3984
  return this._inputAttributes;
4000
3985
  }
4001
3986
  /**
4002
- * Fires each time the user selects a new value ([see example](slug:events_numerictextbox)).
3987
+ * Fires when the user selects a new value ([see example](slug:events_numerictextbox)).
4003
3988
  */
4004
3989
  valueChange = new EventEmitter();
4005
3990
  /**
4006
- * Fires each time the user focuses the NumericTextBox element ([see example](slug:events_numerictextbox)).
3991
+ * Fires when the NumericTextBox element is focused ([see example](slug:events_numerictextbox)).
4007
3992
  */
4008
3993
  onFocus = new EventEmitter();
4009
3994
  /**
4010
- * Fires each time the NumericTextBox component gets blurred ([see example](slug:events_numerictextbox)).
3995
+ * Fires when the `NumericTextBox` component gets blurred ([see example](slug:events_numerictextbox)).
4011
3996
  */
4012
3997
  onBlur = new EventEmitter();
4013
3998
  /**
4014
- * Fires each time the user focuses the `input` element.
3999
+ * Fires when the input element is focused.
4015
4000
  */
4016
4001
  inputFocus = new EventEmitter();
4017
4002
  /**
4018
- * Fires each time the `input` element gets blurred.
4003
+ * Fires when the input element gets blurred.
4019
4004
  */
4020
4005
  inputBlur = new EventEmitter();
4021
4006
  /**
@@ -4231,18 +4216,6 @@ class NumericTextBoxComponent {
4231
4216
  }
4232
4217
  /**
4233
4218
  * Focuses the NumericTextBox.
4234
- *
4235
- * @example
4236
- * ```ts-no-run
4237
- * _@Component({
4238
- * selector: 'my-app',
4239
- * template: `
4240
- * <button (click)="numerictextbox.focus()">Focus NumericTextBox</button>
4241
- * <kendo-numerictextbox #numerictextbox></kendo-numerictextbox>
4242
- * `
4243
- * })
4244
- * class AppComponent { }
4245
- * ```
4246
4219
  */
4247
4220
  focus() {
4248
4221
  invokeElementMethod(this.numericInput, 'focus');
@@ -4254,7 +4227,7 @@ class NumericTextBoxComponent {
4254
4227
  invokeElementMethod(this.numericInput, 'blur');
4255
4228
  }
4256
4229
  /**
4257
- * Notifies the `NumericTextBoxComponent` that the input value should be changed.
4230
+ * Notifies the NumericTextBoxComponent that the input value should be changed.
4258
4231
  * Can be used to update the input after setting the component properties directly.
4259
4232
  */
4260
4233
  notifyValueChange() {
@@ -5082,7 +5055,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
5082
5055
  }] } });
5083
5056
 
5084
5057
  /**
5085
- * Custom component messages override default component messages.
5058
+ * Overrides the default messages of the NumericTextBox component.
5059
+ *
5060
+ * Use this component to provide custom messages for the NumericTextBox.
5061
+ *
5062
+ * @example
5063
+ * ```html
5064
+ * <kendo-numerictextbox>
5065
+ * <kendo-numerictextbox-messages
5066
+ * [increment]="'Custom Increment Message'"
5067
+ * [decrement]="'Custom Decrement Message'">
5068
+ * </kendo-numerictextbox-messages>
5069
+ * <kendo-numerictextbox>
5070
+ * ```
5086
5071
  */
5087
5072
  class NumericTextBoxCustomMessagesComponent extends NumericTextBoxMessages {
5088
5073
  service;
@@ -5554,21 +5539,21 @@ const DEFAULT_FILL_MODE$5 = 'solid';
5554
5539
  * Represents the [Kendo UI MaskedTextBox component for Angular]({% slug overview_maskedtextbox %}).
5555
5540
  *
5556
5541
  * @example
5557
- * ```ts-no-run
5542
+ * ```typescript
5543
+ * import { Component } from '@angular/core';
5558
5544
  *
5559
- * _@Component({
5560
- * selector: 'my-app',
5561
- * template: `
5562
- * <kendo-maskedtextbox
5563
- * [mask]="mask"
5564
- * [value]="value">
5565
- * </kendo-maskedtextbox>
5566
- * `
5545
+ * @Component({
5546
+ * selector: 'my-app',
5547
+ * template: `
5548
+ * <kendo-maskedtextbox
5549
+ * [mask]="mask"
5550
+ * [value]="value">
5551
+ * </kendo-maskedtextbox>
5552
+ * `
5567
5553
  * })
5568
- *
5569
- * class AppComponent {
5570
- * public value: string = "9580128055807792";
5571
- * public mask: string = "0000-0000-0000-0000";
5554
+ * export class AppComponent {
5555
+ * public value: string = "9580128055807792";
5556
+ * public mask: string = "0000-0000-0000-0000";
5572
5557
  * }
5573
5558
  * ```
5574
5559
  */
@@ -5584,27 +5569,23 @@ class MaskedTextBoxComponent {
5584
5569
  */
5585
5570
  focusableId = `k-${guid()}`;
5586
5571
  /**
5587
- * Determines whether the MaskedTextBox is disabled ([see example]({% slug disabled_maskedtextbox %})). To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_maskedtextbox#toc-managing-the-maskedtextbox-disabled-state-in-reactive-forms).
5572
+ * Disables the MaskedTextBox when you set it to `true` ([see example]({% slug disabled_maskedtextbox %})).
5573
+ * To disable the component in reactive forms, see [Forms Support](slug:formssupport_maskedtextbox#toc-managing-the-maskedtextbox-disabled-state-in-reactive-forms).
5574
+ * @default false
5588
5575
  */
5589
5576
  disabled = false;
5590
5577
  /**
5591
- * Determines whether the MaskedTextBox is in its read-only state ([see example]({% slug readonly_maskedtextbox %})).
5592
- *
5578
+ * When `true`, sets the MaskedTextBox to read-only mode ([see example]({% slug readonly_maskedtextbox %})).
5593
5579
  * @default false
5594
5580
  */
5595
5581
  readonly = false;
5596
5582
  /**
5597
- * Sets the title of the `input` element.
5583
+ * Sets the `title` attribute of the input element.
5598
5584
  */
5599
5585
  title;
5600
5586
  /**
5601
- * The size property specifies the padding of the MaskedTextBox internal input element
5602
- * ([see example]({% slug appearance_maskedtextbox %}#toc-size)).
5603
- * The possible values are:
5604
- * * `small`
5605
- * * `medium` (default)
5606
- * * `large`
5607
- * * `none`
5587
+ * Sets the padding size of the MaskedTextBox input element ([see example]({% slug appearance_maskedtextbox %}#toc-size)).
5588
+ * @default 'medium'
5608
5589
  */
5609
5590
  set size(size) {
5610
5591
  const newSize = size ? size : DEFAULT_SIZE$c;
@@ -5615,13 +5596,8 @@ class MaskedTextBoxComponent {
5615
5596
  return this._size;
5616
5597
  }
5617
5598
  /**
5618
- * The rounded property specifies the border radius of the MaskedTextBox
5619
- * ([see example](slug:appearance_maskedtextbox#toc-roundness)).
5620
- * The possible values are:
5621
- * * `small`
5622
- * * `medium` (default)
5623
- * * `large`
5624
- * * `none`
5599
+ * Sets the border radius of the MaskedTextBox ([see example](slug:appearance_maskedtextbox#toc-roundness)).
5600
+ * @default 'medium'
5625
5601
  */
5626
5602
  set rounded(rounded) {
5627
5603
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$7;
@@ -5632,13 +5608,8 @@ class MaskedTextBoxComponent {
5632
5608
  return this._rounded;
5633
5609
  }
5634
5610
  /**
5635
- * The `fillMode` property specifies the background and border styles of the MaskedTexBox
5636
- * ([see example]({% slug appearance_maskedtextbox %}#toc-fill-mode)).
5637
- * The possible values are:
5638
- * * `flat`
5639
- * * `solid` (default)
5640
- * * `outline`
5641
- * * `none`
5611
+ * Sets the background and border style of the MaskedTextBox ([see example]({% slug appearance_maskedtextbox %}#toc-fill-mode)).
5612
+ * @default 'solid'
5642
5613
  */
5643
5614
  set fillMode(fillMode) {
5644
5615
  const newFillMode = fillMode ? fillMode : DEFAULT_FILL_MODE$5;
@@ -5649,19 +5620,19 @@ class MaskedTextBoxComponent {
5649
5620
  return this._fillMode;
5650
5621
  }
5651
5622
  /**
5652
- * Represents the current mask ([see example]({% slug value_maskedtextbox %})).
5653
- * If no mask is set, the component behaves as a standard `type="text"` input.
5623
+ * Sets the mask pattern for the MaskedTextBox ([see example]({% slug value_maskedtextbox %})).
5624
+ * If you do not set a mask, the component acts as a standard `type="text"` input.
5654
5625
  *
5655
- * > If the mask allows for spaces, set the [promptPlaceholder]({% slug api_inputs_maskedtextboxcomponent %}#toc-promptplaceholder)
5656
- * to a character that is not accepted by the mask.
5626
+ * If the mask allows spaces, set the [`promptPlaceholder`]({% slug api_inputs_maskedtextboxcomponent %}#toc-promptplaceholder)
5627
+ * to a character that the mask does not accept.
5657
5628
  */
5658
5629
  mask;
5659
5630
  /**
5660
- * Provides a value for the MaskedTextBox.
5631
+ * Sets the value of the MaskedTextBox.
5661
5632
  */
5662
5633
  value;
5663
5634
  /**
5664
- * Exposes the RegExp-based mask validation array ([see example]({% slug masks_maskedtextbox %})).
5635
+ * Sets the RegExp-based mask validation rules ([see example]({% slug masks_maskedtextbox %})).
5665
5636
  */
5666
5637
  set rules(value) {
5667
5638
  this._rules = Object.assign({}, this.defaultRules, value);
@@ -5670,32 +5641,31 @@ class MaskedTextBoxComponent {
5670
5641
  return this._rules || this.defaultRules;
5671
5642
  }
5672
5643
  /**
5673
- * Represents a prompt character for the masked value.
5644
+ * Sets the prompt character for the masked value.
5674
5645
  * @default `_`
5675
5646
  */
5676
5647
  prompt = '_';
5677
5648
  /**
5678
- * Indicates a character which represents an empty position in the raw value.
5649
+ * Sets the character that represents an empty position in the raw value.
5679
5650
  * @default ' '
5680
5651
  */
5681
5652
  promptPlaceholder = ' ';
5682
5653
  /**
5683
- * Indicates whether to include literals in the raw value ([see example]({% slug value_maskedtextbox %})).
5654
+ * When `true` includes literals in the raw value ([see example]({% slug value_maskedtextbox %})).
5684
5655
  * @default false
5685
5656
  */
5686
5657
  includeLiterals = false;
5687
5658
  /**
5688
- * Specifies if the mask should be shown on focus for empty value.
5659
+ * Shows the mask on focus when the value is empty.
5689
5660
  */
5690
5661
  maskOnFocus = false;
5691
5662
  /**
5692
- * Determines whether the built-in mask validator is enforced when a form is validated
5693
- * ([see example]({% slug validation_maskedtextbox %})).
5663
+ * Enables the built-in mask validator when you set it to `true` ([see example]({% slug validation_maskedtextbox %})).
5694
5664
  * @default true
5695
5665
  */
5696
5666
  maskValidation = true;
5697
5667
  /**
5698
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
5668
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) attribute of the component.
5699
5669
  */
5700
5670
  tabindex = 0;
5701
5671
  /**
@@ -5708,7 +5678,8 @@ class MaskedTextBoxComponent {
5708
5678
  return this.tabindex;
5709
5679
  }
5710
5680
  /**
5711
- * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
5681
+ * Sets HTML attributes for the inner input element.
5682
+ * You cannot change attributes that are essential for component functionality.
5712
5683
  */
5713
5684
  set inputAttributes(attributes) {
5714
5685
  if (isObjectPresent(this.parsedAttributes)) {
@@ -5744,57 +5715,29 @@ class MaskedTextBoxComponent {
5744
5715
  };
5745
5716
  }
5746
5717
  /**
5747
- * Fires each time the user focuses the MaskedTextBox component.
5718
+ * Fires when the MaskedTextBox gets focused.
5748
5719
  *
5749
- * > To wire the event programmatically, use the `onFocus` property.
5720
+ * To subscribe programmatically, use the `onFocus` property.
5750
5721
  *
5751
- * @example
5752
- * ```ts-no-run
5753
- * _@Component({
5754
- * selector: 'my-app',
5755
- * template: `
5756
- * <kendo-maskedtextbox (focus)="handleFocus()"></kendo-maskedtextbox>
5757
- * `
5758
- * })
5759
- * class AppComponent {
5760
- * public handleFocus(): void {
5761
- * console.log("Component is focused");
5762
- * }
5763
- * }
5764
- * ```
5765
5722
  */
5766
5723
  onFocus = new EventEmitter();
5767
5724
  /**
5768
- * Fires each time the MaskedTextBox component gets blurred.
5725
+ * Fires when the MaskedTextBox gets blurred.
5769
5726
  *
5770
- * > To wire the event programmatically, use the `onBlur` property.
5727
+ * To subscribe programmatically, use the `onBlur` property.
5771
5728
  *
5772
- * @example
5773
- * ```ts-no-run
5774
- * _@Component({
5775
- * selector: 'my-app',
5776
- * template: `
5777
- * <kendo-maskedtextbox (blur)="handleBlur()"></kendo-maskedtextbox>
5778
- * `
5779
- * })
5780
- * class AppComponent {
5781
- * public handleBlur(): void {
5782
- * console.log("Component is blurred");
5783
- * }
5784
- * }
5785
- * ```
5786
5729
  */
5787
5730
  onBlur = new EventEmitter();
5788
5731
  /**
5789
- * Fires each time the user focuses the `input` element.
5732
+ * Fires when the input element gets focused.
5790
5733
  */
5791
5734
  inputFocus = new EventEmitter();
5792
5735
  /**
5793
- * Fires each time the `input` element gets blurred.
5736
+ * Fires when the input element gets blurred.
5794
5737
  */
5795
5738
  inputBlur = new EventEmitter();
5796
5739
  /**
5797
- * Fires each time the value changes.
5740
+ * Fires when the value changes.
5798
5741
  */
5799
5742
  valueChange = new EventEmitter();
5800
5743
  direction;
@@ -5803,7 +5746,7 @@ class MaskedTextBoxComponent {
5803
5746
  return this.disabled;
5804
5747
  }
5805
5748
  /**
5806
- * Represents the `ElementRef` of the visible `input` element.
5749
+ * Returns the `ElementRef` of the visible `input` element.
5807
5750
  */
5808
5751
  input;
5809
5752
  /**
@@ -6483,11 +6426,6 @@ class RadioCheckBoxBase {
6483
6426
  *
6484
6427
  * @default 'medium'
6485
6428
  *
6486
- * The possible values are:
6487
- * * `small`
6488
- * * `medium`
6489
- * * `large`
6490
- * * `none`
6491
6429
  */
6492
6430
  set size(size) {
6493
6431
  const newSize = size ? size : DEFAULT_SIZE$b;
@@ -6519,13 +6457,11 @@ class RadioCheckBoxBase {
6519
6457
  /**
6520
6458
  * Fires each time the user focuses the component.
6521
6459
  *
6522
- * > To wire the event programmatically, use the `onFocus` property.
6523
6460
  */
6524
6461
  onFocus = new EventEmitter();
6525
6462
  /**
6526
6463
  * Fires each time the component gets blurred.
6527
6464
  *
6528
- * > To wire the event programmatically, use the `onBlur` property.
6529
6465
  */
6530
6466
  onBlur = new EventEmitter();
6531
6467
  /**
@@ -6724,6 +6660,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6724
6660
  }] } });
6725
6661
 
6726
6662
  const DEFAULT_ROUNDED$6 = 'medium';
6663
+ /**
6664
+ * Represents the Kendo UI CheckBox component for Angular.
6665
+ * Use this component to create a styled checkbox with support for indeterminate state.
6666
+ *
6667
+ * @example
6668
+ * ```html
6669
+ * <kendo-checkbox [(checkedState)]="value"></kendo-checkbox>
6670
+ * ```
6671
+ */
6727
6672
  class CheckBoxComponent extends RadioCheckBoxBase {
6728
6673
  renderer;
6729
6674
  hostElement;
@@ -6734,6 +6679,8 @@ class CheckBoxComponent extends RadioCheckBoxBase {
6734
6679
  /**
6735
6680
  * Sets the checked state of the component.
6736
6681
  *
6682
+ * Use `true`, `false`, or `'indeterminate'` to control the state.
6683
+ *
6737
6684
  * @default false
6738
6685
  */
6739
6686
  set checkedState(value) {
@@ -6747,16 +6694,10 @@ class CheckBoxComponent extends RadioCheckBoxBase {
6747
6694
  return this._checkedState;
6748
6695
  }
6749
6696
  /**
6750
- * The rounded property specifies the border radius of the CheckBox
6697
+ * Sets the `rounded` property to specify the border radius of the CheckBox
6751
6698
  * ([see example](slug:appearance_checkboxdirective#toc-roundness)).
6752
6699
  *
6753
6700
  * @default 'medium'
6754
- *
6755
- * The possible values are:
6756
- * * `small`
6757
- * * `medium`
6758
- * * `large`
6759
- * * `none`
6760
6701
  */
6761
6702
  set rounded(rounded) {
6762
6703
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$6;
@@ -6767,12 +6708,9 @@ class CheckBoxComponent extends RadioCheckBoxBase {
6767
6708
  return this._rounded;
6768
6709
  }
6769
6710
  /**
6770
- * Fires each time the inner input's checked state is changed.
6771
- * When the state of the component is programmatically changed to `ngModel` or `formControl`
6772
- * through its API or form binding, the `checkedStateChange` event is not triggered because it
6773
- * might cause a mix-up with the built-in mechanisms of the `ngModel` or `formControl` bindings.
6774
- *
6775
- * Used to provide a two-way binding for the `checkedState` property.
6711
+ * Fires when the inner input's checked state changes.
6712
+ * This event does not fire when you change the state programmatically using `ngModel` or `formControl`.
6713
+ * Use this event for two-way binding with the `checkedState` property.
6776
6714
  */
6777
6715
  checkedStateChange = new EventEmitter();
6778
6716
  /**
@@ -6937,11 +6875,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
6937
6875
  const DEFAULT_SIZE$a = 'medium';
6938
6876
  const DEFAULT_ROUNDED$5 = 'medium';
6939
6877
  /**
6940
- * Represents the directive that renders the [Kendo UI CheckBox]({% slug overview_checkbox %}) input component.
6941
- * The directive is placed on input type="checkbox" elements.
6878
+ * Renders the [Kendo UI CheckBox]({% slug overview_checkbox %}) input component.
6879
+ * Apply this directive to `input type="checkbox"` HTML elements.
6942
6880
  *
6943
6881
  * @example
6944
- * ```ts-no-run
6882
+ * ```html
6945
6883
  * <input type="checkbox" kendoCheckBox />
6946
6884
  * ```
6947
6885
  */
@@ -6950,14 +6888,10 @@ class CheckBoxDirective {
6950
6888
  hostElement;
6951
6889
  kendoClass = true;
6952
6890
  /**
6953
- * The size property specifies the width and height of the CheckBox
6891
+ * Sets the `size` property to specify the width and height of the CheckBox
6954
6892
  * ([see example]({% slug appearance_checkboxdirective %}#toc-size)).
6955
6893
  *
6956
- * The possible values are:
6957
- * * `small`
6958
- * * `medium` (default)
6959
- * * `large`
6960
- * * `none`
6894
+ * @default 'medium'
6961
6895
  */
6962
6896
  set size(size) {
6963
6897
  const newSize = size ? size : DEFAULT_SIZE$a;
@@ -6968,14 +6902,11 @@ class CheckBoxDirective {
6968
6902
  return this._size;
6969
6903
  }
6970
6904
  /**
6971
- * The rounded property specifies the border radius of the CheckBox
6905
+ * Sets the `rounded` property to specify the border radius of the CheckBox
6972
6906
  * ([see example](slug:appearance_checkboxdirective#toc-roundness)).
6973
6907
  *
6974
- * The possible values are:
6975
- * * `small`
6976
- * * `medium` (default)
6977
- * * `large`
6978
- * * `none`
6908
+ * @default 'medium'
6909
+ *
6979
6910
  */
6980
6911
  set rounded(rounded) {
6981
6912
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$5;
@@ -7404,25 +7335,21 @@ const isJapanese = (input) => {
7404
7335
  };
7405
7336
 
7406
7337
  /**
7407
- * Specifies the adornments in the suffix container ([see examples](slug:adornments_textbox#toc-suffix-adornments)).
7408
- * ```ts-no-run
7409
- * _@Component({
7410
- * selector: 'my-app',
7411
- * template: `
7412
- * <kendo-textbox>
7413
- * <ng-template kendoTextBoxSuffixTemplate>
7414
- * <button kendoButton look="clear" icon="image"></button>
7415
- * </ng-template>
7416
- * </kendo-textbox>
7417
- * `
7418
- * })
7419
- * class AppComponent {}
7338
+ * Represents a template for suffix adornments in the TextBox component ([see examples](slug:adornments_textbox#toc-suffix-adornments)).
7339
+ *
7340
+ * @example
7341
+ * ```html
7342
+ * <kendo-textbox>
7343
+ * <ng-template kendoTextBoxSuffixTemplate>
7344
+ * <button kendoButton icon="image"></button>
7345
+ * </ng-template>
7346
+ * </kendo-textbox>
7420
7347
  * ```
7421
7348
  */
7422
7349
  class TextBoxSuffixTemplateDirective {
7423
7350
  templateRef;
7424
7351
  /**
7425
- * Sets the `showSeparator` attribute of the `kendoTextBoxSuffixTemplate`.
7352
+ * Determines whether a separator is shown before the suffix template.
7426
7353
  *
7427
7354
  * @default false
7428
7355
  */
@@ -7452,26 +7379,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
7452
7379
  }] } });
7453
7380
 
7454
7381
  /**
7455
- * Specifies the adornments in the prefix container ([see examples](slug:adornments_textbox#toc-prefix-adornments)).
7382
+ * Represents a template for prefix adornments in the TextBox component ([see examples](slug:adornments_textbox#toc-prefix-adornments)).
7383
+ *
7456
7384
  * @example
7457
- * ```ts-no-run
7458
- * _@Component({
7459
- * selector: 'my-app',
7460
- * template: `
7461
- * <kendo-textbox>
7462
- * <ng-template kendoTextBoxPrefixTemplate>
7463
- * <button kendoButton look="clear" icon="image"></button>
7464
- * </ng-template>
7385
+ * ```html
7386
+ * <kendo-textbox>
7387
+ * <ng-template kendoTextBoxPrefixTemplate>
7388
+ * <button kendoButton icon="image"></button>
7389
+ * </ng-template>
7465
7390
  * </kendo-textbox>
7466
- * `
7467
- * })
7468
- * class AppComponent {}
7391
+
7469
7392
  * ```
7470
7393
  */
7471
7394
  class TextBoxPrefixTemplateDirective {
7472
7395
  templateRef;
7473
7396
  /**
7474
- * Sets the `showSeparator` attribute of the `kendoTextBoxPrefixTemplate`.
7397
+ * Determines whether a separator is shown after the prefix template.
7475
7398
  *
7476
7399
  * @default false
7477
7400
  */
@@ -7558,6 +7481,18 @@ const DEFAULT_SIZE$9 = 'medium';
7558
7481
  const DEFAULT_ROUNDED$4 = 'medium';
7559
7482
  const DEFAULT_FILL_MODE$4 = 'solid';
7560
7483
  const iconsMap$1 = { checkIcon, exclamationCircleIcon, xIcon };
7484
+ /**
7485
+ * Represents the Kendo UI TextBox component for Angular.
7486
+ * Use this component to create styled and feature-rich text input fields.
7487
+ *
7488
+ * @example
7489
+ * ```html
7490
+ * <kendo-textbox placeholder="Enter text"></kendo-textbox>
7491
+ * ```
7492
+ *
7493
+ * @remarks
7494
+ * Supported children components are: {@link TextBoxCustomMessagesComponent}.
7495
+ */
7561
7496
  class TextBoxComponent {
7562
7497
  localizationService;
7563
7498
  ngZone;
@@ -7575,23 +7510,21 @@ class TextBoxComponent {
7575
7510
  title;
7576
7511
  /**
7577
7512
  * Sets the `type` attribute of the `input` element of the TextBox.
7513
+ * @default 'text'
7578
7514
  */
7579
7515
  type = 'text';
7580
7516
  /**
7581
- * Sets the disabled state of the TextBox. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_textbox#toc-managing-the-textbox-disabled-state-in-reactive-forms).
7582
- *
7517
+ * Sets the disabled state of the TextBox. To disable the component in reactive forms, see [Forms Support](slug:formssupport_textbox#toc-managing-the-textbox-disabled-state-in-reactive-forms).
7583
7518
  * @default false
7584
7519
  */
7585
7520
  disabled = false;
7586
7521
  /**
7587
7522
  * Sets the read-only state of the component.
7588
- *
7589
7523
  * @default false
7590
7524
  */
7591
7525
  readonly = false;
7592
7526
  /**
7593
7527
  * Specifies the `tabindex` of the TextBox.
7594
- *
7595
7528
  * @default 0
7596
7529
  */
7597
7530
  tabindex = 0;
@@ -7600,74 +7533,54 @@ class TextBoxComponent {
7600
7533
  */
7601
7534
  value = null;
7602
7535
  /**
7603
- * Determines whether the whole value will be selected when the TextBox is clicked. Defaults to `false`.
7604
- *
7536
+ * Highlights the whole value when you click the TextBox.
7605
7537
  * @default false
7606
7538
  */
7607
7539
  selectOnFocus = false;
7608
7540
  /**
7609
- * Specifies when the Success icon will be shown ([see example]({% slug validation_textbox %})).
7610
- *
7611
- * The possible values are:
7612
- *
7613
- * `boolean`&mdash;The Success icon is displayed, if the condition given by the developer is met.
7614
- *
7615
- * `initial`&mdash;The Success icon will be displayed when the component state is neither `invalid` nor `touched` or `dirty`.
7541
+ * Specifies when to show the Success icon ([see example]({% slug validation_textbox %})).
7616
7542
  *
7617
7543
  * @default false
7618
7544
  */
7619
7545
  showSuccessIcon = false;
7620
7546
  /**
7621
- * Specifies when the Error icon will be shown ([see example]({% slug validation_textbox %})).
7622
- *
7623
- * The possible values are:
7624
- *
7625
- * * `initial`&mdash;The Error icon will be displayed when the component state is
7626
- * `invalid` and `touched` or `dirty`.
7627
- * * `boolean`&mdash;The Error icon is displayed, if the condition given by the developer is met.
7547
+ * Specifies when to show the Error icon ([see example]({% slug validation_textbox %})).
7628
7548
  *
7629
7549
  * @default false
7630
7550
  */
7631
7551
  showErrorIcon = false;
7632
7552
  /**
7633
- * Specifies whether a Clear button will be rendered.
7634
- *
7553
+ * Shows a **Clear** button in the TextBox.
7635
7554
  * @default false
7636
7555
  */
7637
7556
  clearButton = false;
7638
7557
  /**
7639
- * Sets a custom icon that will be rendered instead of the default one for a valid user input.
7558
+ * Sets a custom icon for valid user input.
7640
7559
  */
7641
7560
  successIcon;
7642
7561
  /**
7643
- * Sets a custom SVG icon that will be rendered instead of the default one for a valid user input.
7562
+ * Sets a custom SVG icon for valid user input.
7644
7563
  */
7645
7564
  successSvgIcon;
7646
7565
  /**
7647
- * Sets a custom icon that will be rendered instead of the default one for invalid user input.
7566
+ * Sets a custom icon for invalid user input.
7648
7567
  */
7649
7568
  errorIcon;
7650
7569
  /**
7651
- * Sets a custom SVG icon that will be rendered instead of the default one for invalid user input.
7570
+ * Sets a custom SVG icon for invalid user input.
7652
7571
  */
7653
7572
  errorSvgIcon;
7654
7573
  /**
7655
- * Sets a custom icon that will be rendered instead of the default one.
7574
+ * Sets a custom icon for the **Clear** button.
7656
7575
  */
7657
7576
  clearButtonIcon;
7658
7577
  /**
7659
- * Sets a custom SVG icon that will be rendered instead of the default one.
7578
+ * Sets a custom SVG icon for the **Clear** button.
7660
7579
  */
7661
7580
  clearButtonSvgIcon;
7662
7581
  /**
7663
- * The size property specifies the padding of the TextBox internal input element
7664
- * ([see example]({% slug appearance_textbox %}#toc-size)).
7665
- *
7666
- * The possible values are:
7667
- * * `small`
7668
- * * `medium` (default)
7669
- * * `large`
7670
- * * `none`
7582
+ * Sets the padding of the TextBox internal input element ([see example]({% slug appearance_textbox %}#toc-size)).
7583
+ * @default 'medium'
7671
7584
  */
7672
7585
  set size(size) {
7673
7586
  const newSize = size ? size : DEFAULT_SIZE$9;
@@ -7678,15 +7591,8 @@ class TextBoxComponent {
7678
7591
  return this._size;
7679
7592
  }
7680
7593
  /**
7681
- * The `rounded` property specifies the border radius of the TextBox
7682
- * ([see example](slug:appearance_textbox#toc-roundness)).
7683
- *
7684
- * The possible values are:
7685
- * * `small`
7686
- * * `medium` (default)
7687
- * * `large`
7688
- * * `full`
7689
- * * `none`
7594
+ * Sets the border radius of the TextBox ([see example](slug:appearance_textbox#toc-roundness)).
7595
+ * @default 'medium'
7690
7596
  */
7691
7597
  set rounded(rounded) {
7692
7598
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$4;
@@ -7697,14 +7603,8 @@ class TextBoxComponent {
7697
7603
  return this._rounded;
7698
7604
  }
7699
7605
  /**
7700
- * The `fillMode` property specifies the background and border styles of the TextBox
7701
- * ([see example]({% slug appearance_textbox %}#toc-fill-mode)).
7702
- *
7703
- * The possible values are:
7704
- * * `flat`
7705
- * * `solid` (default)
7706
- * * `outline`
7707
- * * `none`
7606
+ * Sets the background and border styles of the TextBox ([see example]({% slug appearance_textbox %}#toc-fill-mode)).
7607
+ * @default 'solid'
7708
7608
  */
7709
7609
  set fillMode(fillMode) {
7710
7610
  const newFillMode = fillMode ? fillMode : DEFAULT_FILL_MODE$4;
@@ -7724,15 +7624,15 @@ class TextBoxComponent {
7724
7624
  return this.tabindex;
7725
7625
  }
7726
7626
  /**
7727
- * The hint, which is displayed when the component is empty.
7627
+ * Sets the placeholder text displayed when the component is empty.
7728
7628
  */
7729
7629
  placeholder;
7730
7630
  /**
7731
- * Specifies the maximum length of the TextBox value.
7631
+ * Sets the maximum length of the TextBox value.
7732
7632
  */
7733
7633
  maxlength;
7734
7634
  /**
7735
- * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
7635
+ * Sets the HTML attributes of the inner focusable input element. You cannot change attributes that are essential for component functionality.
7736
7636
  */
7737
7637
  set inputAttributes(attributes) {
7738
7638
  if (isObjectPresent(this.parsedAttributes)) {
@@ -7748,66 +7648,30 @@ class TextBoxComponent {
7748
7648
  return this._inputAttributes;
7749
7649
  }
7750
7650
  /**
7751
- * Fires each time the value is changed&mdash;
7752
- * when the component is blurred or the value is cleared through the **Clear** button
7753
- * ([see example](slug:events_textbox)).
7754
- * When the value of the component is programmatically changed to `ngModel` or `formControl`
7755
- * through its API or form binding, the `valueChange` event is not triggered because it
7756
- * might cause a mix-up with the built-in `valueChange` mechanisms of the `ngModel` or `formControl` bindings.
7651
+ * Fires when the value changes—when the component is blurred or the value is cleared through the **Clear** button ([see example](slug:events_textbox)).
7652
+ * Does not fire when you change the value programmatically through `ngModel` or `formControl`.
7757
7653
  */
7758
7654
  valueChange = new EventEmitter();
7759
7655
  /**
7760
- * Fires each time the user focuses the `input` element.
7656
+ * Fires when the user focuses the `input` element.
7761
7657
  */
7762
7658
  inputFocus = new EventEmitter();
7763
7659
  /**
7764
- * Fires each time the `input` element gets blurred.
7660
+ * Fires when the `input` element is blurred.
7765
7661
  */
7766
7662
  inputBlur = new EventEmitter();
7767
7663
  /**
7768
- * Fires each time the user focuses the TextBox component.
7664
+ * Fires when the user focuses the TextBox component.
7769
7665
  *
7770
- * > To wire the event programmatically, use the `onFocus` property.
7771
- *
7772
- * @example
7773
- * ```ts-no-run
7774
- * _@Component({
7775
- * selector: 'my-app',
7776
- * template: `
7777
- * <kendo-textbox (focus)="handleFocus()"></kendo-textbox>
7778
- * `
7779
- * })
7780
- * class AppComponent {
7781
- * public handleFocus(): void {
7782
- * console.log('Component is focused.');
7783
- * }
7784
- * }
7785
- * ```
7786
7666
  */
7787
7667
  onFocus = new EventEmitter();
7788
7668
  /**
7789
- * Fires each time the TextBox component gets blurred.
7790
- *
7791
- * > To wire the event programmatically, use the `onBlur` property.
7669
+ * Fires when the TextBox component is blurred.
7792
7670
  *
7793
- * @example
7794
- * ```ts-no-run
7795
- * _@Component({
7796
- * selector: 'my-app',
7797
- * template: `
7798
- * <kendo-textbox (blur)="handleBlur()"></kendo-textbox>
7799
- * `
7800
- * })
7801
- * class AppComponent {
7802
- * public handleBlur(): void {
7803
- * console.log('Component is blurred');
7804
- * }
7805
- * }
7806
- * ```
7807
7671
  */
7808
7672
  onBlur = new EventEmitter();
7809
7673
  /**
7810
- * Represents the visible `input` element of the TextBox.
7674
+ * Gets a reference to the visible `input` element of the TextBox.
7811
7675
  */
7812
7676
  input;
7813
7677
  /**
@@ -7916,18 +7780,6 @@ class TextBoxComponent {
7916
7780
  }
7917
7781
  /**
7918
7782
  * Focuses the TextBox.
7919
- *
7920
- * @example
7921
- * ```ts-no-run
7922
- * _@Component({
7923
- * selector: 'my-app',
7924
- * template: `
7925
- * <button (click)="input.focus()">Focus the input</button>
7926
- * <kendo-textbox #input></kendo-textbox>
7927
- * `
7928
- * })
7929
- * class AppComponent { }
7930
- * ```
7931
7783
  */
7932
7784
  focus() {
7933
7785
  if (!this.input) {
@@ -7939,7 +7791,7 @@ class TextBoxComponent {
7939
7791
  this.focusChangedProgrammatically = false;
7940
7792
  }
7941
7793
  /**
7942
- * Blurs the TextBox.
7794
+ * Removes focus from the TextBox.
7943
7795
  */
7944
7796
  blur() {
7945
7797
  this.focusChangedProgrammatically = true;
@@ -8549,38 +8401,38 @@ class ColorInputComponent {
8549
8401
  cdr;
8550
8402
  localizationService;
8551
8403
  /**
8552
- * The id of the hex input.
8404
+ * Sets the `id` of the hex input.
8553
8405
  */
8554
8406
  focusableId = `k-${guid()}`;
8555
8407
  /**
8556
- * The color format view.
8408
+ * Sets the color format view.
8557
8409
  */
8558
8410
  formatView;
8559
8411
  /**
8560
- * The size property specifies the padding of the ColorInput.
8412
+ * Sets the size of the ColorInput.
8561
8413
  *
8562
- * The possible values are:
8563
- * * `small`
8564
- * * `medium` (default)
8565
- * * `large`
8566
- * * `none`
8414
+ * @default 'medium'
8567
8415
  */
8568
8416
  size = DEFAULT_SIZE$8;
8569
8417
  /**
8570
- * The inputs tabindex.
8418
+ * Sets the `tabindex` of the inputs.
8419
+ * @default -1
8571
8420
  */
8572
8421
  tabindex = -1;
8573
8422
  /**
8574
- * The color value that will be parsed and populate the hex & rgba inputs.
8575
- * Required input property.
8423
+ * Sets the color value to parse and populate the hex and RGBA inputs.
8576
8424
  */
8577
8425
  value;
8578
8426
  /**
8579
- * Sets whether the alpha slider will be shown.
8427
+ * Shows or hides the alpha slider.
8428
+ *
8429
+ * @default true
8580
8430
  */
8581
8431
  opacity = true;
8582
8432
  /**
8583
- * Sets the disabled state of the ColorInput.
8433
+ * Disables the ColorInput.
8434
+ *
8435
+ * @default false
8584
8436
  */
8585
8437
  disabled = false;
8586
8438
  /**
@@ -8590,11 +8442,11 @@ class ColorInputComponent {
8590
8442
  */
8591
8443
  readonly = false;
8592
8444
  /**
8593
- * Emits a parsed rgba string color.
8445
+ * Emits a parsed RGBA string color.
8594
8446
  */
8595
8447
  valueChange = new EventEmitter();
8596
8448
  /**
8597
- * Emits when the user tabs out of the last focusable input.
8449
+ * Fires when the user tabs out of the last focusable input.
8598
8450
  */
8599
8451
  tabOut = new EventEmitter();
8600
8452
  colorInputClass = true;
@@ -8603,15 +8455,15 @@ class ColorInputComponent {
8603
8455
  blueInput;
8604
8456
  toggleFormatButton;
8605
8457
  /**
8606
- * The rgba inputs values.
8458
+ * Holds the RGBA input values.
8607
8459
  */
8608
8460
  rgba = {};
8609
8461
  /*
8610
- * The hex input value.
8462
+ * Holds the hex input value.
8611
8463
  */
8612
8464
  hex;
8613
8465
  /**
8614
- * Indicates whether any of the inputs are focused.
8466
+ * Returns `true` if any of the inputs are focused.
8615
8467
  */
8616
8468
  get isFocused() {
8617
8469
  if (!(isDocumentAvailable() && isPresent(this.host))) {
@@ -8621,7 +8473,7 @@ class ColorInputComponent {
8621
8473
  return this.host.nativeElement.contains(activeElement);
8622
8474
  }
8623
8475
  /**
8624
- * Indicates whether any of the rgba inputs have value.
8476
+ * Returns `true` if all RGBA inputs have values.
8625
8477
  */
8626
8478
  get rgbaInputValid() {
8627
8479
  return Object.keys(this.rgba).every(key => isPresent(this.rgba[key]));
@@ -8713,7 +8565,7 @@ class ColorInputComponent {
8713
8565
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: ColorInputComponent, deps: [{ token: i0.ElementRef }, { token: i0.Renderer2 }, { token: i0.ChangeDetectorRef }, { token: i1.LocalizationService }], target: i0.ɵɵFactoryTarget.Component });
8714
8566
  static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "14.0.0", version: "16.2.12", type: ColorInputComponent, isStandalone: true, selector: "kendo-colorinput", inputs: { focusableId: "focusableId", formatView: "formatView", size: "size", tabindex: "tabindex", value: "value", opacity: "opacity", disabled: "disabled", readonly: "readonly" }, outputs: { valueChange: "valueChange", tabOut: "tabOut" }, host: { properties: { "class.k-colorgradient-inputs": "this.colorInputClass", "class.k-hstack": "this.colorInputClass" } }, viewQueries: [{ propertyName: "opacityInput", first: true, predicate: ["opacityInput"], descendants: true }, { propertyName: "hexInput", first: true, predicate: ["hexInput"], descendants: true }, { propertyName: "blueInput", first: true, predicate: ["blue"], descendants: true }, { propertyName: "toggleFormatButton", first: true, predicate: ["toggleFormatButton"], descendants: true, read: ElementRef }], usesOnChanges: true, ngImport: i0, template: `
8715
8567
  <div class="k-vstack">
8716
- <button
8568
+ <button
8717
8569
  kendoButton
8718
8570
  type="button"
8719
8571
  fillMode="flat"
@@ -8844,7 +8696,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
8844
8696
  selector: 'kendo-colorinput',
8845
8697
  template: `
8846
8698
  <div class="k-vstack">
8847
- <button
8699
+ <button
8848
8700
  kendoButton
8849
8701
  type="button"
8850
8702
  fillMode="flat"
@@ -9306,119 +9158,119 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
9306
9158
  */
9307
9159
  class ColorPickerMessages extends ComponentMessages {
9308
9160
  /**
9309
- * The aria-label applied to the ColorPalette component when the value is empty.
9161
+ * Sets the `aria-label` for the ColorPalette component when the value is empty.
9310
9162
  */
9311
9163
  colorPaletteNoColor;
9312
9164
  /**
9313
- * The aria-label applied to the ColorGradient component when the value is empty.
9165
+ * Sets the `aria-label` for the ColorGradient component when the value is empty.
9314
9166
  */
9315
9167
  colorGradientNoColor;
9316
9168
  /**
9317
- * The aria-label applied to the FlatColorPicker component when the value is empty.
9169
+ * Sets the `aria-label` for the FlatColorPicker component when the value is empty.
9318
9170
  */
9319
9171
  flatColorPickerNoColor;
9320
9172
  /**
9321
- * The aria-label applied to the ColorPicker component when the value is empty.
9173
+ * Sets the `aria-label` for the ColorPicker component when the value is empty.
9322
9174
  */
9323
9175
  colorPickerNoColor;
9324
9176
  /**
9325
- * The title for the gradient color drag handle chooser.
9177
+ * Sets the title for the gradient color drag handle chooser.
9326
9178
  */
9327
9179
  colorGradientHandle;
9328
9180
  /**
9329
- * The title for the clear button.
9181
+ * Sets the title for the clear button.
9330
9182
  */
9331
9183
  clearButton;
9332
9184
  /**
9333
- * The title for the hue slider handle.
9185
+ * Sets the title for the hue slider handle.
9334
9186
  */
9335
9187
  hueSliderHandle;
9336
9188
  /**
9337
- * The title for the opacity slider handle.
9189
+ * Sets the title for the opacity slider handle.
9338
9190
  */
9339
9191
  opacitySliderHandle;
9340
9192
  /**
9341
- * The placeholder for the HEX color input.
9193
+ * Sets the placeholder for the HEX color input.
9342
9194
  */
9343
9195
  hexInputPlaceholder;
9344
9196
  /**
9345
- * The placeholder for the red color input.
9197
+ * Sets the placeholder for the red color input.
9346
9198
  */
9347
9199
  redInputPlaceholder;
9348
9200
  /**
9349
- * The placeholder for the green color input.
9201
+ * Sets the placeholder for the green color input.
9350
9202
  */
9351
9203
  greenInputPlaceholder;
9352
9204
  /**
9353
- * The placeholder for the blue color input.
9205
+ * Sets the placeholder for the blue color input.
9354
9206
  */
9355
9207
  blueInputPlaceholder;
9356
9208
  /**
9357
- * The placeholder for the alpha input.
9209
+ * Sets the placeholder for the alpha input.
9358
9210
  */
9359
9211
  alphaInputPlaceholder;
9360
9212
  /**
9361
- * The aria-label attribute of the red color input.
9213
+ * Sets the `aria-label` for the red color input.
9362
9214
  */
9363
9215
  redChannelLabel;
9364
9216
  /**
9365
- * The aria-label attribute of the green color input.
9217
+ * Sets the `aria-label` for the green color input.
9366
9218
  */
9367
9219
  greenChannelLabel;
9368
9220
  /**
9369
- * The aria-label attribute of the blue color input.
9221
+ * Sets the `aria-label` for the blue color input.
9370
9222
  */
9371
9223
  blueChannelLabel;
9372
9224
  /**
9373
- * The aria-label attribute of the alpha color input.
9225
+ * Sets the `aria-label` for the alpha color input.
9374
9226
  */
9375
9227
  alphaChannelLabel;
9376
9228
  /**
9377
- * The "Pass" message for the contrast tool.
9229
+ * Sets the "Pass" message for the contrast tool.
9378
9230
  */
9379
9231
  passContrast;
9380
9232
  /**
9381
- * The "Fail" message for the contrast tool.
9233
+ * Sets the "Fail" message for the contrast tool.
9382
9234
  */
9383
9235
  failContrast;
9384
9236
  /**
9385
- * The "Contrast ratio" message for the contrast tool.
9237
+ * Sets the "Contrast ratio" message for the contrast tool.
9386
9238
  */
9387
9239
  contrastRatio;
9388
9240
  /**
9389
- * The message for the color preview pane.
9241
+ * Sets the message for the color preview pane.
9390
9242
  */
9391
9243
  previewColor;
9392
9244
  /**
9393
- * The message for the selected color pane.
9245
+ * Sets the message for the selected color pane.
9394
9246
  */
9395
9247
  revertSelection;
9396
9248
  /**
9397
- * The message for the gradient view button.
9249
+ * Sets the message for the gradient view button.
9398
9250
  */
9399
9251
  gradientView;
9400
9252
  /**
9401
- * The message for the palette view button.
9253
+ * Sets the message for the palette view button.
9402
9254
  */
9403
9255
  paletteView;
9404
9256
  /**
9405
- * The message for the input format toggle button.
9257
+ * Sets the message for the input format toggle button.
9406
9258
  */
9407
9259
  formatButton;
9408
9260
  /**
9409
- * The message for the Apply action button.
9261
+ * Sets the message for the **Apply** action button.
9410
9262
  */
9411
9263
  applyButton;
9412
9264
  /**
9413
- * The message for the Cancel action button.
9265
+ * Sets the message for the **Cancel** action button.
9414
9266
  */
9415
9267
  cancelButton;
9416
9268
  /**
9417
- * The title of the Close button of the ActionSheet that is rendered instead of the Popup when using small screen devices in adaptive mode.
9269
+ * Sets the title of the **Close** button for the ActionSheet in adaptive mode.
9418
9270
  */
9419
9271
  adaptiveCloseButtonTitle;
9420
9272
  /**
9421
- * The title for the ActionSheet when in adaptive mode.
9273
+ * Sets the title for the ActionSheet in adaptive mode.
9422
9274
  */
9423
9275
  adaptiveTitle;
9424
9276
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: ColorPickerMessages, deps: null, target: i0.ɵɵFactoryTarget.Directive });
@@ -9525,8 +9377,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
9525
9377
  let serial$3 = 0;
9526
9378
  const DEFAULT_SIZE$7 = 'medium';
9527
9379
  /**
9528
- * The ColorGradient component enables smooth color transitions and provides options for selecting specific colors over the drag handle.
9529
- * The ColorGradient is independently used by `kendo-colorpicker` and can be directly added to the page.
9380
+ * Represents the Kendo UI ColorGradient component.
9381
+ *
9382
+ * The ColorGradientComponent lets you select a color by moving a drag handle over a gradient area. You can use it directly or as part of the `kendo-colorpicker`.
9383
+ *
9384
+ * @example
9385
+ * ```html
9386
+ * <kendo-colorgradient [(ngModel)]="color"></kendo-colorgradient>
9387
+ * ```
9388
+ *
9389
+ * @remarks
9390
+ * Supported children components are: {@link ColorPickerMessages}.
9530
9391
  */
9531
9392
  class ColorGradientComponent {
9532
9393
  host;
@@ -9591,19 +9452,15 @@ class ColorGradientComponent {
9591
9452
  */
9592
9453
  id = `k-colorgradient-${serial$3++}`;
9593
9454
  /**
9594
- * Defines whether the alpha slider will be displayed.
9455
+ * Shows or hides the alpha slider.
9595
9456
  *
9596
9457
  * @default true
9597
9458
  */
9598
9459
  opacity = true;
9599
9460
  /**
9600
- * The size property specifies the padding of the ColorGradient internal elements.
9461
+ * Sets the size of the ColorGradient internal elements.
9601
9462
  *
9602
- * The possible values are:
9603
- * * `small`
9604
- * * `medium` (default)
9605
- * * `large`
9606
- * * `none`
9463
+ * @default 'medium'
9607
9464
  */
9608
9465
  set size(size) {
9609
9466
  const newSize = size || DEFAULT_SIZE$7;
@@ -9614,7 +9471,7 @@ class ColorGradientComponent {
9614
9471
  return this._size;
9615
9472
  }
9616
9473
  /**
9617
- * Sets the disabled state of the ColorGradient. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_colorgradient#toc-managing-the-colorgradient-disabled-state-in-reactive-forms).
9474
+ * Disables the ColorGradient. To disable it in reactive forms, see [Forms Support](slug:formssupport_colorgradient#toc-managing-the-colorgradient-disabled-state-in-reactive-forms).
9618
9475
  *
9619
9476
  * @default false
9620
9477
  */
@@ -9626,19 +9483,19 @@ class ColorGradientComponent {
9626
9483
  */
9627
9484
  readonly = false;
9628
9485
  /**
9629
- * Specifies whether the ColorGradient should display a 'Clear color' button.
9486
+ * Shows or hides the **Clear color** button.
9630
9487
  *
9631
9488
  * @default false
9632
9489
  */
9633
9490
  clearButton = false;
9634
9491
  /**
9635
- * Determines the delay time (in milliseconds) before the value is changed on handle drag. A value of 0 indicates no delay.
9492
+ * Sets the delay (in milliseconds) before the value changes on handle drag.
9636
9493
  *
9637
9494
  * @default 0
9638
9495
  */
9639
9496
  delay = 0;
9640
9497
  /**
9641
- * Specifies the value of the initially selected color.
9498
+ * Sets the value of the selected color.
9642
9499
  */
9643
9500
  set value(value) {
9644
9501
  this._value = parseColor(value, this.format, this.opacity);
@@ -9647,8 +9504,7 @@ class ColorGradientComponent {
9647
9504
  return this._value;
9648
9505
  }
9649
9506
  /**
9650
- * Enables the color contrast tool. Accepts the background color that will be compared to the selected value.
9651
- * The tool will calculate the contrast ratio between the two colors.
9507
+ * Enables the color contrast tool that checks the contrast ratio of the selected color against a predefined background color. [See example](slug:contrasttool_colorgradient).
9652
9508
  */
9653
9509
  set contrastTool(value) {
9654
9510
  this._contrastTool = parseColor(value, this.format, this.opacity);
@@ -9657,7 +9513,7 @@ class ColorGradientComponent {
9657
9513
  return this._contrastTool;
9658
9514
  }
9659
9515
  /**
9660
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
9516
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
9661
9517
  *
9662
9518
  * @default 0
9663
9519
  */
@@ -9675,17 +9531,13 @@ class ColorGradientComponent {
9675
9531
  return !this.disabled ? this._tabindex : undefined;
9676
9532
  }
9677
9533
  /**
9678
- * Specifies the output format of the ColorGradientComponent.
9679
- * The input value may be in a different format, but it will be parsed into the output `format`
9680
- * after the component processes it.
9534
+ * Sets the output format of the ColorGradient. The input value may be in a different format, but it will be parsed into the output format after the component processes it.
9681
9535
  *
9682
- * The supported values are:
9683
- * * (Default) `rgba`
9684
- * * `hex`
9536
+ * @default 'rgba'
9685
9537
  */
9686
9538
  format = DEFAULT_OUTPUT_FORMAT;
9687
9539
  /**
9688
- * Fires each time the user selects a new color.
9540
+ * Fires when the user selects a new color..
9689
9541
  */
9690
9542
  valueChange = new EventEmitter();
9691
9543
  /**
@@ -9701,7 +9553,7 @@ class ColorGradientComponent {
9701
9553
  */
9702
9554
  hsva = new BehaviorSubject({});
9703
9555
  /**
9704
- * Indicates whether the ColorGradient or any of its content is focused.
9556
+ * Returns `true` if the component or its content is focused.
9705
9557
  */
9706
9558
  get isFocused() {
9707
9559
  if (!(isDocumentAvailable() && isPresent(this.host))) {
@@ -9720,13 +9572,13 @@ class ColorGradientComponent {
9720
9572
  return this.hsva.value.a * 100;
9721
9573
  }
9722
9574
  /**
9723
- * Determines the step (in pixels) when moving the gradient drag handle using the keyboard arrow keys.
9575
+ * Sets the step (in pixels) for moving the gradient drag handle with the arrow keys.
9724
9576
  *
9725
9577
  * @default 5
9726
9578
  */
9727
9579
  gradientSliderStep = DRAGHANDLE_MOVE_SPEED;
9728
9580
  /**
9729
- * Determines the step (in pixels) when moving the gradient drag handle using the keyboard arrow keys while holding the shift key.
9581
+ * Sets the step (in pixels) for moving the gradient drag handle with `Shift+arrow keys`.
9730
9582
  *
9731
9583
  * @default 2
9732
9584
  */
@@ -10742,8 +10594,17 @@ const DEFAULT_ACCESSIBLE_PRESET = 'accessible';
10742
10594
  const DEFAULT_SIZE$6 = 'medium';
10743
10595
  let serial$2 = 0;
10744
10596
  /**
10745
- * The ColorPalette component provides a set of predefined palette presets and enables you to implement a custom color palette.
10746
- * The ColorPalette is independently used by `kendo-colorpicker` and can be directly added to the page.
10597
+ * Represents the Kendo UI ColorPalette component.
10598
+ *
10599
+ * The `ColorPaletteComponent` provides a set of predefined palette presets and lets you implement a custom color palette. You can use it directly or as part of the `kendo-colorpicker`.
10600
+ *
10601
+ * @example
10602
+ * ```html
10603
+ * <kendo-colorpalette [palette]="['#fff', '#000']" [(value)]="selectedColor"></kendo-colorpalette>
10604
+ * ```
10605
+ *
10606
+ * @remarks
10607
+ * Supported children components are: {@link ColorPickerMessages}.
10747
10608
  */
10748
10609
  class ColorPaletteComponent {
10749
10610
  host;
@@ -10777,18 +10638,14 @@ class ColorPaletteComponent {
10777
10638
  */
10778
10639
  id = `k-colorpalette-${serial$2++}`;
10779
10640
  /**
10780
- * Specifies the output format of the ColorPaletteComponent.
10781
- * The input value may be in a different format. However, it will be parsed into the output `format`
10782
- * after the component processes it.
10641
+ * Specifies the output format of the `ColorPaletteComponent`.
10642
+ * The input value may be in a different format. The component parses it into the output `format`.
10783
10643
  *
10784
- * The supported values are:
10785
- * * (Default) `hex`
10786
- * * `rgba`
10787
- * * `name`
10644
+ * @default 'hex'
10788
10645
  */
10789
10646
  format = 'hex';
10790
10647
  /**
10791
- * Specifies the value of the initially selected color.
10648
+ * Sets the value of the selected color.
10792
10649
  */
10793
10650
  set value(value) {
10794
10651
  this._value = parseColor(value, this.format);
@@ -10797,8 +10654,9 @@ class ColorPaletteComponent {
10797
10654
  return this._value;
10798
10655
  }
10799
10656
  /**
10800
- * Specifies the number of columns that will be displayed.
10801
- * Defaults to `10`.
10657
+ * Sets the number of columns to display.
10658
+ *
10659
+ * @default 10
10802
10660
  */
10803
10661
  set columns(value) {
10804
10662
  const minColumnsCount = 1;
@@ -10808,12 +10666,7 @@ class ColorPaletteComponent {
10808
10666
  return this._columns;
10809
10667
  }
10810
10668
  /**
10811
- * The color palette that will be displayed.
10812
- *
10813
- * The supported values are:
10814
- * * The name of the predefined palette preset (for example, `office`, `basic`, and `apex`).
10815
- * * A string with comma-separated colors.
10816
- * * A string array.
10669
+ * Sets the color palette to display. You can use a predefined palette preset (such as `office`, `basic`, or `apex`), string with comma-separated colors, or an array of string colors.
10817
10670
  */
10818
10671
  set palette(value) {
10819
10672
  if (!isPresent(value)) {
@@ -10830,13 +10683,9 @@ class ColorPaletteComponent {
10830
10683
  return this._palette;
10831
10684
  }
10832
10685
  /**
10833
- * The size property specifies the padding of the ColorPalette internal elements.
10686
+ * Sets the size of the ColorPalette internal elements.
10834
10687
  *
10835
- * The possible values are:
10836
- * * `small`
10837
- * * `medium` (default)
10838
- * * `large`
10839
- * * `none`
10688
+ * @default 'medium'
10840
10689
  */
10841
10690
  set size(size) {
10842
10691
  const newSize = size || DEFAULT_SIZE$6;
@@ -10847,7 +10696,9 @@ class ColorPaletteComponent {
10847
10696
  return this._size;
10848
10697
  }
10849
10698
  /**
10850
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
10699
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
10700
+ *
10701
+ * @default 0
10851
10702
  */
10852
10703
  set tabindex(value) {
10853
10704
  const tabindex = Number(value);
@@ -10858,7 +10709,7 @@ class ColorPaletteComponent {
10858
10709
  return !this.disabled ? this._tabindex : undefined;
10859
10710
  }
10860
10711
  /**
10861
- * Sets the disabled state of the ColorPalette. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_colorpalette#toc-managing-the-colorpalette-disabled-state-in-reactive-forms).
10712
+ * Disables the ColorPalette. To disable it in reactive forms, see [Forms Support](slug:formssupport_colorpalette#toc-managing-the-colorpalette-disabled-state-in-reactive-forms).
10862
10713
  */
10863
10714
  disabled = false;
10864
10715
  /**
@@ -10868,7 +10719,7 @@ class ColorPaletteComponent {
10868
10719
  */
10869
10720
  readonly = false;
10870
10721
  /**
10871
- * Specifies the size of a color cell. The default tile size depends on the `size` of the component.
10722
+ * Sets the size of a color cell. The default tile size depends on the `size` of the component.
10872
10723
  */
10873
10724
  tileSize;
10874
10725
  /**
@@ -10881,11 +10732,11 @@ class ColorPaletteComponent {
10881
10732
  return { width: this.tileSize, height: this.tileSize };
10882
10733
  }
10883
10734
  /**
10884
- * Fires each time the color selection is changed.
10735
+ * Fires when the color selection changes.
10885
10736
  */
10886
10737
  selectionChange = new EventEmitter();
10887
10738
  /**
10888
- * Fires each time the value is changed.
10739
+ * Fires when the value changes.
10889
10740
  */
10890
10741
  valueChange = new EventEmitter();
10891
10742
  /**
@@ -11367,7 +11218,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
11367
11218
  }] });
11368
11219
 
11369
11220
  /**
11370
- * Arguments for the `cancel` event of the ColorPicker and FlatColorPicker components.
11221
+ * Provides the arguments for the `cancel` event of the ColorPicker and FlatColorPicker components.
11371
11222
  */
11372
11223
  class ColorPickerCancelEvent extends PreventableEvent {
11373
11224
  /**
@@ -11381,45 +11232,41 @@ class ColorPickerCancelEvent extends PreventableEvent {
11381
11232
  }
11382
11233
 
11383
11234
  /**
11384
- * Arguments for the `close` event of the ColorPicker component.
11235
+ * Provides the arguments for the `close` event of the ColorPicker component.
11385
11236
  */
11386
11237
  class ColorPickerCloseEvent extends PreventableEvent {
11387
11238
  }
11388
11239
 
11389
11240
  /**
11390
- * Arguments for the `open` event of the ColorPicker component.
11241
+ * Provides the arguments for the `open` event of the ColorPicker component.
11391
11242
  */
11392
11243
  class ColorPickerOpenEvent extends PreventableEvent {
11393
11244
  }
11394
11245
 
11395
11246
  /**
11396
- * Fires each time the left side of the ColorPicker wrapper is clicked.
11397
- * The event is triggered regardless of whether a ColorPicker icon is set or not.
11247
+ * Fires when you click the left side of the ColorPicker wrapper.
11248
+ * The event triggers whether you set a ColorPicker icon or not.
11398
11249
  *
11399
- * Provides information about the current active color and gives the option to prevent the opening of the popup.
11250
+ * Provides information about the current active color and lets you prevent the popup from opening.
11400
11251
  *
11401
11252
  * @example
11402
- *
11403
- * ```ts-no-run
11404
- * _@Component({
11253
+ * ```typescript
11254
+ * @Component({
11405
11255
  * selector: 'my-app',
11406
11256
  * template: `
11407
11257
  * <kendo-colorpicker
11408
11258
  * [icon]="'edit-tools'"
11409
11259
  * [value]="'#900'"
11410
- * (activeColorClick)="handleActiveColorClick($event)"
11260
+ * (activeColorClick)="onColorClick($event)"
11411
11261
  * >
11412
11262
  * </kendo-colorpicker>
11413
11263
  * `
11414
11264
  * })
11415
11265
  * class AppComponent {
11416
- * public handleActiveColorClick(event: ActiveColorClickEvent): void {
11266
+ * public onColorClick(event: ActiveColorClickEvent): void {
11417
11267
  * event.preventOpen();
11418
- *
11419
- * console.log('Open prevented:', event.isOpenPrevented());
11420
- * console.log('Current color:', event.color);
11421
11268
  * }
11422
- * }
11269
+ * }
11423
11270
  * ```
11424
11271
  */
11425
11272
  class ActiveColorClickEvent {
@@ -11433,7 +11280,7 @@ class ActiveColorClickEvent {
11433
11280
  this.color = color;
11434
11281
  }
11435
11282
  /**
11436
- * Prevents the opening of the popup.
11283
+ * Prevents the popup from opening.
11437
11284
  */
11438
11285
  preventOpen() {
11439
11286
  this.openPrevented = true;
@@ -11441,7 +11288,7 @@ class ActiveColorClickEvent {
11441
11288
  /**
11442
11289
  * Returns `true` if the popup opening is prevented by any of its subscribers.
11443
11290
  *
11444
- * @returns - Returns `true` if the open action was prevented. Otherwise, returns `false`.
11291
+ * @returns Returns `true` if the open action was prevented. Otherwise, returns `false`.
11445
11292
  */
11446
11293
  isOpenPrevented() {
11447
11294
  return this.openPrevented;
@@ -11780,10 +11627,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
11780
11627
  /* eslint-disable no-unused-expressions */
11781
11628
  const DEFAULT_SIZE$5 = 'medium';
11782
11629
  /**
11783
- * Represents the [Kendo UI FlatColorPicker component for Angular]({% slug overview_flatcolorpicker %}).
11630
+ * Represents the Kendo UI FlatColorPicker component for Angular.
11784
11631
  *
11785
- * The FlatColorPicker is a powerful tool which allows the user to choose colors through palettes with predefined sets of colors and
11786
- * through a gradient that renders an hsv canvas. It supports previewing the selected color, reverting it to its previous state or clearing it completely.
11632
+ * The `FlatColorPickerComponent` lets you choose colors through palettes with predefined sets of colors and through a gradient that renders an HSV canvas. You can preview the selected color, revert it to its previous state, or clear it.
11633
+ *
11634
+ * @example
11635
+ * ```html
11636
+ * <kendo-flatcolorpicker [(value)]="selectedColor"></kendo-flatcolorpicker>
11637
+ * ```
11638
+ *
11639
+ * @remarks
11640
+ * Supported children components are: {@link ColorPickerMessages}.
11787
11641
  */
11788
11642
  class FlatColorPickerComponent {
11789
11643
  host;
@@ -11842,7 +11696,7 @@ class FlatColorPickerComponent {
11842
11696
  */
11843
11697
  readonly = false;
11844
11698
  /**
11845
- * Sets the disabled state of the FlatColorPicker. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_flatcolorpicker#toc-managing-the-flatcolorpicker-disabled-state-in-reactive-forms).
11699
+ * Sets the disabled state of the FlatColorPicker. To disable it in reactive forms, see [Forms Support](slug:formssupport_flatcolorpicker#toc-managing-the-flatcolorpicker-disabled-state-in-reactive-forms).
11846
11700
  *
11847
11701
  * @default false
11848
11702
  */
@@ -11850,11 +11704,9 @@ class FlatColorPickerComponent {
11850
11704
  /**
11851
11705
  * Specifies the output format of the FlatColorPicker.
11852
11706
  *
11853
- * If the input value is in a different format, it will be parsed into the specified output `format`.
11707
+ * If the input value is in a different format, the component parses it into the specified output `format`.
11854
11708
  *
11855
- * The supported values are:
11856
- * * `rgba` (default)
11857
- * * `hex`
11709
+ * @default 'rgba'
11858
11710
  */
11859
11711
  format = 'rgba';
11860
11712
  /**
@@ -11885,7 +11737,7 @@ class FlatColorPickerComponent {
11885
11737
  return !this.disabled ? this._tabindex : undefined;
11886
11738
  }
11887
11739
  /**
11888
- * Specifies whether the FlatColorPicker should display a 'Clear color' button.
11740
+ * Specifies whether the FlatColorPicker displays a **Clear color** button.
11889
11741
  *
11890
11742
  * @default true
11891
11743
  */
@@ -11893,31 +11745,27 @@ class FlatColorPickerComponent {
11893
11745
  /**
11894
11746
  * Displays `Apply` and `Cancel` action buttons and a color preview pane.
11895
11747
  *
11896
- * When enabled, the component value will not change immediately upon
11897
- * color selection, but only after the `Apply` button is clicked.
11748
+ * When enabled, the component value does not change immediately upon
11749
+ * color selection, but only after the **Apply** button is clicked.
11898
11750
  *
11899
- * The `Cancel` button reverts the current selection to its
11900
- * initial state i.e. to the current value.
11751
+ * The **Cancel** button reverts the current selection to its
11752
+ * initial state, i.e., to the current value.
11901
11753
  *
11902
11754
  * @default true
11903
11755
  */
11904
11756
  preview = true;
11905
11757
  /**
11906
11758
  * Configures the layout of the `Apply` and `Cancel` action buttons.
11907
- * * `start`
11908
- * * `center`
11909
- * * `end` (default)
11910
- * * `stretch`
11759
+ *
11760
+ * @default 'end'
11911
11761
  */
11912
11762
  actionsLayout = 'end';
11913
11763
  /**
11914
- * Sets the initially active view in the FlatColorPicker. The property supports two-way binding.
11915
- * * `gradient` (default)
11916
- * * `palette`
11764
+ * Sets the initially active view in the FlatColorPicker. Supports two-way binding.
11917
11765
  */
11918
11766
  activeView;
11919
11767
  /**
11920
- * Specifies the views that will be rendered. Default value is gradient and palette.
11768
+ * Specifies the views to render. The default value is gradient and palette.
11921
11769
  */
11922
11770
  views = ['gradient', 'palette'];
11923
11771
  /**
@@ -11943,13 +11791,9 @@ class FlatColorPickerComponent {
11943
11791
  return this._paletteSettings;
11944
11792
  }
11945
11793
  /**
11946
- * The size property specifies the padding of the FlatColorPicker internal elements.
11794
+ * Sets the size of the FlatColorPicker internal elements.
11947
11795
  *
11948
- * The possible values are:
11949
- * * `small`
11950
- * * `medium` (default)
11951
- * * `large`
11952
- * * `none`
11796
+ * @default 'medium'
11953
11797
  */
11954
11798
  set size(size) {
11955
11799
  const newSize = size || DEFAULT_SIZE$5;
@@ -11960,7 +11804,7 @@ class FlatColorPickerComponent {
11960
11804
  return this._size;
11961
11805
  }
11962
11806
  /**
11963
- * Fires each time the component value is changed.
11807
+ * Fires when the component value changes.
11964
11808
  */
11965
11809
  valueChange = new EventEmitter();
11966
11810
  /**
@@ -11970,7 +11814,7 @@ class FlatColorPickerComponent {
11970
11814
  */
11971
11815
  cancel = new EventEmitter();
11972
11816
  /**
11973
- * Fires each time the view is about to change.
11817
+ * Fires when the view is about to change.
11974
11818
  * Used to provide a two-way binding for the `activeView` property.
11975
11819
  */
11976
11820
  activeViewChange = new EventEmitter();
@@ -12929,10 +12773,18 @@ const DEFAULT_FILL_MODE$3 = 'solid';
12929
12773
  */
12930
12774
  let nextColorPickerId = 0;
12931
12775
  /**
12932
- * Represents the [Kendo UI ColorPicker component for Angular]({% slug overview_colorpicker %}).
12776
+ * Represents the Kendo UI ColorPicker component for Angular.
12777
+ *
12778
+ * The `ColorPickerComponent` is a tool for choosing colors from Gradient and Palette views
12779
+ * rendered in its popup. You can preview the selected color, revert it to its previous state, or clear it.
12780
+ *
12781
+ * @example
12782
+ * ```html
12783
+ * <kendo-colorpicker [(value)]="selectedColor"></kendo-colorpicker>
12784
+ * ```
12933
12785
  *
12934
- * The ColorPicker is a powerful tool for choosing colors from Gradient and Palette views
12935
- * which are rendered in its popup. It supports previewing the selected color, reverting it to its previous state or clearing it completely.
12786
+ * @remarks
12787
+ * Supported children components are: {@link ColorPickerMessages}.
12936
12788
  */
12937
12789
  class ColorPickerComponent {
12938
12790
  host;
@@ -12970,8 +12822,8 @@ class ColorPickerComponent {
12970
12822
  */
12971
12823
  focusableId;
12972
12824
  /**
12973
- * Specifies the views that will be rendered in the popup.
12974
- * By default both the gradient and palette views will be rendered.
12825
+ * Specifies the views rendered in the popup.
12826
+ * By default, both the gradient and palette views are rendered.
12975
12827
  */
12976
12828
  views = ['gradient', 'palette'];
12977
12829
  /**
@@ -12984,15 +12836,12 @@ class ColorPickerComponent {
12984
12836
  return (this.views && this.views.length > 0) ? this.views[0] : null;
12985
12837
  }
12986
12838
  /**
12987
- * Enables or disables the adaptive mode. By default, adaptive rendering is disabled.
12839
+ * Enables or disables the adaptive mode.
12840
+ * By default, adaptive rendering is disabled.
12988
12841
  */
12989
12842
  adaptiveMode = 'none';
12990
12843
  /**
12991
- * Sets the initially active view in the popup. The property supports two-way binding.
12992
- *
12993
- * The supported values are:
12994
- * * `gradient`
12995
- * * `palette`
12844
+ * Sets the initially active view in the popup. Supports two-way binding.
12996
12845
  */
12997
12846
  activeView;
12998
12847
  /**
@@ -13002,7 +12851,7 @@ class ColorPickerComponent {
13002
12851
  */
13003
12852
  readonly = false;
13004
12853
  /**
13005
- * Sets the disabled state of the ColorPicker. To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_colorpicker#toc-managing-the-colorpicker-disabled-state-in-reactive-forms).
12854
+ * Sets the disabled state of the ColorPicker. To disable it in reactive forms, see [Forms Support](slug:formssupport_colorpicker#toc-managing-the-colorpicker-disabled-state-in-reactive-forms).
13006
12855
  *
13007
12856
  * @default false
13008
12857
  */
@@ -13010,15 +12859,13 @@ class ColorPickerComponent {
13010
12859
  /**
13011
12860
  * Specifies the output format of the ColorPicker.
13012
12861
  *
13013
- * If the input value is in a different format, it will be parsed into the specified output `format`.
12862
+ * If the input value is in a different format, the component parses it into the specified output `format`.
13014
12863
  *
13015
- * The supported values are:
13016
- * * `rgba` (default)
13017
- * * `hex`
12864
+ * @default 'rgba'
13018
12865
  */
13019
12866
  format = 'rgba';
13020
12867
  /**
13021
- * Specifies the value of the initially selected color.
12868
+ * Sets the value of the selected color.
13022
12869
  */
13023
12870
  set value(value) {
13024
12871
  this._value = parseColor(value, this.format, this.gradientSettings.opacity);
@@ -13036,7 +12883,7 @@ class ColorPickerComponent {
13036
12883
  return this._popupSettings;
13037
12884
  }
13038
12885
  /**
13039
- * Configures the palette that is displayed in the ColorPicker popup.
12886
+ * Configures the palette displayed in the ColorPicker popup.
13040
12887
  */
13041
12888
  set paletteSettings(value) {
13042
12889
  this._paletteSettings = Object.assign(this._paletteSettings, value);
@@ -13045,7 +12892,7 @@ class ColorPickerComponent {
13045
12892
  return this._paletteSettings;
13046
12893
  }
13047
12894
  /**
13048
- * Configures the gradient that is displayed in the ColorPicker popup.
12895
+ * Configures the gradient displayed in the ColorPicker popup.
13049
12896
  */
13050
12897
  set gradientSettings(value) {
13051
12898
  this._gradientSettings = Object.assign(this._gradientSettings, value);
@@ -13054,10 +12901,8 @@ class ColorPickerComponent {
13054
12901
  return this._gradientSettings;
13055
12902
  }
13056
12903
  /**
13057
- * Defines the name of an [existing icon in the Kendo UI theme]({% slug icons %}).
13058
- * Provide only the name of the icon without the `k-icon` or the `k-i-` prefixes.
13059
- *
13060
- * For example, `pencil-tools` will be parsed to `k-icon k-i-pencil-tools`.
12904
+ * Defines the name of an existing icon in the Kendo UI theme.
12905
+ * Provide only the name of the icon without the `k-icon` or `k-i-` prefixes.
13061
12906
  */
13062
12907
  icon;
13063
12908
  /**
@@ -13068,8 +12913,8 @@ class ColorPickerComponent {
13068
12913
  */
13069
12914
  iconClass;
13070
12915
  /**
13071
- * Defines an SVGIcon to be rendered within the button.
13072
- * The input can take either an [existing Kendo SVG icon](slug:svgicon_list) or a custom one.
12916
+ * Defines an SVGIcon to render within the button.
12917
+ * The input can take either an existing Kendo SVG icon or a custom one.
13073
12918
  */
13074
12919
  set svgIcon(icon) {
13075
12920
  if (isDevMode() && icon && this.icon && this.iconClass) {
@@ -13081,22 +12926,22 @@ class ColorPickerComponent {
13081
12926
  return this._svgIcon;
13082
12927
  }
13083
12928
  /**
13084
- * Sets the title of the ActionSheet that is rendered instead of the Popup when using small screen devices.
12929
+ * Sets the title of the ActionSheet rendered instead of the Popup on small screens.
13085
12930
  */
13086
12931
  adaptiveTitle = '';
13087
12932
  /**
13088
- * Sets the subtitle of the ActionSheet that is rendered instead of the Popup when using small screen devices.
13089
- * By default the ActionSheet does not render a subtitle.
13090
- */
12933
+ * Sets the subtitle of the ActionSheet rendered instead of the Popup on small screens.
12934
+ * By default, the ActionSheet does not render a subtitle.
12935
+ */
13091
12936
  adaptiveSubtitle;
13092
12937
  /**
13093
- * Specifies whether the ColorPicker should display a 'Clear color' button.
12938
+ * Specifies whether the ColorPicker displays a **Clear color** button.
13094
12939
  *
13095
12940
  * @default true
13096
12941
  */
13097
12942
  clearButton = true;
13098
12943
  /**
13099
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
12944
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
13100
12945
  *
13101
12946
  * @default 0
13102
12947
  */
@@ -13109,36 +12954,28 @@ class ColorPickerComponent {
13109
12954
  return !this.disabled ? this._tabindex : undefined;
13110
12955
  }
13111
12956
  /**
13112
- * Displays `Apply` and `Cancel` action buttons and color preview panes.
12957
+ * Displays **Apply** and **Cancel** action buttons and color preview panes.
13113
12958
  *
13114
- * When enabled, the component value will not change immediately upon
13115
- * color selection, but only after the `Apply` button is clicked.
12959
+ * When enabled, the component value does not change immediately upon
12960
+ * color selection, but only after the **Apply** button is clicked.
13116
12961
  *
13117
- * The `Cancel` button reverts the current selection to its
13118
- * previous state i.e. to the current value.
12962
+ * The **Cancel** button reverts the current selection to its
12963
+ * previous state, i.e., to the current value.
13119
12964
  *
13120
12965
  * @default false
13121
12966
  */
13122
12967
  preview = false;
13123
12968
  /**
13124
- * Configures the layout of the `Apply` and `Cancel` action buttons.
12969
+ * Configures the layout of the **Apply** and **Cancel** action buttons.
13125
12970
  *
13126
- * The possible values are:
13127
- * * `start`
13128
- * * `center`
13129
- * * `end` (default)
13130
- * * `stretch`
12971
+ * @default 'end'
13131
12972
  */
13132
12973
  actionsLayout = 'end';
13133
12974
  /**
13134
12975
  * The size property specifies the padding of the ColorPicker internal elements
13135
12976
  * ([see example]({% slug appearance_colorpicker %}#toc-size)).
13136
12977
  *
13137
- * The possible values are:
13138
- * * `small`
13139
- * * `medium` (default)
13140
- * * `large`
13141
- * * `none`
12978
+ * @default 'medium'
13142
12979
  */
13143
12980
  set size(size) {
13144
12981
  const newSize = size ? size : DEFAULT_SIZE$4;
@@ -13152,12 +12989,7 @@ class ColorPickerComponent {
13152
12989
  * The rounded property specifies the border radius of the ColorPicker
13153
12990
  * ([see example](slug:appearance_colorpicker#toc-roundness)).
13154
12991
  *
13155
- * The possible values are:
13156
- * * `small`
13157
- * * `medium` (default)
13158
- * * `large`
13159
- * * `full`
13160
- * * `none`
12992
+ * @default 'medium'
13161
12993
  */
13162
12994
  set rounded(rounded) {
13163
12995
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$3;
@@ -13171,11 +13003,7 @@ class ColorPickerComponent {
13171
13003
  * The fillMode property specifies the background and border styles of the ColorPicker
13172
13004
  * ([see example]({% slug appearance_colorpicker %}#toc-fill-mode)).
13173
13005
  *
13174
- * The possible values are:
13175
- * * `flat`
13176
- * * `solid` (default)
13177
- * * `outline`
13178
- * * `none`
13006
+ * @default 'solid'
13179
13007
  */
13180
13008
  set fillMode(fillMode) {
13181
13009
  const newFillMode = fillMode ? fillMode : DEFAULT_FILL_MODE$3;
@@ -13186,25 +13014,25 @@ class ColorPickerComponent {
13186
13014
  return this._fillMode;
13187
13015
  }
13188
13016
  /**
13189
- * Fires each time the value is changed.
13017
+ * Fires when the value changes.
13190
13018
  */
13191
13019
  valueChange = new EventEmitter();
13192
13020
  /**
13193
- * Fires each time the Popup (or ActionSheet in adaptive mode) is about to open.
13194
- * This event is preventable. If you cancel it, the Popup (or the ActionSheet) will remain closed.
13021
+ * Fires when the Popup (or ActionSheet in adaptive mode) is about to open.
13022
+ * This event is preventable. If you cancel it, the Popup (or the ActionSheet) remains closed.
13195
13023
  */
13196
13024
  open = new EventEmitter();
13197
13025
  /**
13198
- * Fires each time the Popup (or ActionSheet in adaptive mode) is about to close.
13199
- * This event is preventable. If you cancel it, the Popup (or the ActionSheet) will remain open.
13026
+ * Fires when the Popup (or ActionSheet in adaptive mode) is about to close.
13027
+ * This event is preventable. If you cancel it, the Popup (or the ActionSheet) remains open.
13200
13028
  */
13201
13029
  close = new EventEmitter();
13202
13030
  /**
13203
- * Fires each time ColorPicker is focused.
13031
+ * Fires when the ColorPicker is focused.
13204
13032
  */
13205
13033
  onFocus = new EventEmitter();
13206
13034
  /**
13207
- * Fires each time the ColorPicker is blurred.
13035
+ * Fires when the ColorPicker is blurred.
13208
13036
  */
13209
13037
  onBlur = new EventEmitter();
13210
13038
  /**
@@ -13214,19 +13042,19 @@ class ColorPickerComponent {
13214
13042
  */
13215
13043
  cancel = new EventEmitter();
13216
13044
  /**
13217
- * Fires each time the left side of the ColorPicker wrapper is clicked.
13045
+ * Fires when the left side of the ColorPicker wrapper is clicked.
13218
13046
  * The event is triggered regardless of whether a ColorPicker icon is set or not.
13219
13047
  *
13220
- * The [ActiveColorClickEvent]({% slug api_inputs_activecolorclickevent %}) event provides the option to prevent the popup opening.
13048
+ * The [`ActiveColorClickEvent`]({% slug api_inputs_activecolorclickevent %}) event provides the option to prevent the popup opening.
13221
13049
  */
13222
13050
  activeColorClick = new EventEmitter();
13223
13051
  /**
13224
13052
  * @hidden
13225
- * Fires each time the clear button is clicked.
13053
+ * Fires when the clear button is clicked.
13226
13054
  */
13227
13055
  clearButtonClick = new EventEmitter();
13228
13056
  /**
13229
- * Fires each time the view is about to change.
13057
+ * Fires when the view is about to change.
13230
13058
  * Used to provide a two-way binding for the `activeView` property.
13231
13059
  */
13232
13060
  activeViewChange = new EventEmitter();
@@ -14200,7 +14028,15 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14200
14028
  }] } });
14201
14029
 
14202
14030
  /**
14203
- * Custom component messages override default component messages.
14031
+ * Overrides the default component messages for the ColorPicker.
14032
+ *
14033
+ * @example
14034
+ * ```html
14035
+ * <kendo-colorpicker-messages
14036
+ * [applyButton]="'Apply custom'"
14037
+ * [cancelButton]="'Cancel custom'">
14038
+ * </kendo-colorpicker-messages>
14039
+ * ```
14204
14040
  */
14205
14041
  class ColorPickerCustomMessagesComponent extends ColorPickerMessages {
14206
14042
  service;
@@ -14236,17 +14072,20 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14236
14072
 
14237
14073
  let serial$1 = 0;
14238
14074
  /**
14239
- * Represents an error message that will be shown underneath
14240
- * a Kendo control or native HTML form-bound component after a validation.
14241
- */
14242
- class ErrorComponent {
14075
+ * Represents the Kendo UI FormError component.
14076
+ * Displays an error message under a Kendo Angular component or native HTML form-bound component after validation.
14077
+ *
14078
+ * @example
14079
+ * ```html
14080
+ * <kendo-formerror>Error message here</kendo-formerror>
14081
+ * ```
14082
+ */
14083
+ class ErrorComponent {
14243
14084
  hostClass = true;
14244
14085
  /**
14245
- * Specifies the alignment of the Error message.
14086
+ * Sets the alignment of the error message.
14246
14087
  *
14247
- * The possible values are:
14248
- * * (Default) `start`
14249
- * * `end`
14088
+ * @default 'start'
14250
14089
  */
14251
14090
  align = 'start';
14252
14091
  /**
@@ -14298,15 +14137,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14298
14137
 
14299
14138
  let serial = 0;
14300
14139
  /**
14301
- * Represents a hint message that will be shown underneath a form-bound component.
14140
+ * Displays a hint message under a form-bound component.
14141
+ *
14142
+ * @example
14143
+ * ```html
14144
+ * <kendo-formhint>Hint message here</kendo-formhint>
14145
+ * ```
14302
14146
  */
14303
14147
  class HintComponent {
14304
14148
  /**
14305
- * Specifies the alignment of the Hint message.
14149
+ * Sets the alignment of the hint message.
14306
14150
  *
14307
- * The possible values are:
14308
- * * (Default) `start`
14309
- * * `end`
14151
+ * @default 'start'
14310
14152
  */
14311
14153
  align = 'start';
14312
14154
  /**
@@ -14354,8 +14196,22 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14354
14196
  }] } });
14355
14197
 
14356
14198
  /**
14357
- * Specifies a container for form-bound controls (Kendo controls or native HTML controls).
14199
+ * Represents the Kendo UI FormField component for Angular.
14200
+ * Use this component to group form-bound controls (Kendo Angular components or native HTML controls).
14358
14201
  * Applies styling and behavior rules.
14202
+ *
14203
+ * @example
14204
+ * ```html
14205
+ * <kendo-formfield>
14206
+ * <kendo-label [for]="firstName"text="First Name"></kendo-label>
14207
+ * <kendo-textbox formControlName="firstName" #firstName></kendo-textbox>
14208
+ * <kendo-formhint>Enter your name.</kendo-formhint>
14209
+ * <kendo-formerror>First name is required.</kendo-formerror>
14210
+ * </kendo-formfield>
14211
+ * ```
14212
+ *
14213
+ * @remarks
14214
+ * Supported children components are: {@link ErrorComponent}, {@link HintComponent}, {@link TextBoxComponent}, {@link NumericTextBoxComponent}, {@link MaskedTextBoxComponent}, {@link TextAreaComponent}, {@link DatePickerComponent}, {@link DateTimePickerComponent}, {@link DateInputComponent}, {@link OTPInputComponent}.
14359
14215
  */
14360
14216
  class FormFieldComponent {
14361
14217
  renderer;
@@ -14393,35 +14249,25 @@ class FormFieldComponent {
14393
14249
  errorChildren;
14394
14250
  hintChildren;
14395
14251
  /**
14252
+ * Specifies when to show the hint messages:
14253
+ * * `initial`&mdash;Shows hints when the form control is `valid` or `untouched` and `pristine`.
14254
+ * * `always`&mdash;Always shows hints.
14396
14255
  *
14397
- * Specifies when the Hint messages will be shown.
14398
- *
14399
- * The possible values are:
14400
- *
14401
- * * (Default) `initial`&mdash;Allows displaying hints when the form-bound component state is
14402
- * `valid` or `untouched` and `pristine`.
14403
- * * `always`&mdash;Allows full control over the visibility of the hints.
14404
- *
14256
+ * @default 'initial'
14405
14257
  */
14406
14258
  showHints = 'initial';
14407
14259
  /**
14408
14260
  * Specifies the layout orientation of the form field.
14409
14261
  *
14410
- * * The possible values are:
14411
- *
14412
- * * (Default) `vertical`
14413
- * * `horizontal`
14262
+ * @default 'vertical'
14414
14263
  */
14415
14264
  orientation = 'vertical';
14416
14265
  /**
14417
- * Specifies when the Error messages will be shown.
14418
- *
14419
- * The possible values are:
14420
- *
14421
- * * (Default) `initial`&mdash;Allows displaying errors when the form-bound component state is
14422
- * `invalid` and `touched` or `dirty`.
14423
- * * `always`&mdash;Allows full control over the visibility of the errors.
14266
+ * Specifies when to show the error messages:
14267
+ * * `initial`&mdash;Shows errors when the form control is `invalid` and `touched` or `dirty`.
14268
+ * * `always`&mdash;Always shows errors.
14424
14269
  *
14270
+ * @default 'initial'
14425
14271
  */
14426
14272
  showErrors = 'initial';
14427
14273
  /**
@@ -14638,6 +14484,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14638
14484
  type: Input
14639
14485
  }] } });
14640
14486
 
14487
+ /**
14488
+ * Represents the Kendo UI RadioButton component.
14489
+ * Use this component to create a styled radio button in your Angular application.
14490
+ *
14491
+ * @example
14492
+ * ```html
14493
+ * <kendo-radiobutton
14494
+ * [checked]="true"
14495
+ * (checkedChange)="onCheckedChange($event)">
14496
+ * </kendo-radiobutton>
14497
+ * ```
14498
+ */
14641
14499
  class RadioButtonComponent extends RadioCheckBoxBase {
14642
14500
  renderer;
14643
14501
  hostElement;
@@ -14654,12 +14512,9 @@ class RadioButtonComponent extends RadioCheckBoxBase {
14654
14512
  */
14655
14513
  checked = false;
14656
14514
  /**
14657
- * Fires each time the checked state is changed.
14658
- * When the state of the component is programmatically changed to `ngModel` or `formControl`
14659
- * through its API or form binding, the `checkedStateChange` event is not triggered because it
14660
- * might cause a mix-up with the built-in mechanisms of the `ngModel` or `formControl` bindings.
14661
- *
14662
- * Used to provide a two-way binding for the `checked` property.
14515
+ * Fires when the checked state changes.
14516
+ * The event does not fire when you change the state through `ngModel` or `formControl` bindings.
14517
+ * Use this event for two-way binding of the `checked` property.
14663
14518
  */
14664
14519
  checkedChange = new EventEmitter();
14665
14520
  subs = new Subscription();
@@ -14828,11 +14683,11 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14828
14683
 
14829
14684
  const DEFAULT_SIZE$3 = 'medium';
14830
14685
  /**
14831
- * Represents the directive that renders the [Kendo UI RadioButton]({% slug overview_checkbox %}) input component.
14832
- * The directive is placed on input type="radio" elements.
14686
+ * Represents the directive that renders the Kendo UI RadioButton input component.
14687
+ * Place the directive on `input type="radio"` HTML elements.
14833
14688
  *
14834
14689
  * @example
14835
- * ```ts-no-run
14690
+ * ```html
14836
14691
  * <input type="radio" kendoRadioButton />
14837
14692
  * ```
14838
14693
  */
@@ -14841,13 +14696,9 @@ class RadioButtonDirective {
14841
14696
  hostElement;
14842
14697
  kendoClass = true;
14843
14698
  /**
14844
- * The size property specifies the width and height of the RadioButton
14845
- * ([see example]({% slug appearance_radiobuttondirective %}#toc-size)).
14846
- * The possible values are:
14847
- * * `small`
14848
- * * `medium` (default)
14849
- * * `large`
14850
- * * `none`
14699
+ * Specifies the `size` of the RadioButton. The `size` property changes the width and height of the RadioButton ([see example]({% slug appearance_radiobuttondirective %}#toc-size)).
14700
+ *
14701
+ * @default "medium"
14851
14702
  */
14852
14703
  set size(size) {
14853
14704
  const newSize = size ? size : DEFAULT_SIZE$3;
@@ -14898,7 +14749,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14898
14749
  }] } });
14899
14750
 
14900
14751
  /**
14901
- * Custom component messages override default component messages.
14752
+ * Lets you override the default messages of the RangeSlider component.
14753
+ *
14754
+ * @example
14755
+ *
14756
+ * ```html
14757
+ * <kendo-rangeslider-messages
14758
+ * decreaseHandle="Decrease handle"
14759
+ * increaseHandle="Increase handle"
14760
+ * decreaseRange="Decrease range">
14761
+ * </kendo-rangeslider-messages>
14762
+ * ```
14902
14763
  */
14903
14764
  class RangeSliderCustomMessagesComponent extends RangeSliderMessages {
14904
14765
  service;
@@ -14933,10 +14794,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14933
14794
  }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
14934
14795
 
14935
14796
  /**
14936
- * Renders the hovered rating item content. To define an item template, nest an `<ng-template>` tag
14937
- * with the `kendoRatingHoveredItemTemplate` directive inside the `<kendo-rating>` tag
14938
- * [see example](slug:templates_rating).
14797
+ * Renders the hovered rating item content.
14798
+ * To define an item template, nest an `<ng-template>` tag with the `kendoRatingHoveredItemTemplate` directive inside the `<kendo-rating>` tag ([see example](slug:templates_rating)).
14799
+ *
14939
14800
  * The index of the currently hovered item is available as an implicit context using the `let-index="index"` syntax.
14801
+ * * @example
14802
+ * ```html
14803
+ * <kendo-rating [value]="ratingValue">
14804
+ * <ng-template kendoRatingHoveredItemTemplate let-index="index">
14805
+ * <span>Hovered item: {{ index }}</span>
14806
+ * </ng-template>
14807
+ * </kendo-rating>
14808
+ * ```
14940
14809
  */
14941
14810
  class RatingHoveredItemTemplateDirective {
14942
14811
  templateRef;
@@ -14955,10 +14824,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14955
14824
  }], ctorParameters: function () { return [{ type: i0.TemplateRef }]; } });
14956
14825
 
14957
14826
  /**
14958
- * Renders the rating item content. To define an item template, nest an `<ng-template>` tag
14959
- * with the `kendoRatingItemTemplate` directive inside the `<kendo-rating>` tag
14960
- * [see example](slug:templates_rating).
14827
+ * Renders the rating item content.
14828
+ * To define an item template, nest an `<ng-template>` tag with the `kendoRatingItemTemplate` directive inside the `<kendo-rating>` tag ([see example](slug:templates_rating)).
14961
14829
  * The index of the current item is available as an implicit context using the `let-index="index"` syntax.
14830
+ * * @example
14831
+ * ```html
14832
+ * <kendo-rating [value]="ratingValue">
14833
+ * <ng-template kendoRatingItemTemplate let-index="index">
14834
+ * <span>Item: {{ index }}</span>
14835
+ * </ng-template>
14836
+ * </kendo-rating>
14837
+ * ```
14962
14838
  */
14963
14839
  class RatingItemTemplateDirective {
14964
14840
  templateRef;
@@ -14977,10 +14853,19 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14977
14853
  }], ctorParameters: function () { return [{ type: i0.TemplateRef }]; } });
14978
14854
 
14979
14855
  /**
14980
- * Renders the selected rating item content. To define an item template, nest an `<ng-template>` tag
14981
- * with the `kendoRatingSelectedItemTemplate` directive inside the `<kendo-rating>` tag
14982
- * [see example](slug:templates_rating).
14856
+ * Renders the selected rating item content.
14857
+ * To define an item template, nest an `<ng-template>` tag with the `kendoRatingSelectedItemTemplate` directive inside the `<kendo-rating>` tag ([see example](slug:templates_rating)).
14858
+ *
14983
14859
  * The index of the currently selected item is available as an implicit context using the `let-index="index"` syntax.
14860
+ *
14861
+ * @example
14862
+ * ```html
14863
+ * <kendo-rating [value]="ratingValue">
14864
+ * <ng-template kendoRatingSelectedItemTemplate let-index="index">
14865
+ * <span>Selected item: {{ index }}</span>
14866
+ * </ng-template>
14867
+ * </kendo-rating>
14868
+ * ```
14984
14869
  */
14985
14870
  class RatingSelectedItemTemplateDirective {
14986
14871
  templateRef;
@@ -14999,7 +14884,13 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
14999
14884
  }], ctorParameters: function () { return [{ type: i0.TemplateRef }]; } });
15000
14885
 
15001
14886
  /**
15002
- * Represents the [Kendo UI Rating component for Angular]({% slug overview_rating %}).
14887
+ * Represents the Kendo UI Rating component for Angular.
14888
+ * Use this component to let users select a rating value.
14889
+ *
14890
+ * @example
14891
+ * ```html
14892
+ * <kendo-rating [itemsCount]="5" [(value)]="ratingValue"></kendo-rating>
14893
+ * ```
15003
14894
  */
15004
14895
  class RatingComponent {
15005
14896
  element;
@@ -15011,37 +14902,36 @@ class RatingComponent {
15011
14902
  hoveredItemTemplate;
15012
14903
  selectedItemTemplate;
15013
14904
  /**
15014
- * Determines whether the Rating is disabled ([see example]({% slug disabledstate_rating %})). To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_rating#toc-managing-the-rating-disabled-state-in-reactive-forms).
14905
+ * When `true`, disables the Rating ([see example]({% slug disabledstate_rating %})).
14906
+
14907
+ * To disable the component in reactive forms, see [Forms Support](slug:formssupport_rating#toc-managing-the-rating-disabled-state-in-reactive-forms).
15015
14908
  *
15016
14909
  * @default false
15017
- *
15018
14910
  */
15019
14911
  disabled = false;
15020
14912
  /**
15021
- * Determines whether the Rating is in its read-only state ([see example]({% slug readonly_rating %})).
14913
+ * When `true`, sets the Rating to read-only ([see example]({% slug readonly_rating %})).
14914
+
15022
14915
  *
15023
14916
  * @default false
15024
- *
15025
14917
  */
15026
14918
  readonly = false;
15027
14919
  /**
15028
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the Rating.
14920
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the Rating.
14921
+
15029
14922
  *
15030
14923
  * @default 0
15031
- *
15032
14924
  */
15033
14925
  tabindex = 0;
15034
14926
  /**
15035
14927
  * Sets the number of Rating items ([see example]({% slug itemscount_rating %})).
15036
14928
  *
15037
14929
  * @default 5
15038
- *
15039
14930
  */
15040
14931
  itemsCount = 5;
15041
14932
  /**
15042
- * The initial value of the Rating component.
15043
- * The component can use either NgModel or the `value` binding but not both of them at the same time.
15044
- *
14933
+ * Sets the initial value of the Rating component.
14934
+ * Use either `ngModel` or the `value` binding, but not both at the same time.
15045
14935
  */
15046
14936
  set value(value) {
15047
14937
  this._value = value;
@@ -15054,7 +14944,6 @@ class RatingComponent {
15054
14944
  * Sets the selection mode of the Rating ([see example]({% slug selection_rating %})).
15055
14945
  *
15056
14946
  * @default 'continuous'
15057
- *
15058
14947
  */
15059
14948
  set selection(selection) {
15060
14949
  this._selection = selection;
@@ -15064,10 +14953,9 @@ class RatingComponent {
15064
14953
  return this._selection;
15065
14954
  }
15066
14955
  /**
15067
- * Determines the precision of the Rating ([see example]({% slug precision_rating %})).
14956
+ * Sets the precision of the Rating ([see example]({% slug precision_rating %})).
15068
14957
  *
15069
14958
  * @default 'item'
15070
- *
15071
14959
  */
15072
14960
  set precision(precision) {
15073
14961
  this._precision = precision;
@@ -15077,7 +14965,7 @@ class RatingComponent {
15077
14965
  return this._precision;
15078
14966
  }
15079
14967
  /**
15080
- * Sets the Rating label to the provided text. The text is rendered in a `<span>` element, instead of the native HTML `<label>` element ([see example]({% slug label_rating %})).
14968
+ * Sets the label text for the Rating. The text renders in a `<span>` element ([see example]({% slug label_rating %})).
15081
14969
  */
15082
14970
  label;
15083
14971
  /**
@@ -15085,15 +14973,15 @@ class RatingComponent {
15085
14973
  */
15086
14974
  icon;
15087
14975
  /**
15088
- * Sets a custom SVG icon for the selected/hovered state of the Rating items ([see example]({% slug icon_rating %})).
14976
+ * Sets a custom SVG icon for the selected or hovered state of the Rating items ([see example]({% slug icon_rating %})).
15089
14977
  */
15090
14978
  svgIcon = starIcon;
15091
14979
  /**
15092
- * Sets a custom SVG icon for the default state of the Rating items when they are not hovered or selected ([see example]({% slug icon_rating %})).
14980
+ * Sets a custom SVG icon for the default state of the Rating items when not hovered or selected ([see example]({% slug icon_rating %})).
15093
14981
  */
15094
14982
  svgIconOutline = starOutlineIcon;
15095
14983
  /**
15096
- * Fires each time the user selects a new value.
14984
+ * Fires when the user selects a new value.
15097
14985
  */
15098
14986
  valueChange = new EventEmitter();
15099
14987
  hostClass = true;
@@ -15487,7 +15375,7 @@ class RatingComponent {
15487
15375
  </span>
15488
15376
  </span>
15489
15377
 
15490
- <span
15378
+ <span
15491
15379
  *ngIf="label"
15492
15380
  class="k-rating-label"
15493
15381
  >{{ label }}</span>
@@ -15644,7 +15532,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
15644
15532
  </span>
15645
15533
  </span>
15646
15534
 
15647
- <span
15535
+ <span
15648
15536
  *ngIf="label"
15649
15537
  class="k-rating-label"
15650
15538
  >{{ label }}</span>
@@ -15763,7 +15651,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
15763
15651
  }] } });
15764
15652
 
15765
15653
  /**
15766
- * Custom component messages override default component messages.
15654
+ * Use this component to override the default Signature messages.
15767
15655
  */
15768
15656
  class SignatureCustomMessagesComponent extends SignatureMessages {
15769
15657
  service;
@@ -15798,7 +15686,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
15798
15686
  }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
15799
15687
 
15800
15688
  /**
15801
- * Arguments for the `close` event of the Signature component.
15689
+ * Provides arguments for the `close` event of the Signature component.
15802
15690
  */
15803
15691
  class SignatureCloseEvent extends PreventableEvent {
15804
15692
  }
@@ -15856,7 +15744,15 @@ const iconsMap = { xIcon, hyperlinkOpenIcon };
15856
15744
  /**
15857
15745
  * Represents the [Kendo UI Signature component for Angular]({% slug overview_signature %}).
15858
15746
  *
15859
- * The Signature allows users to add a hand-drawn signature to forms.
15747
+ * Use the Signature to let users add a hand-drawn signature to forms.
15748
+ *
15749
+ * @example
15750
+ * ```html
15751
+ * <kendo-signature [(ngModel)]="signatureValue"></kendo-signature>
15752
+ * ```
15753
+ *
15754
+ * @remarks
15755
+ * Supported children components are: {@link SignatureCustomMessagesComponent}.
15860
15756
  */
15861
15757
  class SignatureComponent {
15862
15758
  element;
@@ -15874,29 +15770,34 @@ class SignatureComponent {
15874
15770
  /**
15875
15771
  * Sets the read-only state of the Signature.
15876
15772
  *
15773
+ * Set to `true` to prevent editing.
15774
+ *
15877
15775
  * @default false
15878
15776
  */
15879
15777
  readonly = false;
15880
15778
  /**
15881
- * Sets the disabled state of the Signature. To disable the component in reactive forms, visit the following [article](slug:formssupport_signature#toc-managing-the-signature-disabled-state-in-reactive-forms)
15779
+ * Sets the disabled state of the Signature.
15780
+ *
15781
+ * Set to `true` to disable the component and prevent any user interaction.
15782
+ * To disable the component in reactive forms, see [Managing the Signature Disabled State in Reactive Forms](slug:formssupport_signature#toc-managing-the-signature-disabled-state-in-reactive-forms).
15882
15783
  *
15883
15784
  * @default false
15884
15785
  */
15885
15786
  disabled = false;
15886
15787
  /**
15887
- * Sets the width of the signature in pixels.
15788
+ * Sets the width of the Signature in pixels.
15888
15789
  *
15889
- * The width can also be set using inline styles and CSS.
15790
+ * You can also set the width using inline styles or CSS.
15890
15791
  */
15891
15792
  width;
15892
15793
  /**
15893
- * The height of the signature in pixels.
15794
+ * Sets the height of the Signature in pixels.
15894
15795
  *
15895
- * The height can also be set using inline styles and CSS.
15796
+ * You can also set the height using inline styles or CSS.
15896
15797
  */
15897
15798
  height;
15898
15799
  /**
15899
- * Gets or sets the value of the signature.
15800
+ * Gets or sets the value of the Signature.
15900
15801
  *
15901
15802
  * The value is a Base64-encoded PNG image.
15902
15803
  */
@@ -15931,69 +15832,54 @@ class SignatureComponent {
15931
15832
  return !this.disabled ? this._tabindex : undefined;
15932
15833
  }
15933
15834
  /**
15934
- * The size property specifies the padding of the Signature internal controls
15935
- * ([see example]({% slug appearance_signature %}#toc-size)).
15835
+ * Sets the padding of the Signature internal controls
15836
+ * ([ee example]({% slug appearance_signature %}#toc-size)).
15936
15837
  *
15937
- * The possible values are:
15938
- * * `small`
15939
- * * `medium` (default)
15940
- * * `large`
15941
- * * `none`
15838
+ * @default 'medium'
15942
15839
  */
15943
15840
  size = DEFAULT_SIZE$2;
15944
15841
  /**
15945
- * The `rounded` property specifies the border radius of the signature
15842
+ * Sets the border radius of the Signature
15946
15843
  * ([see example](slug:appearance_signature#rounded-corners)).
15947
15844
  *
15948
- * The possible values are:
15949
- * * `small`
15950
- * * `medium` (default)
15951
- * * `large`
15952
- * * `full` (not supported by the Signature)
15953
- * * `none`
15845
+ * @default 'medium'
15954
15846
  */
15955
15847
  rounded = DEFAULT_ROUNDED$2;
15956
15848
  /**
15957
- * The `fillMode` property specifies the background and border styles of the signature
15849
+ * Sets the background and border styles of the Signature
15958
15850
  * ([see example](slug:appearance_signature#toc-fill-mode)).
15959
15851
  *
15960
- * The possible values are:
15961
- * * `flat`
15962
- * * `solid` (default)
15963
- * * `outline`
15964
- * * `none`
15852
+ * @default 'solid'
15965
15853
  */
15966
15854
  fillMode = DEFAULT_FILL_MODE$2;
15967
15855
  /**
15968
- * The stroke color of the signature.
15856
+ * Sets the stroke color of the Signature.
15969
15857
  *
15970
15858
  * Accepts CSS color names and hex values.
15971
- *
15972
15859
  * The default value is determined by the theme `$kendo-input-text` variable.
15973
15860
  */
15974
15861
  color;
15975
15862
  /**
15976
- * The background color of the signature.
15863
+ * Sets the background color of the Signature.
15977
15864
  *
15978
15865
  * Accepts CSS color names and hex values.
15979
- *
15980
15866
  * The default value is determined by the theme `$kendo-input-bg` variable.
15981
15867
  */
15982
15868
  backgroundColor;
15983
15869
  /**
15984
- * The stroke width of the signature.
15870
+ * Sets the stroke width of the Signature.
15985
15871
  *
15986
15872
  * @default 1
15987
15873
  */
15988
15874
  strokeWidth = 1;
15989
15875
  /**
15990
- * A flag indicating whether to smooth out signature lines.
15876
+ * When set to `true`, smooths out signature lines.
15991
15877
  *
15992
15878
  * @default false
15993
15879
  */
15994
15880
  smooth = false;
15995
15881
  /**
15996
- * A flag indicating if the signature can be maximized.
15882
+ * When set to `true`, allows the Signature to be maximized.
15997
15883
  *
15998
15884
  * @default true
15999
15885
  */
@@ -16003,17 +15889,17 @@ class SignatureComponent {
16003
15889
  */
16004
15890
  maximized = false;
16005
15891
  /**
16006
- * The scale factor for the popup.
15892
+ * Sets the scale factor for the popup.
16007
15893
  *
16008
- * The Signature width and height will be multiplied by the scale when showing the popup.
15894
+ * The Signature width and height are multiplied by this value when showing the popup.
16009
15895
  *
16010
15896
  * @default 3
16011
15897
  */
16012
15898
  popupScale = DEFAULT_POPUP_SCALE;
16013
15899
  /**
16014
- * The scale factor for the exported image.
15900
+ * Sets the scale factor for the exported image.
16015
15901
  *
16016
- * The Signature width and height will be multiplied by the scale when converting the signature to an image.
15902
+ * The Signature width and height are multiplied by this value when converting the signature to an image.
16017
15903
  *
16018
15904
  * @default 2
16019
15905
  */
@@ -16023,31 +15909,33 @@ class SignatureComponent {
16023
15909
  */
16024
15910
  parentLocalization;
16025
15911
  /**
16026
- * A flag indicating whether the dotted line should be displayed in the background.
15912
+ * When set to `true`, hides the dotted line in the background.
16027
15913
  *
16028
15914
  * @default false
16029
15915
  */
16030
15916
  hideLine = false;
16031
15917
  /**
16032
- * Fires each time the signature value is changed.
15918
+ * Fires when the signature value changes.
16033
15919
  */
16034
15920
  valueChange = new EventEmitter();
16035
15921
  /**
16036
- * Fires each time the popup is about to open.
16037
- * This event is preventable. If you cancel it, the popup will remain closed.
15922
+ * Fires before the popup opens.
15923
+ *
15924
+ * This event is preventable. If you cancel it, the popup stays closed.
16038
15925
  */
16039
15926
  open = new EventEmitter();
16040
15927
  /**
16041
- * Fires each time the popup is about to close.
16042
- * This event is preventable. If you cancel it, the popup will remain open.
15928
+ * Fires before the popup closes.
15929
+ *
15930
+ * This event is preventable. If you cancel it, the popup stays open.
16043
15931
  */
16044
15932
  close = new EventEmitter();
16045
15933
  /**
16046
- * Fires each time Signature is focused.
15934
+ * Fires when the Signature receives focus.
16047
15935
  */
16048
15936
  onFocus = new EventEmitter();
16049
15937
  /**
16050
- * Fires each time the Signature is blurred.
15938
+ * Fires when the Signature loses focus.
16051
15939
  */
16052
15940
  onBlur = new EventEmitter();
16053
15941
  /**
@@ -16058,11 +15946,11 @@ class SignatureComponent {
16058
15946
  minimizeButton;
16059
15947
  maximizeButton;
16060
15948
  /**
16061
- * Indicates whether the Signature wrapper is focused.
15949
+ * Indicates if the Signature wrapper is focused.
16062
15950
  */
16063
15951
  isFocused = false;
16064
15952
  /**
16065
- * Indicates whether the Signature popup is open.
15953
+ * Indicates if the Signature popup is open.
16066
15954
  */
16067
15955
  isOpen;
16068
15956
  /**
@@ -16319,9 +16207,10 @@ class SignatureComponent {
16319
16207
  }
16320
16208
  /**
16321
16209
  * Toggles the popup of the Signature.
16322
- * Does not trigger the `open` and `close` events of the component.
16323
16210
  *
16324
- * @param open An optional parameter. Specifies whether the popup will be opened or closed.
16211
+ * Does not trigger the `open` and `close` events.
16212
+ *
16213
+ * @param open Optional. Set to `true` to open or `false` to close the popup.
16325
16214
  */
16326
16215
  toggle(open) {
16327
16216
  if (this.disabled || this.readonly) {
@@ -16373,7 +16262,7 @@ class SignatureComponent {
16373
16262
  this.backgroundColor = this.backgroundColor || defaultBackgroundColor;
16374
16263
  }
16375
16264
  /**
16376
- * Focuses the wrapper of the Signature.
16265
+ * Focuses the Signature wrapper container.
16377
16266
  */
16378
16267
  focus() {
16379
16268
  this.focused = true;
@@ -16791,7 +16680,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
16791
16680
  }] } });
16792
16681
 
16793
16682
  /**
16794
- * Custom component messages override default component messages.
16683
+ * Use this component to override the default Slider messages.
16795
16684
  */
16796
16685
  class SliderCustomMessagesComponent extends SliderMessages {
16797
16686
  service;
@@ -16826,7 +16715,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
16826
16715
  }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
16827
16716
 
16828
16717
  /**
16829
- * Custom component messages override default component messages.
16718
+ * Overrides the default component messages with custom component messages.
16830
16719
  */
16831
16720
  class SwitchCustomMessagesComponent extends Messages {
16832
16721
  service;
@@ -16861,19 +16750,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
16861
16750
  }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
16862
16751
 
16863
16752
  /**
16864
- * Specifies the adornments in the prefix container ([see example]({% slug textarea_adornments %})).
16865
- * ```ts-no-run
16866
- * _@Component({
16867
- * selector: 'my-app',
16868
- * template: `
16869
- * <kendo-textarea>
16870
- * <kendo-textarea-prefix>
16871
- * <button kendoButton look="clear" icon="image"></button>
16872
- * </kendo-textarea-prefix>
16873
- * </kendo-textarea>
16874
- * `
16875
- * })
16876
- * class AppComponent {}
16753
+ * Represents the prefix adornments container for the TextArea component.
16754
+ *
16755
+ * Nest the `<kendo-textarea-prefix>` component inside `<kendo-textarea>` to add elements before the input.
16756
+ *
16757
+ * @example
16758
+ * ```html
16759
+ * <kendo-textarea>
16760
+ * <kendo-textarea-prefix>
16761
+ * <button kendoButton look="clear" icon="image"></button>
16762
+ * </kendo-textarea-prefix>
16763
+ * </kendo-textarea>
16877
16764
  * ```
16878
16765
  */
16879
16766
  class TextAreaPrefixComponent {
@@ -16925,19 +16812,17 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
16925
16812
  }] } });
16926
16813
 
16927
16814
  /**
16928
- * Specifies the adornments in the suffix container ([see example]({% slug textarea_adornments %})).
16929
- * ```ts-no-run
16930
- * _@Component({
16931
- * selector: 'my-app',
16932
- * template: `
16933
- * <kendo-textarea>
16934
- * <kendo-textarea-suffix>
16935
- * <button kendoButton look="clear" icon="image"></button>
16936
- * </kendo-textarea-suffix>
16937
- * </kendo-textarea>
16938
- * `
16939
- * })
16940
- * class AppComponent {}
16815
+ * Represents the suffix adornments container for the TextArea component.
16816
+ *
16817
+ * Nest the `<kendo-textarea-suffix>` component inside `<kendo-textarea>` to add elements after the input.
16818
+ *
16819
+ * @example
16820
+ * ```html
16821
+ * <kendo-textarea>
16822
+ * <kendo-textarea-suffix>
16823
+ * <button kendoButton look="clear" icon="image"></button>
16824
+ * </kendo-textarea-suffix>
16825
+ * </kendo-textarea>
16941
16826
  * ```
16942
16827
  */
16943
16828
  class TextAreaSuffixComponent {
@@ -17140,7 +17025,17 @@ const DEFAULT_SIZE$1 = 'medium';
17140
17025
  const DEFAULT_ROUNDED$1 = 'medium';
17141
17026
  const DEFAULT_FILL_MODE$1 = 'solid';
17142
17027
  /**
17143
- * Represents the [Kendo UI TextArea component for Angular]({% slug overview_textarea %}).
17028
+ * Represents the Kendo UI TextArea component for Angular.
17029
+ *
17030
+ * Use this component to let users enter and edit multi-line text.
17031
+ *
17032
+ * @example
17033
+ * ```html
17034
+ * <kendo-textarea [(ngModel)]="value" [rows]="5" [cols]="30"></kendo-textarea>
17035
+ * ```
17036
+ *
17037
+ * @remarks
17038
+ * Supported children components are: {@link TextAreaPrefixComponent}, {@link TextAreaSuffixComponent}.
17144
17039
  */
17145
17040
  class TextAreaComponent extends TextFieldsBase {
17146
17041
  localizationService;
@@ -17162,12 +17057,7 @@ class TextAreaComponent extends TextFieldsBase {
17162
17057
  }
17163
17058
  _flow = 'vertical';
17164
17059
  /**
17165
- * Specifies the flow direction of the TextArea sections. This property is useful when adornments are used, in order to specify
17166
- * their position in relation to the textarea element.
17167
- *
17168
- * The possible values are:
17169
- * * `vertical`(Default) &mdash;TextArea sections are placed from top to bottom.
17170
- * * `horizontal`&mdash;TextArea sections are placed from left to right in `ltr`, and from right to left in `rtl` mode.
17060
+ * Specifies the flow direction of the TextArea sections. Use this property to set the position of adornments relative to the text area.
17171
17061
  */
17172
17062
  set flow(flow) {
17173
17063
  this._flow = flow;
@@ -17182,7 +17072,7 @@ class TextAreaComponent extends TextFieldsBase {
17182
17072
  return this._flow;
17183
17073
  }
17184
17074
  /**
17185
- * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
17075
+ * Sets the HTML attributes of the inner focusable input element. Some attributes are required for component functionality and cannot be changed.
17186
17076
  */
17187
17077
  set inputAttributes(attributes) {
17188
17078
  if (isObjectPresent(this.parsedAttributes)) {
@@ -17198,12 +17088,8 @@ class TextAreaComponent extends TextFieldsBase {
17198
17088
  return this._inputAttributes;
17199
17089
  }
17200
17090
  /**
17201
- * Specifies the orientation of the TextArea adornments. This property is used in order to specify
17202
- * the adornments' position relative to themselves.
17091
+ * Specifies the orientation of the TextArea adornments. Use this property to set the position of adornments relative to each other.
17203
17092
  *
17204
- * The possible values are:
17205
- * * `horizontal`(Default) &mdash;TextArea adornments are placed from left to right in `ltr`, and from right to left in `rtl` mode.
17206
- * * `vertical`&mdash;TextArea adornments are placed from top to bottom.
17207
17093
  */
17208
17094
  set adornmentsOrientation(orientation) {
17209
17095
  this._adornmentsOrientation = orientation;
@@ -17218,19 +17104,20 @@ class TextAreaComponent extends TextFieldsBase {
17218
17104
  return this._adornmentsOrientation;
17219
17105
  }
17220
17106
  /**
17221
- * Specifies the visible height of the textarea element in lines.
17107
+ * Sets the visible height of the text area in lines.
17222
17108
  */
17223
17109
  rows;
17224
17110
  /**
17225
- * Specifies the visible width of the textarea element (in average character width).
17111
+ * Sets the visible width of the text area in average character width.
17226
17112
  */
17227
17113
  cols;
17228
17114
  /**
17229
- * Specifies the maximum number of characters that the user can enter in the TextArea component.
17115
+ * Sets the maximum number of characters allowed in the text area.
17230
17116
  */
17231
17117
  maxlength;
17232
17118
  /**
17233
- * Specifies the [tabindex](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
17119
+ * Sets the [`tabindex`](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/tabindex) of the component.
17120
+ * @default 0
17234
17121
  */
17235
17122
  tabindex = 0;
17236
17123
  /**
@@ -17243,26 +17130,15 @@ class TextAreaComponent extends TextFieldsBase {
17243
17130
  return this.tabindex;
17244
17131
  }
17245
17132
  /**
17246
- * Configures the resize behavior of the TextArea.
17133
+ * Sets the resize behavior of the TextArea.
17247
17134
  *
17248
- * The possible values are:
17249
- * * `vertical`(Default)&mdash;The TextArea component can be resized only vertically.
17250
- * * `horizontal`&mdash;The TextArea component can be resized only horizontally.
17251
- * * `both`&mdash;The TextArea component can be resized in both (horizontal and vertical) directions.
17252
- * * `auto`&mdash;Specifies whether the TextArea component will adjust its height automatically, based on the content.
17253
- * * `none`&mdash;The TextArea cannot be resized.
17254
17135
  *
17136
+ * @default 'vertical'
17255
17137
  */
17256
17138
  resizable = 'vertical';
17257
17139
  /**
17258
- * The size property specifies the padding of the internal textarea element
17259
- * ([see example]({% slug appearance_textarea %}#toc-size)).
17260
- *
17261
- * The possible values are:
17262
- * * `small`
17263
- * * `medium` (default)
17264
- * * `large`
17265
- * * `none`
17140
+ * Sets the size of the TextArea. Controls the padding of the text area element ([see example]({% slug appearance_textarea %}#toc-size)).
17141
+ * @default 'medium'
17266
17142
  */
17267
17143
  set size(size) {
17268
17144
  const newSize = size ? size : DEFAULT_SIZE$1;
@@ -17273,14 +17149,8 @@ class TextAreaComponent extends TextFieldsBase {
17273
17149
  return this._size;
17274
17150
  }
17275
17151
  /**
17276
- * The `rounded` property specifies the border radius of the TextArea
17277
- * ([see example](slug:appearance_textarea#toc-roundness)).
17278
- *
17279
- * The possible values are:
17280
- * * `small`
17281
- * * `medium` (default)
17282
- * * `large`
17283
- * * `none`
17152
+ * Sets the border radius of the TextArea ([see example](slug:appearance_textarea#toc-roundness)).
17153
+ * @default 'medium'
17284
17154
  */
17285
17155
  set rounded(rounded) {
17286
17156
  const newRounded = rounded ? rounded : DEFAULT_ROUNDED$1;
@@ -17291,14 +17161,8 @@ class TextAreaComponent extends TextFieldsBase {
17291
17161
  return this._rounded;
17292
17162
  }
17293
17163
  /**
17294
- * The `fillMode` property specifies the background and border styles of the TextArea
17295
- * ([see example](slug:appearance_textarea#toc-fill-mode)).
17296
- *
17297
- * The possible values are:
17298
- * * `flat`
17299
- * * `solid` (default)
17300
- * * `outline`
17301
- * * `none`
17164
+ * Sets the background and border styles of the TextArea ([see example](slug:appearance_textarea#toc-fill-mode)).
17165
+ * @default 'solid'
17302
17166
  */
17303
17167
  set fillMode(fillMode) {
17304
17168
  const newFillMode = fillMode ? fillMode : DEFAULT_FILL_MODE$1;
@@ -17309,65 +17173,35 @@ class TextAreaComponent extends TextFieldsBase {
17309
17173
  return this._fillMode;
17310
17174
  }
17311
17175
  /**
17312
- * Specifies whether the prefix separator of the TextArea is rendered.
17313
- * If a prefix template is not declared, the separator will not be rendered, regardless of the parameter value.
17176
+ * Shows the prefix separator in the TextArea.
17177
+ * The separator is rendered only if a prefix template is declared.
17314
17178
  *
17315
17179
  * @default false
17316
17180
  */
17317
17181
  showPrefixSeparator = false;
17318
17182
  /**
17319
- * Specifies whether the suffix separator of the TextArea is rendered.
17320
- * If a suffix template is not declared, the separator will not be rendered, regardless of the parameter value.
17183
+ * Shows the suffix separator in the TextArea.
17184
+ * The separator is rendered only if a suffix template is declared.
17321
17185
  *
17322
17186
  * @default false
17323
17187
  */
17324
17188
  showSuffixSeparator = false;
17325
17189
  /**
17326
- * Fires each time the user focuses the TextArea component.
17327
- *
17328
- * > To wire the event programmatically, use the `onFocus` property.
17190
+ * Fires when the TextArea is focused.
17329
17191
  *
17330
- * @example
17331
- * ```ts
17332
- * _@Component({
17333
- * selector: 'my-app',
17334
- * template: `
17335
- * <kendo-textarea (focus)="handleFocus()"></kendo-textarea>
17336
- * `
17337
- * })
17338
- * class AppComponent {
17339
- * public handleFocus(): void {
17340
- * console.log('Component is focused.');
17341
- * }
17342
- * }
17343
- * ```
17192
+ * Use the `onFocus` property to subscribe to this event.
17344
17193
  */
17345
17194
  onFocus = new EventEmitter();
17346
17195
  /**
17347
- * Fires each time the TextArea component gets blurred.
17348
- *
17349
- * > To wire the event programmatically, use the `onBlur` property.
17196
+ * Fires when the TextArea gets blurred.
17350
17197
  *
17351
- * @example
17352
- * ```ts
17353
- * _@Component({
17354
- * selector: 'my-app',
17355
- * template: `
17356
- * <kendo-textarea (blur)="handleBlur()"></kendo-textarea>
17357
- * `
17358
- * })
17359
- * class AppComponent {
17360
- * public handleBlur(): void {
17361
- * console.log('Component is blurred');
17362
- * }
17363
- * }
17364
- * ```
17198
+ * Use the `onBlur` property to subscribe to this event.
17365
17199
  */
17366
17200
  onBlur = new EventEmitter();
17367
17201
  /**
17368
- * Fires each time the value is changed or the component is blurred
17369
- * ([see example](slug:events_textarea)).
17370
- * When the component value is changed programmatically or via its form control binding, the valueChange event is not emitted.
17202
+ * Fires when the value changes or the TextArea is blurred ([see example](slug:events_textarea)).
17203
+ *
17204
+ * The event does not fire when the value changes programmatically or through form control binding.
17371
17205
  */
17372
17206
  valueChange = new EventEmitter();
17373
17207
  initialHeight;
@@ -17582,19 +17416,7 @@ class TextAreaComponent extends TextFieldsBase {
17582
17416
  }
17583
17417
  };
17584
17418
  /**
17585
- * Focuses the TextArea component.
17586
- *
17587
- * @example
17588
- * ```ts
17589
- * _@Component({
17590
- * selector: 'my-app',
17591
- * template: `
17592
- * <button (click)="textarea.focus()">Focus the textarea</button>
17593
- * <kendo-textarea #textarea></kendo-textarea>
17594
- * `
17595
- * })
17596
- * class AppComponent { }
17597
- * ```
17419
+ * Focuses the TextArea.
17598
17420
  */
17599
17421
  focus() {
17600
17422
  if (!this.input) {
@@ -17606,7 +17428,7 @@ class TextAreaComponent extends TextFieldsBase {
17606
17428
  this.focusChangedProgrammatically = false;
17607
17429
  }
17608
17430
  /**
17609
- * Blurs the TextArea component.
17431
+ * Blurs the TextArea.
17610
17432
  */
17611
17433
  blur() {
17612
17434
  this.focusChangedProgrammatically = true;
@@ -17864,7 +17686,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
17864
17686
  }] } });
17865
17687
 
17866
17688
  /**
17867
- * Custom component messages override default component messages.
17689
+ * Overrides the default messages of the TextBox component.
17868
17690
  */
17869
17691
  class TextBoxCustomMessagesComponent extends TextBoxMessages {
17870
17692
  service;
@@ -18036,6 +17858,19 @@ const DEFAULT_SIZE = 'medium';
18036
17858
  const DEFAULT_ROUNDED = 'medium';
18037
17859
  const DEFAULT_FILL_MODE = 'solid';
18038
17860
  const DEFAULT_OTPINPUT_LENGTH = 4;
17861
+ /**
17862
+ * Represents the Kendo UI OTP Input component for Angular.
17863
+ *
17864
+ * Use the OTP Input to enter one-time passwords or verification codes.
17865
+ *
17866
+ * @example
17867
+ * ```html
17868
+ * <kendo-otpinput type="number" [(ngModel)]="otpValue"></kendo-otpinput>
17869
+ * ```
17870
+ *
17871
+ * @remarks
17872
+ * Supported children components are: {@link OTPInputCustomMessagesComponent}.
17873
+ */
18039
17874
  class OTPInputComponent {
18040
17875
  hostElement;
18041
17876
  cdr;
@@ -18044,7 +17879,7 @@ class OTPInputComponent {
18044
17879
  localizationService;
18045
17880
  zone;
18046
17881
  /**
18047
- * Configures the total number of input fields.
17882
+ * Sets the total number of input fields.
18048
17883
  *
18049
17884
  * @default 4
18050
17885
  */
@@ -18059,46 +17894,40 @@ class OTPInputComponent {
18059
17894
  return this._length;
18060
17895
  }
18061
17896
  /**
18062
- * Configures the input type.
17897
+ * Sets the input type.
18063
17898
  *
18064
- * * The possible values are:
18065
- * * `text` (default)
18066
- * * `number`
18067
- * * `password`
18068
17899
  *
18069
17900
  * @default 'text'
18070
17901
  */
18071
17902
  type = 'text';
18072
17903
  /**
18073
- * Configures whether the input fields are separate or adjacent to each other.
17904
+ * Sets whether the input fields are separate or adjacent.
18074
17905
  *
18075
17906
  * @default true
18076
17907
  */
18077
17908
  spacing = true;
18078
17909
  /**
18079
- * Specifies the separator between groups of input fields.
18080
- *
18081
- * > The configuration can only be applied when `groupLength` is set.
17910
+ * Sets the separator between groups of input fields. You can use this only when `groupLength` is set.
18082
17911
  */
18083
17912
  separator;
18084
17913
  /**
18085
- * Configures whether the component is enabled or disabled.
17914
+ * When `true`, disables the OTPInput.
18086
17915
  *
18087
17916
  * @default false
18088
17917
  */
18089
17918
  disabled = false;
18090
17919
  /**
18091
- * Configures whether the component is readonly.
17920
+ * When `true`, sets the OTPInput to read-only mode.
18092
17921
  *
18093
17922
  * @default false
18094
17923
  */
18095
17924
  readonly = false;
18096
17925
  /**
18097
- * Configures the placeholder of the input fields.
17926
+ * Sets the placeholder for the input fields.
18098
17927
  */
18099
17928
  placeholder;
18100
17929
  /**
18101
- * 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.
17930
+ * 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.
18102
17931
  */
18103
17932
  get groupLength() {
18104
17933
  return this._groupLength;
@@ -18127,7 +17956,7 @@ class OTPInputComponent {
18127
17956
  this.populateSeparatorPositions();
18128
17957
  }
18129
17958
  /**
18130
- * Configures the value of the component. Unfilled input fields are represented with space.
17959
+ * Sets the value of the component. Unfilled input fields are represented with а space.
18131
17960
  */
18132
17961
  get value() {
18133
17962
  return this._value;
@@ -18155,13 +17984,9 @@ class OTPInputComponent {
18155
17984
  }
18156
17985
  }
18157
17986
  /**
18158
- * The `size` property specifies the padding of the input fields.
17987
+ * Sets the padding of the input fields.
18159
17988
  *
18160
- * The possible values are:
18161
- * * `small`
18162
- * * `medium` (default)
18163
- * * `large`
18164
- * * `none`
17989
+ * @default 'medium'
18165
17990
  */
18166
17991
  set size(size) {
18167
17992
  const newSize = size || DEFAULT_SIZE;
@@ -18174,14 +17999,9 @@ class OTPInputComponent {
18174
17999
  return this._size;
18175
18000
  }
18176
18001
  /**
18177
- * The `rounded` property specifies the border radius of the OTP Input.
18002
+ * Sets the border radius of the OTP Input.
18178
18003
  *
18179
- * The possible values are:
18180
- * * `small`
18181
- * * `medium` (default)
18182
- * * `large`
18183
- * * `full`
18184
- * * `none`
18004
+ * @default 'medium'
18185
18005
  */
18186
18006
  set rounded(rounded) {
18187
18007
  this._rounded = rounded || DEFAULT_ROUNDED;
@@ -18190,13 +18010,9 @@ class OTPInputComponent {
18190
18010
  return this._rounded;
18191
18011
  }
18192
18012
  /**
18193
- * The `fillMode` property specifies the background and border styles of the OTP Input.
18013
+ * Sets the background and border styles of the OTP Input.
18194
18014
  *
18195
- * The possible values are:
18196
- * * `flat`
18197
- * * `solid` (default)
18198
- * * `outline`
18199
- * * `none`
18015
+ * @default 'solid'
18200
18016
  */
18201
18017
  set fillMode(fillMode) {
18202
18018
  const newFillMode = fillMode || DEFAULT_FILL_MODE;
@@ -18207,7 +18023,7 @@ class OTPInputComponent {
18207
18023
  return this._fillMode;
18208
18024
  }
18209
18025
  /**
18210
- * Sets the HTML attributes of the inner focusable input element. Attributes which are essential for certain component functionalities cannot be changed.
18026
+ * Sets the HTML attributes of the inner input element. You cannot change attributes that are required for the component to work.
18211
18027
  */
18212
18028
  set inputAttributes(attributes) {
18213
18029
  this._inputAttributes = attributes;
@@ -18220,18 +18036,17 @@ class OTPInputComponent {
18220
18036
  return this._inputAttributes;
18221
18037
  }
18222
18038
  /**
18223
- * Fires each time the value is changed by the user&mdash;
18224
- * When the value of the component is programmatically changed to `ngModel` or `formControl`
18225
- * through its API or form binding, the `valueChange` event is not triggered because it
18226
- * might cause a mix-up with the built-in `valueChange` mechanisms of the `ngModel` or `formControl` bindings.
18039
+ * Fires when the user changes the value.
18040
+ *
18041
+ * This event does not fire when you change the value programmatically or through form bindings.
18227
18042
  */
18228
18043
  valueChange = new EventEmitter();
18229
18044
  /**
18230
- * Fires each time the user focuses the OTP Input.
18045
+ * Fires when the user focuses the OTP Input.
18231
18046
  */
18232
18047
  onFocus = new EventEmitter();
18233
18048
  /**
18234
- * Fires each time the user blurs the OTP Input.
18049
+ * Fires when the user blurs the OTP Input.
18235
18050
  */
18236
18051
  onBlur = new EventEmitter();
18237
18052
  wrapperClass = true;
@@ -18401,6 +18216,8 @@ class OTPInputComponent {
18401
18216
  }
18402
18217
  }
18403
18218
  /**
18219
+ * Returns `true` if the component has groups.
18220
+ *
18404
18221
  * @hidden
18405
18222
  */
18406
18223
  get hasGroups() {
@@ -18500,7 +18317,9 @@ class OTPInputComponent {
18500
18317
  });
18501
18318
  }
18502
18319
  /**
18503
- * Focuses the OTP Input.
18320
+ * Focuses the OTP Input at the specified index provided as an argument.
18321
+ *
18322
+ * @param index The index of the input to focus.
18504
18323
  */
18505
18324
  focus(index) {
18506
18325
  if (!this.inputFields || index < 0 || index >= this.length) {
@@ -18947,7 +18766,9 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
18947
18766
  }] } });
18948
18767
 
18949
18768
  /**
18950
- * Custom component messages override default component messages.
18769
+ * Provides custom messages for the OTP Input component.
18770
+ *
18771
+ * Use this component to override the default messages.
18951
18772
  */
18952
18773
  class OTPInputCustomMessagesComponent extends OTPInputMessages {
18953
18774
  service;
@@ -18982,7 +18803,18 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
18982
18803
  }], ctorParameters: function () { return [{ type: i1.LocalizationService }]; } });
18983
18804
 
18984
18805
  /**
18985
- * Utility array that contains all `TextBox` related components and directives
18806
+ * Use the `KENDO_TEXTBOX` utility array to add all TextBox-related components and directives to a standalone Angular component.
18807
+ *
18808
+ * @example
18809
+ * ```typescript
18810
+ * import { KENDO_TEXTBOX } from '@progress/kendo-angular-inputs';
18811
+ * @Component({
18812
+ * standalone: true,
18813
+ * imports: [KENDO_TEXTBOX],
18814
+ * template: `<kendo-textbox></kendo-textbox>`
18815
+ * })
18816
+ * export class MyComponent {}
18817
+ * ```
18986
18818
  */
18987
18819
  const KENDO_TEXTBOX = [
18988
18820
  TextBoxDirective,
@@ -18996,7 +18828,18 @@ const KENDO_TEXTBOX = [
18996
18828
  SeparatorComponent
18997
18829
  ];
18998
18830
  /**
18999
- * Utility array that contains all `NumericTextBox` related components and directives
18831
+ * Use the `KENDO_NUMERICTEXTBOX` utility array to add all NumericTextBox-related components and directives to a standalone Angular component.
18832
+ *
18833
+ * @example
18834
+ * ```typescript
18835
+ * import { KENDO_NUMERICTEXTBOX } from '@progress/kendo-angular-inputs';
18836
+ * @Component({
18837
+ * standalone: true,
18838
+ * imports: [KENDO_NUMERICTEXTBOX],
18839
+ * template: `<kendo-numerictextbox></kendo-numerictextbox>`
18840
+ * })
18841
+ * export class MyComponent {}
18842
+ * ```
19000
18843
  */
19001
18844
  const KENDO_NUMERICTEXTBOX = [
19002
18845
  NumericTextBoxComponent,
@@ -19006,7 +18849,18 @@ const KENDO_NUMERICTEXTBOX = [
19006
18849
  SeparatorComponent
19007
18850
  ];
19008
18851
  /**
19009
- * Utility array that contains all `MaskedTextBox` related components and directives
18852
+ * Use the `KENDO_MASKEDTEXTBOX` utility array to add all MaskedTextBox-related components and directives to a standalone Angular component.
18853
+ *
18854
+ * @example
18855
+ * ```typescript
18856
+ * import { KENDO_MASKEDTEXTBOX } from '@progress/kendo-angular-inputs';
18857
+ * @Component({
18858
+ * standalone: true,
18859
+ * imports: [KENDO_MASKEDTEXTBOX],
18860
+ * template: `<kendo-maskedtextbox></kendo-maskedtextbox>`
18861
+ * })
18862
+ * export class MyComponent {}
18863
+ * ```
19010
18864
  */
19011
18865
  const KENDO_MASKEDTEXTBOX = [
19012
18866
  MaskedTextBoxComponent,
@@ -19015,14 +18869,36 @@ const KENDO_MASKEDTEXTBOX = [
19015
18869
  SeparatorComponent
19016
18870
  ];
19017
18871
  /**
19018
- * Utility array that contains all `OTP` related components and directives
18872
+ * Use the `KENDO_OTPINPUT` utility array to add all OTPInput-related components and directives to a standalone Angular component.
18873
+ *
18874
+ * @example
18875
+ * ```typescript
18876
+ * import { KENDO_OTPINPUT } from '@progress/kendo-angular-inputs';
18877
+ * @Component({
18878
+ * standalone: true,
18879
+ * imports: [KENDO_OTPINPUT],
18880
+ * template: `<kendo-otpinput></kendo-otpinput>`
18881
+ * })
18882
+ * export class MyComponent {}
18883
+ * ```
19019
18884
  */
19020
18885
  const KENDO_OTPINPUT = [
19021
18886
  OTPInputComponent,
19022
18887
  OTPInputCustomMessagesComponent
19023
18888
  ];
19024
18889
  /**
19025
- * Utility array that contains all `TextArea` related components and directives
18890
+ * Use the `KENDO_TEXTAREA` utility array to add all TextArea-related components and directives to a standalone Angular component.
18891
+ *
18892
+ * @example
18893
+ * ```typescript
18894
+ * import { KENDO_TEXTAREA } from '@progress/kendo-angular-inputs';
18895
+ * @Component({
18896
+ * standalone: true,
18897
+ * imports: [KENDO_TEXTAREA],
18898
+ * template: `<kendo-textarea></kendo-textarea>`
18899
+ * })
18900
+ * export class MyComponent {}
18901
+ * ```
19026
18902
  */
19027
18903
  const KENDO_TEXTAREA = [
19028
18904
  TextAreaComponent,
@@ -19032,28 +18908,72 @@ const KENDO_TEXTAREA = [
19032
18908
  SeparatorComponent
19033
18909
  ];
19034
18910
  /**
19035
- * Utility array that contains all `CheckBox` related components and directives
18911
+ * Use the `KENDO_CHECKBOX` utility array to add all CheckBox-related components and directives to a standalone Angular component.
18912
+ *
18913
+ * @example
18914
+ * ```typescript
18915
+ * import { KENDO_CHECKBOX } from '@progress/kendo-angular-inputs';
18916
+ * @Component({
18917
+ * standalone: true,
18918
+ * imports: [KENDO_CHECKBOX],
18919
+ * template: `<kendo-checkbox></kendo-checkbox>`
18920
+ * })
18921
+ * export class MyComponent {}
18922
+ * ```
19036
18923
  */
19037
18924
  const KENDO_CHECKBOX = [
19038
18925
  CheckBoxComponent,
19039
18926
  CheckBoxDirective
19040
18927
  ];
19041
18928
  /**
19042
- * Utility array that contains all `RadioButton` related components and directives
18929
+ * Use the `KENDO_RADIOBUTTON` utility array to add all RadioButton-related components and directives to a standalone Angular component.
18930
+ *
18931
+ * @example
18932
+ * ```typescript
18933
+ * import { KENDO_RADIOBUTTON } from '@progress/kendo-angular-inputs';
18934
+ * @Component({
18935
+ * standalone: true,
18936
+ * imports: [KENDO_RADIOBUTTON],
18937
+ * template: `<kendo-radiobutton></kendo-radiobutton>`
18938
+ * })
18939
+ * export class MyComponent {}
18940
+ * ```
19043
18941
  */
19044
18942
  const KENDO_RADIOBUTTON = [
19045
18943
  RadioButtonComponent,
19046
18944
  RadioButtonDirective
19047
18945
  ];
19048
18946
  /**
19049
- * Utility array that contains all `Switch` related components and directives
18947
+ * Use the `KENDO_SWITCH` utility array to add all Switch-related components and directives to a standalone Angular component.
18948
+ *
18949
+ * @example
18950
+ * ```typescript
18951
+ * import { KENDO_SWITCH } from '@progress/kendo-angular-inputs';
18952
+ * @Component({
18953
+ * standalone: true,
18954
+ * imports: [KENDO_SWITCH],
18955
+ * template: `<kendo-switch></kendo-switch>`
18956
+ * })
18957
+ * export class MyComponent {}
18958
+ * ```
19050
18959
  */
19051
18960
  const KENDO_SWITCH = [
19052
18961
  SwitchComponent,
19053
18962
  SwitchCustomMessagesComponent
19054
18963
  ];
19055
18964
  /**
19056
- * Utility array that contains all `FormField` related components and directives
18965
+ * Use the `KENDO_FORMFIELD` utility array to add all FormField-related components and directives to a standalone Angular component.
18966
+ *
18967
+ * @example
18968
+ * ```typescript
18969
+ * import { KENDO_FORMFIELD } from '@progress/kendo-angular-inputs';
18970
+ * @Component({
18971
+ * standalone: true,
18972
+ * imports: [KENDO_FORMFIELD],
18973
+ * template: `<kendo-formfield></kendo-formfield>`
18974
+ * })
18975
+ * export class MyComponent {}
18976
+ * ```
19057
18977
  */
19058
18978
  const KENDO_FORMFIELD = [
19059
18979
  FormFieldComponent,
@@ -19061,7 +18981,18 @@ const KENDO_FORMFIELD = [
19061
18981
  ErrorComponent
19062
18982
  ];
19063
18983
  /**
19064
- * Utility array that contains all `Slider` related components and directives
18984
+ * Use the `KENDO_SLIDER` utility array to add all Slider-related components and directives to a standalone Angular component.
18985
+ *
18986
+ * @example
18987
+ * ```typescript
18988
+ * import { KENDO_SLIDER } from '@progress/kendo-angular-inputs';
18989
+ * @Component({
18990
+ * standalone: true,
18991
+ * imports: [KENDO_SLIDER],
18992
+ * template: `<kendo-slider></kendo-slider>`
18993
+ * })
18994
+ * export class MyComponent {}
18995
+ * ```
19065
18996
  */
19066
18997
  const KENDO_SLIDER = [
19067
18998
  SliderComponent,
@@ -19069,7 +19000,18 @@ const KENDO_SLIDER = [
19069
19000
  LabelTemplateDirective,
19070
19001
  ];
19071
19002
  /**
19072
- * Utility array that contains all `RangeSlider` related components and directives
19003
+ * Use the `KENDO_RANGESLIDER` utility array to add all RangeSlider-related components and directives to a standalone Angular component.
19004
+ *
19005
+ * @example
19006
+ * ```typescript
19007
+ * import { KENDO_RANGESLIDER } from '@progress/kendo-angular-inputs';
19008
+ * @Component({
19009
+ * standalone: true,
19010
+ * imports: [KENDO_RANGESLIDER],
19011
+ * template: `<kendo-rangeslider></kendo-rangeslider>`
19012
+ * })
19013
+ * export class MyComponent {}
19014
+ * ```
19073
19015
  */
19074
19016
  const KENDO_RANGESLIDER = [
19075
19017
  RangeSliderComponent,
@@ -19077,7 +19019,18 @@ const KENDO_RANGESLIDER = [
19077
19019
  LabelTemplateDirective
19078
19020
  ];
19079
19021
  /**
19080
- * Utility array that contains all `Rating` related components and directives
19022
+ * Use the `KENDO_RATING` utility array to add all Rating-related components and directives to a standalone Angular component.
19023
+ *
19024
+ * @example
19025
+ * ```typescript
19026
+ * import { KENDO_RATING } from '@progress/kendo-angular-inputs';
19027
+ * @Component({
19028
+ * standalone: true,
19029
+ * imports: [KENDO_RATING],
19030
+ * template: `<kendo-rating></kendo-rating>`
19031
+ * })
19032
+ * export class MyComponent {}
19033
+ * ```
19081
19034
  */
19082
19035
  const KENDO_RATING = [
19083
19036
  RatingComponent,
@@ -19086,42 +19039,108 @@ const KENDO_RATING = [
19086
19039
  RatingSelectedItemTemplateDirective
19087
19040
  ];
19088
19041
  /**
19089
- * Utility array that contains all `Signature` related components and directives
19042
+ * Use the `KENDO_SIGNATURE` utility array to add all Signature-related components and directives to a standalone Angular component.
19043
+ *
19044
+ * @example
19045
+ * ```typescript
19046
+ * import { KENDO_SIGNATURE } from '@progress/kendo-angular-inputs';
19047
+ * @Component({
19048
+ * standalone: true,
19049
+ * imports: [KENDO_SIGNATURE],
19050
+ * template: `<kendo-signature></kendo-signature>`
19051
+ * })
19052
+ * export class MyComponent {}
19053
+ * ```
19090
19054
  */
19091
19055
  const KENDO_SIGNATURE = [
19092
19056
  SignatureComponent,
19093
19057
  SignatureCustomMessagesComponent
19094
19058
  ];
19095
19059
  /**
19096
- * Utility array that contains all `ColorPicker` related components and directives
19060
+ * Use the `KENDO_COLORPICKER` utility array to add all ColorPicker-related components and directives to a standalone Angular component.
19061
+ *
19062
+ * @example
19063
+ * ```typescript
19064
+ * import { KENDO_COLORPICKER } from '@progress/kendo-angular-inputs';
19065
+ * @Component({
19066
+ * standalone: true,
19067
+ * imports: [KENDO_COLORPICKER],
19068
+ * template: `<kendo-colorpicker></kendo-colorpicker>`
19069
+ * })
19070
+ * export class MyComponent {}
19071
+ * ```
19097
19072
  */
19098
19073
  const KENDO_COLORPICKER = [
19099
19074
  ColorPickerComponent,
19100
19075
  ColorPickerCustomMessagesComponent
19101
19076
  ];
19102
19077
  /**
19103
- * Utility array that contains all `FlatColorPicker` related components and directives
19078
+ * Use the `KENDO_FLATCOLORPICKER` utility array to add all FlatColorPicker-related components and directives to a standalone Angular component.
19079
+ *
19080
+ * @example
19081
+ * ```typescript
19082
+ * import { KENDO_FLATCOLORPICKER } from '@progress/kendo-angular-inputs';
19083
+ * @Component({
19084
+ * standalone: true,
19085
+ * imports: [KENDO_FLATCOLORPICKER],
19086
+ * template: `<kendo-flatcolorpicker></kendo-flatcolorpicker>`
19087
+ * })
19088
+ * export class MyComponent {}
19089
+ * ```
19104
19090
  */
19105
19091
  const KENDO_FLATCOLORPICKER = [
19106
19092
  FlatColorPickerComponent,
19107
19093
  ColorPickerCustomMessagesComponent
19108
19094
  ];
19109
19095
  /**
19110
- * Utility array that contains all `ColorPallete` related components and directives
19096
+ * Use the `KENDO_COLORPALETTE` utility array to add all ColorPalette-related components and directives to a standalone Angular component.
19097
+ *
19098
+ * @example
19099
+ * ```typescript
19100
+ * import { KENDO_COLORPALETTE } from '@progress/kendo-angular-inputs';
19101
+ * @Component({
19102
+ * standalone: true,
19103
+ * imports: [KENDO_COLORPALETTE],
19104
+ * template: `<kendo-colorpalette></kendo-colorpalette>`
19105
+ * })
19106
+ * export class MyComponent {}
19107
+ * ```
19111
19108
  */
19112
19109
  const KENDO_COLORPALETTE = [
19113
19110
  ColorPaletteComponent,
19114
19111
  ColorPickerCustomMessagesComponent
19115
19112
  ];
19116
19113
  /**
19117
- * Utility array that contains all `ColorGradient` related components and directives
19114
+ * Use the `KENDO_COLORGRADIENT` utility array to add all ColorGradient-related components and directives to a standalone Angular component.
19115
+ *
19116
+ * @example
19117
+ * ```typescript
19118
+ * import { KENDO_COLORGRADIENT } from '@progress/kendo-angular-inputs';
19119
+ * @Component({
19120
+ * standalone: true,
19121
+ * imports: [KENDO_COLORGRADIENT],
19122
+ * template: `<kendo-colorgradient></kendo-colorgradient>`
19123
+ * })
19124
+ * export class MyComponent {}
19125
+ * ```
19118
19126
  */
19119
19127
  const KENDO_COLORGRADIENT = [
19120
19128
  ColorGradientComponent,
19121
19129
  ColorPickerCustomMessagesComponent
19122
19130
  ];
19123
19131
  /**
19124
- * Utility array that contains all `@progress/kendo-angular-inputs` related components and directives
19132
+ * Use the `KENDO_INPUTS` utility array to add all `@progress/kendo-angular-inputs`-related components and directives to a standalone Angular component.
19133
+ *
19134
+ * @example
19135
+ * ```typescript
19136
+ * import { KENDO_INPUTS } from '@progress/kendo-angular-inputs';
19137
+ * @Component({
19138
+ * standalone: true,
19139
+ * imports: [KENDO_INPUTS],
19140
+ * template: `<kendo-textbox></kendo-textbox>`
19141
+ * })
19142
+ * export class MyComponent {}
19143
+ * ```
19125
19144
  */
19126
19145
  const KENDO_INPUTS = [
19127
19146
  ...KENDO_TEXTBOX,
@@ -19145,35 +19164,23 @@ const KENDO_INPUTS = [
19145
19164
 
19146
19165
  //IMPORTANT: NgModule export kept for backwards compatibility
19147
19166
  /**
19148
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19149
- * definition for the Inputs components.
19167
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Inputs components.
19150
19168
  *
19151
- * @example
19169
+ * Use this module to import all Kendo UI for Angular Inputs components at once in your NgModule-based Angular application.
19152
19170
  *
19153
- * ```ts-no-run
19154
- * // Import the Inputs module
19171
+ * @example
19172
+ * ```typescript
19155
19173
  * import { InputsModule } from '@progress/kendo-angular-inputs';
19156
- *
19157
- * // The browser platform with a compiler
19158
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19159
- * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
19160
- *
19161
19174
  * import { NgModule } from '@angular/core';
19162
- *
19163
- * // Import the app component
19175
+ * import { BrowserModule } from '@angular/platform-browser';
19164
19176
  * import { AppComponent } from './app.component';
19165
19177
  *
19166
- * // Define the app module
19167
- * _@NgModule({
19168
- * declarations: [AppComponent], // declare app component
19169
- * imports: [BrowserModule, BrowserAnimationsModule, InputsModule], // import Inputs module
19170
- * bootstrap: [AppComponent]
19178
+ * @NgModule({
19179
+ * declarations: [AppComponent],
19180
+ * imports: [BrowserModule, InputsModule],
19181
+ * bootstrap: [AppComponent]
19171
19182
  * })
19172
19183
  * export class AppModule {}
19173
- *
19174
- * // Compile and launch the module
19175
- * platformBrowserDynamic().bootstrapModule(AppModule);
19176
- *
19177
19184
  * ```
19178
19185
  */
19179
19186
  class InputsModule {
@@ -19192,35 +19199,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19192
19199
 
19193
19200
  //IMPORTANT: NgModule export kept for backwards compatibility
19194
19201
  /**
19195
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19196
- * definition for the Slider component.
19202
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Slider component.
19203
+ *
19204
+ * Use this module to add the Slider component to your NgModule-based Angular application.
19197
19205
  *
19198
19206
  * @example
19199
19207
  *
19200
- * ```ts-no-run
19201
- * // Import the Inputs module
19208
+ * ```typescript
19202
19209
  * import { SliderModule } from '@progress/kendo-angular-inputs';
19203
- *
19204
- * // The browser platform with a compiler
19205
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19206
19210
  * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
19207
- *
19208
19211
  * import { NgModule } from '@angular/core';
19209
- *
19210
- * // Import the app component
19211
19212
  * import { AppComponent } from './app.component';
19212
19213
  *
19213
- * // Define the app module
19214
- * _@NgModule({
19215
- * declarations: [AppComponent], // declare app component
19216
- * imports: [BrowserModule, BrowserAnimationsModule, SliderModule], // import Slider module
19214
+ * @NgModule({
19215
+ * declarations: [AppComponent],
19216
+ * imports: [BrowserModule, BrowserAnimationsModule, SliderModule],
19217
19217
  * bootstrap: [AppComponent]
19218
19218
  * })
19219
19219
  * export class AppModule {}
19220
- *
19221
- * // Compile and launch the module
19222
- * platformBrowserDynamic().bootstrapModule(AppModule);
19223
- *
19224
19220
  * ```
19225
19221
  */
19226
19222
  class SliderModule {
@@ -19239,35 +19235,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19239
19235
 
19240
19236
  //IMPORTANT: NgModule export kept for backwards compatibility
19241
19237
  /**
19242
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19243
- * definition for the RangeSlider component.
19238
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the RangeSlider component.
19239
+ *
19240
+ * Use this module to add the RangeSlider component to your NgModule-based Angular application.
19244
19241
  *
19245
19242
  * @example
19246
19243
  *
19247
- * ```ts-no-run
19248
- * // Import the Inputs module
19244
+ * ```typescript
19249
19245
  * import { RangeSliderModule } from '@progress/kendo-angular-inputs';
19250
- *
19251
- * // The browser platform with a compiler
19252
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19253
19246
  * import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
19254
- *
19255
19247
  * import { NgModule } from '@angular/core';
19256
- *
19257
- * // Import the app component
19258
19248
  * import { AppComponent } from './app.component';
19259
19249
  *
19260
- * // Define the app module
19261
- * _@NgModule({
19262
- * declarations: [AppComponent], // declare app component
19263
- * imports: [BrowserModule, BrowserAnimationsModule, RangeSliderModule], // import RangeSlider module
19250
+ * @NgModule({
19251
+ * declarations: [AppComponent],
19252
+ * imports: [BrowserModule, BrowserAnimationsModule, RangeSliderModule],
19264
19253
  * bootstrap: [AppComponent]
19265
19254
  * })
19266
19255
  * export class AppModule {}
19267
- *
19268
- * // Compile and launch the module
19269
- * platformBrowserDynamic().bootstrapModule(AppModule);
19270
- *
19271
19256
  * ```
19272
19257
  */
19273
19258
  class RangeSliderModule {
@@ -19286,34 +19271,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19286
19271
 
19287
19272
  //IMPORTANT: NgModule export kept for backwards compatibility
19288
19273
  /**
19289
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19290
- * definition for the Switch component.
19274
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Switch component.
19275
+ *
19276
+ * Use this module to add the Switch component to your NgModule-based Angular application.
19291
19277
  *
19292
19278
  * @example
19293
19279
  *
19294
- * ```ts-no-run
19295
- * // Import the Switch module
19280
+ * ```typescript
19296
19281
  * import { SwitchModule } from '@progress/kendo-angular-inputs';
19297
- *
19298
- * // The browser platform with a compiler
19299
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19300
- *
19301
19282
  * import { NgModule } from '@angular/core';
19302
- *
19303
- * // Import the app component
19304
19283
  * import { AppComponent } from './app.component';
19305
19284
  *
19306
- * // Define the app module
19307
- * _@NgModule({
19308
- * declarations: [AppComponent], // declare app component
19309
- * imports: [BrowserModule, SwitchModule], // import Switch module
19285
+ * @NgModule({
19286
+ * declarations: [AppComponent],
19287
+ * imports: [BrowserModule, SwitchModule],
19310
19288
  * bootstrap: [AppComponent]
19311
19289
  * })
19312
19290
  * export class AppModule {}
19313
- *
19314
- * // Compile and launch the module
19315
- * platformBrowserDynamic().bootstrapModule(AppModule);
19316
- *
19317
19291
  * ```
19318
19292
  */
19319
19293
  class SwitchModule {
@@ -19332,34 +19306,58 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19332
19306
 
19333
19307
  //IMPORTANT: NgModule export kept for backwards compatibility
19334
19308
  /**
19335
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19336
- * definition for the NumericTextBox component.
19309
+ * Defines the [NgModule](link:site.data.urls.angular['ngmoduleapi']) for the OTP Input component.
19310
+ *
19311
+ * Use this module to add the OTP Input component to your NgModule-based Angular application.
19337
19312
  *
19338
19313
  * @example
19314
+ * ```typescript
19315
+ * import { OTPInputModule } from '@progress/kendo-angular-inputs';
19316
+ * import { NgModule } from '@angular/core';
19317
+ * import { BrowserModule } from '@angular/platform-browser';
19318
+ * import { AppComponent } from './app.component';
19339
19319
  *
19340
- * ```ts-no-run
19341
- * // Import the NumericTextBox module
19342
- * import { NumericTextBoxModule } from '@progress/kendo-angular-inputs';
19320
+ * @NgModule({
19321
+ * declarations: [AppComponent],
19322
+ * imports: [BrowserModule, OTPInputModule],
19323
+ * bootstrap: [AppComponent]
19324
+ * })
19325
+ * export class AppModule {}
19326
+ * ```
19327
+ */
19328
+ class OTPInputModule {
19329
+ static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: OTPInputModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
19330
+ static ɵmod = i0.ɵɵngDeclareNgModule({ minVersion: "14.0.0", version: "16.2.12", ngImport: i0, type: OTPInputModule, imports: [OTPInputComponent, OTPInputCustomMessagesComponent], exports: [OTPInputComponent, OTPInputCustomMessagesComponent] });
19331
+ static ɵinj = i0.ɵɵngDeclareInjector({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: OTPInputModule, providers: [IconsService], imports: [OTPInputComponent] });
19332
+ }
19333
+ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: OTPInputModule, decorators: [{
19334
+ type: NgModule,
19335
+ args: [{
19336
+ imports: [...KENDO_OTPINPUT],
19337
+ exports: [...KENDO_OTPINPUT],
19338
+ providers: [IconsService]
19339
+ }]
19340
+ }] });
19341
+
19342
+ //IMPORTANT: NgModule export kept for backwards compatibility
19343
+ /**
19344
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the NumericTextBox component.
19343
19345
  *
19344
- * // The browser platform with a compiler
19345
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19346
+ * Use this module to add the NumericTextBox component to your NgModule-based Angular application.
19346
19347
  *
19348
+ * @example
19349
+ * ```typescript
19350
+ * import { NumericTextBoxModule } from '@progress/kendo-angular-inputs';
19347
19351
  * import { NgModule } from '@angular/core';
19348
- *
19349
- * // Import the app component
19352
+ * import { BrowserModule } from '@angular/platform-browser';
19350
19353
  * import { AppComponent } from './app.component';
19351
19354
  *
19352
- * // Define the app module
19353
- * _@NgModule({
19354
- * declarations: [AppComponent], // declare app component
19355
- * imports: [BrowserModule, NumericTextBoxModule], // import NumericTextBox module
19356
- * bootstrap: [AppComponent]
19355
+ * @NgModule({
19356
+ * declarations: [AppComponent],
19357
+ * imports: [BrowserModule, NumericTextBoxModule],
19358
+ * bootstrap: [AppComponent]
19357
19359
  * })
19358
19360
  * export class AppModule {}
19359
- *
19360
- * // Compile and launch the module
19361
- * platformBrowserDynamic().bootstrapModule(AppModule);
19362
- *
19363
19361
  * ```
19364
19362
  */
19365
19363
  class NumericTextBoxModule {
@@ -19378,34 +19376,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19378
19376
 
19379
19377
  //IMPORTANT: NgModule export kept for backwards compatibility
19380
19378
  /**
19381
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19382
- * definition for the MaskedTextBox component.
19379
+ * Defines the [NgModule](link:site.data.urls.angular['ngmoduleapi']) for the MaskedTextBox component.
19383
19380
  *
19384
- * @example
19381
+ * Use this module to add the MaskedTextBox component to your NgModule-based Angular application.
19385
19382
  *
19386
- * ```ts-no-run
19387
- * // Import the MaskedTextBox module
19383
+ * @example
19384
+ * ```typescript
19388
19385
  * import { MaskedTextBoxModule } from '@progress/kendo-angular-inputs';
19389
- *
19390
- * // The browser platform with a compiler
19391
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19392
- *
19393
19386
  * import { NgModule } from '@angular/core';
19394
- *
19395
- * // Import the app component
19387
+ * import { BrowserModule } from '@angular/platform-browser';
19396
19388
  * import { AppComponent } from './app.component';
19397
19389
  *
19398
- * // Define the app module
19399
- * _@NgModule({
19400
- * declarations: [AppComponent], // declare app component
19401
- * imports: [BrowserModule, MaskedTextBoxModule], // import MaskedTextBox module
19402
- * bootstrap: [AppComponent]
19390
+ * @NgModule({
19391
+ * declarations: [AppComponent],
19392
+ * imports: [BrowserModule, MaskedTextBoxModule],
19393
+ * bootstrap: [AppComponent]
19403
19394
  * })
19404
19395
  * export class AppModule {}
19405
- *
19406
- * // Compile and launch the module
19407
- * platformBrowserDynamic().bootstrapModule(AppModule);
19408
- *
19409
19396
  * ```
19410
19397
  */
19411
19398
  class MaskedTextBoxModule {
@@ -19423,34 +19410,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19423
19410
 
19424
19411
  //IMPORTANT: NgModule export kept for backwards compatibility
19425
19412
  /**
19426
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19427
- * definition for the TextBox directive.
19413
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the TextBox directive.
19414
+ *
19415
+ * Use this module to add the TextBox directive to your NgModule-based Angular application.
19428
19416
  *
19429
19417
  * @example
19430
19418
  *
19431
- * ```ts-no-run
19432
- * // Import the TextBox module
19419
+ * ```typescript
19433
19420
  * import { TextBoxModule } from '@progress/kendo-angular-inputs';
19434
- *
19435
- * // The browser platform with a compiler
19436
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19437
- *
19438
19421
  * import { NgModule } from '@angular/core';
19439
- *
19440
- * // Import the app component
19441
19422
  * import { AppComponent } from './app.component';
19442
19423
  *
19443
- * // Define the app module
19444
- * _@NgModule({
19445
- * declarations: [AppComponent], // declare app component
19446
- * imports: [BrowserModule, TextBoxModule], // import TextBox module
19424
+ * @NgModule({
19425
+ * declarations: [AppComponent],
19426
+ * imports: [BrowserModule, TextBoxModule],
19447
19427
  * bootstrap: [AppComponent]
19448
19428
  * })
19449
19429
  * export class AppModule {}
19450
- *
19451
- * // Compile and launch the module
19452
- * platformBrowserDynamic().bootstrapModule(AppModule);
19453
- *
19454
19430
  * ```
19455
19431
  */
19456
19432
  class TextBoxModule {
@@ -19469,34 +19445,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19469
19445
 
19470
19446
  //IMPORTANT: NgModule export kept for backwards compatibility
19471
19447
  /**
19472
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19473
- * definition for the TextArea component.
19448
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the TextArea component.
19449
+ *
19450
+ * Use this module to add the TextArea component to your NgModule-based Angular application.
19474
19451
  *
19475
19452
  * @example
19476
19453
  *
19477
- * ```ts-no-run
19478
- * // Import the TextArea module
19454
+ * ```typescript
19479
19455
  * import { TextAreaModule } from '@progress/kendo-angular-inputs';
19480
- *
19481
- * // The browser platform with a compiler
19482
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19483
- *
19484
19456
  * import { NgModule } from '@angular/core';
19485
- *
19486
- * // Import the app component
19487
19457
  * import { AppComponent } from './app.component';
19488
19458
  *
19489
- * // Define the app module
19490
- * _@NgModule({
19491
- * declarations: [AppComponent], // declare app component
19492
- * imports: [BrowserModule, TextAreaModule], // import TextArea module
19459
+ * @NgModule({
19460
+ * declarations: [AppComponent],
19461
+ * imports: [BrowserModule, TextAreaModule],
19493
19462
  * bootstrap: [AppComponent]
19494
19463
  * })
19495
19464
  * export class AppModule {}
19496
- *
19497
- * // Compile and launch the module
19498
- * platformBrowserDynamic().bootstrapModule(AppModule);
19499
- *
19500
19465
  * ```
19501
19466
  */
19502
19467
  class TextAreaModule {
@@ -19514,34 +19479,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19514
19479
 
19515
19480
  //IMPORTANT: NgModule export kept for backwards compatibility
19516
19481
  /**
19517
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19518
- * definition for the CheckBox directive and CheckBoxComponent.
19482
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the CheckBox directive and CheckBoxComponent.
19519
19483
  *
19520
- * @example
19484
+ * Use this module to add CheckBox features to your NgModule-based Angular application.
19521
19485
  *
19522
- * ```ts-no-run
19523
- * // Import the CheckBox module
19486
+ * @example
19487
+ * ```typescript
19524
19488
  * import { CheckBoxModule } from '@progress/kendo-angular-inputs';
19525
- *
19526
- * // The browser platform with a compiler
19527
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19528
- *
19529
19489
  * import { NgModule } from '@angular/core';
19530
- *
19531
- * // Import the app component
19490
+ * import { BrowserModule } from '@angular/platform-browser';
19532
19491
  * import { AppComponent } from './app.component';
19533
19492
  *
19534
- * // Define the app module
19535
- * _@NgModule({
19536
- * declarations: [AppComponent], // declare app component
19537
- * imports: [BrowserModule, CheckBoxModule], // import CheckBox module
19538
- * bootstrap: [AppComponent]
19493
+ * @NgModule({
19494
+ * declarations: [AppComponent],
19495
+ * imports: [BrowserModule, CheckBoxModule],
19496
+ * bootstrap: [AppComponent]
19539
19497
  * })
19540
19498
  * export class AppModule {}
19541
- *
19542
- * // Compile and launch the module
19543
- * platformBrowserDynamic().bootstrapModule(AppModule);
19544
- *
19545
19499
  * ```
19546
19500
  */
19547
19501
  class CheckBoxModule {
@@ -19559,34 +19513,24 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19559
19513
 
19560
19514
  //IMPORTANT: NgModule export kept for backwards compatibility
19561
19515
  /**
19562
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19563
- * definition for the RadioButton directive and RadioButtonComponent.
19516
+ * Defines the [NgModule](link:site.data.urls.angular['ngmoduleapi']) for the RadioButton directive and RadioButton component.
19517
+ *
19518
+ * Use this module to add the RadioButton directive and component to your NgModule-based Angular application.
19564
19519
  *
19565
19520
  * @example
19566
19521
  *
19567
- * ```ts-no-run
19568
- * // Import the RadioButton module
19522
+ * ```typescript
19569
19523
  * import { RadioButtonModule } from '@progress/kendo-angular-inputs';
19570
- *
19571
- * // The browser platform with a compiler
19572
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19573
- *
19574
19524
  * import { NgModule } from '@angular/core';
19575
- *
19576
- * // Import the app component
19525
+ * import { BrowserModule } from '@angular/platform-browser';
19577
19526
  * import { AppComponent } from './app.component';
19578
19527
  *
19579
- * // Define the app module
19580
- * _@NgModule({
19581
- * declarations: [AppComponent], // declare app component
19582
- * imports: [BrowserModule, RadioButtonModule], // import RadioButton module
19528
+ * @NgModule({
19529
+ * declarations: [AppComponent],
19530
+ * imports: [BrowserModule, RadioButtonModule],
19583
19531
  * bootstrap: [AppComponent]
19584
19532
  * })
19585
19533
  * export class AppModule {}
19586
- *
19587
- * // Compile and launch the module
19588
- * platformBrowserDynamic().bootstrapModule(AppModule);
19589
- *
19590
19534
  * ```
19591
19535
  */
19592
19536
  class RadioButtonModule {
@@ -19603,7 +19547,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19603
19547
  }] });
19604
19548
 
19605
19549
  /**
19606
- * Arguments for the `blur` event of the Switch component.
19550
+ * Provides arguments for the `blur` event of the Switch component.
19607
19551
  */
19608
19552
  class SwitchBlurEvent {
19609
19553
  /**
@@ -19613,7 +19557,7 @@ class SwitchBlurEvent {
19613
19557
  }
19614
19558
 
19615
19559
  /**
19616
- * Arguments for the `focus` event of the Switch component.
19560
+ * Provides arguments for the `focus` event of the Switch component.
19617
19561
  */
19618
19562
  class SwitchFocusEvent {
19619
19563
  /**
@@ -19624,8 +19568,24 @@ class SwitchFocusEvent {
19624
19568
 
19625
19569
  //IMPORTANT: NgModule export kept for backwards compatibility
19626
19570
  /**
19627
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19628
- * definition for the ColorPicker.
19571
+ * Defines the [NgModule](link:site.data.urls.angular['ngmoduleapi']) for the ColorPicker.
19572
+ *
19573
+ * Use this module to add ColorPicker features to your NgModule-based Angular application.
19574
+ *
19575
+ * @example
19576
+ * ```typescript
19577
+ * import { ColorPickerModule } from '@progress/kendo-angular-inputs';
19578
+ * import { NgModule } from '@angular/core';
19579
+ * import { BrowserModule } from '@angular/platform-browser';
19580
+ * import { AppComponent } from './app.component';
19581
+ *
19582
+ * @NgModule({
19583
+ * declarations: [AppComponent],
19584
+ * imports: [BrowserModule, ColorPickerModule],
19585
+ * bootstrap: [AppComponent]
19586
+ * })
19587
+ * export class AppModule {}
19588
+ * ```
19629
19589
  */
19630
19590
  class ColorPickerModule {
19631
19591
  static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: ColorPickerModule, deps: [], target: i0.ɵɵFactoryTarget.NgModule });
@@ -19643,34 +19603,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19643
19603
 
19644
19604
  //IMPORTANT: NgModule export kept for backwards compatibility
19645
19605
  /**
19646
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19647
- * definition for the FormField, Error and Hint components.
19606
+ * Defines the [NgModule](link:site.data.urls.angular['ngmoduleapi']) for the FormField, Error, and Hint components.
19648
19607
  *
19649
- * @example
19608
+ * Use this module to add FormField, Error, and Hint features to your NgModule-based Angular application.
19650
19609
  *
19651
- * ```ts-no-run
19652
- * // Import the FormField module
19610
+ * @example
19611
+ * ```typescript
19653
19612
  * import { FormFieldModule } from '@progress/kendo-angular-inputs';
19654
- *
19655
- * // The browser platform with a compiler
19656
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19657
- *
19658
19613
  * import { NgModule } from '@angular/core';
19659
- *
19660
- * // Import the app component
19614
+ * import { BrowserModule } from '@angular/platform-browser';
19661
19615
  * import { AppComponent } from './app.component';
19662
19616
  *
19663
- * // Define the app module
19664
- * _@NgModule({
19665
- * declarations: [AppComponent], // declare app component
19666
- * imports: [BrowserModule, FormFieldModule], // import FormField module
19667
- * bootstrap: [AppComponent]
19617
+ * @NgModule({
19618
+ * declarations: [AppComponent],
19619
+ * imports: [BrowserModule, FormFieldModule],
19620
+ * bootstrap: [AppComponent]
19668
19621
  * })
19669
19622
  * export class AppModule {}
19670
- *
19671
- * // Compile and launch the module
19672
- * platformBrowserDynamic().bootstrapModule(AppModule);
19673
- *
19674
19623
  * ```
19675
19624
  */
19676
19625
  class FormFieldModule {
@@ -19688,34 +19637,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19688
19637
 
19689
19638
  //IMPORTANT: NgModule export kept for backwards compatibility
19690
19639
  /**
19691
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19692
- * definition for the Signature component.
19640
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Signature component.
19641
+ *
19642
+ * Use this module to add the Signature component to your NgModule-based Angular application.
19693
19643
  *
19694
19644
  * @example
19695
19645
  *
19696
- * ```ts-no-run
19697
- * // Import the Signature module
19646
+ * ```typescript
19698
19647
  * import { SignatureModule } from '@progress/kendo-angular-inputs';
19699
- *
19700
- * // The browser platform with a compiler
19701
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19702
- *
19703
19648
  * import { NgModule } from '@angular/core';
19704
- *
19705
- * // Import the app component
19706
19649
  * import { AppComponent } from './app.component';
19707
19650
  *
19708
- * // Define the app module
19709
- * _@NgModule({
19710
- * declarations: [AppComponent], // declare app component
19711
- * imports: [BrowserModule, SignatureModule], // import Signature module
19651
+ * @NgModule({
19652
+ * declarations: [AppComponent],
19653
+ * imports: [BrowserModule, SignatureModule],
19712
19654
  * bootstrap: [AppComponent]
19713
19655
  * })
19714
19656
  * export class AppModule {}
19715
- *
19716
- * // Compile and launch the module
19717
- * platformBrowserDynamic().bootstrapModule(AppModule);
19718
- *
19719
19657
  * ```
19720
19658
  */
19721
19659
  class SignatureModule {
@@ -19734,34 +19672,23 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19734
19672
 
19735
19673
  //IMPORTANT: NgModule export kept for backwards compatibility
19736
19674
  /**
19737
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
19738
- * definition for the Rating component.
19675
+ * Defines the [`NgModule`](link:site.data.urls.angular['ngmoduleapi']) for the Rating component.
19676
+ *
19677
+ * Use this module to add the Rating component to your NgModule-based Angular application.
19739
19678
  *
19740
19679
  * @example
19741
19680
  *
19742
- * ```ts-no-run
19743
- * // Import the Rating module
19681
+ * ```typescript
19744
19682
  * import { RatingModule } from '@progress/kendo-angular-inputs';
19745
- *
19746
- * // The browser platform with a compiler
19747
- * import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';
19748
- *
19749
19683
  * import { NgModule } from '@angular/core';
19750
- *
19751
- * // Import the app component
19752
19684
  * import { AppComponent } from './app.component';
19753
19685
  *
19754
- * // Define the app module
19755
- * _@NgModule({
19756
- * declarations: [AppComponent], // declare app component
19757
- * imports: [BrowserModule, RatingModule], // import Rating module
19686
+ * @NgModule({
19687
+ * declarations: [AppComponent],
19688
+ * imports: [BrowserModule, RatingModule],
19758
19689
  * bootstrap: [AppComponent]
19759
19690
  * })
19760
19691
  * export class AppModule {}
19761
- *
19762
- * // Compile and launch the module
19763
- * platformBrowserDynamic().bootstrapModule(AppModule);
19764
- *
19765
19692
  * ```
19766
19693
  */
19767
19694
  class RatingModule {
@@ -19782,5 +19709,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImpo
19782
19709
  * Generated bundle index. Do not edit.
19783
19710
  */
19784
19711
 
19785
- export { ActiveColorClickEvent, CheckBoxComponent, CheckBoxDirective, CheckBoxModule, ColorGradientComponent, ColorPaletteComponent, ColorPickerCancelEvent, ColorPickerCloseEvent, ColorPickerComponent, ColorPickerCustomMessagesComponent, ColorPickerModule, ColorPickerOpenEvent, ErrorComponent, FlatColorPickerComponent, FormFieldComponent, FormFieldModule, HintComponent, InputSeparatorComponent, InputsModule, KENDO_CHECKBOX, KENDO_COLORGRADIENT, KENDO_COLORPALETTE, KENDO_COLORPICKER, KENDO_FLATCOLORPICKER, KENDO_FORMFIELD, KENDO_INPUTS, KENDO_MASKEDTEXTBOX, KENDO_NUMERICTEXTBOX, KENDO_OTPINPUT, KENDO_RADIOBUTTON, KENDO_RANGESLIDER, KENDO_RATING, KENDO_SIGNATURE, KENDO_SLIDER, KENDO_SWITCH, KENDO_TEXTAREA, KENDO_TEXTBOX, LabelTemplateDirective, LocalizedColorPickerMessagesDirective, LocalizedNumericTextBoxMessagesDirective, LocalizedRangeSliderMessagesDirective, LocalizedSignatureMessagesDirective, LocalizedSliderMessagesDirective, LocalizedSwitchMessagesDirective, LocalizedTextBoxMessagesDirective, MaskedTextBoxComponent, MaskedTextBoxModule, MaskingService, NumericLabelDirective, NumericTextBoxComponent, NumericTextBoxCustomMessagesComponent, NumericTextBoxModule, OTPInputComponent, OTPInputCustomMessagesComponent, RadioButtonComponent, RadioButtonDirective, RadioButtonModule, RangeSliderComponent, RangeSliderCustomMessagesComponent, RangeSliderModule, RatingComponent, RatingHoveredItemTemplateDirective, RatingItemTemplateDirective, RatingModule, RatingSelectedItemTemplateDirective, SignatureCloseEvent, SignatureComponent, SignatureCustomMessagesComponent, SignatureMessages, SignatureModule, SignatureOpenEvent, SliderComponent, SliderCustomMessagesComponent, SliderModule, SliderTicksComponent, SwitchBlurEvent, SwitchComponent, SwitchCustomMessagesComponent, SwitchFocusEvent, SwitchModule, TextAreaComponent, TextAreaDirective, TextAreaModule, TextAreaPrefixComponent, TextAreaSuffixComponent, TextBoxComponent, TextBoxCustomMessagesComponent, TextBoxDirective, TextBoxModule, TextBoxPrefixTemplateDirective, TextBoxSuffixTemplateDirective };
19712
+ export { ActiveColorClickEvent, CheckBoxComponent, CheckBoxDirective, CheckBoxModule, ColorGradientComponent, ColorPaletteComponent, ColorPickerCancelEvent, ColorPickerCloseEvent, ColorPickerComponent, ColorPickerCustomMessagesComponent, ColorPickerModule, ColorPickerOpenEvent, ErrorComponent, FlatColorPickerComponent, FormFieldComponent, FormFieldModule, HintComponent, InputSeparatorComponent, InputsModule, KENDO_CHECKBOX, KENDO_COLORGRADIENT, KENDO_COLORPALETTE, KENDO_COLORPICKER, KENDO_FLATCOLORPICKER, KENDO_FORMFIELD, KENDO_INPUTS, KENDO_MASKEDTEXTBOX, KENDO_NUMERICTEXTBOX, KENDO_OTPINPUT, KENDO_RADIOBUTTON, KENDO_RANGESLIDER, KENDO_RATING, KENDO_SIGNATURE, KENDO_SLIDER, KENDO_SWITCH, KENDO_TEXTAREA, KENDO_TEXTBOX, LabelTemplateDirective, LocalizedColorPickerMessagesDirective, LocalizedNumericTextBoxMessagesDirective, LocalizedRangeSliderMessagesDirective, LocalizedSignatureMessagesDirective, LocalizedSliderMessagesDirective, LocalizedSwitchMessagesDirective, LocalizedTextBoxMessagesDirective, MaskedTextBoxComponent, MaskedTextBoxModule, MaskingService, NumericLabelDirective, NumericTextBoxComponent, NumericTextBoxCustomMessagesComponent, NumericTextBoxModule, OTPInputComponent, OTPInputCustomMessagesComponent, OTPInputModule, RadioButtonComponent, RadioButtonDirective, RadioButtonModule, RangeSliderComponent, RangeSliderCustomMessagesComponent, RangeSliderModule, RatingComponent, RatingHoveredItemTemplateDirective, RatingItemTemplateDirective, RatingModule, RatingSelectedItemTemplateDirective, SignatureCloseEvent, SignatureComponent, SignatureCustomMessagesComponent, SignatureMessages, SignatureModule, SignatureOpenEvent, SliderComponent, SliderCustomMessagesComponent, SliderModule, SliderTicksComponent, SwitchBlurEvent, SwitchComponent, SwitchCustomMessagesComponent, SwitchFocusEvent, SwitchModule, TextAreaComponent, TextAreaDirective, TextAreaModule, TextAreaPrefixComponent, TextAreaSuffixComponent, TextBoxComponent, TextBoxCustomMessagesComponent, TextBoxDirective, TextBoxModule, TextBoxPrefixTemplateDirective, TextBoxSuffixTemplateDirective };
19786
19713