mtrl 0.10.6 → 0.10.8

package/README.md

@@ -115,7 +115,7 @@ Or import the base once, followed by the components you use:
 ```typescript
 import 'mtrl/styles/base';
 import 'mtrl/styles/button';
-import 'mtrl/styles/textfield';
+import 'mtrl/styles/text-field';
 
 // Optional: an alternate theme and the utility classes
 import 'mtrl/themes/ocean';
@@ -153,7 +153,7 @@ The default baseline also supports this setting without `data-theme`. On that un
 
 M3's scheme variants, generated from the baseline seed, ship as their own entries only (not in the full stylesheet): `neutral`, `vibrant`, `expressive`, `fidelity`, `content`, `monochrome`, `rainbow` and `fruit-salad`, for example `mtrl/themes/vibrant`. `schemeToTokens` (`mtrl/core/theme`) turns any M3 scheme's role colours into these tokens.
 
-Deprecated, removed in 1.0: `material` (use `baseline`), `winter` (use `ocean`), `browngreen` (use `brownbeige`) and `legacy`.
+Deprecated themes, removed in the package `material` 3.0.0: the theme `material` (use `baseline`), `winter` (use `ocean`), `browngreen` (use `brownbeige`) and `legacy`.
 
 ### Custom properties
 
@@ -267,7 +267,7 @@ note.setText('Saved');
 document.body.append(note.element);
 ```
 
-The element gets the `mtrl-note` class, `withEvents` adds `on`, `off` and `emit`, and `destroy()` removes the element. Add `withLifecycle()` from `mtrl/core/compose/features` when features need to register cleanup.
+The element gets the `mtrl-note` class, `withEvents` adds `on`, `off` and `emit`, and `destroy()` removes the element. Add `withLifecycle()` from `mtrl/core/compose` when features need to register cleanup.
 
 ## Markup and sanitizing
 
@@ -289,6 +289,10 @@ configureHTML({ sanitize: (html) => policy.createHTML(html) });
 
 The policy sees every string, the library's own icons included; a `TrustedHTML` value passed as an icon or content skips it. With no policy set, markup is written as it is. Text options (`text`, a card's `text`) never go through `innerHTML`.
 
+## Moving to `material`
+
+This library continues as the npm package `material`, from version 3.0.0. Stay on the latest `mtrl` 0.10.x until you are ready; then change the package name to `material` (version 3) and follow its migration guide. The `@deprecated` notes and the [changelog](CHANGELOG.md) say what `material` 3.0.0 changes.
+
 ## Upgrading from 0.9
 
 0.10.0 adds the elements and framework components; for factory users, most apps need nothing. The changes to check are listed in the [0.10.0 changelog's migration section](CHANGELOG.md#migrating-from-09x): setters no longer emit `change`, the time picker's events pass `{ value }`, the `--mtrl-sys-color-*-rgb` properties are gone, disabled non-form roots use `aria-disabled`, cards are `article`s, and the text field's DOM gained a `__field` wrapper.

package/dist/README.md

@@ -115,7 +115,7 @@ Or import the base once, followed by the components you use:
 ```typescript
 import 'mtrl/styles/base';
 import 'mtrl/styles/button';
-import 'mtrl/styles/textfield';
+import 'mtrl/styles/text-field';
 
 // Optional: an alternate theme and the utility classes
 import 'mtrl/themes/ocean';
@@ -153,7 +153,7 @@ The default baseline also supports this setting without `data-theme`. On that un
 
 M3's scheme variants, generated from the baseline seed, ship as their own entries only (not in the full stylesheet): `neutral`, `vibrant`, `expressive`, `fidelity`, `content`, `monochrome`, `rainbow` and `fruit-salad`, for example `mtrl/themes/vibrant`. `schemeToTokens` (`mtrl/core/theme`) turns any M3 scheme's role colours into these tokens.
 
-Deprecated, removed in 1.0: `material` (use `baseline`), `winter` (use `ocean`), `browngreen` (use `brownbeige`) and `legacy`.
+Deprecated themes, removed in the package `material` 3.0.0: the theme `material` (use `baseline`), `winter` (use `ocean`), `browngreen` (use `brownbeige`) and `legacy`.
 
 ### Custom properties
 
@@ -267,7 +267,7 @@ note.setText('Saved');
 document.body.append(note.element);
 ```
 
-The element gets the `mtrl-note` class, `withEvents` adds `on`, `off` and `emit`, and `destroy()` removes the element. Add `withLifecycle()` from `mtrl/core/compose/features` when features need to register cleanup.
+The element gets the `mtrl-note` class, `withEvents` adds `on`, `off` and `emit`, and `destroy()` removes the element. Add `withLifecycle()` from `mtrl/core/compose` when features need to register cleanup.
 
 ## Markup and sanitizing
 
@@ -289,6 +289,10 @@ configureHTML({ sanitize: (html) => policy.createHTML(html) });
 
 The policy sees every string, the library's own icons included; a `TrustedHTML` value passed as an icon or content skips it. With no policy set, markup is written as it is. Text options (`text`, a card's `text`) never go through `innerHTML`.
 
