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

package/core/index.d.ts

@@ -6,10 +6,10 @@ import { EventEmitter } from '@angular/core';
 import { FocusableOption } from '@angular/cdk/a11y';
 import { FocusOrigin } from '@angular/cdk/a11y';
 import { FormGroupDirective } from '@angular/forms';
-import { HighContrastModeDetector } from '@angular/cdk/a11y';
 import * as i0 from '@angular/core';
 import * as i1 from '@angular/cdk/bidi';
 import { InjectionToken } from '@angular/core';
+import { Injector } from '@angular/core';
 import { NgControl } from '@angular/forms';
 import { NgForm } from '@angular/forms';
 import { NgZone } from '@angular/core';
@@ -19,15 +19,10 @@ import { OnInit } from '@angular/core';
 import { Platform } from '@angular/cdk/platform';
 import { Provider } from '@angular/core';
 import { QueryList } from '@angular/core';
+import { Signal } from '@angular/core';
 import { Subject } from 'rxjs';
 import { Version } from '@angular/core';
 
-/**
- * This is a permissive type for abstract class constructors.
- * @docs-private
- */
-export declare type _AbstractConstructor<T = object> = abstract new (...args: any[]) => T;
-
 
 /** @docs-private */
 export declare class AnimationCurves {
@@ -44,64 +39,6 @@ export declare class AnimationDurations {
     static EXITING: string;
 }
 
-/**
- * @docs-private
- * @deprecated Will be removed together with `mixinColor`.
- * @breaking-change 19.0.0
- */
-export declare interface CanColor {
-    /** Theme color palette for the component. */
-    color: ThemePalette;
-    /** Default color to fall back to if no value is set. */
-    defaultColor: ThemePalette | undefined;
-}
-
-declare type CanColorCtor = _Constructor<CanColor> & _AbstractConstructor<CanColor>;
-
-/**
- * @docs-private
- * @deprecated Will be removed together with `mixinDisabled`.
- * @breaking-change 19.0.0
- */
-export declare interface CanDisable {
-    /** Whether the component is disabled. */
-    disabled: boolean;
-}
-
-declare type CanDisableCtor = _Constructor<CanDisable> & _AbstractConstructor<CanDisable>;
-
-/**
- * @docs-private
- * @deprecated Will be removed together with `mixinDisableRipple`.
- * @breaking-change 19.0.0
- */
-export declare interface CanDisableRipple {
-    /** Whether ripples are disabled. */
-    disableRipple: boolean;
-}
-
-declare type CanDisableRippleCtor = _Constructor<CanDisableRipple> & _AbstractConstructor<CanDisableRipple>;
-
-/**
- * @docs-private
- * @deprecated Will be removed together with `mixinErrorState`.
- * @breaking-change 19.0.0
- */
-export declare interface CanUpdateErrorState {
-    /** Updates the error state based on the provided error state matcher. */
-    updateErrorState(): void;
-    /** Whether the component is in an error state. */
-    errorState: boolean;
-    /** An object used to control the error state of the component. */
-    errorStateMatcher: ErrorStateMatcher_2;
-}
-
-declare type CanUpdateErrorStateCtor = _Constructor<CanUpdateErrorState> & _AbstractConstructor<CanUpdateErrorState>;
-
-
-/** @docs-private */
-export declare type _Constructor<T> = new (...args: any[]) => T;
-
 /**
  * Counts the amount of option group labels that precede the specified option.
  * @param optionIndex Index of the option at which to start counting.
@@ -262,6 +199,42 @@ export declare abstract class DateAdapter<D, L = any> {
      * @returns An invalid date.
      */
     abstract invalid(): D;
+    /**
+     * Sets the time of one date to the time of another.
+     * @param target Date whose time will be set.
+     * @param hours New hours to set on the date object.
+     * @param minutes New minutes to set on the date object.
+     * @param seconds New seconds to set on the date object.
+     */
+    setTime(target: D, hours: number, minutes: number, seconds: number): D;
+    /**
+     * Gets the hours component of the given date.
+     * @param date The date to extract the hours from.
+     */
+    getHours(date: D): number;
+    /**
+     * Gets the minutes component of the given date.
+     * @param date The date to extract the minutes from.
+     */
+    getMinutes(date: D): number;
+    /**
+     * Gets the seconds component of the given date.
+     * @param date The date to extract the seconds from.
+     */
+    getSeconds(date: D): number;
+    /**
+     * Parses a date with a specific time from a user-provided value.
+     * @param value The value to parse.
+     * @param parseFormat The expected format of the value being parsed
+     *     (type is implementation-dependent).
+     */
+    parseTime(value: any, parseFormat: any): D | null;
+    /**
+     * Adds an amount of seconds to the specified date.
+     * @param date Date to which to add the seconds.
+     * @param amount Amount of seconds to add to the date.
+     */
+    addSeconds(date: D, amount: number): D;
     /**
      * Given a potential date object, returns that same date object if it is
      * a valid date, or `null` if it's not a valid date.
@@ -295,6 +268,14 @@ export declare abstract class DateAdapter<D, L = any> {
      *     a number greater than 0 if the first date is later.
      */
     compareDate(first: D, second: D): number;
+    /**
+     * Compares the time values of two dates.
+     * @param first First date to compare.
+     * @param second Second date to compare.
+     * @returns 0 if the times are equal, a number less than 0 if the first time is earlier,
+     *     a number greater than 0 if the first time is later.
+     */
+    compareTime(first: D, second: D): number;
     /**
      * Checks if two dates are equal.
      * @param first The first date to check.
@@ -303,6 +284,14 @@ export declare abstract class DateAdapter<D, L = any> {
      *     Null dates are considered equal to other null dates.
      */
     sameDate(first: D | null, second: D | null): boolean;
+    /**
+     * Checks if the times of two dates are equal.
+     * @param first The first date to check.
+     * @param second The second date to check.
+     * @returns Whether the times of the two dates are equal.
+     *     Null dates are considered equal to other null dates.
+     */
+    sameTime(first: D | null, second: D | null): boolean;
     /**
      * Clamp the given date between min and max dates.
      * @param date The date to clamp.
@@ -362,66 +351,19 @@ export declare class _ErrorStateTracker {
  */
 export declare function _getOptionScrollPosition(optionOffset: number, optionHeight: number, currentScrollPosition: number, panelHeight: number): number;
 
-/** Object that can be used to configure the sanity checks granularly. */
+/**
+ * Object that can be used to configure the sanity checks granularly.
+ * @deprecated No longer used and will be removed.
+ * @breaking-change 21.0.0
+ */
 export declare interface GranularSanityChecks {
     doctype: boolean;
     theme: boolean;
     version: boolean;
 }
 
-/** @docs-private */
-declare interface HasElementRef {
-    _elementRef: ElementRef;
-}
-
-/** @docs-private */
-declare interface HasErrorState {
-    _parentFormGroup: FormGroupDirective | null;
-    _parentForm: NgForm | null;
-    _defaultErrorStateMatcher: ErrorStateMatcher_2;
-    ngControl: NgControl | null;
-    stateChanges: Subject<void>;
-}
-
-/**
- * Mixin that adds an initialized property to a directive which, when subscribed to, will emit a
- * value once markInitialized has been called, which should be done during the ngOnInit function.
- * If the subscription is made after it has already been marked as initialized, then it will trigger
- * an emit immediately.
- * @docs-private
- * @deprecated Will be removed together with `mixinInitializer`.
- * @breaking-change 19.0.0
- */
-export declare interface HasInitialized {
-    /** Stream that emits once during the directive/component's ngOnInit. */
-    initialized: Observable<void>;
-    /**
-     * Sets the state as initialized and must be called during ngOnInit to notify subscribers that
-     * the directive has been initialized.
-     * @docs-private
-     */
-    _markInitialized: () => void;
-}
-
-declare type HasInitializedCtor = _Constructor<HasInitialized>;
-
-/**
- * @docs-private
- * @deprecated Will be removed together with `mixinTabIndex`.
- * @breaking-change 19.0.0
- */
-export declare interface HasTabIndex {
-    /** Tabindex of the component. */
-    tabIndex: number;
-    /** Tabindex to which to fall back to if no value is set. */
-    defaultTabIndex: number;
-}
-
-declare type HasTabIndexCtor = _Constructor<HasTabIndex> & _AbstractConstructor<HasTabIndex>;
-
 declare namespace i1_2 {
     export {
-        MATERIAL_SANITY_CHECKS_FACTORY,
         MATERIAL_SANITY_CHECKS,
         SanityChecks,
         GranularSanityChecks,
@@ -431,6 +373,9 @@ declare namespace i1_2 {
 
 declare namespace i1_3 {
     export {
+        RippleRenderer,
+        RippleTarget,
+        defaultRippleAnimationConfig,
         MatRippleModule,
         RippleGlobalOptions,
         MAT_RIPPLE_GLOBAL_OPTIONS,
@@ -438,10 +383,7 @@ declare namespace i1_3 {
         RippleState,
         RippleConfig,
         RippleAnimationConfig,
-        RippleRef,
-        RippleTarget,
-        defaultRippleAnimationConfig,
-        RippleRenderer
+        RippleRef
     }
 }
 
@@ -512,16 +454,12 @@ export declare const MAT_RIPPLE_GLOBAL_OPTIONS: InjectionToken<RippleGlobalOptio
  * components. This includes Bidi, etc.
  *
  * This module should be imported to each top-level component module (e.g., MatTabsModule).
+ * @deprecated No longer used and will be removed.
+ * @breaking-change 21.0.0
  */
 export declare class MatCommonModule {
-    private _sanityChecks;
-    private _document;
-    /** Whether we've done the global sanity checks (e.g. a theme is loaded, there is a doctype). */
-    private _hasDoneGlobalChecks;
-    constructor(highContrastModeDetector: HighContrastModeDetector, _sanityChecks: SanityChecks, _document: Document);
-    /** Gets whether a specific sanity check is enabled. */
-    private _checkIsEnabled;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatCommonModule, [null, { optional: true; }, null]>;
+    constructor(...args: any[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatCommonModule, never>;
     static ɵmod: i0.ɵɵNgModuleDeclaration<MatCommonModule, never, [typeof i1.BidiModule], [typeof i1.BidiModule]>;
     static ɵinj: i0.ɵɵInjectorDeclaration<MatCommonModule>;
 }
@@ -529,6 +467,7 @@ export declare class MatCommonModule {
 export declare type MatDateFormats = {
     parse: {
         dateInput: any;
+        timeInput?: any;
     };
     display: {
         dateInput: any;
@@ -536,15 +475,18 @@ export declare type MatDateFormats = {
         monthYearLabel: any;
         dateA11yLabel: any;
         monthYearA11yLabel: any;
+        timeInput?: any;
+        timeOptionLabel?: any;
     };
 };
 
-/** Injection token that configures whether the Material sanity checks are enabled. */
+/**
+ * Injection token that configures whether the Material sanity checks are enabled.
+ * @deprecated No longer used and will be removed.
+ * @breaking-change 21.0.0
+ */
 export declare const MATERIAL_SANITY_CHECKS: InjectionToken<SanityChecks>;
 
-/** @docs-private */
-declare function MATERIAL_SANITY_CHECKS_FACTORY(): SanityChecks;
-
 /**
  * Internal shared component used as a container in form field controls.
  * Not to be confused with `mat-form-field` which MDC calls a "text field".
@@ -591,8 +533,8 @@ export declare class MatOptgroup {
     _labelId: string;
     /** Whether the group is in inert a11y mode. */
     _inert: boolean;
-    constructor(parent?: MatOptionParentComponent);
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatOptgroup, [{ optional: true; }]>;
+    constructor(...args: unknown[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatOptgroup, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MatOptgroup, "mat-optgroup", ["matOptgroup"], { "label": { "alias": "label"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, {}, never, ["*", "mat-option, ng-container"], true, never>;
     static ngAcceptInputType_disabled: unknown;
 }
@@ -604,13 +546,14 @@ export declare class MatOption<T = any> implements FocusableOption, AfterViewChe
     private _element;
     _changeDetectorRef: ChangeDetectorRef;
     private _parent;
-    group: MatOptgroup;
+    group: MatOptgroup | null;
+    private _signalDisableRipple;
     private _selected;
     private _active;
     private _disabled;
     private _mostRecentViewValue;
     /** Whether the wrapping component is in multiple selection mode. */
-    get multiple(): boolean | undefined;
+    get multiple(): boolean | null | undefined;
     /** Whether or not the option is currently selected. */
     get selected(): boolean;
     /** The form value of the option. */
@@ -630,7 +573,7 @@ export declare class MatOption<T = any> implements FocusableOption, AfterViewChe
     _text: ElementRef<HTMLElement> | undefined;
     /** Emits when the state of the option changes and any parents have to be notified. */
     readonly _stateChanges: Subject<void>;
-    constructor(_element: ElementRef<HTMLElement>, _changeDetectorRef: ChangeDetectorRef, _parent: MatOptionParentComponent, group: MatOptgroup);
+    constructor(...args: unknown[]);
     /**
      * Whether or not the option is currently active and ready to be selected.
      * An active option displays styles as if it is focused, but the
@@ -678,7 +621,7 @@ export declare class MatOption<T = any> implements FocusableOption, AfterViewChe
     ngOnDestroy(): void;
     /** Emits the selection change event. */
     private _emitSelectionChangeEvent;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatOption<any>, [null, null, { optional: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatOption<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MatOption<any>, "mat-option", ["matOption"], { "value": { "alias": "value"; "required": false; }; "id": { "alias": "id"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "onSelectionChange": "onSelectionChange"; }, never, ["mat-icon", "*"], true, never>;
     static ngAcceptInputType_disabled: unknown;
 }
@@ -695,7 +638,7 @@ export declare class MatOptionModule {
  * @docs-private
  */
 export declare interface MatOptionParentComponent {
-    disableRipple?: boolean;
+    disableRipple?: boolean | Signal<boolean>;
     multiple?: boolean;
     inertGroups?: boolean;
     hideSingleSelectionIndicator?: boolean;
@@ -728,7 +671,7 @@ export declare class MatOptionSelectionChange<T = any> {
  * @docs-private
  */
 export declare class MatPseudoCheckbox {
-    _animationMode?: string | undefined;
+    _animationMode?: "NoopAnimations" | "BrowserAnimations" | null | undefined;
     /** Display state of the checkbox. */
     state: MatPseudoCheckboxState;
     /** Whether the checkbox is disabled. */
@@ -738,8 +681,8 @@ export declare class MatPseudoCheckbox {
      * indicator inside a square box. 'minimal' appearance only renders the checkmark/mixedmark.
      */
     appearance: 'minimal' | 'full';
-    constructor(_animationMode?: string | undefined);
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatPseudoCheckbox, [{ optional: true; }]>;
+    constructor(...args: unknown[]);
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatPseudoCheckbox, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MatPseudoCheckbox, "mat-pseudo-checkbox", never, { "state": { "alias": "state"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "appearance": { "alias": "appearance"; "required": false; }; }, {}, never, never, true, never>;
 }
 
@@ -757,7 +700,7 @@ export declare type MatPseudoCheckboxState = 'unchecked' | 'checked' | 'indeterm
 
 export declare class MatRipple implements OnInit, OnDestroy, RippleTarget {
     private _elementRef;
-    private _animationMode?;
+    private _animationMode;
     /** Custom color for all ripples. */
     color: string;
     /** Whether the ripples should be visible outside the component's bounds. */
@@ -799,7 +742,7 @@ export declare class MatRipple implements OnInit, OnDestroy, RippleTarget {
     private _globalOptions;
     /** @docs-private Whether ripple directive is initialized and the input bindings are set. */
     _isInitialized: boolean;
-    constructor(_elementRef: ElementRef<HTMLElement>, ngZone: NgZone, platform: Platform, globalOptions?: RippleGlobalOptions, _animationMode?: string | undefined);
+    constructor(...args: unknown[]);
     ngOnInit(): void;
     ngOnDestroy(): void;
     /** Fades out all currently showing ripple elements. */
@@ -832,7 +775,7 @@ export declare class MatRipple implements OnInit, OnDestroy, RippleTarget {
      * @param config Optional ripple configuration for the manual ripple.
      */
     launch(x: number, y: number, config?: RippleConfig): RippleRef;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatRipple, [null, null, null, { optional: true; }, { optional: true; }]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatRipple, never>;
     static ɵdir: i0.ɵɵDirectiveDeclaration<MatRipple, "[mat-ripple], [matRipple]", ["matRipple"], { "color": { "alias": "matRippleColor"; "required": false; }; "unbounded": { "alias": "matRippleUnbounded"; "required": false; }; "centered": { "alias": "matRippleCentered"; "required": false; }; "radius": { "alias": "matRippleRadius"; "required": false; }; "animation": { "alias": "matRippleAnimation"; "required": false; }; "disabled": { "alias": "matRippleDisabled"; "required": false; }; "trigger": { "alias": "matRippleTrigger"; "required": false; }; }, {}, never, never, true, never>;
 }
 
@@ -850,6 +793,7 @@ export declare class MatRippleLoader implements OnDestroy {
     private _globalRippleOptions;
     private _platform;
     private _ngZone;
+    private _injector;
     private _hosts;
     constructor();
     ngOnDestroy(): void;
@@ -864,8 +808,6 @@ export declare class MatRippleLoader implements OnDestroy {
         centered?: boolean;
         disabled?: boolean;
     }): void;
-    /** Returns the ripple instance for the given host element. */
-    getRipple(host: HTMLElement): MatRipple | undefined;
     /** Sets the disabled state on the ripple instance corresponding to the given host element. */
     setDisabled(host: HTMLElement, disabled: boolean): void;
     /**
@@ -875,7 +817,6 @@ export declare class MatRippleLoader implements OnDestroy {
     private _onInteraction;
     /** Creates a MatRipple and appends it to the given element. */
     private _createRipple;
-    attachRipple(host: HTMLElement, ripple: MatRipple): void;
     destroyRipple(host: HTMLElement): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<MatRippleLoader, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<MatRippleLoader>;
@@ -887,49 +828,6 @@ export declare class MatRippleModule {
     static ɵinj: i0.ɵɵInjectorDeclaration<MatRippleModule>;
 }
 
-/**
- * Mixin to augment a directive with a `color` property.
- * @deprecated Use a plain input and host bindings instead.
- * @breaking-change 19.0.0
- */
-export declare function mixinColor<T extends _AbstractConstructor<HasElementRef>>(base: T, defaultColor?: ThemePalette): CanColorCtor & T;
-
-/**
- * Mixin to augment a directive with a `disabled` property.
- * @deprecated Use an input with a transform instead.
- * @breaking-change 19.0.0
- */
-export declare function mixinDisabled<T extends _AbstractConstructor<{}>>(base: T): CanDisableCtor & T;
-
-/**
- * Mixin to augment a directive with a `disableRipple` property.
- * @deprecated Use an input with a transform instead.
- * @breaking-change 19.0.0
- */
-export declare function mixinDisableRipple<T extends _AbstractConstructor<{}>>(base: T): CanDisableRippleCtor & T;
-
-/**
- * Mixin to augment a directive with updateErrorState method.
- * For component with `errorState` and need to update `errorState`.
- * @deprecated Implement the `updateErrorState` method directly.
- * @breaking-change 19.0.0
- */
-export declare function mixinErrorState<T extends _AbstractConstructor<HasErrorState>>(base: T): CanUpdateErrorStateCtor & T;
-
-/**
- * Mixin to augment a directive with an initialized property that will emits when ngOnInit ends.
- * @deprecated Track the initialized state manually.
- * @breaking-change 19.0.0
- */
-export declare function mixinInitialized<T extends _Constructor<{}>>(base: T): HasInitializedCtor & T;
-
-/**
- * Mixin to augment a directive with a `tabIndex` property.
- * @deprecated Use an input with a transform instead.
- * @breaking-change 19.0.0
- */
-export declare function mixinTabIndex<T extends _AbstractConstructor<CanDisable>>(base: T, defaultTabIndex?: number): HasTabIndexCtor & T;
-
 /** Adapts the native JS Date for use with cdk-based components that work with dates. */
 export declare class NativeDateAdapter extends DateAdapter<Date> {
     /**
@@ -939,12 +837,7 @@ export declare class NativeDateAdapter extends DateAdapter<Date> {
     useUtcForDisplay: boolean;
     /** The injected locale. */
     private readonly _matDateLocale;
-    constructor(
-    /**
-     * @deprecated Now injected via inject(), param to be removed.
-     * @breaking-change 18.0.0
-     */
-    matDateLocale?: string);
+    constructor(...args: unknown[]);
     getYear(date: Date): number;
     getMonth(date: Date): number;
     getDate(date: Date): number;
@@ -973,6 +866,12 @@ export declare class NativeDateAdapter extends DateAdapter<Date> {
     isDateInstance(obj: any): obj is Date;
     isValid(date: Date): boolean;
     invalid(): Date;
+    setTime(target: Date, hours: number, minutes: number, seconds: number): Date;
+    getHours(date: Date): number;
+    getMinutes(date: Date): number;
+    getSeconds(date: Date): number;
+    parseTime(userValue: any, parseFormat?: any): Date | null;
+    addSeconds(date: Date, amount: number): Date;
     /** Creates a date but allows the month and date to overflow. */
     private _createDateWithOverflow;
     /**
@@ -993,7 +892,12 @@ export declare class NativeDateAdapter extends DateAdapter<Date> {
      * @returns A Date object with its UTC representation based on the passed in date info
      */
     private _format;
-    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateAdapter, [{ optional: true; }]>;
+    /**
+     * Attempts to parse a time string into a date object. Returns null if it cannot be parsed.
+     * @param value Time string to parse.
+     */
+    private _parseTimeString;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NativeDateAdapter, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<NativeDateAdapter>;
 }
 
@@ -1108,7 +1012,7 @@ export declare class RippleRenderer implements EventListenerObject {
      */
     private _containerRect;
     private static _eventManager;
-    constructor(_target: RippleTarget, _ngZone: NgZone, elementOrElementRef: HTMLElement | ElementRef<HTMLElement>, _platform: Platform);
+    constructor(_target: RippleTarget, _ngZone: NgZone, elementOrElementRef: HTMLElement | ElementRef<HTMLElement>, _platform: Platform, injector?: Injector);
     /**
      * Fades in a ripple at the given coordinates.
      * @param x Coordinate within the element, along the X axis at which to start the ripple.
@@ -1173,6 +1077,8 @@ export declare interface RippleTarget {
 /**
  * Possible sanity checks that can be enabled. If set to
  * true/false, all checks will be enabled/disabled.
+ * @deprecated No longer used and will be removed.
+ * @breaking-change 21.0.0
  */
 export declare type SanityChecks = boolean | GranularSanityChecks;
 
@@ -1189,6 +1095,16 @@ export declare class ShowOnDirtyErrorStateMatcher implements ErrorStateMatcher {
     static ɵprov: i0.ɵɵInjectableDeclaration<ShowOnDirtyErrorStateMatcher>;
 }
 
+/**
+ * Component used to load structural styles for focus indicators.
+ * @docs-private
+ */
+export declare class _StructuralStylesLoader {
+    static ɵfac: i0.ɵɵFactoryDeclaration<_StructuralStylesLoader, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<_StructuralStylesLoader, "structural-styles", never, {}, {}, never, never, true, never>;
+}
+
+
 /** Possible color palette values. */
 export declare type ThemePalette = 'primary' | 'accent' | 'warn' | undefined;
 

package/core/option/_optgroup-theme.scss

@@ -10,18 +10,19 @@
 @mixin base($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, base));
+  } @else {
   }
-  @else {}
 }
 
 @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-optgroup.$prefix,
-        tokens-mat-optgroup.get-color-tokens($theme));
+      @include token-utils.create-token-values(
+        tokens-mat-optgroup.$prefix,
+        tokens-mat-optgroup.get-color-tokens($theme)
+      );
     }
   }
 }
@@ -29,11 +30,12 @@
 @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-mat-optgroup.$prefix,
-        tokens-mat-optgroup.get-typography-tokens($theme));
+      @include token-utils.create-token-values(
+        tokens-mat-optgroup.$prefix,
+        tokens-mat-optgroup.get-typography-tokens($theme)
+      );
     }
   }
 }
@@ -41,23 +43,29 @@
 @mixin density($theme) {
   @if inspection.get-theme-version($theme) == 1 {
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, density));
+  } @else {
   }
-  @else {}
 }
 
-@mixin overrides($tokens: ()) {
-  @include token-utils.batch-create-token-values(
-    $tokens,
-    (prefix: tokens-mat-optgroup.$prefix, tokens: tokens-mat-optgroup.get-token-slots()),
+/// Defines the tokens that will be available in the `overrides` mixin and for docs extraction.
+@function _define-overrides() {
+  @return (
+    (
+      namespace: tokens-mat-optgroup.$prefix,
+      tokens: tokens-mat-optgroup.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-optgroup') {
     @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);
@@ -74,9 +82,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-optgroup.$prefix, map.get($tokens, tokens-mat-optgroup.$prefix));
+      tokens-mat-optgroup.$prefix,
+      map.get($tokens, tokens-mat-optgroup.$prefix)
+    );
   }
 }