@angular/material 19.0.0-next.1 → 19.0.0-next.10

package/timepicker/index.d.ts

@@ -0,0 +1,297 @@
+import { AbstractControl } from '@angular/forms';
+import { ControlValueAccessor } from '@angular/forms';
+import { ElementRef } from '@angular/core';
+import * as i0 from '@angular/core';
+import * as i4 from '@angular/cdk/scrolling';
+import { InjectionToken } from '@angular/core';
+import { InputSignal } from '@angular/core';
+import { InputSignalWithTransform } from '@angular/core';
+import { MatOption } from '@angular/material/core';
+import { MatOptionParentComponent } from '@angular/material/core';
+import { ModelSignal } from '@angular/core';
+import { OnDestroy } from '@angular/core';
+import { OutputEmitterRef } from '@angular/core';
+import { Signal } from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import { ValidationErrors } from '@angular/forms';
+import { Validator } from '@angular/forms';
+
+declare namespace i1 {
+    export {
+        MatTimepickerSelected,
+        MatTimepicker
+    }
+}
+
+declare namespace i2 {
+    export {
+        MatTimepickerInput
+    }
+}
+
+declare namespace i3 {
+    export {
+        MatTimepickerToggle
+    }
+}
+
+/**
+ * Injection token that can be used to configure the default options for the timepicker component.
+ */
+export declare const MAT_TIMEPICKER_CONFIG: InjectionToken<MatTimepickerConfig>;
+
+/**
+ * Renders out a listbox that can be used to select a time of day.
+ * Intended to be used together with `MatTimepickerInput`.
+ */
+export declare class MatTimepicker<D> implements OnDestroy, MatOptionParentComponent {
+    private _overlay;
+    private _dir;
+    private _viewContainerRef;
+    private _injector;
+    private _defaultConfig;
+    private _dateAdapter;
+    private _dateFormats;
+    private _isOpen;
+    private _activeDescendant;
+    private _input;
+    private _overlayRef;
+    private _portal;
+    private _optionsCacheKey;
+    private _localeChanges;
+    private _onOpenRender;
+    protected _panelTemplate: Signal<TemplateRef<unknown>>;
+    protected _timeOptions: readonly MatTimepickerOption<D>[];
+    protected _options: Signal<readonly MatOption<any>[]>;
+    private _keyManager;
+    /**
+     * Interval between each option in the timepicker. The value can either be an amount of
+     * seconds (e.g. 90) or a number with a unit (e.g. 45m). Supported units are `s` for seconds,
+     * `m` for minutes or `h` for hours.
+     */
+    readonly interval: InputSignalWithTransform<number | null, number | string | null>;
+    /**
+     * Array of pre-defined options that the user can select from, as an alternative to using the
+     * `interval` input. An error will be thrown if both `options` and `interval` are specified.
+     */
+    readonly options: InputSignal<readonly MatTimepickerOption<D>[] | null>;
+    /** Whether the timepicker is open. */
+    readonly isOpen: Signal<boolean>;
+    /** Emits when the user selects a time. */
+    readonly selected: OutputEmitterRef<MatTimepickerSelected<D>>;
+    /** Emits when the timepicker is opened. */
+    readonly opened: OutputEmitterRef<void>;
+    /** Emits when the timepicker is closed. */
+    readonly closed: OutputEmitterRef<void>;
+    /** ID of the active descendant option. */
+    readonly activeDescendant: Signal<string | null>;
+    /** Unique ID of the timepicker's panel */
+    readonly panelId: string;
+    /** Whether ripples within the timepicker should be disabled. */
+    readonly disableRipple: InputSignalWithTransform<boolean, unknown>;
+    /** ARIA label for the timepicker panel. */
+    readonly ariaLabel: InputSignal<string | null>;
+    /** ID of the label element for the timepicker panel. */
+    readonly ariaLabelledby: InputSignal<string | null>;
+    constructor();
+    /** Opens the timepicker. */
+    open(): void;
+    /** Closes the timepicker. */
+    close(): void;
+    /** Registers an input with the timepicker. */
+    registerInput(input: MatTimepickerInput<D>): void;
+    ngOnDestroy(): void;
+    /** Selects a specific time value. */
+    protected _selectValue(value: D): void;
+    /** Gets the value of the `aria-labelledby` attribute. */
+    protected _getAriaLabelledby(): string | null;
+    /** Creates an overlay reference for the timepicker panel. */
+    private _getOverlayRef;
+    /** Generates the list of options from which the user can select.. */
+    private _generateOptions;
+    /**
+     * Synchronizes the internal state of the component based on a specific selected date.
+     * @param value Currently selected date.
+     * @param options Options rendered out in the timepicker.
+     * @param fallback Option to set as active if no option is selected.
+     */
+    private _syncSelectedState;
+    /** Handles keyboard events while the overlay is open. */
+    private _handleKeydown;
+    /** Sets up the logic that updates the timepicker when the locale changes. */
+    private _handleLocaleChanges;
+    /**
+     * Sets up the logic that updates the timepicker when the state of the connected input changes.
+     */
+    private _handleInputStateChanges;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatTimepicker<any>, never>;
+    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>;
+}
+
+/**
+ * Object that can be used to configure the default options for the timepicker component.
+ */
+export declare interface MatTimepickerConfig {
+    /** Default interval for all time pickers. */
+    interval?: string | number;
+    /** Whether ripples inside the timepicker should be disabled by default. */
+    disableRipple?: boolean;
+}
+
+/**
+ * Input that can be used to enter time and connect to a `mat-timepicker`.
+ */
+export declare class MatTimepickerInput<D> implements ControlValueAccessor, Validator, OnDestroy {
+    private _elementRef;
+    private _document;
+    private _dateAdapter;
+    private _dateFormats;
+    private _formField;
+    private _onChange;
+    private _onTouched;
+    private _validatorOnChange;
+    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 the input is disabled. */
+    readonly disabled: Signal<boolean>;
+    /** Whether the input should be disabled through the template. */
+    protected 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(value: string): 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; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; }, never, never, true, never>;
+}
+
+export declare class MatTimepickerModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatTimepickerModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<MatTimepickerModule, never, [typeof i1.MatTimepicker, typeof i2.MatTimepickerInput, typeof i3.MatTimepickerToggle], [typeof i4.CdkScrollableModule, typeof i1.MatTimepicker, typeof i2.MatTimepickerInput, typeof i3.MatTimepickerToggle]>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<MatTimepickerModule>;
+}
+
+/**
+ * Time selection option that can be displayed within a `mat-timepicker`.
+ */
+export declare interface MatTimepickerOption<D = unknown> {
+    /** Date value of the option. */
+    value: D;
+    /** Label to show to the user. */
+    label: string;
+}
+
+/** Event emitted when a value is selected in the timepicker. */
+export declare interface MatTimepickerSelected<D> {
+    value: D;
+    source: MatTimepicker<D>;
+}
+
+/** Button that can be used to open a `mat-timepicker`. */
+export declare class MatTimepickerToggle<D> {
+    private _defaultConfig;
+    private _defaultTabIndex;
+    /** Timepicker instance that the button will toggle. */
+    readonly timepicker: InputSignal<MatTimepicker<D>>;
+    /** Screen-reader label for the button. */
+    readonly ariaLabel: InputSignal<string | undefined>;
+    /** Whether the toggle button is disabled. */
+    readonly disabled: InputSignalWithTransform<boolean, unknown>;
+    /** Tabindex for the toggle. */
+    readonly tabIndex: InputSignal<number | null>;
+    /** Whether ripples on the toggle should be disabled. */
+    readonly disableRipple: InputSignalWithTransform<boolean, unknown>;
+    /** Opens the connected timepicker. */
+    protected _open(event: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatTimepickerToggle<any>, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MatTimepickerToggle<any>, "mat-timepicker-toggle", ["matTimepickerToggle"], { "timepicker": { "alias": "for"; "required": true; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "disableRipple": { "alias": "disableRipple"; "required": false; "isSignal": true; }; }, {}, never, ["[matTimepickerToggleIcon]"], true, never>;
+}
+
+export { }

package/timepicker/testing/index.d.ts

@@ -0,0 +1,113 @@
+import { BaseHarnessFilters } from '@angular/cdk/testing';
+import { ComponentHarness } from '@angular/cdk/testing';
+import { ComponentHarnessConstructor } from '@angular/cdk/testing';
+import { HarnessPredicate } from '@angular/cdk/testing';
+import { MatOptionHarness } from '@angular/material/core/testing';
+import { OptionHarnessFilters } from '@angular/material/core/testing';
+
+export declare class MatTimepickerHarness extends ComponentHarness {
+    private _documentRootLocator;
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a timepicker with specific
+     * attributes.
+     * @param options Options for filtering which timepicker instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with<T extends MatTimepickerHarness>(this: ComponentHarnessConstructor<T>, options?: TimepickerHarnessFilters): HarnessPredicate<T>;
+    /** Whether the timepicker is open. */
+    isOpen(): Promise<boolean>;
+    /** Gets the options inside the timepicker panel. */
+    getOptions(filters?: Omit<OptionHarnessFilters, 'ancestor'>): Promise<MatOptionHarness[]>;
+    /** Selects the first option matching the given filters. */
+    selectOption(filters: OptionHarnessFilters): Promise<void>;
+    /** Gets the selector that can be used to find the timepicker's panel. */
+    protected _getPanelSelector(): Promise<string>;
+}
+
+/** Harness for interacting with a standard Material timepicker inputs in tests. */
+export declare class MatTimepickerInputHarness extends ComponentHarness {
+    private _documentRootLocator;
+    static hostSelector: string;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatTimepickerInputHarness`
+     * that meets certain criteria.
+     * @param options Options for filtering which input instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with<T extends MatTimepickerInputHarness>(this: ComponentHarnessConstructor<T>, options?: TimepickerInputHarnessFilters): HarnessPredicate<T>;
+    /** Gets whether the timepicker associated with the input is open. */
+    isTimepickerOpen(): Promise<boolean>;
+    /** Opens the timepicker associated with the input and returns the timepicker instance. */
+    openTimepicker(): Promise<MatTimepickerHarness>;
+    /** Closes the timepicker associated with the input. */
+    closeTimepicker(): Promise<void>;
+    /**
+     * Gets the `MatTimepickerHarness` that is associated with the input.
+     * @param filter Optionally filters which timepicker is included.
+     */
+    getTimepicker(filter?: TimepickerHarnessFilters): Promise<MatTimepickerHarness>;
+    /** Whether the input is disabled. */
+    isDisabled(): Promise<boolean>;
+    /** Whether the input is required. */
+    isRequired(): Promise<boolean>;
+    /** Gets the value of the input. */
+    getValue(): Promise<string>;
+    /**
+     * Sets the value of the input. The value will be set by simulating
+     * keypresses that correspond to the given value.
+     */
+    setValue(newValue: string): Promise<void>;
+    /** Gets the placeholder of the input. */
+    getPlaceholder(): Promise<string>;
+    /**
+     * Focuses the input and returns a promise that indicates when the
+     * action is complete.
+     */
+    focus(): Promise<void>;
+    /**
+     * Blurs the input and returns a promise that indicates when the
+     * action is complete.
+     */
+    blur(): Promise<void>;
+    /** Whether the input is focused. */
+    isFocused(): Promise<boolean>;
+}
+
+/** Harness for interacting with a standard Material timepicker toggle in tests. */
+export declare class MatTimepickerToggleHarness extends ComponentHarness {
+    static hostSelector: string;
+    /** The clickable button inside the toggle. */
+    private _button;
+    /**
+     * Gets a `HarnessPredicate` that can be used to search for a `MatTimepickerToggleHarness` that
+     * meets certain criteria.
+     * @param options Options for filtering which timepicker toggle instances are considered a match.
+     * @return a `HarnessPredicate` configured with the given options.
+     */
+    static with(options?: TimepickerToggleHarnessFilters): HarnessPredicate<MatTimepickerToggleHarness>;
+    /** Opens the timepicker associated with the toggle. */
+    openTimepicker(): Promise<void>;
+    /** Gets whether the timepicker associated with the toggle is open. */
+    isTimepickerOpen(): Promise<boolean>;
+    /** Whether the toggle is disabled. */
+    isDisabled(): Promise<boolean>;
+}
+
+/** A set of criteria that can be used to filter a list of `MatTimepickerHarness` instances. */
+export declare interface TimepickerHarnessFilters extends BaseHarnessFilters {
+}
+
+/** A set of criteria that can be used to filter a list of timepicker input instances. */
+export declare interface TimepickerInputHarnessFilters extends BaseHarnessFilters {
+    /** Filters based on the value of the input. */
+    value?: string | RegExp;
+    /** Filters based on the placeholder text of the input. */
+    placeholder?: string | RegExp;
+}
+
+/** A set of criteria that can be used to filter a list of timepicker toggle instances. */
+export declare interface TimepickerToggleHarnessFilters extends BaseHarnessFilters {
+}
+
+export { }

package/toolbar/_toolbar-theme.scss

@@ -17,16 +17,18 @@
   );
 }
 
-@mixin base($theme) {}
+@mixin base($theme) {
+}
 
 @mixin color($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, color));
-  }
-  @else {
+  } @else {
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(tokens-mat-toolbar.$prefix,
-        tokens-mat-toolbar.get-color-tokens($theme));
+      @include token-utils.create-token-values(
+        tokens-mat-toolbar.$prefix,
+        tokens-mat-toolbar.get-color-tokens($theme)
+      );
     }
 
     .mat-toolbar {
@@ -48,14 +50,15 @@
 @mixin typography($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, typography));
-  }
-  @else {
+  } @else {
     // TODO(mmalerba): Stop calling this and resolve resulting screen diffs.
     $theme: inspection.private-get-typography-back-compat-theme($theme);
 
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(tokens-mat-toolbar.$prefix,
-        tokens-mat-toolbar.get-typography-tokens($theme));
+      @include token-utils.create-token-values(
+        tokens-mat-toolbar.$prefix,
+        tokens-mat-toolbar.get-typography-tokens($theme)
+      );
     }
   }
 }
@@ -63,30 +66,37 @@
 @mixin density($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, density));
-  }
-  @else {
+  } @else {
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(tokens-mat-toolbar.$prefix,
-        tokens-mat-toolbar.get-density-tokens($theme));
+      @include token-utils.create-token-values(
+        tokens-mat-toolbar.$prefix,
+        tokens-mat-toolbar.get-density-tokens($theme)
+      );
     }
   }
 }
 
+/// Defines the tokens that will be available in the `overrides` mixin and for docs extraction.
+@function _define-overrides() {
+  @return (
+    (
+      namespace: tokens-mat-toolbar.$prefix,
+      tokens: tokens-mat-toolbar.get-token-slots(),
+    ),
+  );
+}
+
 /// Outputs the CSS variable values for the given tokens.
 /// @param {Map} $tokens The token values to emit.
 @mixin overrides($tokens: ()) {
-  @include token-utils.batch-create-token-values(
-    $tokens,
-    (prefix: tokens-mat-toolbar.$prefix, tokens: tokens-mat-toolbar.get-token-slots()),
-  );
+  @include token-utils.batch-create-token-values($tokens, _define-overrides()...);
 }
 
 @mixin theme($theme) {
   @include theming.private-check-duplicate-theme-styles($theme, 'mat-toolbar') {
     @if inspection.get-theme-version($theme) == 1 {
       @include _theme-from-tokens(inspection.get-theme-tokens($theme));
-    }
-    @else {
+    } @else {
       @include base($theme);
       @if inspection.theme-has($theme, color) {
         @include color($theme);
@@ -103,9 +113,12 @@
 
 @mixin _theme-from-tokens($tokens) {
   @include validation.selector-defined(
-      'Calls to Angular Material theme mixins with an M3 theme must be wrapped in a selector');
+    'Calls to Angular Material theme mixins with an M3 theme must be wrapped in a selector'
+  );
   @if ($tokens != ()) {
-    @include token-utils.create-token-values(tokens-mat-toolbar.$prefix,
-      map.get($tokens, tokens-mat-toolbar.$prefix));
+    @include token-utils.create-token-values(
+      tokens-mat-toolbar.$prefix,
+      map.get($tokens, tokens-mat-toolbar.$prefix)
+    );
   }
 }

package/toolbar/index.d.ts

@@ -2,7 +2,6 @@ import { AfterViewInit } from '@angular/core';
 import { ElementRef } from '@angular/core';
 import * as i0 from '@angular/core';
 import * as i1 from '@angular/material/core';
-import { Platform } from '@angular/cdk/platform';
 import { QueryList } from '@angular/core';
 
 declare namespace i2 {
@@ -14,8 +13,9 @@ declare namespace i2 {
 }
 
 export declare class MatToolbar implements AfterViewInit {
-    protected _elementRef: ElementRef;
+    protected _elementRef: ElementRef<any>;
     private _platform;
+    private _document;
     /**
      * Theme color of the toolbar. This API is supported in M2 themes only, it has
      * no effect in M3 themes.
@@ -24,10 +24,9 @@ export declare class MatToolbar implements AfterViewInit {
      * https://material.angular.io/guide/theming#using-component-color-variants.
      */
     color?: string | null;
-    private _document;
     /** Reference to all toolbar row elements that have been projected. */
     _toolbarRows: QueryList<MatToolbarRow>;
-    constructor(_elementRef: ElementRef, _platform: Platform, document?: any);
+    constructor(...args: unknown[]);
     ngAfterViewInit(): void;
     /**
      * Throws an exception when developers are attempting to combine the different toolbar row modes.

package/tooltip/_tooltip-theme.scss

@@ -9,8 +9,7 @@
 @mixin base($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, base));
-  }
-  @else {
+  } @else {
     // Add default values for tokens not related to color, typography, or density.
     @include sass-utils.current-selector-or-root() {
       @include token-utils.create-token-values(
@@ -24,8 +23,7 @@
 @mixin color($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, color));
-  }
-  @else {
+  } @else {
     @include sass-utils.current-selector-or-root() {
       @include token-utils.create-token-values(
         tokens-mdc-plain-tooltip.$prefix,
@@ -38,8 +36,7 @@
 @mixin typography($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, typography));
-  }
-  @else {
+  } @else {
     @include sass-utils.current-selector-or-root() {
       @include token-utils.create-token-values(
         tokens-mdc-plain-tooltip.$prefix,
@@ -52,8 +49,7 @@
 @mixin density($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, density));
-  }
-  @else {
+  } @else {
     @include sass-utils.current-selector-or-root() {
       @include token-utils.create-token-values(
         tokens-mdc-plain-tooltip.$prefix,
@@ -63,19 +59,25 @@
   }
 }
 
-@mixin overrides($tokens: ()) {
-  @include token-utils.batch-create-token-values(
-    $tokens,
-    (prefix: tokens-mdc-plain-tooltip.$prefix, tokens: tokens-mdc-plain-tooltip.get-token-slots()),
+/// Defines the tokens that will be available in the `overrides` mixin and for docs extraction.
+@function _define-overrides() {
+  @return (
+    (
+      namespace: tokens-mdc-plain-tooltip.$prefix,
+      tokens: tokens-mdc-plain-tooltip.get-token-slots(),
+    ),
   );
 }
 
+@mixin overrides($tokens: ()) {
+  @include token-utils.batch-create-token-values($tokens, _define-overrides()...);
+}
+
 @mixin theme($theme) {
   @include theming.private-check-duplicate-theme-styles($theme, 'mat-tooltip') {
     @if inspection.get-theme-version($theme) == 1 {
       @include _theme-from-tokens(inspection.get-theme-tokens($theme));
-    }
-    @else {
+    } @else {
       @include base($theme);
       @if inspection.theme-has($theme, color) {
         @include color($theme);
@@ -92,7 +94,8 @@
 
 @mixin _theme-from-tokens($tokens) {
   @include validation.selector-defined(
-      'Calls to Angular Material theme mixins with an M3 theme must be wrapped in a selector');
+    'Calls to Angular Material theme mixins with an M3 theme must be wrapped in a selector'
+  );
   @if $tokens != () {
     $tokens: token-utils.get-tokens-for($tokens, tokens-mdc-plain-tooltip.$prefix);
     @include token-utils.create-token-values(tokens-mdc-plain-tooltip.$prefix, $tokens);