@m3e/web 2.0.0

package/dist/src/fab-menu/FabMenuElement.d.ts

@@ -0,0 +1,110 @@
+import { CSSResultGroup, LitElement, PropertyValues } from "lit";
+import { FabMenuVariant } from "./FabMenuVariant";
+declare const M3eFabMenuElement_base: import("../core/shared/mixins/Constructor").Constructor & typeof LitElement;
+/**
+ * A menu, opened from a floating action button (FAB), used to display multiple related actions.
+ *
+ * @description
+ * The `m3e-fab-menu` component presents a dynamic menu of related actions, elegantly revealed from a
+ * floating action button (FAB). Designed using expressive, adaptive surfaces, it enables seamless access
+ * to contextual actions in modern, visually rich interfaces.
+ *
+ * @example
+ * The following example illustrates triggering a `m3e-fab-menu` from an `m3e-fab` using a `m3e-fab-menu-trigger`.
+ * ```html
+ * <m3e-fab variant="primary" size="large">
+ *  <m3e-fab-menu-trigger for="fabmenu">
+ *    <m3e-icon name="edit"></m3e-icon>
+ *  </m3e-fab-menu-trigger>
+ * </m3e-fab>
+ * <m3e-fab-menu id="fabmenu" variant="secondary">
+ *  <m3e-fab-menu-item>First</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Second</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Third</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Forth</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Fifth</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Sixth</m3e-fab-menu-item>
+ * </m3e-fab-menu>
+ * ```
+ *
+ * @tag m3e-fab-menu
+ *
+ * @slot - Renders the contents of the menu.
+ *
+ * @attr variant - The appearance variant of the menu.
+ *
+ * @fires beforetoggle - Dispatched before the toggle state changes.
+ * @fires toggle - Dispatched after the toggle state has changed.
+ *
+ * @cssprop --m3e-fab-menu-spacing - Vertical gap between menu items.
+ * @cssprop --m3e-fab-menu-max-width - Maximum width of the menu.
+ * @cssprop --m3e-primary-fab-color - Foreground color for primary variant items.
+ * @cssprop --m3e-primary-fab-container-color - Container color for primary variant items.
+ * @cssprop --m3e-primary-fab-hover-color - Hover background color for primary variant items.
+ * @cssprop --m3e-primary-fab-focus-color - Focus background color for primary variant items.
+ * @cssprop --m3e-primary-fab-ripple-color - Ripple color for primary variant items.
+ * @cssprop --m3e-secondary-fab-color - Foreground color for secondary variant items.
+ * @cssprop --m3e-secondary-fab-container-color - Container color for secondary variant items.
+ * @cssprop --m3e-secondary-fab-hover-color - Hover background color for secondary variant items.
+ * @cssprop --m3e-secondary-fab-focus-color - Focus background color for secondary variant items.
+ * @cssprop --m3e-secondary-fab-ripple-color - Ripple color for secondary variant items.
+ * @cssprop --m3e-tertiary-fab-color - Foreground color for tertiary variant items.
+ * @cssprop --m3e-tertiary-fab-container-color - Container color for tertiary variant items.
+ * @cssprop --m3e-tertiary-fab-hover-color - Hover background color for tertiary variant items.
+ * @cssprop --m3e-tertiary-fab-focus-color - Focus background color for tertiary variant items.
+ * @cssprop --m3e-tertiary-fab-ripple-color - Ripple color for tertiary variant items.
+ */
+export declare class M3eFabMenuElement extends M3eFabMenuElement_base {
+    #private;
+    /** The styles of the element. */
+    static styles: CSSResultGroup;
+    /**
+     * The appearance variant of the menu.
+     * @default "primary"
+     */
+    variant: FabMenuVariant;
+    /** Whether the menu is open. */
+    get isOpen(): boolean;
+    /**
+     * Opens the menu.
+     * @param {HTMLElement} trigger The element that triggered the menu.
+     * @returns {Promise<void>} A `Promise` that resolves when the menu is opened.
+     */
+    show(trigger: HTMLElement): Promise<void>;
+    /**
+     * Hides the menu.
+     * @param {boolean} [restoreFocus=false] A value indicating whether to restore focus to the menu's trigger.
+     */
+    hide(restoreFocus?: boolean): void;
+    /**
+     * Toggles the menu.
+     * @param {HTMLElement} trigger The element that triggered the menu.
+     * @returns {Promise<void>} A `Promise` that resolves when the menu is opened or closed.
+     */
+    toggle(trigger: HTMLElement): Promise<void>;
+    /** @inheritdoc */
+    connectedCallback(): void;
+    /** @inheritdoc */
+    disconnectedCallback(): void;
+    /** @inheritdoc */
+    protected firstUpdated(_changedProperties: PropertyValues): void;
+    /** @inheritdoc */
+    protected render(): unknown;
+}
+interface M3eFabMenuElementEventMap extends HTMLElementEventMap {
+    beforetoggle: ToggleEvent;
+    toggle: ToggleEvent;
+}
+export interface M3eFabMenuElement {
+    addEventListener<K extends keyof M3eFabMenuElementEventMap>(type: K, listener: (this: M3eFabMenuElement, ev: M3eFabMenuElementEventMap[K]) => void, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof M3eFabMenuElementEventMap>(type: K, listener: (this: M3eFabMenuElement, ev: M3eFabMenuElementEventMap[K]) => void, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "m3e-fab-menu": M3eFabMenuElement;
+    }
+}
+export {};
+//# sourceMappingURL=FabMenuElement.d.ts.map

package/dist/src/fab-menu/FabMenuElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FabMenuElement.d.ts","sourceRoot":"","sources":["../../../src/fab-menu/FabMenuElement.ts"],"names":[],"mappings":"AACA,OAAO,EAAO,cAAc,EAAQ,UAAU,EAAE,cAAc,EAAa,MAAM,KAAK,CAAC;AAUvF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;;AAGlD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,qBACa,iBAAkB,SAAQ,sBAAwB;;IAC7D,iCAAiC;IACjC,OAAgB,MAAM,EAAE,cAAc,CA8FpC;IA8BF;;;OAGG;IAC0B,OAAO,EAAE,cAAc,CAAa;IAEjE,gCAAgC;IAChC,IAAI,MAAM,YAET;IAED;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC/C;;;OAGG;IACH,IAAI,CAAC,YAAY,GAAE,OAAe,GAAG,IAAI;IAkBzC;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjD,kBAAkB;IACT,iBAAiB,IAAI,IAAI;IAYlC,kBAAkB;IACT,oBAAoB,IAAI,IAAI;IAQrC,kBAAkB;cACC,YAAY,CAAC,kBAAkB,EAAE,cAAc,GAAG,IAAI;IAKzE,kBAAkB;cACC,MAAM,IAAI,OAAO;CA2DrC;AAED,UAAU,yBAA0B,SAAQ,mBAAmB;IAC7D,YAAY,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,CAAC,SAAS,MAAM,yBAAyB,EACxD,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7E,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;IAER,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kCAAkC,EAC5C,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,CAAC;IAER,mBAAmB,CAAC,CAAC,SAAS,MAAM,yBAAyB,EAC3D,IAAI,EAAE,CAAC,EACP,QAAQ,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7E,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GACvC,IAAI,CAAC;IAER,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,kCAAkC,EAC5C,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,GACvC,IAAI,CAAC;CACT;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,cAAc,EAAE,iBAAiB,CAAC;KACnC;CACF"}

package/dist/src/fab-menu/FabMenuItemElement.d.ts

@@ -0,0 +1,74 @@
+import { CSSResultGroup, LitElement, PropertyValues } from "lit";
+import type { M3eFabMenuElement } from "./FabMenuElement";
+declare const M3eFabMenuItemElement_base: import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").LinkButtonMixin> & import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").DisabledMixin> & import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").AttachInternalsMixin> & import("../core/shared/mixins/Constructor").Constructor & typeof LitElement;
+/**
+ * An item of a floating action button (FAB) menu.
+ *
+ * @example
+ * The following example illustrates triggering a `m3e-fab-menu` from an `m3e-fab` using a `m3e-fab-menu-trigger`.
+ * ```html
+ * <m3e-fab variant="primary" size="large">
+ *  <m3e-fab-menu-trigger for="fabmenu">
+ *    <m3e-icon name="edit"></m3e-icon>
+ *  </m3e-fab-menu-trigger>
+ * </m3e-fab>
+ * <m3e-fab-menu id="fabmenu" variant="secondary">
+ *  <m3e-fab-menu-item>First</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Second</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Third</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Forth</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Fifth</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Sixth</m3e-fab-menu-item>
+ * </m3e-fab-menu>
+ * ```
+ *
+ * @tag m3e-menu-item
+ *
+ * @slot - Renders the label of the item.
+ * @slot icon - Renders an icon before the items's label.
+ *
+ * @attr disabled - Whether the element is disabled.
+ * @attr download - A value indicating whether the `target` of the link button will be downloaded, optionally specifying the new name of the file.
+ * @attr href - The URL to which the link button points.
+ * @attr rel - The relationship between the `target` of the link button and the document.
+ * @attr target - The target of the link button.
+ *
+ * @fires click - Emitted when the element is clicked.
+ *
+ * @cssprop --m3e-fab-menu-item-height - Height of the menu item.
+ * @cssprop --m3e-fab-menu-item-font-size - Font size of the menu item label.
+ * @cssprop --m3e-fab-menu-item-font-weight - Font weight of the menu item label.
+ * @cssprop --m3e-fab-menu-item-line-height - Line height of the menu item label.
+ * @cssprop --m3e-fab-menu-item-tracking - Letter spacing of the menu item label.
+ * @cssprop --m3e-fab-menu-item-shape - Border radius of the menu item.
+ * @cssprop --m3e-fab-menu-item-leading-space - Padding at the start of the menu item.
+ * @cssprop --m3e-fab-menu-item-trailing-space - Padding at the end of the menu item.
+ * @cssprop --m3e-fab-menu-item-spacing - Gap between icon and label.
+ * @cssprop --m3e-fab-menu-item-icon-size - Size of the icon in the menu item.
+ */
+export declare class M3eFabMenuItemElement extends M3eFabMenuItemElement_base {
+    #private;
+    /** The styles of the element. */
+    static styles: CSSResultGroup;
+    /** @private */ private readonly _elevation?;
+    /** @private */ private readonly _focusRing?;
+    /** @private */ private readonly _stateLayer?;
+    /** @private */ private readonly _ripple?;
+    /** The floating action button (FAB) menu to which this item belongs. */
+    get menu(): M3eFabMenuElement | null;
+    /** @inheritdoc */
+    connectedCallback(): void;
+    /** @inheritdoc */
+    disconnectedCallback(): void;
+    /** @inheritdoc */
+    protected firstUpdated(_changedProperties: PropertyValues<this>): void;
+    /** @inheritdoc */
+    render(): unknown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "m3e-fab-menu-item": M3eFabMenuItemElement;
+    }
+}
+export {};
+//# sourceMappingURL=FabMenuItemElement.d.ts.map

