material 3.2.5 → 3.2.7

package/dist/elements/search.d.ts

@@ -1,57 +1,16 @@
-/**
- * `<m-search>` with `<m-search-suggestion>` children: the search as a
- * form-associated custom element.
- *
- * Each `<m-search-suggestion>` declares one suggestion: `value`, its text (or
- * `label`), `icon` and `group` (a divider separates groups). The search reads
- * them into the factory's suggestions and redraws the list in place when they
- * change, in one pass per batch of changes: an app replacing them as the user
- * types gets one redraw, and none when they come back the same.
- *
- * The `value` attribute is the default query and the `value` property the
- * live one, as on a native input: the attribute moves the value until the
- * user or script changes it, and a form reset returns to it. The value is
- * submitted under the host's `name`.
- *
- * Events: `input` as the query changes (typing, and the clear button or
- * Escape emptying it), `change` when it is submitted (Enter), `select` when a
- * suggestion is chosen, `open` and `close` as the view opens and closes, and
- * `action` on a click of the trailing icon or the avatar. Enter on a
- * highlighted suggestion is the selection only.
- *
- * The open view is the factory's: in the top layer, docked (a popover over a
- * scrim) or full screen (a modal dialog), inside the element's shadow root.
- * `open` shows it and reflects its state; `show()` and `close()` are its
- * methods, as on `<m-dialog>`. `focus()` focuses the input, which opens the
- * view as a click does.
- *
- * `leading-icon`, `trailing-icon`, `avatar` and their labels have no setter
- * on the search: changing one recreates it, keeping the value.
- *
- * Parts: `search`, `surface`, `container`, `leading-icon`, `input`, `clear-button`, `trailing`,
- * `divider`, `content`, `suggestions`, `status`, among others.
- *
- * @module elements
- */
 import type { SearchComponent, SearchEvents } from "../components/search/types.js";
 import { type AttributeValue, type Config, type DefineOptions, type ElementAttributes, type ElementInstance } from "./define.js";
-/** The factory's events, and the element's own names for four of them. */
 export interface SearchElementEvents extends SearchEvents {
     change: SearchEvents["submit"];
     select: SearchEvents["suggestionSelect"];
     open: SearchEvents["expand"];
     close: SearchEvents["collapse"];
 }
