@angular/material 21.0.0-next.6 → 21.0.0-next.9

package/types/timepicker.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from '@angular/core';
-import { OnDestroy, Signal, ModelSignal, InputSignal, InputSignalWithTransform, ElementRef, InjectionToken, TemplateRef, OutputEmitterRef } from '@angular/core';
+import { InjectionToken, Signal, ElementRef, OnDestroy, TemplateRef, InputSignalWithTransform, InputSignal, OutputEmitterRef, ModelSignal } from '@angular/core';
 import { MatOption } from './_option-chunk.js';
 import { MatOptionParentComponent } from './_option-parent-chunk.js';
 import { ScrollStrategy } from '@angular/cdk/overlay';
@@ -8,129 +8,6 @@ import * as i1 from '@angular/cdk/scrolling';
 import '@angular/cdk/a11y';
 import 'rxjs';
 
-/**
- * Input that can be used to enter time and connect to a `mat-timepicker`.
- */
-declare class MatTimepickerInput<D> implements ControlValueAccessor, Validator, OnDestroy {
-    private _elementRef;
-    private _dateAdapter;
-    private _dateFormats;
-    private _formField;
-    private _onChange;
-    private _onTouched;
-    private _validatorOnChange;
-    private _cleanupClick;
-    private _accessorDisabled;
-    private _localeSubscription;
-    private _timepickerSubscription;
-    private _validator;
-    private _lastValueValid;
-    private _lastValidDate;
-    /** Value of the `aria-activedescendant` attribute. */
-    protected readonly _ariaActiveDescendant: Signal<string | null>;
-    /** Value of the `aria-expanded` attribute. */
-    protected readonly _ariaExpanded: Signal<string>;
-    /** Value of the `aria-controls` attribute. */
-    protected readonly _ariaControls: Signal<string | null>;
-    /** Current value of the input. */
-    readonly value: ModelSignal<D | null>;
-    /** Timepicker that the input is associated with. */
-    readonly timepicker: InputSignal<MatTimepicker<D>>;
-    /**
-     * Minimum time that can be selected or typed in. Can be either
-     * a date object (only time will be used) or a valid time string.
-     */
-    readonly min: InputSignalWithTransform<D | null, unknown>;
-    /**
-     * Maximum time that can be selected or typed in. Can be either
-     * a date object (only time will be used) or a valid time string.
-     */
-    readonly max: InputSignalWithTransform<D | null, unknown>;
-    /**
-     * Whether to open the timepicker overlay when clicking on the input. Enabled by default.
-     * Note that when disabling this option, you'll have to provide your own logic for opening
-     * the overlay.
-     */
-    readonly openOnClick: InputSignalWithTransform<boolean, unknown>;
-    /** Whether the input is disabled. */
-    readonly disabled: Signal<boolean>;
-    /**
-     * Whether the input should be disabled through the template.
-     * @docs-private
-     */
-    readonly disabledInput: InputSignalWithTransform<boolean, unknown>;
-    constructor();
-    /**
-     * Implemented as a part of `ControlValueAccessor`.
-     * @docs-private
-     */
-    writeValue(value: any): void;
-    /**
-     * Implemented as a part of `ControlValueAccessor`.
-     * @docs-private
-     */
-    registerOnChange(fn: (value: any) => void): void;
-    /**
-     * Implemented as a part of `ControlValueAccessor`.
-     * @docs-private
-     */
-    registerOnTouched(fn: () => void): void;
-    /**
-     * Implemented as a part of `ControlValueAccessor`.
-     * @docs-private
-     */
-    setDisabledState(isDisabled: boolean): void;
-    /**
-     * Implemented as a part of `Validator`.
-     * @docs-private
-     */
-    validate(control: AbstractControl): ValidationErrors | null;
-    /**
-     * Implemented as a part of `Validator`.
-     * @docs-private
-     */
-    registerOnValidatorChange(fn: () => void): void;
-    /** Gets the element to which the timepicker popup should be attached. */
-    getOverlayOrigin(): ElementRef<HTMLElement>;
-    /** Focuses the input. */
-    focus(): void;
-    ngOnDestroy(): void;
-    /** Gets the ID of the input's label. */
-    _getLabelId(): string | null;
-    /** Handles clicks on the input or the containing form field. */
-    private _handleClick;
-    /** Handles the `input` event. */
-    protected _handleInput(event: Event): void;
-    /** Handles the `blur` event. */
-    protected _handleBlur(): void;
-    /** Handles the `keydown` event. */
-    protected _handleKeydown(event: KeyboardEvent): void;
-    /** Sets up the code that watches for changes in the value and adjusts the input. */
-    private _respondToValueChanges;
-    /** Sets up the logic that registers the input with the timepicker. */
-    private _registerTimepicker;
-    /** Sets up the logic that adjusts the input if the min/max changes. */
-    private _respondToMinMaxChanges;
-    /**
-     * Assigns a value set by the user to the input's model.
-     * @param selection Time selected by the user that should be assigned.
-     * @param propagateToAccessor Whether the value should be propagated to the ControlValueAccessor.
-     */
-    private _assignUserSelection;
-    /** Formats the current value and assigns it to the input. */
-    private _formatValue;
-    /** Checks whether a value is valid. */
-    private _isValid;
-    /** Transforms an arbitrary value into a value that can be assigned to a date-based input. */
-    private _transformDateInput;
-    /** Whether the input is currently focused. */
-    private _hasFocus;
-    /** Gets a function that can be used to validate the input. */
-    private _getValidator;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatTimepickerInput<any>, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatTimepickerInput<any>, "input[matTimepicker]", ["matTimepickerInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timepicker": { "alias": "matTimepicker"; "required": true; "isSignal": true; }; "min": { "alias": "matTimepickerMin"; "required": false; "isSignal": true; }; "max": { "alias": "matTimepickerMax"; "required": false; "isSignal": true; }; "openOnClick": { "alias": "matTimepickerOpenOnClick"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
-}
-
 /**
  * Object that can be used to configure the default options for the timepicker component.
  */
@@ -161,6 +38,25 @@ interface MatTimepickerSelected<D> {
 }
 /** Injection token used to configure the behavior of the timepicker dropdown while scrolling. */
 declare const MAT_TIMEPICKER_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
+/** Represents an input that is connected to a `mat-timepicker`. */
+interface MatTimepickerConnectedInput<D> {
+    /** Current value of the input. */
+    value: Signal<D | null>;
+    /** Minimum allowed time. */
+    min: Signal<D | null>;
+    /** Maximum allowed time. */
+    max: Signal<D | null>;
+    /** Whether the input is disabled. */
+    disabled: Signal<boolean>;
+    /** Focuses the input. */
+    focus(): void;
+    /** Gets the element to which to connect the timepicker overlay. */
+    getOverlayOrigin(): ElementRef<HTMLElement>;
+    /** Gets the ID of the input's label. */
+    getLabelId(): string | null;
+    /** Callback invoked when the timepicker assigns a value. */
+    timepickerValueAssigned(value: D | null): void;
+}
 /**
  * Renders out a listbox that can be used to select a time of day.
  * Intended to be used together with `MatTimepickerInput`.
@@ -223,7 +119,7 @@ declare class MatTimepicker<D> implements OnDestroy, MatOptionParentComponent {
     /** Closes the timepicker. */
     close(): void;
     /** Registers an input with the timepicker. */
-    registerInput(input: MatTimepickerInput<D>): void;
+    registerInput(input: MatTimepickerConnectedInput<D>): void;
     ngOnDestroy(): void;
     /** Selects a specific time value. */
     protected _selectValue(option: MatOption<D>): void;
@@ -254,6 +150,131 @@ declare class MatTimepicker<D> implements OnDestroy, MatOptionParentComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<MatTimepicker<any>, "mat-timepicker", ["matTimepicker"], { "interval": { "alias": "interval"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "disableRipple": { "alias": "disableRipple"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; }, { "selected": "selected"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
 }
 
+/**
+ * Input that can be used to enter time and connect to a `mat-timepicker`.
+ */
+declare class MatTimepickerInput<D> implements MatTimepickerConnectedInput<D>, ControlValueAccessor, Validator, OnDestroy {
+    private _elementRef;
+    private _dateAdapter;
+    private _dateFormats;
+    private _formField;
+    private _onChange;
+    private _onTouched;
+    private _validatorOnChange;
+    private _cleanupClick;
+    private _accessorDisabled;
+    private _localeSubscription;
+    private _timepickerSubscription;
+    private _validator;
+    private _lastValueValid;
+    private _lastValidDate;
+    /** Value of the `aria-activedescendant` attribute. */
+    protected readonly _ariaActiveDescendant: Signal<string | null>;
+    /** Value of the `aria-expanded` attribute. */
+    protected readonly _ariaExpanded: Signal<string>;
+    /** Value of the `aria-controls` attribute. */
+    protected readonly _ariaControls: Signal<string | null>;
+    /** Current value of the input. */
+    readonly value: ModelSignal<D | null>;
+    /** Timepicker that the input is associated with. */
+    readonly timepicker: InputSignal<MatTimepicker<D>>;
+    /**
+     * Minimum time that can be selected or typed in. Can be either
+     * a date object (only time will be used) or a valid time string.
+     */
+    readonly min: InputSignalWithTransform<D | null, unknown>;
+    /**
+     * Maximum time that can be selected or typed in. Can be either
+     * a date object (only time will be used) or a valid time string.
+     */
+    readonly max: InputSignalWithTransform<D | null, unknown>;
+    /**
+     * Whether to open the timepicker overlay when clicking on the input. Enabled by default.
+     * Note that when disabling this option, you'll have to provide your own logic for opening
+     * the overlay.
+     */
+    readonly openOnClick: InputSignalWithTransform<boolean, unknown>;
+    /** Whether the input is disabled. */
+    readonly disabled: Signal<boolean>;
+    /**
+     * Whether the input should be disabled through the template.
+     * @docs-private
+     */
+    readonly disabledInput: InputSignalWithTransform<boolean, unknown>;
+    constructor();
+    /**
+     * Implemented as a part of `ControlValueAccessor`.
+     * @docs-private
+     */
+    writeValue(value: any): void;
+    /**
+     * Implemented as a part of `ControlValueAccessor`.
+     * @docs-private
+     */
+    registerOnChange(fn: (value: any) => void): void;
+    /**
+     * Implemented as a part of `ControlValueAccessor`.
+     * @docs-private
+     */
+    registerOnTouched(fn: () => void): void;
+    /**
+     * Implemented as a part of `ControlValueAccessor`.
+     * @docs-private
+     */
+    setDisabledState(isDisabled: boolean): void;
+    /**
+     * Implemented as a part of `Validator`.
+     * @docs-private
+     */
+    validate(control: AbstractControl): ValidationErrors | null;
+    /**
+     * Implemented as a part of `Validator`.
+     * @docs-private
+     */
+    registerOnValidatorChange(fn: () => void): void;
+    /** Gets the element to which the timepicker popup should be attached. */
+    getOverlayOrigin(): ElementRef<HTMLElement>;
+    /** Focuses the input. */
+    focus(): void;
+    ngOnDestroy(): void;
+    /** Gets the ID of the input's label. */
+    getLabelId(): string | null;
+    /** Handles clicks on the input or the containing form field. */
+    private _handleClick;
+    /** Handles the `input` event. */
+    protected _handleInput(event: Event): void;
+    /** Handles the `blur` event. */
+    protected _handleBlur(): void;
+    /** Handles the `keydown` event. */
+    protected _handleKeydown(event: KeyboardEvent): void;
+    /** Called by the timepicker to sync up the user-selected value. */
+    timepickerValueAssigned(value: D | null): void;
+    /** Sets up the code that watches for changes in the value and adjusts the input. */
+    private _respondToValueChanges;
+    /** Sets up the logic that registers the input with the timepicker. */
+    private _registerTimepicker;
+    /** Sets up the logic that adjusts the input if the min/max changes. */
+    private _respondToMinMaxChanges;
+    /**
+     * Assigns a value set by the user to the input's model.
+     * @param selection Time selected by the user that should be assigned.
+     * @param propagateToAccessor Whether the value should be propagated to the ControlValueAccessor.
+     */
+    private _assignUserSelection;
+    /** Formats the current value and assigns it to the input. */
+    private _formatValue;
+    /** Checks whether a value is valid. */
+    private _isValid;
+    /** Transforms an arbitrary value into a value that can be assigned to a date-based input. */
+    private _transformDateInput;
+    /** Whether the input is currently focused. */
+    private _hasFocus;
+    /** Gets a function that can be used to validate the input. */
+    private _getValidator;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatTimepickerInput<any>, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MatTimepickerInput<any>, "input[matTimepicker]", ["matTimepickerInput"], { "value": { "alias": "value"; "required": false; "isSignal": true; }; "timepicker": { "alias": "matTimepicker"; "required": true; "isSignal": true; }; "min": { "alias": "matTimepickerMin"; "required": false; "isSignal": true; }; "max": { "alias": "matTimepickerMax"; "required": false; "isSignal": true; }; "openOnClick": { "alias": "matTimepickerOpenOnClick"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
 /** Button that can be used to open a `mat-timepicker`. */
 declare class MatTimepickerToggle<D> {
     private _defaultConfig;
@@ -291,4 +312,4 @@ declare class MatTimepickerModule {
 }
 
 export { MAT_TIMEPICKER_CONFIG, MAT_TIMEPICKER_SCROLL_STRATEGY, MatTimepicker, MatTimepickerInput, MatTimepickerModule, MatTimepickerToggle };
-export type { MatTimepickerConfig, MatTimepickerOption, MatTimepickerSelected };
+export type { MatTimepickerConfig, MatTimepickerConnectedInput, MatTimepickerOption, MatTimepickerSelected };