package/dist/src/fab-menu/FabMenuItemElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FabMenuItemElement.d.ts","sourceRoot":"","sources":["../../../src/fab-menu/FabMenuItemElement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,cAAc,EAAQ,UAAU,EAAE,cAAc,EAAa,MAAM,KAAK,CAAC;AAiBvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBACa,qBAAsB,SAAQ,0BAE1C;;IACC,iCAAiC;IACjC,OAAgB,MAAM,EAAE,cAAc,CA8HpC;IAEF,eAAe,CAAsB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAsB;IACvF,eAAe,CAAuB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAsB;IACxF,eAAe,CAAwB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAuB;IAC3F,eAAe,CAAmB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAmB;IAI9E,wEAAwE;IACxE,IAAI,IAAI,IAAI,iBAAiB,GAAG,IAAI,CAEnC;IAED,kBAAkB;IACT,iBAAiB,IAAI,IAAI;IAKlC,kBAAkB;IACT,oBAAoB,IAAI,IAAI;IAKrC,kBAAkB;cACC,YAAY,CAAC,kBAAkB,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,IAAI;IAK/E,kBAAkB;IACT,MAAM,IAAI,OAAO;CAqB3B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,qBAAqB,CAAC;KAC5C;CACF"}

package/dist/src/fab-menu/FabMenuTriggerElement.d.ts