+## Moving to `material`
+
+This library continues as the npm package `material`, from version 3.0.0. Stay on the latest `mtrl` 0.10.x until you are ready; then change the package name to `material` (version 3) and follow its migration guide. The `@deprecated` notes and the [changelog](CHANGELOG.md) say what `material` 3.0.0 changes.
+
 ## Upgrading from 0.9
 
 0.10.0 adds the elements and framework components; for factory users, most apps need nothing. The changes to check are listed in the [0.10.0 changelog's migration section](CHANGELOG.md#migrating-from-09x): setters no longer emit `change`, the time picker's events pass `{ value }`, the `--mtrl-sys-color-*-rgb` properties are gone, disabled non-form roots use `aria-disabled`, cards are `article`s, and the text field's DOM gained a `__field` wrapper.

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

@@ -6,5 +6,5 @@ import { createBottomAppBar } from "./bottom-app-bar.js";
 export default createBottomAppBar;
 export { createBottomAppBar };
 export type { BottomAppBarConfig, BottomAppBar as BottomAppBarComponent, 
-/** @deprecated Use BottomAppBarComponent, the name every component type has. Removed in 1.0 (FLO-383). */
+/** @deprecated Use BottomAppBarComponent, the name every component type has. Removed in `material` 3.0.0 (FLO-383). */
 BottomAppBar, } from "./types.js";

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

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

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

@@ -73,8 +73,8 @@ export declare const BUTTON_CLASSES: {
  */
 export declare const DEFAULT_RIPPLE_CONFIG: {
     readonly DURATION: 450;
-    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in 1.0. */
+    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in `material` 3.0.0. */
     readonly TIMING: "cubic-bezier(0.4, 0.0, 0.2, 1)";
-    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in 1.0. */
+    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in `material` 3.0.0. */
     readonly OPACITY: readonly ["0.7", "0"];
 };

package/dist/components/button-group/constants.d.ts

@@ -162,12 +162,12 @@ export declare const BUTTON_GROUP_DEFAULTS: {
     readonly RIPPLE_DURATION: 300;
     /**
      * Default ripple animation timing function
-     * @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in 1.0.
+     * @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in `material` 3.0.0.
      */
     readonly RIPPLE_TIMING: "cubic-bezier(0.4, 0, 0.2, 1)";
     /**
      * Default ripple opacity values [start, end]
-     * @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in 1.0.
+     * @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in `material` 3.0.0.
      */
     readonly RIPPLE_OPACITY: [string, string];
 };

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

@@ -218,7 +218,7 @@ export interface ButtonGroupConfig {
     ariaLabel?: string;
     /**
      * Event handlers for button group events. On 0.10.x this map is accepted
-     * and never called: subscribe with `on(event, handler)` on the group. In 1.0
+     * and never called: subscribe with `on(event, handler)` on the group. In `material` 3.0.0
      * the handlers run, with the listener's argument.
      */
     on?: {

package/dist/components/card/features.d.ts

@@ -56,7 +56,7 @@ export declare const withLoading: (config?: LoadingConfig) => (component: BaseCo
  * that no stylesheet reads. A card's elevation comes from its variant and
  * state classes in the stylesheet.
  *
- * @deprecated Since 0.10 (FLO-323): a no-op, removed in 1.0. Drop it from
+ * @deprecated Since 0.10 (FLO-323): a no-op, removed in `material` 3.0.0. Drop it from
  * the composition.
  * @category Components
  */

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

@@ -66,24 +66,24 @@ export { default } from "./card.js";
  * These types define the structure and behavior of the Card component.
  */
 export type { CardVariant, CardElevationLevel, CardSchema as CardConfig, 
-/** @deprecated Use CardConfig. Removed in 1.0 (FLO-383). */
+/** @deprecated Use CardConfig. Removed in `material` 3.0.0 (FLO-383). */
 CardSchema, CardHeaderConfig, CardContentConfig, CardActionsConfig, CardMediaConfig, CardAriaAttributes, CardComponent, CardEvents, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 LoadingFeature, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 ExpandableFeature, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 SwipeableFeature, } from "./types.js";
 export { createCardContent, createCardHeader, createCardActions, createCardMedia, } from "./content.js";
 export { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 withAPI, } from "./api.js";
 export { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 withLoading, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 withExpandable, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 withSwipeable, 
-/** @deprecated Internal, no replacement: removed from mtrl/components/card in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/card in `material` 3.0.0 (FLO-381). */
 withElevation, } from "./features.js";

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

@@ -224,7 +224,7 @@ export interface BaseComponent {
     getElementClass: (base: string, element: string) => string;
     /** Add CSS class(es) */
     addClass: (...classes: string[]) => BaseComponent;
-    /** Emit an event. In 1.0, `emit` accepts only the card's own events ({@link CardEvents}). */
+    /** Emit an event. In `material` 3.0.0, `emit` accepts only the card's own events ({@link CardEvents}). */
     emit?: (event: string, data?: unknown) => void;
     /** Component configuration */
     config: CardComponentConfig;
@@ -446,19 +446,19 @@ export interface CardComponent extends BaseComponent {
     /**
      * Optional loading feature
      * @deprecated Never set by `createCard`: only the deprecated `withLoading` feature adds it.
-     * Removed in 1.0 with that feature (FLO-381).
+     * Removed in `material` 3.0.0 with that feature (FLO-381).
      */
     loading?: LoadingFeature;
     /**
      * Optional expandable feature
      * @deprecated Never set by `createCard`: only the deprecated `withExpandable` feature adds it.
-     * Removed in 1.0 with that feature (FLO-381).
+     * Removed in `material` 3.0.0 with that feature (FLO-381).
      */
     expandable?: ExpandableFeature;
     /**
      * Optional swipeable feature
      * @deprecated Never set by `createCard`: only the deprecated `withSwipeable` feature adds it.
-     * Removed in 1.0 with that feature (FLO-381).
+     * Removed in `material` 3.0.0 with that feature (FLO-381).
      */
     swipeable?: SwipeableFeature;
 }

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

@@ -1,7 +1,7 @@
 import type { ForwardedEventPayload } from "../../core/dom/index.js";
 /** Current item reported by programmatic navigation or native scrolling. */
 export interface CarouselChangePayload {
-    /** The current item's index. In 1.0 the payload carries it as `value`, and `index` is gone. */
+    /** The current item's index. In `material` 3.0.0 the payload carries it as `value`, and `index` is gone. */
     index: number;
 }
 /** Events emitted by the scroll feature and forwarded from the root. */

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

@@ -7,7 +7,7 @@ import type { EventCallback } from "../../core/state/emitter.js";
  * - filled: Checkbox with filled background when checked (default)
  * - outlined: Checkbox with outline only, for less visual emphasis
  * @deprecated The type of the deprecated `variant` option, which has no effect: M3 has one
- * checkbox style (FLO-94, FLO-265). Removed in 1.0.
+ * checkbox style (FLO-94, FLO-265). Removed in `material` 3.0.0.
  */
 export type CheckboxVariant = "filled" | "outlined";
 /**

package/dist/components/chips/features/controller.js

@@ -114,7 +114,6 @@ export const withController = (config) => (component) => {
                     chipRect.height / 2;
                 container.scrollTo({
                     top: Math.max(0, scrollTop),
-                    behavior: "smooth",
                 });
             }
             else {
@@ -124,7 +123,6 @@ export const withController = (config) => (component) => {
                     chipRect.width / 2;
                 container.scrollTo({
                     left: Math.max(0, scrollLeft),
-                    behavior: "smooth",
                 });
             }
         }

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

@@ -36,9 +36,13 @@ export interface ChipConfig {
     trailingLabel?: string;
     /** The trailing button opens a menu: aria-haspopup="menu", and a drop-down arrow unless trailingIcon is set. */
     trailingMenu?: boolean;
-    /** In 1.0 a chip's `onClick` receives the `click` payload, `{ event, originalEvent, element }`, not the chip. */
+    /**
+     * In `material` 3.0.0 a chip's `onClick` receives the `click` payload, `{ event, originalEvent, element }`, not the chip.
+     * It then runs before the chip toggles, alone or in a set: `isSelected()` inside it is
+     * the state before the click (today it runs after the toggle). Read the new state in `onChange`.
+     */
     onClick?: (chip: ChipComponent) => void;
-    /** In 1.0 a chip's `onChange` receives one object, `{ selected, chip, value }`, the `change` payload. */
+    /** In `material` 3.0.0 a chip's `onChange` receives one object, `{ selected, chip, value }`, the `change` payload. */
     onChange?: (selected: boolean, chip: ChipComponent) => void;
     onSelect?: (chip: ChipComponent) => void;
     class?: string;
@@ -47,13 +51,13 @@ export interface ChipConfig {
     ripple?: boolean;
     /**
      * @internal Selection belongs to the chips container.
-     * @deprecated Not for apps: moves out of ChipConfig in 1.0.0 (FLO-381).
+     * @deprecated Not for apps: moves out of ChipConfig in `material` 3.0.0 (FLO-381).
      */
     managedSelection?: boolean;
     /**
      * @internal The chip is a cell of a chip set's grid (FLO-261): the root is a
      * `gridcell`, and a one-action chip's cell is its focus target.
-     * @deprecated Not for apps: moves out of ChipConfig in 1.0.0 (FLO-381).
+     * @deprecated Not for apps: moves out of ChipConfig in `material` 3.0.0 (FLO-381).
      */
     cell?: boolean;
 }
@@ -150,12 +154,15 @@ export interface ChipsConfig {
      * Whether the set keeps at least one chip selected: deselecting the last selected
      * chip is refused. Off by default, as in Material; single-select sets used to
      * enforce it without a way to opt out. FLO-257.
+     * In `material` 3.0.0 a refused click emits no `change` and calls no `onChange` and no
+     * `onSelect` (today the set emits `change` and both callbacks run, with the
+     * chip still selected).
      * @default false
      */
     selectionRequired?: boolean;
     /**
      * Callback function when chip selection changes.
-     * In 1.0 it receives one object, `{ value, selected, changed }` (no array, no
+     * In `material` 3.0.0 it receives one object, `{ value, selected, changed }` (no array, no
      * second argument), and also hears `selectByValue(values, true)`.
      */
     onChange?: (event: ChipsChangeEvent, changedValue: string | null) => void;
@@ -343,7 +350,8 @@ export interface ChipsComponent {
      */
     getLabelPosition: () => string;
     /**
-     * Scrolls to a specific chip
+     * Scrolls to a specific chip. A scrollable set scrolls smoothly, from its
+     * stylesheet, and at once under reduced motion.
      * @param chipOrIndex - Chip instance or index to scroll to
      * @returns The chips instance for chaining
      */

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

@@ -1,5 +1,5 @@
 export { default } from "./datepicker.js";
 export type { DatePickerConfig, DatePickerComponent, DatePickerEvents, DatePickerValue, DatePickerValueOf, DatePickerInput, DatePickerChangePayload, DatePickerVisibilityPayload, DatePickerTapPayload, DatePickerSwipePayload, DatePickerVariant, DatePickerView, DatePickerSelectionMode, } from "./types.js";
 export { 
-/** @deprecated Internal, no replacement: removed from mtrl/components/datepicker in 1.0.0 (FLO-381). */
+/** @deprecated Internal, no replacement: removed from mtrl/components/datepicker in `material` 3.0.0 (FLO-381). */
 DEFAULT_DATE_FORMAT, } from "./types.js";

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

@@ -290,6 +290,9 @@ export interface DatePickerComponent<V = DatePickerValue> {
     getClass: (name: string) => string;
     /**
      * Opens the datepicker dropdown/modal
+     * A limit on 0.10.x, fixed in `material` 3.0.0: a docked picker opened with `open()` from
+     * a click outside it is closed again by that same click. Call `open()` once
+     * the click has finished (for example from a `setTimeout`).
      * @returns The datepicker component for chaining
      */
     open: () => DatePickerComponent<V>;

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

@@ -125,6 +125,12 @@ export interface DialogConfig {
     closeOnOverlayClick?: boolean;
     /**
      * Whether to close when Escape key is pressed
+     * A limit on 0.10.x, fixed in `material` 3.0.0: a `layer: "top"` dialog that refuses
+     * Escape (this option `false`, or a `beforeclose` listener that prevents it)
+     * is still closed by the third press.
+     * In `material` 3.0.0 Escape is handled as a key press in both layers: only the topmost
+     * open modal answers, after what is open inside it (a menu, a select) has
+     * used the key, and never for the key press that opened it.
      * @default true
      */
     closeOnEscape?: boolean;
@@ -217,7 +223,7 @@ export interface DialogButton {
     /**
      * Has no effect: the button has no colour option, and M3's dialog actions
      * are text buttons in the dialog's own colours.
-     * @deprecated Since 0.10 (FLO-324); removed in 1.0.
+     * @deprecated Since 0.10 (FLO-324); removed in `material` 3.0.0.
      */
     color?: string;
     /**
@@ -365,12 +371,19 @@ export interface DialogComponent {
     /**
      * Opens the dialog
      * Displays the dialog with animation
+     * In `material` 3.0.0 `open` is emitted inside `open()`, and `isOpen()` is true when it
+     * returns (without `layer: "top"` both come about 10 ms later today). A
+     * listener added after calling `open()` then no longer hears `open`: add it
+     * before the call, or listen to `afteropen`. A second `open()` emits nothing.
      * @returns Dialog component for method chaining
      */
     open: () => DialogComponent;
     /**
      * Closes the dialog
      * Hides the dialog with animation
+     * In `material` 3.0.0 `close()` on a closed dialog does nothing and emits nothing (today
+     * it emits `beforeclose`, `close` and `afterclose` again), and `close()` then
+     * `open()` at once ends open.
      * @returns Dialog component for method chaining
      */
     close: () => DialogComponent;

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

@@ -82,6 +82,8 @@ export interface DrawerConfig extends BaseComponentConfig {
     open?: boolean;
     /**
      * Whether the modal drawer can be dismissed by clicking the scrim
+     * A limit on 0.10.x, fixed in `material` 3.0.0: with `layer: "top"` and this option
+     * `false`, the third Escape still closes the drawer.
      * @default true
      */
     dismissible?: boolean;

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

@@ -53,7 +53,7 @@ export declare const FAB_CLASSES: {
     readonly ICON: "fab__icon";
     /** Applied when FAB is lowered (pressed state) */
     readonly LOWERED: "fab--lowered";
-    /** @deprecated Applied to small FABs; the small size is deprecated (FAB_SIZES.SMALL). Removed in 1.0. */
+    /** @deprecated Applied to small FABs; the small size is deprecated (FAB_SIZES.SMALL). Removed in `material` 3.0.0. */
     readonly SMALL: "fab--small";
     /** Applied to medium FABs */
     readonly MEDIUM: "fab--medium";
@@ -72,7 +72,7 @@ export declare const FAB_TYPES: {
  * Default icon sizes based on FAB size
  */
 export declare const FAB_ICON_SIZES: {
-    /** @deprecated The small FAB's icon size; the small size is deprecated (FAB_SIZES.SMALL). Removed in 1.0. */
+    /** @deprecated The small FAB's icon size; the small size is deprecated (FAB_SIZES.SMALL). Removed in `material` 3.0.0. */
     readonly SMALL: "24px";
     readonly DEFAULT: "24px";
     readonly MEDIUM: "28px";

package/dist/components/fab-menu/types.d.ts

@@ -97,9 +97,19 @@ export interface FabMenuComponent extends ElementComponent {
     fab: HTMLElement;
     /** The list of the list presentation: `role="menu"` */
     list: HTMLElement;
-    /** Opens the menu */
+    /**
+     * Opens the menu
+     * In `material` 3.0.0, in the `menu` presentation, `isOpen()` is true and `open` has been
+     * emitted when `open()` returns (today both wait for the menu's module to
+     * load); the surface is shown when the module has arrived.
+     */
     open(event?: Event): this;
-    /** Closes the menu */
+    /**
+     * Closes the menu
+     * In `material` 3.0.0, in the `menu` presentation, `close` is emitted inside `close()`
+     * (about 50 ms later today), and a `close()` before the surface has arrived
+     * ends closed (today it is ignored, and the menu then opens).
+     */
     close(): this;
     /** Opens or closes the menu */
     toggle(event?: Event): this;

package/dist/components/icon-button/constants.d.ts

@@ -115,9 +115,9 @@ export declare const ICON_BUTTON_CLASSES: {
  */
 export declare const DEFAULT_RIPPLE_CONFIG: {
     readonly DURATION: 450;
-    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in 1.0. */
+    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in `material` 3.0.0. */
     readonly TIMING: "cubic-bezier(0.4, 0.0, 0.2, 1)";
-    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in 1.0. */
+    /** @deprecated Has no effect: the option it is the default of is never applied (FLO-268). Removed in `material` 3.0.0. */
     readonly OPACITY: [string, string];
 };
 /**

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

@@ -75,7 +75,7 @@ export interface IconButtonConfig extends BaseComponentConfig {
      * When true, the button can be selected/unselected
      *
      * A click emits `change`. The DOM `toggle` event the button also dispatches
-     * is deprecated and removed in 1.0: listen to `change`.
+     * is deprecated and removed in `material` 3.0.0: listen to `change`.
      *
      * @default false
      */

package/dist/components/index.d.ts

@@ -51,7 +51,7 @@ export { default as createTabs } from "./tabs/index.js";
 export { createTab } from "./tabs/tab.js";
 export { default as createTextField } from "./textfield/index.js";
 export { 
-/** @deprecated Use createTextField: M3 writes "text field" as two words. Removed in 1.0 (FLO-383). */
+/** @deprecated Use createTextField: M3 writes "text field" as two words. Removed in `material` 3.0.0 (FLO-383). */
 default as createTextfield, } from "./textfield/index.js";
 export { default as createTimePicker } from "./timepicker/index.js";
 export { default as createToolbar } from "./toolbar/index.js";
@@ -60,14 +60,14 @@ export { default as createTooltip } from "./tooltip/index.js";
 export { createCardContent, createCardHeader, createCardActions, createCardMedia, } from "./card/content.js";
 export type { BadgeConfig, BadgeComponent } from "./badge/types.js";
 export type { BottomAppBarConfig, BottomAppBar as BottomAppBarComponent, 
-/** @deprecated Use BottomAppBarComponent, the name every component type has. Removed in 1.0 (FLO-383). */
+/** @deprecated Use BottomAppBarComponent, the name every component type has. Removed in `material` 3.0.0 (FLO-383). */
 BottomAppBar, } from "./bottom-app-bar/types.js";
 export type { BottomSheetConfig, BottomSheetComponent, BottomSheetVariant, BottomSheetState, BottomSheetStateEvent, BottomSheetEventHandlers, } from "./bottom-sheet/types.js";
 export type { SideSheetConfig, SideSheetComponent, SideSheetVariant, SideSheetPosition, SideSheetEventHandlers, } from "./side-sheet/types.js";
 export type { ButtonConfig, ButtonComponent, ButtonVariant, } from "./button/types.js";
 export type { ButtonGroupConfig, ButtonGroupComponent, ButtonGroupItemConfig, ButtonGroupEvent, ButtonGroupEventType, ButtonGroupVariant, ButtonGroupOrientation, ButtonGroupDensity, } from "./button-group/types.js";
 export type { CardSchema as CardConfig, 
-/** @deprecated Use CardConfig. Removed in 1.0 (FLO-383). */
+/** @deprecated Use CardConfig. Removed in `material` 3.0.0 (FLO-383). */
 CardSchema, } from "./card/types.js";
 export type { CarouselConfig, CarouselComponent } from "./carousel/types.js";
 export type { CheckboxConfig, CheckboxComponent } from "./checkbox/types.js";
@@ -94,14 +94,14 @@ export type { SnackbarConfig, SnackbarComponent } from "./snackbar/types.js";
 export type { SwitchConfig, SwitchComponent } from "./switch/types.js";
 export type { TabsConfig, TabsComponent, TabConfig, TabComponent, } from "./tabs/types.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, } from "./textfield/types.js";
 export type { TimePickerConfig, TimePickerComponent } from "./timepicker/types.js";
 export type { FabMenuConfig, FabMenuComponent, FabMenuEvents, FabMenuItem } from "./fab-menu/types.js";
 export type { ToolbarConfig, ToolbarComponent, ToolbarEvents, ToolbarItem, } from "./toolbar/types.js";
 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 "./top-app-bar/types.js";
 export type { TooltipConfig, TooltipComponent } from "./tooltip/types.js";

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

@@ -377,7 +377,7 @@ export interface ListEvents<T = unknown> {
     select: (event: SelectEvent<T>) => void;
     load: (event: LoadEvent<T>) => void;
     scroll: (event: ForwardedEventPayload<Event, HTMLElement> & {
-        /** @deprecated Never sent: the root's scroll is forwarded without it. Removed in 1.0 (FLO-380, FLO-384). */
+        /** @deprecated Never sent: the root's scroll is forwarded without it. Removed in `material` 3.0.0 (FLO-380, FLO-384). */
         component?: ListComponent<T>;
     }) => void;
     keydown: (event: ForwardedEventPayload<KeyboardEvent, HTMLElement>) => void;

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

@@ -308,9 +308,14 @@ export interface MenuEvent {
     menu: MenuComponent;
     /** Original DOM event if available */
     originalEvent?: Event;
-    /** Function to prevent default behavior */
+    /**
+     * Function to prevent default behavior
+     * In `material` 3.0.0 the `open` and `close` payloads have no `preventDefault` and no
+     * `defaultPrevented`: these two events cannot be cancelled. The `select`
+     * payload keeps both.
+     */
     preventDefault: () => void;
-    /** Whether default behavior was prevented */
+    /** Whether default behavior was prevented. In `material` 3.0.0 on the `select` payload only. */
     defaultPrevented: boolean;
 }
 /**
@@ -345,6 +350,10 @@ export interface MenuComponent {
     open: (event?: Event, interactionType?: "mouse" | "keyboard") => MenuComponent;
     /**
      * Closes the menu
+     * In `material` 3.0.0 `close` is emitted inside `close()` and `isOpen()` is false when it
+     * returns (both come about 50 ms later today), while the menu is still in
+     * the document; and `close()` then `open()` at once reopens it (today the
+     * `open()` is ignored).
      * @param event - Optional event that triggered the close
      * @param restoreFocus - Whether focus returns to the opener (default true)
      * @param skipAnimation - Whether to close without the exit animation

package/dist/components/navigation-rail/types.d.ts

@@ -50,9 +50,9 @@ export interface NavigationRailConfig extends BaseComponentConfig {
     header?: HTMLElement;
     ripple?: boolean;
     onSelect?: (event: NavigationRailSelectEvent) => void;
-    /** In 1.0 it receives `{ expanded: true }`, the object an `expand` listener receives. */
+    /** In `material` 3.0.0 it receives `{ expanded: true }`, the object an `expand` listener receives. */
     onExpand?: () => void;
-    /** In 1.0 it receives `{ expanded: false }`, the object a `collapse` listener receives. */
+    /** In `material` 3.0.0 it receives `{ expanded: false }`, the object a `collapse` listener receives. */
     onCollapse?: () => void;
 }
 export interface NavigationRailComponent {

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: {
-    /** @deprecated The radios have no variant option; nothing reads this. Removed in 1.0. */
+    /** @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";
-    /** @deprecated The radios have no label position option; nothing reads this. Removed in 1.0. */
+    /** @deprecated The radios have no label position option; nothing reads this. Removed in `material` 3.0.0. */
     readonly LABEL_POSITION: "right";
-    /** @deprecated The radios have no size option; nothing reads this. Removed in 1.0. */
+    /** @deprecated The radios have no size option; nothing reads this. Removed in `material` 3.0.0. */
     readonly SIZE: "medium";
 };
 /**