mtrl 0.10.5 → 0.10.7

package/dist/components/progress/types.d.ts

@@ -135,15 +135,37 @@ export interface ProgressEvents {
 export interface ProgressComponent {
     /** The component's root DOM element */
     element: HTMLElement;
-    /** The track element (unfilled part) - always an SVG element */
+    /**
+     * The track element (unfilled part) - always an SVG element
+     * @deprecated Internal in `material` 3.0.0 and off the public type; no replacement: it
+     * was never meant to be driven from outside. It named a part of the SVG the canvas
+     * replaced.
+     */
     track: SVGElement;
-    /** The indicator element (filled part) - always an SVG element */
+    /**
+     * The indicator element (filled part) - always an SVG element
+     * @deprecated Internal in `material` 3.0.0 and off the public type; no replacement: it
+     * was never meant to be driven from outside. It named a part of the SVG the canvas
+     * replaced.
+     */
     indicator: SVGElement;
-    /** The canvas the indicator is drawn on */
+    /**
+     * The canvas the indicator is drawn on
+     * @deprecated Internal in `material` 3.0.0 and off the public type; the canvas is the
+     * element's own: `progress.element.querySelector('canvas')`.
+     */
     canvas?: HTMLCanvasElement;
-    /** Re-measures the canvas and redraws; the component does this on resize */
+    /**
+     * Re-measures the canvas and redraws; the component does this on resize
+     * @deprecated Internal in `material` 3.0.0 and off the public type; no replacement: the
+     * component observes its own size and redraws itself.
+     */
     resize?: () => void;
-    /** The buffer element for linear variant (pre-loaded state) - always an SVG element */
+    /**
+     * The buffer element for linear variant (pre-loaded state) - always an SVG element
+     * @deprecated Internal in `material` 3.0.0 and off the public type; the buffer's value
+     * is set with `setBuffer()` and read with `getBuffer()`.
+     */
     buffer?: SVGElement;
     /**
      * Gets a class name with the component's prefix

package/dist/components/radios/constants.d.ts

@@ -69,13 +69,13 @@ export declare const RADIO_EVENTS: {
  * Default configuration values
  */
 export declare const RADIO_DEFAULTS: {
-    /** Default radio variant */
+    /** @deprecated The radios have no variant option; nothing reads this. Removed in `material` 3.0.0. */
     readonly VARIANT: "standard";
     /** Default radio direction */
     readonly DIRECTION: "vertical";
-    /** Default label position */
+    /** @deprecated The radios have no label position option; nothing reads this. Removed in `material` 3.0.0. */
     readonly LABEL_POSITION: "right";
-    /** Default radio size */
+    /** @deprecated The radios have no size option; nothing reads this. Removed in `material` 3.0.0. */
     readonly SIZE: "medium";
 };
 /**

package/dist/components/radios/types.d.ts

@@ -101,7 +101,10 @@ export interface RadioItem {
 }
 /** Selection or unknown-value clearing reported by the radio group. */
 export interface RadiosChangePayload {
-    /** Selected value, or an empty string when an unknown value clears selection. */
+    /**
+     * Selected value, or an empty string when an unknown value clears selection.
+     * In `material` 3.0.0 that is `null`, as the select and `<m-radios>` report it.
+     */
     value: string;
     /** Native input change event; undefined for programmatic clearing. */
     originalEvent: Event | undefined;
@@ -133,12 +136,14 @@ export interface RadiosComponent {
      */
     getClass: (name: string) => string;
     /**
-     * Gets the radios component name
+     * Gets the radios component name.
+     * In `material` 3.0.0 it returns `null`, not an empty string, when nothing is selected.
      * @returns Selected radio value or empty string if none selected
      */
     getValue: () => string;
     /**
-     * Sets the radios component value (selects a radio)
+     * Sets the radios component value (selects a radio).
+     * In `material` 3.0.0 it also accepts `null`, which clears the selection.
      * @param value - Value to select
      * @returns The radios component for chaining
      */

package/dist/components/search/features/suggestions.js

@@ -154,10 +154,7 @@ export const withSuggestions = () => (component) => {
             if (newItem) {
                 newItem.classList.add(getClass(SEARCH_CLASSES.SUGGESTION_ITEM_SELECTED));
                 newItem.setAttribute("aria-selected", "true");
-                newItem.scrollIntoView({
-                    block: "nearest",
-                    behavior: "smooth",
-                });
+                newItem.scrollIntoView({ block: "nearest" });
             }
         }
     };

package/dist/components/search/types.d.ts

@@ -116,17 +116,17 @@ export interface SearchConfig {
     class?: string;
     /** Component prefix for class names */
     prefix?: string;
-    /** Called when search is submitted */
+    /** Called when search is submitted. In `material` 3.0.0 it receives the `SearchEvent` a `submit` listener receives: read `event.value`. */
     onSubmit?: (value: string) => void;
-    /** Called when input value changes */
+    /** Called when input value changes. In `material` 3.0.0 it receives the `SearchEvent` an `input` listener receives: read `event.value`. */
     onInput?: (value: string) => void;
-    /** Called when search is cleared */
+    /** Called when search is cleared. In `material` 3.0.0 it receives the `SearchEvent` a `clear` listener receives. */
     onClear?: () => void;
-    /** Called when view expands */
+    /** Called when view expands. In `material` 3.0.0 it receives the object an `expand` listener receives. */
     onExpand?: () => void;
-    /** Called when view collapses */
+    /** Called when view collapses. In `material` 3.0.0 it receives the object a `collapse` listener receives. */
     onCollapse?: () => void;
-    /** Called when a suggestion is selected */
+    /** Called when a suggestion is selected. In `material` 3.0.0 it receives the `SearchEvent`: the suggestion is `event.suggestion`. */
     onSuggestionSelect?: (suggestion: SearchSuggestion) => void;
     /** Event handlers map */
     on?: Partial<Record<SearchEventType, (event: SearchEvent) => void>>;
@@ -190,7 +190,13 @@ export interface SearchComponent {
     disable: () => SearchComponent;
     /** Checks if the component is disabled */
     isDisabled: () => boolean;
-    /** Adds an event listener */
+    /**
+     * Adds an event listener
+     * In `material` 3.0.0 an `expand` or `collapse` listener is typed with what those events
+     * carry, `{ component, state, viewMode }` (`SearchStateEvent`): `event.value`
+     * and `event.preventDefault()` there become type errors (they are
+     * `undefined` and not a function at run time today).
+     */
     on: (event: SearchEventType, handler: (event: SearchEvent) => void) => SearchComponent;
     /** Removes an event listener */
     off: (event: SearchEventType, handler: (event: SearchEvent) => void) => SearchComponent;

package/dist/components/select/constants.d.ts

@@ -80,7 +80,7 @@ export declare const SELECT_DEFAULTS: {
 export declare const SELECT_CLASSES: {
     /** Container element */
     readonly CONTAINER: "select";
-    /** @deprecated Renamed `TEXT_FIELD` in 1.0 (FLO-383); the class stays `select__textfield`. */
+    /** @deprecated Renamed `TEXT_FIELD` in `material` 3.0.0 (FLO-383), and its class becomes `select__text-field`. */
     readonly TEXTFIELD: "select__textfield";
     /** Dropdown icon */
     readonly DROPDOWN_ICON: "select__dropdown-icon";

package/dist/components/select/types.d.ts

@@ -160,12 +160,14 @@ export interface SelectComponent {
     element: HTMLElement;
     /**
      * The textfield component
-     * @deprecated Renamed `textField` in 1.0 (FLO-383); `textfield` remains as an alias through
-     * 1.x.
+     * @deprecated Renamed `textField` in `material` 3.0.0 (FLO-383), where `select.textfield` is `undefined`.
+     * 0.10.x has no `textField`, so rename it when you upgrade.
      */
     textfield: TextfieldComponent;
     /**
      * The menu component
+     * @deprecated Removed in `material` 3.0.0. Use the select's own methods and events: `open()`,
+     * `close()`, `isOpen()`, `getOptions()`, `setOptions()`, and `open`, `close` and `change`.
      */
     menu: MenuComponent;
     /**
@@ -284,6 +286,8 @@ export interface SelectEvent {
     originalEvent?: Event;
     /**
      * Function to prevent default behavior
+     * In `material` 3.0.0 the select's `open`, `close` and `change` payloads have no
+     * `preventDefault` and no `defaultPrevented`: these events cannot be cancelled.
      */
     preventDefault: () => void;
     /**

package/dist/components/side-sheet/types.d.ts

@@ -55,6 +55,8 @@ export interface SideSheetConfig {
     closeOnScrimClick?: boolean;
     /**
      * Whether Escape closes it.
+     * A limit on 0.10.x, fixed in `material` 3.0.0: with `layer: "top"` and this option
+     * `false`, the third Escape still closes a modal sheet.
      * @default true
      */
     closeOnEscape?: boolean;

package/dist/components/slider/types.d.ts

@@ -167,6 +167,13 @@ export interface SliderStateComponent {
     valueBubble?: HTMLElement | null;
     secondHandle?: HTMLElement | null;
     secondValueBubble?: HTMLElement | null;
+    /**
+     * The older bag the same elements were kept in
+     * @deprecated Internal in `material` 3.0.0 and outside the public contract: nothing in
+     * the library fills it, it may go in any release, and `SliderComponent` has no
+     * `components`. Use the slider's own API (`setValue()`, `getValue()` and the rest of
+     * `SliderComponent`) and `slider.element`.
+     */
     components?: Record<string, HTMLElement | null | undefined>;
     getClass: (name: string) => string;
     emit: (event: string, data: unknown) => unknown;

package/dist/components/snackbar/types.d.ts

@@ -129,7 +129,12 @@ export interface SnackbarConfig {
 export interface SnackbarComponent {
     /** The root element of the snackbar */
     element: HTMLElement;
-    /** Current state of the snackbar */
+    /**
+     * Current state of the snackbar
+     * In `material` 3.0.0 a snackbar shown behind another is `"queued"` until its turn, then
+     * `"visible"` with `open` (today it says `"visible"` while it waits). `material` 3.0.0
+     * adds `isOpen()`, true only while it is on screen.
+     */
     state: SnackbarState;
     /** The action button element (if present) */
     actionButton?: HTMLElement;
@@ -137,9 +142,19 @@ export interface SnackbarComponent {
     closeButton?: HTMLElement;
     /** Timer for auto-dismissal */
     timer?: SnackbarTimer;
-    /** Displays the snackbar */
+    /**
+     * Displays the snackbar
+     * A limit on 0.10.x, fixed in `material` 3.0.0: a snackbar still waiting behind another
+     * when a `queueBehavior: 'replace'` snackbar or `clearSnackbars()` drops it
+     * keeps `state` `"visible"`, and `show()` on it does nothing from then on.
+     * Create a new snackbar instead of showing that one again.
+     */
     show: () => SnackbarComponent;
-    /** Hides the snackbar */
+    /**
+     * Hides the snackbar
+     * In `material` 3.0.0 `hide()` on a snackbar still waiting behind another takes it out of
+     * the queue and emits nothing (today it emits `close` and `dismiss`).
+     */
     hide: () => SnackbarComponent;
     /** Sets the message text */
     setMessage: (message: string) => SnackbarComponent;

package/dist/components/split-button/types.d.ts

@@ -84,7 +84,12 @@ export interface SplitButtonComponent {
     leadingElement: HTMLButtonElement;
     /** The trailing button's element */
     trailingElement: HTMLButtonElement;
-    /** The menu, when the component was given items */
+    /**
+     * The menu, when the component was given items
+     * @deprecated Removed in `material` 3.0.0. Use the split button's own methods and events: `expand()`,
+     * `collapse()`, `isExpanded()`, and `expand`, `collapse` and `select`. `material` 3.0.0 adds
+     * `setItems()` and `getItems()` for what `menu.setItems()` does today.
+     */
     menu?: MenuComponent;
     /** Sets the leading button's label */
     setText: (text: string) => SplitButtonComponent;

package/dist/components/switch/index.d.ts

@@ -2,8 +2,8 @@ export { default } from "./switch.js";
 export { SWITCH_LABEL_POSITIONS, SWITCH_STATES, SWITCH_EVENTS, SWITCH_DEFAULTS, SWITCH_CLASSES } from "./constants.js";
 export type { SwitchConfig, SwitchComponent, SwitchEvents, SwitchChangePayload } from "./types.js";
 export { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/switch in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/switch in `material` 3.0.0 (FLO-381). */
 withSupportingText, } from "./features.js";
 export type { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/switch in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/switch in `material` 3.0.0 (FLO-381). */
 SupportingTextComponent, } from "./features.js";

package/dist/components/tabs/index.d.ts

@@ -7,39 +7,39 @@ import { updateTabPanels, setupKeyboardNavigation } from "./utils.js";
 export { TAB_VARIANTS, TAB_STATES, TAB_INDICATOR_WIDTH_STRATEGIES, TAB_EVENTS, TABS_EVENTS, TABS_DEFAULTS, TABS_CLASSES, TAB_CLASSES, } from "./constants.js";
 export type { TabsConfig, TabsComponent, TabComponent, TabConfig, TabChangeEventData, IndicatorConfig, } from "./types.js";
 export { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 addScrollIndicators, setupResponsiveBehavior, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 createTabsState, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 createTabIndicator, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 updateTabPanels, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 setupKeyboardNavigation, };
 export { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 withTabsManagement, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 withScrollable, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 withDivider, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 withIndicator, } from "./features.js";
 export type { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 TabsManagementConfig, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 TabsManagementComponent, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 ScrollableConfig, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 ScrollableComponent, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 DividerConfig, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 IndicatorFeatureConfig, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/tabs in `material` 3.0.0 (FLO-381). */
 IndicatorComponent, } from "./features.js";
 export default createTabs;
 export { createTab } from "./tab.js";

package/dist/components/tabs/scroll-indicators.js

@@ -26,16 +26,10 @@ export const addScrollIndicators = (tabs, config = {}) => {
         tabs.element.appendChild(leftButton);
         tabs.element.appendChild(rightButton);
         leftButton.addEventListener('click', () => {
-            scrollContainer.scrollBy({
-                left: -100,
-                behavior: 'smooth'
-            });
+            scrollContainer.scrollBy({ left: -100 });
         });
         rightButton.addEventListener('click', () => {
-            scrollContainer.scrollBy({
-                left: 100,
-                behavior: 'smooth'
-            });
+            scrollContainer.scrollBy({ left: 100 });
         });
     }
     const updateIndicators = () => {

package/dist/components/tabs/types.d.ts

@@ -281,7 +281,11 @@ export interface TabComponent {
     element: HTMLElement;
     /** The button the tab is built on */
     button?: TabButton;
-    /** The tab's badge component (if any) */
+    /**
+     * The tab's badge component (if any). In `material` 3.0.0 it may be `undefined` until
+     * the badge is shown: read it with a guard, or use `setBadge()`, `getBadge()`,
+     * `showBadge()` and `hideBadge()`, which work whether it exists yet or not.
+     */
     badge?: BadgeComponent;
     /** Gets a class name with the component's prefix */
     getClass: (name: string) => string;
@@ -407,7 +411,7 @@ export interface TabsComponent {
      */
     off(event: string, handler: Function): this;
     /**
-     * Emit an event
+     * Emit an event. In `material` 3.0.0, `emit` accepts only the tabs' own events.
      * @param event - Event name
      * @param data - Event data
      * @returns Tabs component for chaining

package/dist/components/textfield/constants.d.ts

@@ -98,6 +98,9 @@ declare const TEXTFIELD_DEFAULTS: {
 };
 /**
  * CSS class names used by the textfield component
+ * In `material` 3.0.0 the classes are written `text-field` (`mtrl-text-field`,
+ * `mtrl-text-field__input`, …): page CSS and `classList` calls that keep
+ * `mtrl-textfield` then match nothing, and nothing warns.
  * @category Components
  */
 declare const TEXTFIELD_CLASSES: {
@@ -155,17 +158,17 @@ declare const TEXTFIELD_CLASSES: {
     readonly MULTILINE: "textfield--multiline";
 };
 export { TEXTFIELD_VARIANTS as TEXT_FIELD_VARIANTS, TEXTFIELD_STATES as TEXT_FIELD_STATES, TEXTFIELD_TYPES as TEXT_FIELD_TYPES, TEXTFIELD_EVENTS as TEXT_FIELD_EVENTS, TEXTFIELD_DENSITY as TEXT_FIELD_DENSITY, TEXTFIELD_DEFAULTS as TEXT_FIELD_DEFAULTS, TEXTFIELD_CLASSES as TEXT_FIELD_CLASSES, 
-/** @deprecated Use TEXT_FIELD_VARIANTS: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_VARIANTS: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_VARIANTS, 
-/** @deprecated Use TEXT_FIELD_STATES: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_STATES: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_STATES, 
-/** @deprecated Use TEXT_FIELD_TYPES: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_TYPES: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_TYPES, 
-/** @deprecated Use TEXT_FIELD_EVENTS: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_EVENTS: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_EVENTS, 
-/** @deprecated Use TEXT_FIELD_DENSITY: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_DENSITY: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_DENSITY, 
-/** @deprecated Use TEXT_FIELD_DEFAULTS: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_DEFAULTS: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_DEFAULTS, 
-/** @deprecated Use TEXT_FIELD_CLASSES: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TEXT_FIELD_CLASSES: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TEXTFIELD_CLASSES, };

package/dist/components/textfield/index.d.ts

@@ -1,17 +1,17 @@
 export { default } from "./textfield.js";
 export { default as createTextField } from "./textfield.js";
 export type { TextfieldConfig as TextFieldConfig, TextfieldComponent as TextFieldComponent, 
-/** @deprecated Use TextFieldConfig: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldConfig: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldConfig, 
-/** @deprecated Use TextFieldComponent: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldComponent: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldComponent, TextfieldDensity as TextFieldDensity, TextfieldEvents as TextFieldEvents, TextfieldValuePayload as TextFieldValuePayload, TextfieldFocusPayload as TextFieldFocusPayload, TextfieldTrailingPayload as TextFieldTrailingPayload, 
-/** @deprecated Use TextFieldDensity: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldDensity: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldDensity, 
-/** @deprecated Use TextFieldEvents: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldEvents: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldEvents, 
-/** @deprecated Use TextFieldValuePayload: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldValuePayload: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldValuePayload, 
-/** @deprecated Use TextFieldFocusPayload: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldFocusPayload: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldFocusPayload, 
-/** @deprecated Use TextFieldTrailingPayload: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TextFieldTrailingPayload: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 TextfieldTrailingPayload, } from "./types.js";

package/dist/components/textfield/types.d.ts

@@ -289,6 +289,7 @@ export interface BaseComponent {
  */
 declare module "../../core/config/global" {
     interface ComponentConfigMap {
+        /** In `material` 3.0.0 this defaults key is `'text-field'`: `setComponentDefaults('text-field', …)`. */
         textfield?: Partial<TextfieldConfig>;
     }
 }

package/dist/components/timepicker/constants.d.ts

@@ -192,7 +192,7 @@ export declare const TIMEPICKER_DEFAULTS: {
     readonly CANCEL_TEXT: "Cancel";
     /** Default confirm button text */
     readonly CONFIRM_TEXT: "OK";
-    /** Whether picker is initially open */
+    /** Whether picker is initially open. In `material` 3.0.0 this key is `OPEN`, with the option renamed `open`. */
     readonly IS_OPEN: false;
     /** Default clock icon */
     readonly CLOCK_ICON: "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"24\" height=\"24\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n    <circle cx=\"12\" cy=\"12\" r=\"10\"></circle>\n    <polyline points=\"12 6 12 12 16 14\"></polyline>\n  </svg>";

package/dist/components/timepicker/types.d.ts

@@ -182,6 +182,8 @@ export interface TimePickerConfig {
     confirmText?: string;
     /**
      * Whether the time picker is initially visible (for inline mode)
+     * In `material` 3.0.0 this option is named `open`, and the picker is open when its
+     * factory returns (today it opens on a 0 ms timer).
      * @default false
      */
     isOpen?: boolean;
@@ -222,7 +224,8 @@ export interface TimePickerConfig {
      */
     onClose?: () => void;
     /**
-     * Callback when time is confirmed; receives the same 24-hour value as getValue()
+     * Callback when time is confirmed; receives the same 24-hour value as getValue().
+     * In `material` 3.0.0 it receives `{ value }`, the object a `confirm` listener receives.
      */
     onConfirm?: (time: string) => void;
     /**
@@ -269,7 +272,7 @@ export interface TimePickerComponent {
     modalElement: HTMLElement;
     /** Dialog container element */
     dialogElement: HTMLElement;
-    /** Whether the time picker is currently open */
+    /** Whether the time picker is currently open. In `material` 3.0.0 it is a method: `isOpen()`. */
     isOpen: boolean;
     /**
      * Opens the time picker

package/dist/components/tooltip/api.js

@@ -39,7 +39,9 @@ export const withAPI = ({ lifecycle }) => (component) => {
     const calculatePosition = () => {
         if (!target)
             return { top: 0, left: 0 };
-        const tooltipRect = component.element.getBoundingClientRect();
+        component.element.style.left = "0px";
+        const tooltipWidth = component.element.offsetWidth;
+        const tooltipHeight = component.element.offsetHeight;
         const targetRect = target.getBoundingClientRect();
         const scrollY = topLayer ? 0 : window.scrollY || window.pageYOffset;
         const scrollX = topLayer ? 0 : window.scrollX || window.pageXOffset;
@@ -49,23 +51,23 @@ export const withAPI = ({ lifecycle }) => (component) => {
         let arrowPosition;
         switch (position) {
             case TOOLTIP_POSITIONS.TOP:
-                top = targetRect.top + scrollY - tooltipRect.height - offset;
+                top = targetRect.top + scrollY - tooltipHeight - offset;
                 left =
                     targetRect.left +
                         scrollX +
                         targetRect.width / 2 -
-                        tooltipRect.width / 2;
+                        tooltipWidth / 2;
                 arrowPosition = "bottom";
                 break;
             case TOOLTIP_POSITIONS.TOP_START:
-                top = targetRect.top + scrollY - tooltipRect.height - offset;
+                top = targetRect.top + scrollY - tooltipHeight - offset;
                 left = targetRect.left + scrollX;
                 arrowPosition = "bottom-start";
                 break;
             case TOOLTIP_POSITIONS.TOP_END:
-                top = targetRect.top + scrollY - tooltipRect.height - offset;
+                top = targetRect.top + scrollY - tooltipHeight - offset;
                 left =
-                    targetRect.left + scrollX + targetRect.width - tooltipRect.width;
+                    targetRect.left + scrollX + targetRect.width - tooltipWidth;
                 arrowPosition = "bottom-end";
                 break;
             case TOOLTIP_POSITIONS.RIGHT:
@@ -73,7 +75,7 @@ export const withAPI = ({ lifecycle }) => (component) => {
                     targetRect.top +
                         scrollY +
                         targetRect.height / 2 -
-                        tooltipRect.height / 2;
+                        tooltipHeight / 2;
                 left = targetRect.left + scrollX + targetRect.width + offset;
                 arrowPosition = "left";
                 break;
@@ -84,7 +86,7 @@ export const withAPI = ({ lifecycle }) => (component) => {
                 break;
             case TOOLTIP_POSITIONS.RIGHT_END:
                 top =
-                    targetRect.top + scrollY + targetRect.height - tooltipRect.height;
+                    targetRect.top + scrollY + targetRect.height - tooltipHeight;
                 left = targetRect.left + scrollX + targetRect.width + offset;
                 arrowPosition = "left-end";
                 break;
@@ -94,7 +96,7 @@ export const withAPI = ({ lifecycle }) => (component) => {
                     targetRect.left +
                         scrollX +
                         targetRect.width / 2 -
-                        tooltipRect.width / 2;
+                        tooltipWidth / 2;
                 arrowPosition = "top";
                 break;
             case TOOLTIP_POSITIONS.BOTTOM_START:
@@ -105,7 +107,7 @@ export const withAPI = ({ lifecycle }) => (component) => {
             case TOOLTIP_POSITIONS.BOTTOM_END:
                 top = targetRect.top + scrollY + targetRect.height + offset;
                 left =
-                    targetRect.left + scrollX + targetRect.width - tooltipRect.width;
+                    targetRect.left + scrollX + targetRect.width - tooltipWidth;
                 arrowPosition = "top-end";
                 break;
             case TOOLTIP_POSITIONS.LEFT:
@@ -113,19 +115,19 @@ export const withAPI = ({ lifecycle }) => (component) => {
                     targetRect.top +
                         scrollY +
                         targetRect.height / 2 -
-                        tooltipRect.height / 2;
-                left = targetRect.left + scrollX - tooltipRect.width - offset;
+                        tooltipHeight / 2;
+                left = targetRect.left + scrollX - tooltipWidth - offset;
                 arrowPosition = "right";
                 break;
             case TOOLTIP_POSITIONS.LEFT_START:
                 top = targetRect.top + scrollY;
-                left = targetRect.left + scrollX - tooltipRect.width - offset;
+                left = targetRect.left + scrollX - tooltipWidth - offset;
                 arrowPosition = "right-start";
                 break;
             case TOOLTIP_POSITIONS.LEFT_END:
                 top =
-                    targetRect.top + scrollY + targetRect.height - tooltipRect.height;
-                left = targetRect.left + scrollX - tooltipRect.width - offset;
+                    targetRect.top + scrollY + targetRect.height - tooltipHeight;
+                left = targetRect.left + scrollX - tooltipWidth - offset;
                 arrowPosition = "right-end";
                 break;
             default:
@@ -134,15 +136,15 @@ export const withAPI = ({ lifecycle }) => (component) => {
                     targetRect.left +
                         scrollX +
                         targetRect.width / 2 -
-                        tooltipRect.width / 2;
+                        tooltipWidth / 2;
                 arrowPosition = "top";
         }
         const windowWidth = window.innerWidth;
         if (left < 0) {
             left = 0;
         }
-        else if (left + tooltipRect.width > windowWidth) {
-            left = windowWidth - tooltipRect.width;
+        else if (left + tooltipWidth > windowWidth) {
+            left = windowWidth - tooltipWidth;
         }
         return { top, left, arrowPosition };
     };

package/dist/components/tooltip/constants.d.ts

@@ -79,7 +79,7 @@ export declare const TOOLTIP_DEFAULTS: {
     readonly SHOW_ON_HOVER: true;
     /**
      * Whether to allow rich HTML content by default
-     * @deprecated The `rich` option has no effect and is removed in 1.0, and this default with it.
+     * @deprecated The `rich` option has no effect and is removed in `material` 3.0.0, and this default with it.
      */
     readonly RICH: false;
 };

package/dist/components/tooltip/types.d.ts

@@ -120,7 +120,7 @@ export interface TooltipConfig {
     /**
      * Never read, so it has no effect: a rich tooltip is `variant: 'rich'`, and
      * the content is always text.
-     * @deprecated Since 0.10 (FLO-324); removed in 1.0.
+     * @deprecated Since 0.10 (FLO-324); removed in `material` 3.0.0.
      */
     rich?: boolean;
 }

package/dist/components/top-app-bar/index.d.ts

@@ -7,5 +7,5 @@ export { TOP_APP_BAR_TYPES, TOP_APP_BAR_STATES, TOP_APP_BAR_DEFAULTS, TOP_APP_BA
 export default createTopAppBar;
 export { createTopAppBar };
 export type { TopAppBarConfig, TopAppBar as TopAppBarComponent, 
-/** @deprecated Use TopAppBarComponent, the name every component type has. Removed in 1.0 (FLO-383). */
+/** @deprecated Use TopAppBarComponent, the name every component type has. Removed in `material` 3.0.0 (FLO-383). */
 TopAppBar, } from "./types.js";