@@ -0,0 +1,43 @@
+import { ActionElementBase } from "@m3e/web/core";
+import { M3eFabMenuElement } from "./FabMenuElement";
+declare const M3eFabMenuTriggerElement_base: import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").HtmlForMixin> & typeof ActionElementBase;
+/**
+ * An element, nested within a clickable element, used to open a floating action button (FAB) menu.
+ *
+ * @example
+ * The following example illustrates triggering a `m3e-fab-menu` from an `m3e-fab` using a `m3e-fab-menu-trigger`.
+ * ```html
+ * <m3e-fab variant="primary" size="large">
+ *  <m3e-fab-menu-trigger for="fabmenu">
+ *    <m3e-icon name="edit"></m3e-icon>
+ *  </m3e-fab-menu-trigger>
+ * </m3e-fab>
+ * <m3e-fab-menu id="fabmenu" variant="secondary">
+ *  <m3e-fab-menu-item>First</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Second</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Third</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Forth</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Fifth</m3e-fab-menu-item>
+ *  <m3e-fab-menu-item>Sixth</m3e-fab-menu-item>
+ * </m3e-fab-menu>
+ * ```
+ *
+ * @tag m3e-fab-menu-trigger
+ */
+export declare class M3eFabMenuTriggerElement extends M3eFabMenuTriggerElement_base {
+    /** The menu triggered by the element. */
+    get menu(): M3eFabMenuElement | null;
+    /** @inheritdoc */
+    attach(control: HTMLElement): void;
+    /** @inheritdoc */
+    detach(): void;
+    /** @inheritdoc */
+    _onClick(): void;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "m3e-fab-menu-trigger": M3eFabMenuTriggerElement;
+    }
+}
+export {};
+//# sourceMappingURL=FabMenuTriggerElement.d.ts.map

