material 3.2.6 → 3.2.7

package/dist/elements/bottom-sheet.d.ts

@@ -1,42 +1,9 @@
-/**
- * `<m-bottom-sheet>`: the bottom sheet as a custom element. Its regions are
- * slots: `headline` (the `headline` attribute is its fallback text), which
- * names the sheet, and the default slot, the content. The drag handle is the
- * factory's; `no-drag-handle` drops it, and dragging with it.
- *
- * Standard by default, in the page beside what it covers. `modal` makes it
- * the modal sheet in the factory's top layer (`layer: "top"`): a native
- * `<dialog>` in the element's shadow root, shown with `showModal()`, above
- * every z-index, the page outside inert, the scrim its `::backdrop`; Escape
- * and a click on the backdrop close it.
- *
- * `open` shows it and reflects its state, as on `<dialog open>`. `show()`,
- * `close()`, `expand()` and `collapse()` are its methods, and `open` and
- * `close` are dispatched as it opens and closes (not when the attribute is
- * what changed).
- *
- * An open sheet is partially expanded, `peek-height` pixels tall (by
- * default its content up to half the screen), or with `expanded` at its full
- * height. `max-width` is the widest it grows, in pixels (640 by default),
- * past which it centres itself; a change recreates it. `expanded` reflects that state as `open` does: set while the sheet
- * is closed, it opens expanded. `expand` and `collapse` are dispatched as the
- * user or a method moves it to its full height and away from it, closing
- * included, so an app keeping `expanded` in its state follows them.
- * `no-close-on-scrim-click` and `no-close-on-escape` keep a modal sheet open
- * on a click on the scrim and on Escape.
- *
- * Parts: `bottom-sheet`, `container`, `handle`, `header`, `title`, `content`.
- *
- * @module elements
- */
 import type { BottomSheetComponent, BottomSheetEventHandlers } from "../components/bottom-sheet/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
-/** The sheet's events, and `expand` and `collapse`, which the element tells apart from its state changes. */
 export interface BottomSheetElementEvents extends BottomSheetEventHandlers {
     expand?: () => void;
     collapse?: () => void;
 }
-/** The sheet with the `show()` the element names after `<dialog>`'s, and its `expand` and `collapse` events. */
 export interface BottomSheetElementComponent extends Omit<BottomSheetComponent, "on" | "off"> {
     show: () => BottomSheetComponent;
     on: <T extends keyof BottomSheetElementEvents>(event: T, handler: NonNullable<BottomSheetElementEvents[T]>) => unknown;
@@ -44,7 +11,9 @@ export interface BottomSheetElementComponent extends Omit<BottomSheetComponent,
 }
 declare const bottomSheetSpec: {
     name: string;
-    slots: readonly ["headline"];
+    slots: readonly [
+        "headline"
+    ];
     create: (config: import("./define.js").Config) => BottomSheetElementComponent;
     styles: string[];
     hostStyles: string;
@@ -91,7 +60,12 @@ declare const bottomSheetSpec: {
             update: (c: BottomSheetElementComponent, _v: import("./define.js").AttributeValue, host: HTMLElement) => void;
         };
     };
