@progress/kendo-angular-dateinputs 19.1.2-develop.3 → 19.1.2-develop.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-angular-dateinputs",
-  "version": "19.1.2-develop.3",
+  "version": "19.1.2-develop.5",
   "description": "Kendo UI for Angular Date Inputs Package - Everything you need to add date selection functionality to apps (DatePicker, TimePicker, DateInput, DateRangePicker, DateTimePicker, Calendar, and MultiViewCalendar).",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Progress",
@@ -79,7 +79,7 @@
     "package": {
       "productName": "Kendo UI for Angular",
       "productCode": "KENDOUIANGULAR",
-      "publishDate": 1750152543,
+      "publishDate": 1750430884,
       "licensingDocsUrl": "https://www.telerik.com/kendo-angular-ui/my-license/"
     }
   },
@@ -90,22 +90,23 @@
     "@angular/forms": "16 - 20",
     "@angular/platform-browser": "16 - 20",
     "@progress/kendo-licensing": "^1.5.0",
-    "@progress/kendo-angular-buttons": "19.1.2-develop.3",
-    "@progress/kendo-angular-common": "19.1.2-develop.3",
-    "@progress/kendo-angular-utils": "19.1.2-develop.3",
-    "@progress/kendo-angular-intl": "19.1.2-develop.3",
-    "@progress/kendo-angular-l10n": "19.1.2-develop.3",
-    "@progress/kendo-angular-icons": "19.1.2-develop.3",
-    "@progress/kendo-angular-popup": "19.1.2-develop.3",
-    "@progress/kendo-angular-navigation": "19.1.2-develop.3",
+    "@progress/kendo-angular-buttons": "19.1.2-develop.5",
+    "@progress/kendo-angular-common": "19.1.2-develop.5",
+    "@progress/kendo-angular-utils": "19.1.2-develop.5",
+    "@progress/kendo-angular-intl": "19.1.2-develop.5",
+    "@progress/kendo-angular-l10n": "19.1.2-develop.5",
+    "@progress/kendo-angular-icons": "19.1.2-develop.5",
+    "@progress/kendo-angular-popup": "19.1.2-develop.5",
+    "@progress/kendo-angular-navigation": "19.1.2-develop.5",
     "rxjs": "^6.5.3 || ^7.0.0"
   },
   "dependencies": {
     "tslib": "^2.3.1",
-    "@progress/kendo-angular-schematics": "19.1.2-develop.3",
+    "@progress/kendo-angular-schematics": "19.1.2-develop.5",
     "@progress/kendo-common": "^1.0.1",
     "@progress/kendo-date-math": "^1.1.0",
-    "@progress/kendo-dateinputs-common": "^0.4.4"
+    "@progress/kendo-dateinputs-common": "^0.4.4",
+    "node-html-parser": "^7.0.1"
   },
   "schematics": "./schematics/collection.json",
   "module": "fesm2022/progress-kendo-angular-dateinputs.mjs",

package/popup-settings.model.d.ts

@@ -7,16 +7,9 @@ import { ViewContainerRef } from '@angular/core';
  * Used for configuring the options of the popup container.
  *
  * @example