package/dist/src/fab-menu/FabMenuTriggerElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FabMenuTriggerElement.d.ts","sourceRoot":"","sources":["../../../src/fab-menu/FabMenuTriggerElement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAW,MAAM,eAAe,CAAC;AAG3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBACa,wBAAyB,SAAQ,6BAA0B;IACtE,yCAAyC;IACzC,IAAI,IAAI,IAAI,iBAAiB,GAAG,IAAI,CAEnC;IAED,kBAAkB;IACT,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAY3C,kBAAkB;IACT,MAAM,IAAI,IAAI;IAYvB,kBAAkB;IACT,QAAQ,IAAI,IAAI;CAK1B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,sBAAsB,EAAE,wBAAwB,CAAC;KAClD;CACF"}

package/dist/src/fab-menu/FabMenuVariant.d.ts

@@ -0,0 +1,3 @@
+/** Specifies the possible appearance variants of a floating-action button menu. */
+export type FabMenuVariant = "primary" | "secondary" | "tertiary";
+//# sourceMappingURL=FabMenuVariant.d.ts.map

package/dist/src/fab-menu/FabMenuVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FabMenuVariant.d.ts","sourceRoot":"","sources":["../../../src/fab-menu/FabMenuVariant.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC"}

package/dist/src/fab-menu/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./FabMenuElement";
+export * from "./FabMenuItemElement";
+export * from "./FabMenuTriggerElement";
+export * from "./FabMenuVariant";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/fab-menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fab-menu/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC"}

package/dist/src/form-field/FloatLabelType.d.ts

@@ -0,0 +1,3 @@
+/** Specifies the possible behaviors used to float labels in a form field. */
+export type FloatLabelType = "always" | "auto";
+//# sourceMappingURL=FloatLabelType.d.ts.map

package/dist/src/form-field/FloatLabelType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FloatLabelType.d.ts","sourceRoot":"","sources":["../../../src/form-field/FloatLabelType.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC"}

