@angular/material 20.0.0-next.0 → 20.0.0-next.10

package/tooltip/index.d.ts

@@ -1,215 +1,12 @@
-import { AfterViewInit } from '@angular/core';
-import { BooleanInput } from '@angular/cdk/coercion';
-import { ConnectedPosition } from '@angular/cdk/overlay';
-import { Directionality } from '@angular/cdk/bidi';
-import { ElementRef } from '@angular/core';
-import * as i0 from '@angular/core';
-import * as i1 from '@angular/cdk/a11y';
-import * as i2 from '@angular/cdk/overlay';
-import * as i3 from '@angular/material/core';
-import * as i5 from '@angular/cdk/scrolling';
-import { InjectionToken } from '@angular/core';
-import { NumberInput } from '@angular/cdk/coercion';
-import { Observable } from 'rxjs';
-import { OnDestroy } from '@angular/core';
-import { OriginConnectionPosition } from '@angular/cdk/overlay';
-import { Overlay } from '@angular/cdk/overlay';
-import { OverlayConnectionPosition } from '@angular/cdk/overlay';
-import { OverlayRef } from '@angular/cdk/overlay';
-import { ScrollStrategy } from '@angular/cdk/overlay';
-
-/**
- * Creates an error to be thrown if the user supplied an invalid tooltip position.
- * @docs-private
- */
-export declare function getMatTooltipInvalidPositionError(position: string): Error;
-
-declare namespace i4 {
-    export {
-        getMatTooltipInvalidPositionError,
-        MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY,
-        MAT_TOOLTIP_DEFAULT_OPTIONS_FACTORY,
-        TooltipPosition,
-        TooltipTouchGestures,
-        TooltipVisibility,
-        SCROLL_THROTTLE_MS,
-        MAT_TOOLTIP_SCROLL_STRATEGY,
-        MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER,
-        MAT_TOOLTIP_DEFAULT_OPTIONS,
-        MatTooltipDefaultOptions,
-        TOOLTIP_PANEL_CLASS,
-        MatTooltip,
-        TooltipComponent
-    }
-}
-
-/** Injection token to be used to override the default options for `matTooltip`. */
-export declare const MAT_TOOLTIP_DEFAULT_OPTIONS: InjectionToken<MatTooltipDefaultOptions>;
-
-/** @docs-private */
-export declare function MAT_TOOLTIP_DEFAULT_OPTIONS_FACTORY(): MatTooltipDefaultOptions;
-
-/** Injection token that determines the scroll handling while a tooltip is visible. */
-export declare const MAT_TOOLTIP_SCROLL_STRATEGY: InjectionToken<() => ScrollStrategy>;
-
-/** @docs-private */
-export declare function MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY(overlay: Overlay): () => ScrollStrategy;
-
-/** @docs-private */
-export declare const MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER: {
-    provide: InjectionToken<() => ScrollStrategy>;
-    deps: (typeof Overlay)[];
-    useFactory: typeof MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY;
-};
-
-/**
- * Directive that attaches a material design tooltip to the host element. Animates the showing and
- * hiding of a tooltip provided position (defaults to below the element).
- *
- * https://material.io/design/components/tooltips.html
- */
-export declare class MatTooltip implements OnDestroy, AfterViewInit {
-    private _elementRef;
-    private _ngZone;
-    private _platform;
-    private _ariaDescriber;
-    private _focusMonitor;
-    protected _dir: Directionality;
-    private _injector;
-    private _viewContainerRef;
-    private _defaultOptions;
-    _overlayRef: OverlayRef | null;
-    _tooltipInstance: TooltipComponent | null;
-    private _portal;
-    private _position;
-    private _positionAtOrigin;
-    private _disabled;
-    private _tooltipClass;
-    private _viewInitialized;
-    private _pointerExitEventsInitialized;
-    private readonly _tooltipComponent;
-    private _viewportMargin;
-    private _currentPosition;
-    private readonly _cssClassPrefix;
-    private _ariaDescriptionPending;
-    private _dirSubscribed;
-    /** Allows the user to define the position of the tooltip relative to the parent element */
-    get position(): TooltipPosition;
-    set position(value: TooltipPosition);
-    /**
-     * Whether tooltip should be relative to the click or touch origin
-     * instead of outside the element bounding box.
-     */
-    get positionAtOrigin(): boolean;
-    set positionAtOrigin(value: BooleanInput);
-    /** Disables the display of the tooltip. */
-    get disabled(): boolean;
-    set disabled(value: BooleanInput);
-    /** The default delay in ms before showing the tooltip after show is called */
-    get showDelay(): number;
-    set showDelay(value: NumberInput);
-    private _showDelay;
-    /** The default delay in ms before hiding the tooltip after hide is called */
-    get hideDelay(): number;
-    set hideDelay(value: NumberInput);
-    private _hideDelay;
-    /**
-     * How touch gestures should be handled by the tooltip. On touch devices the tooltip directive
-     * uses a long press gesture to show and hide, however it can conflict with the native browser
-     * gestures. To work around the conflict, Angular Material disables native gestures on the
-     * trigger, but that might not be desirable on particular elements (e.g. inputs and draggable
-     * elements). The different values for this option configure the touch event handling as follows:
-     * - `auto` - Enables touch gestures for all elements, but tries to avoid conflicts with native
-     *   browser gestures on particular elements. In particular, it allows text selection on inputs
-     *   and textareas, and preserves the native browser dragging on elements marked as `draggable`.
-     * - `on` - Enables touch gestures for all elements and disables native
-     *   browser gestures with no exceptions.
-     * - `off` - Disables touch gestures. Note that this will prevent the tooltip from
-     *   showing on touch devices.
-     */
-    touchGestures: TooltipTouchGestures;
-    /** The message to be displayed in the tooltip */
-    get message(): string;
-    set message(value: string | null | undefined);
-    private _message;
-    /** Classes to be passed to the tooltip. Supports the same syntax as `ngClass`. */
-    get tooltipClass(): string | string[] | Set<string> | {
-        [key: string]: any;
-    };
-    set tooltipClass(value: string | string[] | Set<string> | {
-        [key: string]: any;
-    });
-    /** Manually-bound passive event listeners. */
-    private readonly _passiveListeners;
-    /** Timer started at the last `touchstart` event. */
-    private _touchstartTimeout;
-    /** Emits when the component is destroyed. */
-    private readonly _destroyed;
-    /** Whether ngOnDestroyed has been called. */
-    private _isDestroyed;
-    constructor(...args: unknown[]);
-    ngAfterViewInit(): void;
-    /**
-     * Dispose the tooltip when destroyed.
-     */
-    ngOnDestroy(): void;
-    /** Shows the tooltip after the delay in ms, defaults to tooltip-delay-show or 0ms if no input */
-    show(delay?: number, origin?: {
-        x: number;
-        y: number;
-    }): void;
-    /** Hides the tooltip after the delay in ms, defaults to tooltip-delay-hide or 0ms if no input */
-    hide(delay?: number): void;
-    /** Shows/hides the tooltip */
-    toggle(origin?: {
-        x: number;
-        y: number;
-    }): void;
-    /** Returns true if the tooltip is currently visible to the user */
-    _isTooltipVisible(): boolean;
-    /** Create the overlay config and position strategy */
-    private _createOverlay;
-    /** Detaches the currently-attached tooltip. */
-    private _detach;
-    /** Updates the position of the current tooltip. */
-    private _updatePosition;
-    /** Adds the configured offset to a position. Used as a hook for child classes. */
-    protected _addOffset(position: ConnectedPosition): ConnectedPosition;
-    /**
-     * Returns the origin position and a fallback position based on the user's position preference.
-     * The fallback position is the inverse of the origin (e.g. `'below' -> 'above'`).
-     */
-    _getOrigin(): {
-        main: OriginConnectionPosition;
-        fallback: OriginConnectionPosition;
-    };
-    /** Returns the overlay position and a fallback position based on the user's preference */
-    _getOverlayPosition(): {
-        main: OverlayConnectionPosition;
-        fallback: OverlayConnectionPosition;
-    };
-    /** Updates the tooltip message and repositions the overlay according to the new message length */
-    private _updateTooltipMessage;
-    /** Updates the tooltip class */
-    private _setTooltipClass;
-    /** Inverts an overlay position. */
-    private _invertPosition;
-    /** Updates the class on the overlay panel based on the current position of the tooltip. */
-    private _updateCurrentPositionClass;
-    /** Binds the pointer events to the tooltip trigger. */
-    private _setupPointerEnterEventsIfNeeded;
-    private _setupPointerExitEventsIfNeeded;
-    private _addListeners;
-    private _platformSupportsMouseEvents;
-    /** Listener for the `wheel` event on the element. */
-    private _wheelListener;
-    /** Disables the native browser gestures, based on how the tooltip has been configured. */
-    private _disableNativeGesturesIfNecessary;
-    /** Updates the tooltip's ARIA description based on it current state. */
-    private _syncAriaDescription;
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatTooltip, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<MatTooltip, "[matTooltip]", ["matTooltip"], { "position": { "alias": "matTooltipPosition"; "required": false; }; "positionAtOrigin": { "alias": "matTooltipPositionAtOrigin"; "required": false; }; "disabled": { "alias": "matTooltipDisabled"; "required": false; }; "showDelay": { "alias": "matTooltipShowDelay"; "required": false; }; "hideDelay": { "alias": "matTooltipHideDelay"; "required": false; }; "touchGestures": { "alias": "matTooltipTouchGestures"; "required": false; }; "message": { "alias": "matTooltip"; "required": false; }; "tooltipClass": { "alias": "matTooltipClass"; "required": false; }; }, {}, never, never, true, never>;
-}
+export { h as MAT_TOOLTIP_DEFAULT_OPTIONS, f as MAT_TOOLTIP_DEFAULT_OPTIONS_FACTORY, c as MAT_TOOLTIP_SCROLL_STRATEGY, d as MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY, e as MAT_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER, k as MatTooltip, i as MatTooltipDefaultOptions, M as MatTooltipModule, S as SCROLL_THROTTLE_MS, j as TOOLTIP_PANEL_CLASS, l as TooltipComponent, T as TooltipPosition, a as TooltipTouchGestures, b as TooltipVisibility, g as getMatTooltipInvalidPositionError } from '../module.d-m-qXd3m8.js';
+import '@angular/core';
+import '@angular/cdk/a11y';
+import '@angular/cdk/overlay';
+import '../common-module.d-C8xzHJDr.js';
+import '@angular/cdk/bidi';
+import '@angular/cdk/coercion';
+import 'rxjs';
+import '@angular/cdk/scrolling';
 
 /**
  * Animations used by MatTooltip.
@@ -217,149 +14,8 @@ export declare class MatTooltip implements OnDestroy, AfterViewInit {
  * @deprecated No longer being used, to be removed.
  * @breaking-change 21.0.0
  */