- * ```ts
- * _@Component({
- * selector: 'my-app',
- * template: `
- *  <kendo-datepicker [popupSettings]="{ animate: false }">
- *  </kendo-datepicker>
- * `
- * })
- * export class AppComponent {
- * }
+ * ```html
+ * <kendo-timepicker [popupSettings]="{ animate: false, appendTo: 'root', popupClass: 'custom-popup' }">
+ * </kendo-timepicker>
  * ```
  */
 export interface PopupSettings {

package/timepicker/localization/messages.d.ts

@@ -9,59 +9,59 @@ import * as i0 from "@angular/core";
  */
 export declare class TimePickerMessages extends ComponentMessages {
     /**
-     * The text of the **Accept** button in the popup footer of the TimeList.
+     * Specifies the text of the **Accept** button in the popup footer of the TimeList.
      */
     accept: string;
     /**
-     * The label of the **Accept** button in the popup footer of the TimeList.
+     * Specifies the label of the **Accept** button in the popup footer of the TimeList.
      */
     acceptLabel: string;
     /**
-     * The text of the **Cancel** button in the popup footer of the TimeList.
+     * Specifies the text of the **Cancel** button in the popup footer of the TimeList.
      */
     cancel: string;
     /**
-     * The label of the **Cancel** button in the popup footer of the TimeList.
+     * Specifies the label of the **Cancel** button in the popup footer of the TimeList.
      */
     cancelLabel: string;
     /**
-     * The text of the **Now** button in the popup header of the TimeList.
+     * Specifies the text of the **Now** button in the popup header of the TimeList.
      */
     now: string;
     /**
-     * The label of the **Now** button in the popup header of the TimeList.
+     * Specifies the label of the **Now** button in the popup header of the TimeList.
      */
     nowLabel: string;
     /**
-     * The title of the **Toggle** button of the TimePicker.
+     * Specifies the title of the **Toggle** button of the TimePicker.
      */
     toggle: string;
     /**
-     * The label of the **Hour** part in the TimePicker.
+     * Specifies the label of the **Hour** part in the TimePicker.
      */
     hour: string;
     /**
-     * The label of the **Minute** part in the TimePicker.
+     * Specifies the label of the **Minute** part in the TimePicker.
      */
     minute: string;
     /**
-     * The label of the **Second** part in the TimePicker.
+     * Specifies the label of the **Second** part in the TimePicker.
      */
     second: string;
     /**
-     * The label of the **Millisecond** part in the TimePicker.
+     * Specifies the label of the **Millisecond** part in the TimePicker.
      */
     millisecond: string;
     /**
-     * The label of the **Dayperiod** part in the TimePicker.
+     * Specifies the label of the **Dayperiod** part in the TimePicker.
      */
     dayperiod: string;
     /**
-     * The title of the **Clear** button of the TimePicker.
+     * Specifies the title of the **Clear** button of the TimePicker.
      */
     clearTitle: string;
     /**
-     * The title of the Close button of the ActionSheet that is rendered instead of the Popup when using small screen devices in adaptive mode.
+     * Specifies the title of the **Close** button of the ActionSheet that renders instead of the popup when using small screen devices in adaptive mode.
      */
     adaptiveCloseButtonTitle: string;
     static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerMessages, never>;

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

@@ -6,7 +6,18 @@ import { LocalizationService } from '@progress/kendo-angular-l10n';
 import { TimePickerMessages } from './messages';
 import * as i0 from "@angular/core";
 /**
- * Custom component messages override default component messages ([see example]({% slug globalization_dateinputs %}#toc-custom-messages)).
+ * Represents the Kendo UI TimePicker custom messages component for Angular. Allows you to override default component messages ([see example]({% slug globalization_dateinputs %}#toc-custom-messages)).
+ *
+ * @example
+ * ```html
+ * <kendo-timepicker>
+ *   <kendo-timepicker-messages
+ *     accept="Apply"
+ *     cancel="Close"
+ *     now="Current time">
+ *   </kendo-timepicker-messages>
+ * </kendo-timepicker>
+ * ```
  */
 export declare class TimePickerCustomMessagesComponent extends TimePickerMessages {
     protected service: LocalizationService;

package/timepicker/timepicker.component.d.ts

@@ -26,6 +26,22 @@ import { ActionSheetComponent } from '@progress/kendo-angular-navigation';
 import * as i0 from "@angular/core";
 /**
  * Represents the [Kendo UI TimePicker component for Angular](slug:overview_timepicker).
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   selector: 'my-app',
+ *   template: `
+ *     <kendo-timepicker [(value)]="selectedTime"></kendo-timepicker>
+ *   `
+ * })
+ * export class AppComponent {
+ *   public selectedTime: Date = new Date();
+ * }
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link TimePickerCustomMessagesComponent}.
  */
 export declare class TimePickerComponent extends MultiTabStop implements ControlValueAccessor, OnInit, AfterViewInit, OnChanges, OnDestroy, Validator {
     private bus;
@@ -52,14 +68,15 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
      */
     focusableId: string;
     /**
-     * Sets or gets the `disabled` property of the TimePicker and
-     * determines whether the component is active
+     * Determines whether the TimePicker is disabled
      * ([see example]({% slug disabled_timepicker %})).
      * To learn how to disable the component in reactive forms, refer to the article on [Forms Support](slug:formssupport_timepicker#toc-managing-the-timepicker-disabled-state-in-reactive-forms).
+     *
+     * @default false
      */
     disabled: boolean;
     /**
-     * Sets the read-only state of the TimePicker
+     * Determines the read-only state of the TimePicker
      * ([see example]({% slug readonly_timepicker %}#toc-read-only-timepicker)).
      *
      * @default false
@@ -69,8 +86,9 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
      * Sets the read-only state of the TimePicker input field
      * ([see example]({% slug readonly_timepicker %}#toc-read-only-input)).
      *
-     * > Note that if you set the [`readonly`]({% slug api_dateinputs_timepickercomponent %}#toc-readonly) property value to `true`,
+     * If you set the [`readonly`]({% slug api_dateinputs_timepickercomponent %}#toc-readonly) property value to `true`,
      * the input will be rendered in a read-only state regardless of the `readOnlyInput` value.
+     * @default false
      */
     readOnlyInput: boolean;
     /**
@@ -82,83 +100,40 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
     /**
      * Specifies the time format that is used to display the input value
      * ([see example]({% slug formats_timepicker %})).
+     * @default 't'
      */
     format: string;
     /**
      * Defines the descriptions of the format sections in the input field.
      * For more information, refer to the article on
      * [placeholders]({% slug placeholders_timepicker %}).
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     * <div class="row example-wrapper" [style.min-height.px]="450">
-     *  <div class="col-xs-12 col-md-6 example-col">
-     *    <p>Full-length format description:</p>
-     *    <kendo-timepicker formatPlaceholder="wide"></kendo-timepicker>
-     *  </div>
-     *
-     *  <div class="col-xs-12 col-md-6 example-col">
-     *    <p>Narrow-length format description:</p>
-     *    <kendo-timepicker formatPlaceholder="narrow"></kendo-timepicker>
-     *  </div>
-     *
-     *  <div class="col-xs-12 col-md-6 example-col">
-     *    <p>Short-length format description:</p>
-     *    <kendo-timepicker formatPlaceholder="short"></kendo-timepicker>
-     *  </div>
-     *
-     *  <div class="col-xs-12 col-md-6 example-col">
-     *    <p>Display defined format:</p>
-     *    <kendo-timepicker format="HH:mm:ss" formatPlaceholder="formatPattern"></kendo-timepicker>
-     *  </div>
-     *
-     *  <div class="col-xs-12 col-md-6 example-col">
-     *    <p>Custom defined format descriptions</p>
-     *    <kendo-timepicker format="HH:mm:ss"
-     *      [formatPlaceholder]="{ hour: 'H', minute: 'm', second: 's' }"
-     *    ></kendo-timepicker>
-     *  </div>
-     * </div>
-     * `
-     * })
-     * export class AppComponent { }
-     * ```
      */
     formatPlaceholder: DateInputFormatPlaceholder;
     /**
      * Specifies the hint the TimePicker displays when its value is `null`.
      * For more information, refer to the article on
      * [placeholders]({% slug placeholders_timepicker %}).
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     *  <kendo-timepicker placeholder="Enter start..."></kendo-timepicker>
-     * `
-     * })
-     * export class AppComponent { }
-     * ```
+     * @default null
      */
     placeholder: string;
     /**
      * Specifies the smallest valid time value
      * ([see example]({% slug timeranges_timepicker %})).
+     * @default `00:00:00`
      */
     set min(min: Date);
     get min(): Date;
     /**
      * Specifies the biggest valid time value
      * ([see example]({% slug timeranges_timepicker %})).
+     * @default `23:59:59`
      */
     set max(max: Date);
     get max(): Date;
     /**
      * Determines whether the built-in validation for incomplete dates is to be enforced when a form is being validated.
+     *
+     * @default false
      */
     incompleteDateValidation: boolean;
     /**
@@ -185,12 +160,16 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
     allowCaretMode: boolean;
     /**
      * Determines whether to display the **Cancel** button in the popup.
+     *
+     * @default true
      */
     cancelButton: boolean;
     /**
      * Determines whether to display the **Now** button in the popup.
      *
-     * > If the current time is out of range or the incremental step is greater than `1`, the **Now** button will be hidden.
+     * If the current time is out of range or the incremental step is greater than `1`, the **Now** button will be hidden.
+     *
+     * @default true
      */
     nowButton: boolean;
     /**
@@ -198,36 +177,22 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
      * For more information, refer to the article on
      * [incremental steps]({% slug incrementalsteps_timepicker %}).
      *
-     * > If the incremental step is greater than `1`, the **Now** button will be hidden.
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     *  <kendo-timepicker format="HH:mm:ss" [steps]="steps"></kendo-timepicker>
-     * `
-     * })
-     * class AppComponent {
-     *   public steps = { hour: 2, minute: 15, second: 15, millisecond: 10 };
-     * }
-     * ```
-     *
+     * If the incremental step is greater than `1`, the **Now** button will be hidden.
      */
     set steps(steps: TimePickerIncrementalSteps);
     get steps(): TimePickerIncrementalSteps;
     /**
      * Configures the popup of the TimePicker.
      *
-     * The available options are:
-     * - `animate: Boolean`&mdash;Controls the popup animation. By default, the open and close animations are enabled.
-     * - `appendTo: 'root' | 'component' | ViewContainerRef`&mdash;Controls the popup container. By default, the popup will be appended to the root component.
-     * - `popupClass: String`&mdash;Specifies a list of CSS classes that are used to style the popup.
+     * The available options are animate which controls the popup animation and by default, the open and close animations are enabled.
+     * The `appendTo` option controls the popup container and by default, the popup will be appended to the root component.
+     * The `popupClass` option specifies a list of CSS classes that are used to style the popup.
      */
     set popupSettings(settings: PopupSettings);
     get popupSettings(): PopupSettings;
     /**
-     * Sets or gets the `tabindex` property of the TimePicker.
+     * Sets the tabindex of the TimePicker component.
+     * @default 0
      */
     tabindex: number;
     /**
@@ -253,50 +218,33 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
      */
     rangeValidation: boolean;
     /**
-     * Enables or disables the adaptive mode. By default the adaptive rendering is disabled.
+     * Determines whether the TimePicker is in adaptive mode.
+     * @default 'none'
      */
     adaptiveMode: AdaptiveMode;
     /**
-     * Specifies the value of the TimePicker component.
+     * Determines whether the TimePicker is in adaptive mode.
      *
-     * > The `value` has to be a valid [JavaScript `Date`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date) instance or `null`.
+     * The `value` has to be a valid [JavaScript `Date`](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Date) instance or `null`.
      */
     set value(value: Date | null);
     get value(): Date | null;
     /**
      * Sets the size of the component.
-     *
-     * The possible values are:
-     * * `small`
-     * * `medium` (Default)
-     * * `large`
-     * * `none`
-     *
+     * @default 'medium'
      */
     set size(size: DateInputSize);
     get size(): DateInputSize;
     /**
-     * Sets the border radius of the component.
-     *
-     * The possible values are:
-     * * `small`
-     * * `medium` (Default)
-     * * `large`
-     * * `full`
-     * * `none`
+     * Sets the rounded styling of the component.
+     * @default 'medium'
      *
      */
     set rounded(rounded: DateInputRounded);
     get rounded(): DateInputRounded;
     /**
      * Sets the fillMode of the component.
-     *
-     * The possible values are:
-     * * `solid` (Default)
-     * * `flat`
-     * * `outline`
-     * * `none`
-     *
+     * @default 'solid'
      */
     set fillMode(fillMode: DateInputFillMode);
     get fillMode(): DateInputFillMode;
@@ -444,33 +392,23 @@ export declare class TimePickerComponent extends MultiTabStop implements Control
     /**
      * Focuses the TimePicker component.
      *
-     * @example
-     * ```ts
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     *  <button (click)="timepicker.focus()">Focus time picker</button>
-     *  <kendo-timepicker #timepicker></kendo-timepicker>
-     * `
-     * })
-     * export class AppComponent { }
-     * ```
      */
     focus(): void;
     /**
      * Blurs the TimePicker component.
+     *
      */
     blur(): void;
     /**
-     * Toggles the visibility of the popup or actionSheet.
-     * If you use the `toggle` method to show or hide the popup or actionSheet,
-     * the `open` and `close` events do not fire.
+     * Toggles the visibility of the popup or ActionSheet.
+     * If you use the `toggle` method to show or hide the popup or ActionSheet, the `open` and `close` events do not fire.
      *
-     * @param show - The state of the popup.
+     * @param {boolean} show The state of the popup.
      */
     toggle(show?: boolean): void;
     /**
-     * Indicates whether the component is currently open. That is when the popup or actionSheet is open.
+     * Returns whether the component is currently open.
+     * That is when the popup or ActionSheet is open.
      */
     get isOpen(): boolean;
     /**

package/timepicker/timepicker.module.d.ts

@@ -7,8 +7,19 @@ import * as i1 from "./localization/timepicker-custom-messages.component";
 import * as i2 from "./timepicker.component";
 import * as i3 from "@progress/kendo-angular-common";
 /**
- * Represents the [NgModule](link:site.data.urls.angular['ngmoduleapi'])
- * definition for the TimePicker component.
+ * Required for adding all TimePicker features in NgModule-based Angular applications.
+ *
+ * @example
+ * ```typescript
+ * import { NgModule } from '@angular/core';
+ * import { TimePickerModule } from '@progress/kendo-angular-dateinputs';
+ *
+ * @NgModule({
+ *   imports: [TimePickerModule],
+ *   // ...
+ * })
+ * export class AppModule { }
+ * ```
  */
 export declare class TimePickerModule {
     static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerModule, never>;

package/timepicker/timeselector.component.d.ts

@@ -34,62 +34,58 @@ export declare class TimeSelectorComponent implements OnChanges, OnInit, OnDestr
      */
     get disabledClass(): boolean;
     /**
-     * Specifies the time format used to display the time list columns.
+     * Specifies the time format that displays the time list columns.
+     *
+     * @default 't'
      */
     format: string;
     /**
-     * Specifies the smallest valid time value.
+     * Sets the smallest valid time value.
      */
     min: Date;
     /**
-     * Specifies the biggest valid time value.
+     * Sets the largest valid time value.
      */
     max: Date;
     /**
-     * Determines whether to display the **Cancel** button in the popup.
+     * Controls the display of the **Cancel** button in the popup.
+     *
+     * @default true
      */
     cancelButton: boolean;
     /**
-     * Determines whether to display the **Set** button in the popup.
+     * Controls the display of the **Set** button in the popup.
+     *
+     * @default true
      */
     setButton: boolean;
     /**
-     * Determines whether to display the **Now** button in the popup.
+     * Controls the display of the **Now** button in the popup.
      *
-     * > If the current time is out of range or the incremental step is greater than `1`, the **Now** button will be hidden.
+     * When the current time is out of range or the incremental step is greater than `1`, the **Now** button is hidden.
+     *
+     * @default true
      */
     nowButton: boolean;
     /**
-     * Sets or gets the `disabled` property of the TimeSelector and determines whether the component is active.
+     * Sets the `disabled` property of the `TimeSelector` and controls whether the component is active.
+     *
+     * @default false
      */
     disabled: boolean;
     /**
-     * Needed in order to set it in the dom service so that timeselector height can be properly calculated
+     * Sets the adaptive mode for the component.
+     * Use this property to enable proper height calculation in the DOM service.
      */
     isAdaptiveEnabled: boolean;
+    /**
+     * Specifies whether the component is used as part of a DateTimePicker.
+     */
     isDateTimePicker: boolean;
     /**
      * Configures the incremental steps of the TimeSelector.
      *
-     * The available options are:
-     * - `hour: Number`—Controls the incremental step of the hour value.
-     * - `minute: Number`—Controls the incremental step of the minute value.
-     * - `second: Number`—Controls the incremental step of the second value.
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     *  <kendo-timeselector format="HH:mm:ss" [steps]="steps"></kendo-timeselector>
-     * `
-     * })
-     * export class AppComponent {
-     *   public steps = { hour: 2, minute: 15, second: 15 };
-     * }
-     * ```
-     *
-     * > If the incremental step is greater than `1`, the **Now** button will be hidden.
+     * When the incremental step is greater than `1`, the **Now** button is hidden.
      */
     set steps(steps: TimePickerIncrementalSteps);
     get steps(): TimePickerIncrementalSteps;
@@ -134,18 +130,6 @@ export declare class TimeSelectorComponent implements OnChanges, OnInit, OnDestr
     ngOnDestroy(): void;
     /**
      * Focuses the TimeSelector component.
-     *
-     * @example
-     * ```ts
-     * _@Component({
-     * selector: 'my-app',
-     * template: `
-     *  <button (click)="timeselector.focus()">Focus time picker</button>
-     *  <kendo-timeselector #timeselector></kendo-timeselector>
-     * `
-     * })
-     * export class AppComponent { }
-     * ```
      */
     focus(): void;
     /**