package/dist/src/form-field/FormFieldControl.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Adapted from Angular Material Form Field Control
+ * Source: https://github.com/angular/components/blob/main/src/material/form-field/form-field-control.ts
+ *
+ * @license MIT
+ * Copyright (c) 2025 Google LLC
+ * See LICENSE file in the project root for full license text.
+ */
+/** An interface which allows a control to work inside of a `M3eFormField`. */
+export interface FormFieldControl extends HTMLElement {
+    /** A value indicating whether the control is disabled. */
+    disabled: boolean;
+    /** The value of the control. */
+    value?: unknown;
+    /** A value indicating whether the control is required. */
+    required?: boolean;
+    /** A value indicated whether the content of the control is read-only. */
+    readonly?: boolean;
+    /** A value indicating whether the form field's label should try to float. */
+    readonly shouldLabelFloat?: boolean;
+    /** The error message that would be displayed if the user submits the form, or an empty string if no error message. */
+    readonly validationMessage?: string;
+    /** The `HTMLFormElement` associated with this element. */
+    readonly form?: HTMLFormElement | null;
+    /**
+     * Handles the click event on the control's container.
+     * @param {MouseEvent} event The `MouseEvent`.
+     */
+    onContainerClick?: (event: MouseEvent) => void;
+    /**
+     * Returns `true` if the element has no validity problems; otherwise,
+     * returns `false`, fires an invalid event.
+     */
+    checkValidity?: () => boolean;
+}
+/**
+ * Determines whether a value is a `FormFieldControl`.
+ * @param {unknown} value The value to test.
+ * @returns {value is FormFieldControl} A value indicating whether `value` is a `FormFieldControl`.
+ */
+export declare function isFormFieldControl(value: unknown): value is FormFieldControl;
+/**
+ * Locates the first `FormFieldControl` in a given slot.
+ * @param {HTMLSlotElement} slot The slot in which to locate a `FormFieldControl`.
+ * @returns {FormFieldControl | null} The `FormFieldControl` located in `slot`.
+ */
+export declare function findFormFieldControl(slot: HTMLSlotElement): FormFieldControl | null;
+//# sourceMappingURL=FormFieldControl.d.ts.map

package/dist/src/form-field/FormFieldControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldControl.d.ts","sourceRoot":"","sources":["../../../src/form-field/FormFieldControl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,0DAA0D;IAC1D,QAAQ,EAAE,OAAO,CAAC;IAElB,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,6EAA6E;IAC7E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAEpC,sHAAsH;IACtH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAEpC,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAE/C;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;CAC/B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAQ5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,GAAG,gBAAgB,GAAG,IAAI,CAenF"}