-/** The search, with the element's events, methods and input. */
 export interface SearchElementComponent extends Omit<SearchComponent, "on" | "off"> {
-    /** Subscribes by the element's event names (`open`, `select`…) as well as the factory's. */
     on: <K extends keyof SearchElementEvents>(event: K, handler: SearchElementEvents[K]) => SearchElementComponent;
     off: <K extends keyof SearchElementEvents>(event: K, handler: SearchElementEvents[K]) => SearchElementComponent;
-    /** Opens the view. */
     show: () => SearchElementComponent;
-    /** Closes the view. */
     close: () => SearchElementComponent;
-    /** The combobox. */
     input: HTMLInputElement;
 }
 declare const searchSpec: {
@@ -107,12 +66,10 @@ declare const searchSpec: {
             config: string;
             update: (c: SearchElementComponent, v: AttributeValue) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         "leading-icon": {
             type: "string";
             config: string;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         "trailing-icon": {
             type: "string";
             config: string;
@@ -121,7 +78,6 @@ declare const searchSpec: {
             type: "string";
             config: string;
         };
-        /** Markup (HTML), not a person's name or an image URL. Not sanitized by default: see Markup and sanitizing. */
         avatar: {
             type: "string";
             config: string;
@@ -152,7 +108,11 @@ declare const searchSpec: {
             set: (c: SearchElementComponent, value: unknown) => void;
         };
     };
-    methods: readonly ["show", "close", "focus"];
+    methods: readonly [
+        "show",
+        "close",
+        "focus"
+    ];
     model: "value";
     events: {
         input: {
@@ -198,12 +158,7 @@ declare const searchSpec: {
 };
 export declare const searchElement: import("./define.js").ElementDefinition<SearchElementComponent>;
 export type SearchSpec = typeof searchSpec;
-/** `<m-search>` as a ref or a query returns it. */
 export type SearchElement = ElementInstance<SearchSpec, SearchElementComponent>;
-/**
- * `<m-search-suggestion>` declares one suggestion and renders nothing. Its
- * text is the label unless `label` is set; `value` defaults to the label.
- */
 export declare const searchSuggestionDeclaration: {
     readonly name: "search-suggestion";
     readonly attributes: {
@@ -213,7 +168,6 @@ export declare const searchSuggestionDeclaration: {
         readonly label: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         readonly icon: {
             readonly type: "string";
         };
@@ -223,10 +177,8 @@ export declare const searchSuggestionDeclaration: {
     };
 };
 export type SearchSuggestionAttributes = ElementAttributes<typeof searchSuggestionDeclaration>;
-/** Registers `<m-search>` and `<m-search-suggestion>` (or with another prefix). */
 export declare const defineSearch: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-search": SearchElement;
         "m-search-suggestion": HTMLElement & SearchSuggestionAttributes;

package/dist/elements/select.d.ts

@@ -1,26 +1,3 @@
-/**
- * `<m-select>` with `<m-select-option>` children: the select as a
- * form-associated custom element.
- *
- * Each `<m-select-option>` declares one option: `value`, its text (or
- * `label`), `disabled` and `icon`. The select reads them into the factory's
- * options and updates in place when they change; the children stay where the
- * framework put them.
- *
- * The `value` attribute is the default selection and the `value` property the
- * live one, as on a native select: the attribute moves the value until the
- * user or script changes it, and a form reset returns to it. Choosing an
- * option dispatches `change` with its value. The listbox opens in the top
- * layer (the factory's `layer: "top"`), inside the element's shadow root.
- *
- * `label` has no setter on the select: changing it recreates it, keeping the
- * value. The field is read-only, which takes it out of constraint validation:
- * the element reports `required` itself, as `valueMissing`.
- *
- * Parts: `select`, `text-field`, `field`, `label`, `input`, `trailing-icon`.
- *
- * @module elements
- */
 import type { SelectComponent } from "../components/select/types.js";
 import { type AttributeValue, type Config, type DefineOptions, type ElementAttributes, type ElementHost, type ElementInstance } from "./define.js";
 declare const selectSpec: {
@@ -107,12 +84,7 @@ declare const selectSpec: {
 };
 export declare const selectElement: import("./define.js").ElementDefinition<SelectComponent>;
 export type SelectSpec = typeof selectSpec;
-/** `<m-select>` as a ref or a query returns it. */
 export type SelectElement = ElementInstance<SelectSpec, SelectComponent>;
-/**
- * `<m-select-option>` declares one option and renders nothing. Its text is
- * the label unless `label` is set.
- */
 export declare const selectOptionDeclaration: {
     readonly name: "select-option";
     readonly attributes: {
@@ -122,7 +94,6 @@ export declare const selectOptionDeclaration: {
         readonly label: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         readonly icon: {
             readonly type: "string";
         };
@@ -132,10 +103,8 @@ export declare const selectOptionDeclaration: {
     };
 };
 export type SelectOptionAttributes = ElementAttributes<typeof selectOptionDeclaration>;
-/** Registers `<m-select>` and `<m-select-option>` (or with another prefix). */
 export declare const defineSelect: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-select": SelectElement;
         "m-select-option": HTMLElement & SelectOptionAttributes;

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

@@ -1,35 +1,13 @@
-/**
- * `<m-side-sheet>`: the side 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 header's close
- * button is the factory's; `no-close-button` drops it. `position` is `start`
- * or `end` (the default), logical as on the factory, and `width` its width
- * in pixels (256 by default, up to 400).
- *
- * Standard by default, docked beside the page. `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, unless `no-close-on-scrim-click` or
- * `no-close-on-escape` says otherwise.
- *
- * `open` shows it and reflects its state, as on `<dialog open>`. `show()` and
- * `close()` are its methods, and `open` and `close` are dispatched as it
- * opens and closes (not when the attribute is what changed).
- *
- * Parts: `side-sheet`, `container`, `header`, `title`, `close`, `content`.
- *
- * @module elements
- */
 import type { SideSheetComponent } from "../components/side-sheet/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
-/** The sheet with the `show()` the element names after `<dialog>`'s. */
 export interface SideSheetElementComponent extends SideSheetComponent {
     show: () => SideSheetComponent;
 }
 declare const sideSheetSpec: {
     name: string;
-    slots: readonly ["headline"];
+    slots: readonly [
+        "headline"
+    ];
     create: (config: import("./define.js").Config) => SideSheetElementComponent;
     styles: string[];
     hostStyles: string;
@@ -72,7 +50,10 @@ declare const sideSheetSpec: {
             update: (c: SideSheetElementComponent, _v: import("./define.js").AttributeValue, host: HTMLElement) => void;
         };
     };
-    methods: readonly ["show", "close"];
+    methods: readonly [
+        "show",
+        "close"
+    ];
     events: {
         open: {
             detail: () => null;
@@ -87,12 +68,9 @@ declare const sideSheetSpec: {
 };
 export declare const sideSheetElement: import("./define.js").ElementDefinition<SideSheetElementComponent>;
 export type SideSheetSpec = typeof sideSheetSpec;
-/** `<m-side-sheet>` as a ref or a query returns it. */
 export type SideSheetElement = ElementInstance<SideSheetSpec, SideSheetElementComponent>;
-/** Registers `<m-side-sheet>` (or `<prefix-side-sheet>`). */
 export declare const defineSideSheet: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-side-sheet": SideSheetElement;
     }

package/dist/elements/slider.d.ts

@@ -1,18 +1,3 @@
-/**
- * `<m-slider>`: the slider as a form-associated custom element.
- *
- * The `value` attribute is the default and the `value` property the live one,
- * as on a native range input: the attribute moves the value until the user or
- * script changes it. `range` adds a second handle, whose `second-value` and
- * `secondValue` work the same way. `input` fires while the
- * value moves and `change` when an interaction ends. `aria-label` names the
- * handles.
- *
- * Parts: `slider`, `container`, `track`, `handle`, `value`, `visual`, `segment`, `ticks`, `dot`,
- * `inset-icon`.
- *
- * @module elements
- */
 import type { SliderComponent } from "../components/slider/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
 declare const sliderSpec: {
@@ -95,7 +80,6 @@ declare const sliderSpec: {
             type: "string";
             config: string;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         icon: {
             type: "string";
             config: string;
@@ -104,13 +88,11 @@ declare const sliderSpec: {
             type: "string";
             config: string;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. Shown at size M, L or XL. */
         "inset-icon": {
             type: "string";
             config: string;
             update: (c: SliderComponent, _v: import("./define.js").AttributeValue, host: HTMLElement) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. Replaces `inset-icon` while the value is at the minimum. */
         "inset-icon-at-min": {
             type: "string";
             config: string;
@@ -133,7 +115,9 @@ declare const sliderSpec: {
         };
     };
     model: "value";
-    defaults: readonly ["secondValue"];
+    defaults: readonly [
+        "secondValue"
+    ];
     events: {
         input: {
             detail: (payload: unknown) => {
@@ -159,12 +143,9 @@ declare const sliderSpec: {
 };
 export declare const sliderElement: import("./define.js").ElementDefinition<SliderComponent>;
 export type SliderSpec = typeof sliderSpec;
-/** `<m-slider>` as a ref or a query returns it. */
 export type SliderElement = ElementInstance<SliderSpec, SliderComponent>;
-/** Registers `<m-slider>` (or `<prefix-slider>`). */
 export declare const defineSlider: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-slider": SliderElement;
     }

package/dist/elements/snackbar.d.ts

@@ -1,27 +1,3 @@
-/**
- * `<m-snackbar>`: a snackbar, in the top layer.
- *
- * The message is the `message` attribute, or the element's text when there
- * is none; it is read rather than slotted, since the snackbar may open inside
- * a modal dialog, away from the host. `action` is the action button's label,
- * `dismissible` adds the close icon, and `duration` is `short`, `long`,
- * `indefinite` or milliseconds (0 for indefinite). The snackbar opens with
- * `show()` or by setting `open`, and dispatches `open`, `action` and `close`
- * (once per close, its `detail.reason` saying why).
- *
- * Snackbars share the factory's queue, elements and factories alike: one
- * shows at a time, the others wait their turn in the order they were shown.
- * `open` is true from `show()` on, while it waits too; the `open` event comes
- * when it is on screen. `queue-behavior="replace"` dismisses the one on screen
- * (its `close` gives `reason: "queue"`) and drops the waiting ones instead.
- *
- * The surface stays in the element's shadow root and opens in the top layer
- * (`layer: "top"`), above modal dialogs.
- *
- * Parts: `snackbar`, `text`.
- *
- * @module elements
- */
 import type { SnackbarComponent } from "../components/snackbar/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
 declare const snackbarSpec: {
@@ -68,7 +44,10 @@ declare const snackbarSpec: {
             set: (c: SnackbarComponent, v: unknown) => undefined;
         };
     };
-    methods: readonly ["show", "hide"];
+    methods: readonly [
+        "show",
+        "hide"
+    ];
     events: {
         open: {
             detail: () => null;
@@ -94,12 +73,9 @@ declare const snackbarSpec: {
 };
 export declare const snackbarElement: import("./define.js").ElementDefinition<SnackbarComponent>;
 export type SnackbarSpec = typeof snackbarSpec;
-/** `<m-snackbar>` as a ref or a query returns it. */
 export type SnackbarElement = ElementInstance<SnackbarSpec, SnackbarComponent>;
-/** Registers `<m-snackbar>` (or `<prefix-snackbar>`). */
 export declare const defineSnackbar: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-snackbar": SnackbarElement;
     }

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

@@ -1,33 +1,7 @@
-/**
- * `<m-split-button>` with `<m-menu-item>` children.
- *
- * The element's text (or `label`) is the leading button's label, and each
- * `<m-menu-item>` child declares one item of the menu the trailing button
- * opens, as in `<m-menu>`. The items are the factory's own menu items, so the
- * menu item declaration is shared rather than a split-button one. The menu
- * opens in the top layer (the factory's `layer: "top"`), inside the element's
- * shadow root.
- *
- * `click` is the native one, for the leading action only: a click on the
- * trailing button or in the menu stops at the shadow root. `open` and `close`
- * are dispatched as the menu opens and closes, and `select` with the item's
- * value when one is chosen.
- *
- * The factory creates its menu only when it has items: going from no items
- * to some, or back, recreates it. `variant`, `size`, `trailing-label` and
- * `group-label` have no setter and recreate it too.
- *
- * Parts: `split-button`, `button`, `leading`, `trailing`, `text`, `icon`, `chevron`, `ripple`.
- *
- * @module elements
- */
 import type { SplitButtonComponent, SplitButtonEvent, SplitButtonEventType } from "../components/split-button/types.js";
 import { type Config, type DefineOptions, type ElementInstance } from "./define.js";
-/** The factory's events, and the element's own names for two of them. */
 export type SplitButtonElementEventType = SplitButtonEventType | "open" | "close";
-/** The split button, with the element's events. */
 export interface SplitButtonElementComponent extends Omit<SplitButtonComponent, "on" | "off"> {
-    /** Subscribes by the element's event names (`open`, `close`) as well as the factory's. */
     on: (event: SplitButtonElementEventType, handler: (event: SplitButtonEvent) => void) => SplitButtonElementComponent;
     off: (event: SplitButtonElementEventType, handler: (event: SplitButtonEvent) => void) => SplitButtonElementComponent;
 }
@@ -42,7 +16,6 @@ declare const splitButtonSpec: {
             type: "string";
             update: (c: SplitButtonElementComponent, _v: import("./define.js").AttributeValue, host: HTMLElement) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         icon: {
             type: "string";
             config: string;
@@ -96,12 +69,9 @@ declare const splitButtonSpec: {
 };
 export declare const splitButtonElement: import("./define.js").ElementDefinition<SplitButtonElementComponent>;
 export type SplitButtonSpec = typeof splitButtonSpec;
-/** `<m-split-button>` as a ref or a query returns it. */
 export type SplitButtonElement = ElementInstance<SplitButtonSpec, SplitButtonElementComponent>;
-/** Registers `<m-split-button>` and `<m-menu-item>` (or with another prefix). */
 export declare const defineSplitButton: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-split-button": SplitButtonElement;
     }

package/dist/elements/styles.d.ts

@@ -1,73 +1,10 @@
-/**
- * Stylesheets for the shadow roots of the elements.
- *
- * Each element adopts the CSS of its component and the component's style
- * dependencies, the same entries the selective stylesheets are built from
- * (`scripts/style-manifest.ts`). One sheet per entry per page, shared by every
- * instance.
- *
- * @module elements
- */
-/** The tag prefix: `<m-switch>`. The pre-upgrade CSS is built for it. */
 export declare const DEFAULT_PREFIX = "m";
-/** Internal registry access; preserves application registrations and overrides. */
 export declare const styleText: (name: string) => string | undefined;
-/** Identifies only fallback nodes inserted by applyStyles, never authored styles. */
 export declare const isFallbackStyle: (node: Node) => boolean;
-/**
- * Registers the CSS text of style entries, keyed as in `componentStyles`.
- * Must run before the elements that use them are created.
- *
- * @experimental The element authoring API (`defineElement`, `ElementSpec`,
- * `registerStyles`, `hasStyles`, `SHADOW_BASE_STYLES`) is outside semantic
- * versioning in 3.x: it may change in a minor release. The elements the
- * library defines, and their attributes, properties and events, are not.
- */
 export declare const registerStyles: (css: Record<string, string>) => void;
-/**
- * Whether CSS is registered under a name.
- *
- * @experimental The element authoring API (`defineElement`, `ElementSpec`,
- * `registerStyles`, `hasStyles`, `SHADOW_BASE_STYLES`) is outside semantic
- * versioning in 3.x: it may change in a minor release. The elements the
- * library defines, and their attributes, properties and events, are not.
- */
 export declare const hasStyles: (name: string) => boolean;
-/**
- * On a host the server rendered with a declarative shadow root.
- * The `data-mtrl-*` namespace is the library's own: this attribute, and the
- * elements' `marker` reflections (define.ts), which no component or page
- * writes. Component `data-*` names (`data-id`, `data-density`, `data-theme`)
- * are that component's own state, and a page's `data-ssr` must not be this
- * contract. Inert after upgrade, because the rollback rule is `:not(:defined)`.
- */
 export declare const RENDERED_HOST_ATTRIBUTE = "data-mtrl-ssr";
-/**
- * Last rule of every pre-upgrade sheet, inside `mtrl.preupgrade`.
- * `:not(#\0)` is an id selector (specificity 1,0,0) that matches every element,
- * so each selector outranks every pre-upgrade selector of the same subject
- * (the host, its `::before` and `::after`, and a direct child), none of which
- * has an id. The child subject is `:defined` (specificity 1,3,0). Every
- * built-in element is defined, so a slotted `div` or `span` is rolled back.
- * An undefined custom element is not: a carousel, a FAB menu, or a menu that
- * opted out keeps its own pre-upgrade rule. A rendered mtrl child carries
- * this attribute and is covered by the host selector. The deepest pre-upgrade
- * subject is a direct child, including a following sibling of one (`> * + *`);
- * none styles a grandchild or a child's pseudo-element. `all` does not reset
- * custom properties; the element rules set none. Not tag-specific, so
- * retagging for another prefix leaves it as it is.
- */
 export declare const preupgradeRollback: () => string;
-/**
- * Pre-upgrade CSS, built for the default prefix, for another one: every tag
- * selector `m-*` becomes `<prefix>-*`. The rules name tags only in selectors
- * (`m-tabs:not(:defined)>*`), and no value starts a word with `m-`.
- */
 export declare const retagPreupgrade: (css: string, prefix: string) => string;
-/** The rules as one layered stylesheet, for each prefix. The rollback is once, after them. */
 export declare const preupgradeSheet: (css: string, prefixes?: Iterable<string>) => string;
-/**
- * Applies the registered entries to a shadow root, in the given order.
- * Falls back to `<style>` elements where constructable stylesheets are missing.
- */
 export declare const applyStyles: (root: ShadowRoot, names: readonly string[]) => void;

package/dist/elements/switch.d.ts

@@ -1,15 +1,3 @@
-/**
- * `<m-switch>`: the switch 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. Children are the label.
- *
- * Parts: `switch`, `container`, `content`, `label`, `helper`, `input`, `track`, `thumb`,
- * `thumb-icon`.
- *
- * @module elements
- */
 import type { SwitchComponent } from "../components/switch/types.js";
 import { type DefineOptions, type ElementInstance } from "./define.js";
 declare const switchSpec: {
@@ -37,7 +25,6 @@ declare const switchSpec: {
             config: string;
             update: (c: SwitchComponent, v: import("./define.js").AttributeValue) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         icon: {
             type: "string";
             config: string;
@@ -60,7 +47,11 @@ declare const switchSpec: {
             config: string;
         };
     };
-    methods: readonly ["toggle", "check", "uncheck"];
+    methods: readonly [
+        "toggle",
+        "check",
+        "uncheck"
+    ];
     model: "checked";
     events: {
         change: {
@@ -88,12 +79,9 @@ declare const switchSpec: {
 };
 export declare const switchElement: import("./define.js").ElementDefinition<SwitchComponent>;
 export type SwitchSpec = typeof switchSpec;
-/** `<m-switch>` as a ref or a query returns it. */
 export type SwitchElement = ElementInstance<SwitchSpec, SwitchComponent>;
-/** Registers `<m-switch>` (or `<prefix-switch>`). */
 export declare const defineSwitch: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-switch": SwitchElement;
     }

package/dist/elements/tabs.d.ts

@@ -1,17 +1,3 @@
-/**
- * `<m-tabs>` with `<m-tab>` children.
- *
- * Each `<m-tab>` declares one tab (`value`, `icon`, `badge`, `disabled`, and its
- * text as content). The tabs element reads them into the factory's config and
- * rebuilds when they change; the children stay where the framework put them.
- * `value` on `<m-tabs>` is the default selection, which moves the live one
- * until the user or script changes it; the `value` property is the live
- * selection.
- *
- * Parts: `tabs`, `scroll`, `tab`, `button`, `icon`, `text`, `ripple`, `indicator`, `divider`.
- *
- * @module elements
- */
 import type { TabsComponent } from "../components/tabs/types.js";
 import { type Config, type DefineOptions, type ElementAttributes, type ElementInstance } from "./define.js";
 declare const tabsSpec: {
@@ -47,12 +33,7 @@ declare const tabsSpec: {
 };
 export declare const tabsElement: import("./define.js").ElementDefinition<TabsComponent>;
 export type TabsSpec = typeof tabsSpec;
-/** `<m-tabs>` as a ref or a query returns it. */
 export type TabsElement = ElementInstance<TabsSpec, TabsComponent>;
-/**
- * `<m-tab>` declares one tab and renders nothing. Its text content is the
- * label unless `label` is set.
- */
 export declare const tabDeclaration: {
     readonly name: "tab";
     readonly attributes: {
@@ -62,7 +43,6 @@ export declare const tabDeclaration: {
         readonly label: {
             readonly type: "string";
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         readonly icon: {
             readonly type: "string";
         };
@@ -75,10 +55,8 @@ export declare const tabDeclaration: {
     };
 };
 export type TabAttributes = ElementAttributes<typeof tabDeclaration>;
-/** Registers `<m-tabs>` and `<m-tab>` (or with another prefix). */
 export declare const defineTabs: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-tabs": TabsElement;
         "m-tab": HTMLElement & TabAttributes;

package/dist/elements/text-field.d.ts

@@ -1,33 +1,6 @@
-/**
- * `<m-text-field>`: the text field as a form-associated custom element.
- *
- * The `value` attribute is the default value and the `value` property the
- * live one, as on a native input: the attribute moves the value until the
- * user or script changes it. The `label` attribute is the floating
- * label, which the factory renders; there is no slot. The `trailing-icon`
- * attribute is the trailing icon's markup and `trailing-icon-label` its
- * button's accessible name: without the label the icon is decorative.
- *
- * Changing `label` or `type` recreates the field and keeps the value.
- * Changing `trailing-icon-label` updates the existing icon in place, so the
- * button, the input and focus stay. A field created without a label has no
- * label element to update, and `type="multiline"` swaps the input for a
- * textarea.
- *
- * A click, Enter or Space on the trailing icon button dispatches `trailing`
- * from the host, with the factory's `{ value, event }`, bubbling and composed.
- *
- * Parts: `text-field`, `field`, `label`, `input`, `leading-icon`, `trailing-icon`, `prefix`,
- * `suffix`, `supporting`, `helper`, `counter`, `outline`, `outline-leading`, `outline-notch`,
- * `outline-trailing`.
- *
- * @module elements
- */
 import type { TextFieldComponent } from "../components/text-field/types.js";
 import { type AttributeValue, type DefineOptions, type ElementInstance } from "./define.js";
-/** The text field, with the methods the element adds to it. */
 export type TextFieldElementComponent = TextFieldComponent & {
-    /** Selects the field's text. */
     select: () => void;
 };
 declare const textFieldSpec: {
@@ -79,23 +52,16 @@ declare const textFieldSpec: {
             config: string;
             update: (c: TextFieldElementComponent, v: AttributeValue) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         "leading-icon": {
             type: "string";
             config: string;
             update: (c: TextFieldElementComponent, v: AttributeValue) => undefined;
         };
-        /** Markup (HTML). Not sanitized by default: see Markup and sanitizing. */
         "trailing-icon": {
             type: "string";
             config: string;
             update: (c: TextFieldElementComponent, v: AttributeValue, host: HTMLElement) => undefined;
         };
-        /**
-         * The trailing icon button's accessible name. With it the icon is a button
-         * that emits `trailing`; without it, or with an empty value, the icon is
-         * decorative. A change updates the existing icon through the factory setter.
-         */
         "trailing-icon-label": {
             type: "string";
             config: string;
@@ -148,7 +114,10 @@ declare const textFieldSpec: {
             set: (c: TextFieldElementComponent, v: unknown) => undefined;
         };
     };
-    methods: readonly ["select", "setError"];
+    methods: readonly [
+        "select",
+        "setError"
+    ];
     model: "value";
     events: {
         input: {
@@ -182,12 +151,9 @@ declare const textFieldSpec: {
 };
 export declare const textFieldElement: import("./define.js").ElementDefinition<TextFieldElementComponent>;
 export type TextFieldSpec = typeof textFieldSpec;
-/** `<m-text-field>` as a ref or a query returns it. */
 export type TextFieldElement = ElementInstance<TextFieldSpec, TextFieldElementComponent>;
-/** Registers `<m-text-field>` (or `<prefix-text-field>`). */
 export declare const defineTextField: (options?: DefineOptions) => string;
 declare global {
-    /** `document.querySelector("m-…")` and `createElement` return the element's type (the default prefix). */
     interface HTMLElementTagNameMap {
         "m-text-field": TextFieldElement;
     }