-    methods: readonly ["show", "close", "expand", "collapse"];
+    methods: readonly [
+        "show",
+        "close",
+        "expand",
+        "collapse"
+    ];
     events: {
         open: {
             detail: () => null;
@@ -117,12 +91,9 @@ declare const bottomSheetSpec: {
 };
 export declare const bottomSheetElement: import("./define.js").ElementDefinition<BottomSheetElementComponent>;
 export type BottomSheetSpec = typeof bottomSheetSpec;
-/** `<m-bottom-sheet>` as a ref or a query returns it. */
 export type BottomSheetElement = ElementInstance<BottomSheetSpec, BottomSheetElementComponent>;
-/** Registers `<m-bottom-sheet>` (or `<prefix-bottom-sheet>`). */
 export declare const defineBottomSheet: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-bottom-sheet": BottomSheetElement;
     }

package/dist/elements/button-group.d.ts

@@ -1,27 +1,5 @@
-/**
- * `<m-button-group>` with `<m-button-group-item>` children.
- *
- * Each `<m-button-group-item>` declares one button (`value`, `icon`,
- * `selected-icon`, `aria-label`, `disabled`, `selected`, and its text as the
- * label). The group reads them into the factory's config and updates in place
- * when they change; the children stay where the framework put them.
- *
- * With `selection="single"` or `"multi"` the buttons toggle. `value` on the
- * group is the default selection (comma-separated in a multi group), which
- * moves the live one until the user or script changes it; without it, the
- * items' `selected` is the default. The `value` property is the live
- * selection: a string or null in a single group, an array in a multi group,
- * null without selection. Every press dispatches `action` with the button's
- * value; the factory calls it `click`, which the host already receives from
- * the browser.
- *
- * Parts: `button-group`, `button`, `text`, `ripple`.
- *
- * @module elements
- */
 import type { ButtonGroupComponent } from "../components/button-group/types.js";
 import { type Config, type DefineOptions, type ElementAttributes, type ElementHost, type ElementInstance } from "./define.js";
-/** The live selection: one value, several, or none. */
 export type ButtonGroupValue = string | string[] | null;
 declare const buttonGroupSpec: {
     name: string;
@@ -118,12 +96,7 @@ declare const buttonGroupSpec: {
 };
 export declare const buttonGroupElement: import("./define.js").ElementDefinition<ButtonGroupComponent>;
 export type ButtonGroupSpec = typeof buttonGroupSpec;
-/** `<m-button-group>` as a ref or a query returns it. */
 export type ButtonGroupElement = ElementInstance<ButtonGroupSpec, ButtonGroupComponent>;
-/**
- * `<m-button-group-item>` declares one button and renders nothing. Its text
- * content is the label unless `label` is set.
- */
 export declare const buttonGroupItemDeclaration: {
     readonly name: "button-group-item";
     readonly attributes: {
@@ -133,11 +106,9 @@ export declare const buttonGroupItemDeclaration: {
         readonly label: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         readonly icon: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. Shown on an icon-only item while it is selected. */
         readonly "selected-icon": {
             readonly type: "string";
         };
@@ -153,10 +124,8 @@ export declare const buttonGroupItemDeclaration: {
     };
 };
 export type ButtonGroupItemAttributes = ElementAttributes<typeof buttonGroupItemDeclaration>;
-/** Registers `<m-button-group>` and `<m-button-group-item>` (or with another prefix). */
 export declare const defineButtonGroup: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-button-group": ButtonGroupElement;
         "m-button-group-item": HTMLElement & ButtonGroupItemAttributes;

package/dist/elements/button.d.ts

@@ -1,17 +1,3 @@
-/**
- * `<m-button>`: the button as a custom element. Children are the label.
- *
- * `type="submit"` and `type="reset"` act on the host's form, which a button
- * inside a shadow root cannot reach by itself (see `form-button`).
- *
- * A toggle button (for now from the button's global defaults: the element has
- * no toggle attribute) dispatches `change` with `{ selected, value }` from the
- * host on each click.
- *
- * Parts: `button`, `icon`, `label` (also `text`), `ripple`.
- *
- * @module elements
- */
 import type { ButtonComponent } from "../components/button/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
 declare const buttonSpec: {
@@ -40,7 +26,6 @@ declare const buttonSpec: {
             config: string;
             update: (c: ButtonComponent, v: import("./define.js").AttributeValue) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         icon: {
             type: "string";
             config: string;
@@ -77,12 +62,9 @@ declare const buttonSpec: {
 };
 export declare const buttonElement: import("./define.js").ElementDefinition<ButtonComponent>;
 export type ButtonSpec = typeof buttonSpec;
-/** `<m-button>` as a ref or a query returns it. */
 export type ButtonElement = ElementInstance<ButtonSpec, ButtonComponent>;
-/** Registers `<m-button>` (or `<prefix-button>`). */
 export declare const defineButton: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-button": ButtonElement;
     }

package/dist/elements/card.d.ts

@@ -1,28 +1,15 @@
-/**
- * `<m-card>`: the card as a custom element. It holds arbitrary content, so
- * its regions are slots, placed by the factory's own builders:
- *
- * - `media`: at the top, clipped to the card's shape;
- * - `avatar`, `headline`, `subhead` and `header-action`: the header, whose
- *   headline names the card (`headline` and `subhead` attributes are the
- *   fallback text);
- * - the default slot: the supporting content, padded;
- * - `actions`: the row of actions at the bottom.
- *
- * A region is built only when it has content, and the card is recreated when
- * a region appears or goes away; content changes inside a region are the
- * slot's. `clickable` makes the card a button (Enter and Space click it) and
- * its activation is the native `click`.
- *
- * Parts: `card`, `content`.
- *
- * @module elements
- */
 import type { CardComponent } from "../components/card/types.js";
 import { type Config, type DefineOptions, type ElementInstance } from "./define.js";
 declare const cardSpec: {
     name: string;
-    slots: readonly ["avatar", "header-action", "headline", "subhead", "media", "actions"];
+    slots: readonly [
+        "avatar",
+        "header-action",
+        "headline",
+        "subhead",
+        "media",
+        "actions"
+    ];
     create: (config: Config) => CardComponent;
     styles: string[];
     hostStyles: string;
@@ -64,12 +51,9 @@ declare const cardSpec: {
 };
 export declare const cardElement: import("./define.js").ElementDefinition<CardComponent>;
 export type CardSpec = typeof cardSpec;
-/** `<m-card>` as a ref or a query returns it. */
 export type CardElement = ElementInstance<CardSpec, CardComponent>;
-/** Registers `<m-card>` (or `<prefix-card>`). */
 export declare const defineCard: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-card": CardElement;
     }

package/dist/elements/carousel.d.ts

@@ -1,24 +1,3 @@
-/**
- * `<m-carousel>` with `<m-carousel-item>` children.
- *
- * Each `<m-carousel-item>` declares one item (`src`, `alt`, `description`,
- * `button-text`, `button-url`, `value`, and its text as the label). The
- * carousel reads them into the factory's config and updates in place when
- * they change; the children stay where the framework put them.
- *
- * `variant` and the sizing attributes have no setter on the carousel:
- * changing one recreates it. `index` on `<m-carousel>` is the default current
- * item, which moves the live one until the user or script changes it; the
- * `index` property is the live one, and `change` reports the item the user
- * scrolls, swipes or arrows to.
- *
- * The carousel fills the host's height, as the factory fills its
- * container's: give `<m-carousel>` a height.
- *
- * Parts: `carousel`, `scroller`, `track`, `item`, `content`, `title`, `snap`.
- *
- * @module elements
- */
 import type { CarouselComponent } from "../components/carousel/types.js";
 import { type Config, type DefineOptions, type ElementAttributes, type ElementInstance } from "./define.js";
 declare const carouselSpec: {
@@ -80,7 +59,11 @@ declare const carouselSpec: {
         };
     };
     model: "index";
-    methods: readonly ["next", "prev", "goTo"];
+    methods: readonly [
+        "next",
+        "prev",
+        "goTo"
+    ];
     events: {
         change: {
             detail: (payload: unknown) => {
@@ -93,12 +76,7 @@ declare const carouselSpec: {
 };
 export declare const carouselElement: import("./define.js").ElementDefinition<CarouselComponent>;
 export type CarouselSpec = typeof carouselSpec;
-/** `<m-carousel>` as a ref or a query returns it. */
 export type CarouselElement = ElementInstance<CarouselSpec, CarouselComponent>;
-/**
- * `<m-carousel-item>` declares one item and renders nothing. Its text
- * content is the label unless `label` is set.
- */
 export declare const carouselItemDeclaration: {
     readonly name: "carousel-item";
     readonly attributes: {
@@ -126,10 +104,8 @@ export declare const carouselItemDeclaration: {
     };
 };
 export type CarouselItemAttributes = ElementAttributes<typeof carouselItemDeclaration>;
-/** Registers `<m-carousel>` and `<m-carousel-item>` (or with another prefix). */
 export declare const defineCarousel: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-carousel": CarouselElement;
         "m-carousel-item": HTMLElement & CarouselItemAttributes;

package/dist/elements/checkbox.d.ts

@@ -1,14 +1,3 @@
-/**
- * `<m-checkbox>`: the checkbox as a form-associated custom element.
- *
- * The `checked` attribute is the default state and the `checked` property the
- * live one, as on a native checkbox: the attribute moves the state until the
- * user or script changes it. `indeterminate` is a property only, as natively. Children are the label.
- *
- * Parts: `checkbox`, `input`, `icon`, `label`.
- *
- * @module elements
- */
 import type { CheckboxComponent } from "../components/checkbox/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
 declare const checkboxSpec: {
@@ -62,7 +51,11 @@ declare const checkboxSpec: {
             config: string;
         };
     };
-    methods: readonly ["toggle", "check", "uncheck"];
+    methods: readonly [
+        "toggle",
+        "check",
+        "uncheck"
+    ];
     model: "checked";
     events: {
         change: {
@@ -90,12 +83,9 @@ declare const checkboxSpec: {
 };
 export declare const checkboxElement: import("./define.js").ElementDefinition<CheckboxComponent>;
 export type CheckboxSpec = typeof checkboxSpec;
-/** `<m-checkbox>` as a ref or a query returns it. */
 export type CheckboxElement = ElementInstance<CheckboxSpec, CheckboxComponent>;
-/** Registers `<m-checkbox>` (or `<prefix-checkbox>`). */
 export declare const defineCheckbox: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-checkbox": CheckboxElement;
     }

package/dist/elements/chips.d.ts

@@ -1,28 +1,5 @@
-/**
- * `<m-chips>` with `<m-chip>` children: the chip set.
- *
- * Each `<m-chip>` declares one chip (`variant`, `value`, `icon`,
- * `trailing-icon`, `avatar`, `remove-label`, `selected`, `disabled`,
- * `elevated`, and its text as the label). The set reads them into the
- * factory's config and updates in place when they change; the children stay
- * where the framework put them.
- *
- * Filter and input chips select. `value` on the set is the default selection
- * (comma-separated in a multi-select set), which moves the live one until the
- * user or script changes it; without it, the chips' `selected` is the default.
- * The `value` property is the live selection: an array in a multi-select set
- * (the default, as the factory's), a string or null with `selection="single"`.
- * Removing an input chip dispatches `remove`; the set drops the chip, and the
- * app removes its `<m-chip>`, which is not shown again meanwhile.
- *
- * Parts: `chips`, `container`, `chip`, `action`, `leading-icon`, `checkmark`, `label`,
- * `trailing-icon`, `ripple`.
- *
- * @module elements
- */
 import type { ChipsComponent } from "../components/chips/types.js";
 import { type Config, type DefineOptions, type ElementAttributes, type ElementHost, type ElementInstance } from "./define.js";
-/** The live selection: several values, or one or none in a single-select set. */
 export type ChipsValue = string | string[] | null;
 declare const chipsSpec: {
     name: string;
@@ -93,12 +70,7 @@ declare const chipsSpec: {
 };
 export declare const chipsElement: import("./define.js").ElementDefinition<ChipsComponent>;
 export type ChipsSpec = typeof chipsSpec;
-/** `<m-chips>` as a ref or a query returns it. */
 export type ChipsElement = ElementInstance<ChipsSpec, ChipsComponent>;
-/**
- * `<m-chip>` declares one chip and renders nothing. Its text content is the
- * label unless `label` is set.
- */
 export declare const chipDeclaration: {
     readonly name: "chip";
     readonly attributes: {
@@ -111,15 +83,12 @@ export declare const chipDeclaration: {
         readonly variant: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         readonly icon: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         readonly "trailing-icon": {
             readonly type: "string";
         };
-        /** Markup (HTML), not a person's name or an image URL. Not sanitized by default: see Markup and sanitizing. Input chips only; takes precedence over `icon`. */
         readonly avatar: {
             readonly type: "string";
         };
@@ -138,10 +107,8 @@ export declare const chipDeclaration: {
     };
 };
 export type ChipAttributes = ElementAttributes<typeof chipDeclaration>;
-/** Registers `<m-chips>` and `<m-chip>` (or with another prefix). */
 export declare const defineChips: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-chips": ChipsElement;
         "m-chip": HTMLElement & ChipAttributes;

package/dist/elements/datepicker.d.ts

@@ -1,50 +1,6 @@
-/**
- * `<m-datepicker>`: the date picker as a form-associated custom element.
- *
- * The factory renders its own field, a text input with a calendar button:
- * that field is the trigger. A click on the button (or on the input of a
- * modal variant), ArrowDown in the input, the `open` attribute or `show()`
- * opens the calendar. The modal variants (`modal`, `modal-input`,
- * `fullscreen`) are a native `<dialog>` in the element's shadow root shown
- * with `showModal()`: the page outside is inert and Save commits, Cancel,
- * Escape and the backdrop do not. The docked calendar opens beside the field
- * (`show()`, not modal) and commits each date chosen.
- *
- * The value is an ISO date, `YYYY-MM-DD`, as on `<input type=date>`. With
- * `selection-mode="range"` a complete range is an ISO 8601 interval,
- * `YYYY-MM-DD/YYYY-MM-DD`: one string for the form, with a separator no date
- * contains. A lone date in range mode is a one-day range, `d/d`, as the
- * factory holds it. Empty is `""`. A value that is not one of these, or
- * that `min`, `max` or the mode rule out, empties the picker (the factory
- * keeps no such date).
- *
- * The `value` attribute is the default and the `value` property the live
- * value, as on a native input: the attribute moves the value until the user
- * or script changes it, and a form reset returns to it. `change` is
- * dispatched with `{ value }` when a date is committed. `open` reflects the
- * calendar's state, as on `<dialog open>`; `open` and `close` are dispatched
- * as it opens and closes (not when the attribute is what changed).
- *
- * `initial-view` is the view the calendar first opens on: `day`, `month` or
- * `year` (the full-screen variant has the days only). `close-on-select`
- * closes the calendar on a date chosen, committing it: a modal variant then
- * needs no Save. The factory reads both once: a change recreates the picker.
- *
- * The input of a modal variant is read-only, which takes it out of constraint
- * validation: the element reports the factory's `required` check as
- * `valueMissing`. `readonly` is the factory's: the value stays and the
- * calendar closed. `supporting-text` is the factory's supporting text.
- *
- * Parts: `datepicker`, `label`, `anchor`, `input`, `trigger`, `help`, `error`, `calendar`,
- * `header`, `navigation`, `prev`, `next`, `weekday`, `day`, among others.
- *
- * @module elements
- */
 import type { DatePickerComponent } from "../components/datepicker/types.js";
 import { type DefineOptions, type ElementHost, type ElementInstance } from "./define.js";
-/** The date picker, with what the element adds to it. */
 export interface DatepickerElementComponent extends DatePickerComponent {
-    /** Opens the calendar, unless the picker is disabled or read-only. */
     show: () => void;
 }
 declare const datepickerSpec: {
@@ -122,7 +78,10 @@ declare const datepickerSpec: {
         };
     };
     model: "value";
-    methods: readonly ["show", "close"];
+    methods: readonly [
+        "show",
+        "close"
+    ];
     events: {
         change: {
             detail: (payload: unknown) => {
@@ -151,12 +110,9 @@ declare const datepickerSpec: {
 };
 export declare const datepickerElement: import("./define.js").ElementDefinition<DatepickerElementComponent>;
 export type DatepickerSpec = typeof datepickerSpec;
-/** `<m-datepicker>` as a ref or a query returns it. */
 export type DatepickerElement = ElementInstance<DatepickerSpec, DatepickerElementComponent>;
-/** Registers `<m-datepicker>` (or `<prefix-datepicker>`). */
 export declare const defineDatepicker: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-datepicker": DatepickerElement;
     }