package/dist/src/form-field/FormFieldElement.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Adapted from Angular Material Form Field
+ * Source: https://github.com/angular/components/blob/main/src/material/form-field/form-field.ts
+ *
+ * @license MIT
+ * Copyright (c) 2025 Google LLC
+ * See LICENSE file in the project root for full license text.
+ */
+import { CSSResultGroup, LitElement, PropertyValues } from "lit";
+import { FormFieldControl } from "./FormFieldControl";
+import { FormFieldVariant } from "./FormFieldVariant";
+import { HideSubscriptType } from "./HideSubscriptType";
+import { FloatLabelType } from "./FloatLabelType";
+declare const M3eFormFieldElement_base: import("../core/shared/mixins/Constructor").Constructor<import("@m3e/web/core").AttachInternalsMixin> & typeof LitElement;
+/**
+ * A container for form controls that applies Material Design styling and behavior.
+ *
+ * @description
+ * The `m3e-form-field` component is a semantic, expressive container for form controls that anchors
+ * label behavior, subscript messaging, and variant-specific layout. Designed according to Material Design 3
+ * guidelines, it supports two visual variants—`outlined` and `filled`—each with dynamic elevation,
+ * shape transitions, and adaptive color theming. The component responds to control state changes
+ * (focus, hover, press, disabled, invalid) with smooth motion and semantic clarity, ensuring
+ * visual hierarchy and emotional resonance.
+
+ * The component is accessible by default, with ARIA annotations, contrast-safe color tokens,
+ * and dynamic descriptions for hint and error messaging. It supports prefix and suffix content,
+ * floating labels, and adaptive subscript visibility. When hosting a control with validation,
+ * error messages are surfaced with `aria-invalid` and described for assistive technology.
+
+ * Native form controls may not expose full state or messaging on their own. `m3e-form-field` bridges
+ * these gaps by coordinating label floating, container styling, and subscript feedback.
+ *
+ * @example
+ * The following example illustrates a basic usage of the `m3e-form-field`.
+ * ```html
+ * <m3e-form-field>
+ *  <label slot="label" for="field">Text field</label>
+ *  <input id="field" />
+ * </m3e-form-field>
+ * ```
+ *
+ * @tag m3e-form-field
+ *
+ * @slot - Renders the control of the field.
+ * @slot prefix - Renders content before the fields's control.
+ * @slot prefix-text - Renders text before the fields's control.
+ * @slot suffix - Renders content after the fields's control.
+ * @slot suffix-text - Renders text after the fields's control.
+ * @slot hint - Renders hint text in the fields's subscript, when the control is valid.
+ * @slot error - Renders error text in the fields's subscript, when the control is invalid.
+ *
+ * @attr float-label - Specifies whether the label should float always or only when necessary.
+ * @attr hide-required-marker - Whether the required marker should be hidden.
+ * @attr hide-subscript - Whether subscript content is hidden.
+ * @attr variant - The appearance variant of the field.
+ *
+ * @cssprop --m3e-form-field-font-size - Font size for the form field container text.
+ * @cssprop --m3e-form-field-font-weight - Font weight for the form field container text.
+ * @cssprop --m3e-form-field-line-height - Line height for the form field container text.
+ * @cssprop --m3e-form-field-tracking - Letter spacing for the form field container text.
+ * @cssprop --m3e-form-field-label-font-size - Font size for the floating label.
+ * @cssprop --m3e-form-field-label-font-weight - Font weight for the floating label.
+ * @cssprop --m3e-form-field-label-line-height - Line height for the floating label.
+ * @cssprop --m3e-form-field-label-tracking - Letter spacing for the floating label.
+ * @cssprop --m3e-form-field-subscript-font-size - Font size for hint and error text.
+ * @cssprop --m3e-form-field-subscript-font-weight - Font weight for hint and error text.
+ * @cssprop --m3e-form-field-subscript-line-height - Line height for hint and error text.
+ * @cssprop --m3e-form-field-subscript-tracking - Letter spacing for hint and error text.
+ * @cssprop --m3e-form-field-color - Text color for the form field container.
+ * @cssprop --m3e-form-field-subscript-color - Color for hint and error text.
+ * @cssprop --m3e-form-field-invalid-color - Color used when the control is invalid.
+ * @cssprop --m3e-form-field-focused-outline-color - Outline color when focused.
+ * @cssprop --m3e-form-field-focused-color - Label color when focused.
+ * @cssprop --m3e-form-field-outline-color - Outline color in outlined variant.
+ * @cssprop --m3e-form-field-container-color - Background color in filled variant.
+ * @cssprop --m3e-form-field-hover-container-color - Hover background color in filled variant.
+ * @cssprop --m3e-form-field-width - Width of the form field container.
+ * @cssprop --m3e-form-field-icon-size - Size of prefix and suffix icons.
+ * @cssprop --m3e-outlined-form-field-container-shape - Corner radius for outlined container.
+ * @cssprop --m3e-form-field-container-shape - Corner radius for filled container.
+ * @cssprop --m3e-form-field-hover-container-opacity - Opacity for hover background in filled variant.
+ * @cssprop --m3e-form-field-disabled-opacity - Opacity for disabled text.
+ * @cssprop --m3e-form-field-disabled-container-opacity - Opacity for disabled container background.
+ */
+export declare class M3eFormFieldElement extends M3eFormFieldElement_base {
+    #private;
+    /** The styles of the element. */
+    static styles: CSSResultGroup;
+    /** @private */ private readonly _base;
+    /** @private */ private readonly _prefix;
+    /** @private */ private readonly _error;
+    /** @private */ private readonly _hint;
+    /** @private */ private _pseudoLabel;
+    /** @private */ private _required;
+    /** @private */ private _invalid;
+    /** @private */ private _validationMessage;
+    constructor();
+    /** A reference to the element used to anchor dropdown menus. */
+    get menuAnchor(): HTMLElement;
+    /** A reference to the hosted form field control. */
+    get control(): FormFieldControl | null;
+    /**
+     * The appearance variant of the field.
+     * @default "outlined"
+     */
+    variant: FormFieldVariant;
+    /**
+     * Whether the required marker should be hidden.
+     * @default false
+     */
+    hideRequiredMarker: boolean;
+    /**
+     * Whether subscript content is hidden.
+     * @default "auto"
+     */
+    hideSubscript: HideSubscriptType;
+    /**
+     * Specifies whether the label should float always or only when necessary.
+     * @default "auto"
+     */
+    floatLabel: FloatLabelType;
+    /**
+     * Notifies the form field that the state of the hosted `control` has changed.
+     * @param {boolean} [checkValidity=false] Whether to check validity.
+     */
+    notifyControlStateChange(checkValidity?: boolean): void;
+    /** @inheritdoc */
+    connectedCallback(): void;
+    /** @inheritdoc */
+    disconnectedCallback(): void;
+    /** @private */
+    protected firstUpdated(_changedProperties: PropertyValues): void;
+    /** @inheritdoc */
+    protected update(changedProperties: PropertyValues): void;
+    /** @inheritdoc */
+    protected render(): unknown;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        "m3e-form-field": M3eFormFieldElement;
+    }
+}
+export {};
+//# sourceMappingURL=FormFieldElement.d.ts.map