-export declare const matTooltipAnimations: {
+declare const matTooltipAnimations: {
     readonly tooltipState: any;
 };
 
-/** Default `matTooltip` options that can be overridden. */
-export declare interface MatTooltipDefaultOptions {
-    /** Default delay when the tooltip is shown. */
-    showDelay: number;
-    /** Default delay when the tooltip is hidden. */
-    hideDelay: number;
-    /** Default delay when hiding the tooltip on a touch device. */
-    touchendHideDelay: number;
-    /** Time between the user putting the pointer on a tooltip trigger and the long press event being fired on a touch device. */
-    touchLongPressShowDelay?: number;
-    /** Default touch gesture handling for tooltips. */
-    touchGestures?: TooltipTouchGestures;
-    /** Default position for tooltips. */
-    position?: TooltipPosition;
-    /**
-     * Default value for whether tooltips should be positioned near the click or touch origin
-     * instead of outside the element bounding box.
-     */
-    positionAtOrigin?: boolean;
-    /** Disables the ability for the user to interact with the tooltip element. */
-    disableTooltipInteractivity?: boolean;
-    /**
-     * Default classes to be applied to the tooltip. These default classes will not be applied if
-     * `tooltipClass` is defined directly on the tooltip element, as it will override the default.
-     */
-    tooltipClass?: string | string[];
-}
-
-export declare class MatTooltipModule {
-    static ɵfac: i0.ɵɵFactoryDeclaration<MatTooltipModule, never>;
-    static ɵmod: i0.ɵɵNgModuleDeclaration<MatTooltipModule, never, [typeof i1.A11yModule, typeof i2.OverlayModule, typeof i3.MatCommonModule, typeof i4.MatTooltip, typeof i4.TooltipComponent], [typeof i4.MatTooltip, typeof i4.TooltipComponent, typeof i3.MatCommonModule, typeof i5.CdkScrollableModule]>;
-    static ɵinj: i0.ɵɵInjectorDeclaration<MatTooltipModule>;
-}
-
-/** Time in ms to throttle repositioning after scroll events. */
-export declare const SCROLL_THROTTLE_MS = 20;
-
-/**
- * CSS class that will be attached to the overlay panel.
- * @deprecated
- * @breaking-change 13.0.0 remove this variable
- */
-export declare const TOOLTIP_PANEL_CLASS = "mat-mdc-tooltip-panel";
-
-/**
- * Internal component that wraps the tooltip's content.
- * @docs-private
- */
-export declare class TooltipComponent implements OnDestroy {
-    private _changeDetectorRef;
-    protected _elementRef: ElementRef<HTMLElement>;
-    _isMultiline: boolean;
-    /** Message to display in the tooltip */
-    message: string;
-    /** Classes to be added to the tooltip. Supports the same syntax as `ngClass`. */
-    tooltipClass: string | string[] | Set<string> | {
-        [key: string]: any;
-    };
-    /** The timeout ID of any current timer set to show the tooltip */
-    private _showTimeoutId;
-    /** The timeout ID of any current timer set to hide the tooltip */
-    private _hideTimeoutId;
-    /** Element that caused the tooltip to open. */
-    _triggerElement: HTMLElement;
-    /** Amount of milliseconds to delay the closing sequence. */
-    _mouseLeaveHideDelay: number;
-    /** Whether animations are currently disabled. */
-    private _animationsDisabled;
-    /** Reference to the internal tooltip element. */
-    _tooltip: ElementRef<HTMLElement>;
-    /** Whether interactions on the page should close the tooltip */
-    private _closeOnInteraction;
-    /** Whether the tooltip is currently visible. */
-    private _isVisible;
-    /** Subject for notifying that the tooltip has been hidden from the view */
-    private readonly _onHide;
-    /** Name of the show animation and the class that toggles it. */
-    private readonly _showAnimation;
-    /** Name of the hide animation and the class that toggles it. */
-    private readonly _hideAnimation;
-    constructor(...args: unknown[]);
-    /**
-     * Shows the tooltip with an animation originating from the provided origin
-     * @param delay Amount of milliseconds to the delay showing the tooltip.
-     */
-    show(delay: number): void;
-    /**
-     * Begins the animation to hide the tooltip after the provided delay in ms.
-     * @param delay Amount of milliseconds to delay showing the tooltip.
-     */
-    hide(delay: number): void;
-    /** Returns an observable that notifies when the tooltip has been hidden from view. */
-    afterHidden(): Observable<void>;
-    /** Whether the tooltip is being displayed. */
-    isVisible(): boolean;
-    ngOnDestroy(): void;
-    /**
-     * Interactions on the HTML body should close the tooltip immediately as defined in the
-     * material design spec.
-     * https://material.io/design/components/tooltips.html#behavior
-     */
-    _handleBodyInteraction(): void;
-    /**
-     * Marks that the tooltip needs to be checked in the next change detection run.
-     * Mainly used for rendering the initial text before positioning a tooltip, which
-     * can be problematic in components with OnPush change detection.
-     */
-    _markForCheck(): void;
-    _handleMouseLeave({ relatedTarget }: MouseEvent): void;
-    /**
-     * Callback for when the timeout in this.show() gets completed.
-     * This method is only needed by the mdc-tooltip, and so it is only implemented
-     * in the mdc-tooltip, not here.
-     */
-    protected _onShow(): void;
-    /** Whether the tooltip text has overflown to the next line */
-    private _isTooltipMultiline;
-    /** Event listener dispatched when an animation on the tooltip finishes. */
-    _handleAnimationEnd({ animationName }: AnimationEvent): void;
-    /** Cancels any pending animation sequences. */
-    _cancelPendingAnimations(): void;
-    /** Handles the cleanup after an animation has finished. */
-    private _finalizeAnimation;
-    /** Toggles the visibility of the tooltip element. */
-    private _toggleVisibility;
-    static ɵfac: i0.ɵɵFactoryDeclaration<TooltipComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<TooltipComponent, "mat-tooltip-component", never, {}, {}, never, never, true, never>;
-}
-
-/** Possible positions for a tooltip. */
-export declare type TooltipPosition = 'left' | 'right' | 'above' | 'below' | 'before' | 'after';
-
-/**
- * Options for how the tooltip trigger should handle touch gestures.
- * See `MatTooltip.touchGestures` for more information.
- */
-export declare type TooltipTouchGestures = 'auto' | 'on' | 'off';
-
-/** Possible visibility states of a tooltip. */
-export declare type TooltipVisibility = 'initial' | 'visible' | 'hidden';
-
-export { }
+export { matTooltipAnimations };

package/tooltip/testing/index.d.ts

@@ -1,10 +1,11 @@
-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 { BaseHarnessFilters, ComponentHarness, ComponentHarnessConstructor, HarnessPredicate } from '@angular/cdk/testing';
+
+/** A set of criteria that can be used to filter a list of `MatTooltipHarness` instances. */
+interface TooltipHarnessFilters extends BaseHarnessFilters {
+}
 
 /** Harness for interacting with a mat-tooltip in tests. */
-export declare class MatTooltipHarness extends ComponentHarness {
+declare class MatTooltipHarness extends ComponentHarness {
     static hostSelector: string;
     private _optionalPanel;
     private _hiddenClass;
@@ -30,8 +31,5 @@ export declare class MatTooltipHarness extends ComponentHarness {
     getTooltipText(): Promise<string>;
 }
 
-/** A set of criteria that can be used to filter a list of `MatTooltipHarness` instances. */
-export declare interface TooltipHarnessFilters extends BaseHarnessFilters {
-}
-
-export { }
+export { MatTooltipHarness };
+export type { TooltipHarnessFilters };

package/{core/tokens/m2/mat/_tree.scss → tree/_m2-tree.scss}

@@ -1,8 +1,8 @@
 @use 'sass:map';
-@use '../../token-definition';
-@use '../../../theming/theming';
-@use '../../../theming/inspection';
-@use '../../../style/sass-utils';
+@use '../core/tokens/m2-utils';
+@use '../core/theming/theming';
+@use '../core/theming/inspection';
+@use '../core/style/sass-utils';
 
 // The prefix used to generate the fully qualified name for tokens in this file.
 $prefix: (mat, tree);
@@ -55,8 +55,8 @@ $prefix: (mat, tree);
 @function get-token-slots() {
   @return sass-utils.deep-merge-all(
       get-unthemable-tokens(),
-      get-color-tokens(token-definition.$placeholder-color-config),
-      get-typography-tokens(token-definition.$placeholder-typography-config),
-      get-density-tokens(token-definition.$placeholder-density-config)
+      get-color-tokens(m2-utils.$placeholder-color-config),
+      get-typography-tokens(m2-utils.$placeholder-typography-config),
+      get-density-tokens(m2-utils.$placeholder-density-config)
   );
 }

package/{core/tokens/m3/mat/_tree.scss → tree/_m3-tree.scss}

@@ -1,5 +1,8 @@
 @use 'sass:map';
-@use '../../token-definition';
+@use 'sass:list';
+@use '../core/tokens/m3-utils';
+@use '../core/theming/theming';
+@use '../core/theming/inspection';
 
 // The prefix used to generate the fully qualified name for tokens in this file.
 $prefix: (mat, tree);
@@ -18,5 +21,15 @@ $prefix: (mat, tree);
     node-text-weight: map.get($systems, md-sys-typescale, body-large-weight),
   );
 
-  @return token-definition.namespace-tokens($prefix, $tokens, $token-slots);
+  @return m3-utils.namespace($prefix, $tokens, $token-slots);
+}
+
+// Tokens that can be configured through Angular Material's density theming API.
+@function get-density-tokens($theme) {
+  $scale: theming.clamp-density(inspection.get-theme-density($theme), -4);
+  $index: ($scale * -1) + 1;
+
+  @return (
+    node-min-height: list.nth((48px, 44px, 40px, 36px, 28px), $index),
+  );
 }

package/tree/_tree-theme.scss

@@ -5,7 +5,8 @@
 @use '../core/typography/typography';
 @use '../core/style/sass-utils';
 @use '../core/tokens/token-utils';
-@use '../core/tokens/m2/mat/tree' as tokens-mat-tree;
+@use './m2-tree';
+@use './m3-tree';
 
 @mixin base($theme) {
   @if inspection.get-theme-version($theme) == 1 {
@@ -19,9 +20,9 @@
     @include _theme-from-tokens(inspection.get-theme-tokens($theme, color));
   } @else {
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(
-        tokens-mat-tree.$prefix,
-        tokens-mat-tree.get-color-tokens($theme)
+      @include token-utils.create-token-values-mixed(
+        m2-tree.$prefix,
+        m2-tree.get-color-tokens($theme)
       );
     }
   }
@@ -35,9 +36,9 @@
     $theme: inspection.private-get-typography-back-compat-theme($theme);
 
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(
-        tokens-mat-tree.$prefix,
-        tokens-mat-tree.get-typography-tokens($theme)
+      @include token-utils.create-token-values-mixed(
+        m2-tree.$prefix,
+        m2-tree.get-typography-tokens($theme)
       );
     }
   }
@@ -45,14 +46,14 @@
 
 @mixin density($theme) {
   @if inspection.get-theme-version($theme) == 1 {
-    @include _theme-from-tokens(inspection.get-theme-tokens($theme, density));
+    @include token-utils.create-token-values(m3-tree.$prefix, m3-tree.get-density-tokens($theme));
   } @else {
     $density-scale: inspection.get-theme-density($theme);
 
     @include sass-utils.current-selector-or-root() {
-      @include token-utils.create-token-values(
-        tokens-mat-tree.$prefix,
-        tokens-mat-tree.get-density-tokens($theme)
+      @include token-utils.create-token-values-mixed(
+        m2-tree.$prefix,
+        m2-tree.get-density-tokens($theme)
       );
     }
   }
@@ -62,8 +63,8 @@
 @function _define-overrides() {
   @return (
     (
-      namespace: tokens-mat-tree.$prefix,
-      tokens: tokens-mat-tree.get-token-slots(),
+      namespace: m2-tree.$prefix,
+      tokens: m2-tree.get-token-slots(),
     ),
   );
 }
@@ -76,6 +77,9 @@
   @include theming.private-check-duplicate-theme-styles($theme, 'mat-tree') {
     @if inspection.get-theme-version($theme) == 1 {
       @include _theme-from-tokens(inspection.get-theme-tokens($theme));
+      @if inspection.theme-has($theme, density) {
+        @include density($theme);
+      }
     } @else {
       @include base($theme);
       @if inspection.theme-has($theme, color) {
@@ -97,8 +101,8 @@
   );
   @if ($tokens != ()) {
     @include token-utils.create-token-values(
-      tokens-mat-tree.$prefix,
-      map.get($tokens, tokens-mat-tree.$prefix)
+      m2-tree.$prefix,
+      map.get($tokens, m2-tree.$prefix)
     );
   }
 }