package/dist/src/form-field/FormFieldElement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldElement.d.ts","sourceRoot":"","sources":["../../../src/form-field/FormFieldElement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAO,cAAc,EAAQ,UAAU,EAAW,cAAc,EAAa,MAAM,KAAK,CAAC;AAmBhG,OAAO,EAAwB,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,qBACa,mBAAoB,SAAQ,wBAA2B;;IAgClE,iCAAiC;IACjC,OAAgB,MAAM,EAAE,cAAc,CAqZpC;IAoCF,eAAe,CAAiB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrE,eAAe,CAAmB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACzE,eAAe,CAAkB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACvE,eAAe,CAAiB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IAiBrE,eAAe,CAAU,OAAO,CAAC,YAAY,CAAM;IACnD,eAAe,CAAU,OAAO,CAAC,SAAS,CAAS;IACnD,eAAe,CAAU,OAAO,CAAC,QAAQ,CAAS;IAClD,eAAe,CAAU,OAAO,CAAC,kBAAkB,CAAM;;IAoBzD,gEAAgE;IAChE,IAAI,UAAU,gBAEb;IAED,oDAAoD;IACpD,IAAI,OAAO,4BAEV;IAED;;;OAGG;IAC0B,OAAO,EAAE,gBAAgB,CAAc;IAEpE;;;OAGG;IAC4E,kBAAkB,UAAS;IAE1G;;;OAGG;IACuD,aAAa,EAAE,iBAAiB,CAAU;IAEpG;;;OAGG;IACoD,UAAU,EAAE,cAAc,CAAU;IAE3F;;;OAGG;IACH,wBAAwB,CAAC,aAAa,GAAE,OAAe,GAAG,IAAI;IAqB9D,kBAAkB;IACT,iBAAiB,IAAI,IAAI;IAMlC,kBAAkB;IACT,oBAAoB,IAAI,IAAI;IAKrC,eAAe;cACI,YAAY,CAAC,kBAAkB,EAAE,cAAc,GAAG,IAAI;IAYzE,kBAAkB;cACC,MAAM,CAAC,iBAAiB,EAAE,cAAc,GAAG,IAAI;IAgBlE,kBAAkB;cACC,MAAM,IAAI,OAAO;CA6MrC;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,mBAAmB,CAAC;KACvC;CACF"}

package/dist/src/form-field/FormFieldVariant.d.ts

@@ -0,0 +1,3 @@
+/** Specifies the possible appearance variants of a form field. */
+export type FormFieldVariant = "filled" | "outlined";
+//# sourceMappingURL=FormFieldVariant.d.ts.map

package/dist/src/form-field/FormFieldVariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormFieldVariant.d.ts","sourceRoot":"","sources":["../../../src/form-field/FormFieldVariant.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAC"}

package/dist/src/form-field/HideSubscriptType.d.ts

@@ -0,0 +1,3 @@
+/** Specifies the possible behavior modes used to hide subscript content in a form field. */
+export type HideSubscriptType = "always" | "auto" | "never";
+//# sourceMappingURL=HideSubscriptType.d.ts.map

package/dist/src/form-field/HideSubscriptType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HideSubscriptType.d.ts","sourceRoot":"","sources":["../../../src/form-field/HideSubscriptType.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC"}

package/dist/src/form-field/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./FloatLabelType";
+export * from "./FormFieldControl";
+export * from "./FormFieldElement";
+export * from "./FormFieldVariant";
+export * from "./HideSubscriptType";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/form-field/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/form-field/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}