@lmvz-ds/components 0.32.0 → 0.34.0

package/types/components.d.ts

@@ -492,6 +492,48 @@ export declare namespace Components {
          */
         "open": boolean;
     }
+    export interface LmvzPopover {
+        /**
+         * The anchor element or its id. Used for positioning.
+         */
+        "anchor"?: string | HTMLElement;
+        /**
+         * Whether to move focus to the first focusable element on open.
+         * @default true
+         */
+        "autoFocus": boolean;
+        /**
+         * Closes the popover, firing lmvzCancel first. If cancelled, the popover stays open.
+         */
+        "hide": () => Promise<void>;
+        /**
+         * Accessible label for the popover container.
+         */
+        "label"?: string;
+        /**
+         * Whether the popover is open.
+         * @default false
+         */
+        "open": boolean;
+        /**
+         * Preferred placement relative to the anchor.
+         * @default 'bottom-start'
+         */
+        "placement": Popover.Placement;
+        /**
+         * Opens the popover.
+         */
+        "show": () => Promise<void>;
+        /**
+         * Controls the size variant of the card surface.
+         * @default 'sm'
+         */
+        "size": Popover.Size;
+        /**
+         * Toggles the popover open state.
+         */
+        "toggle": () => Promise<void>;
+    }
     /**
      * Radio button component with form association, ARIA validation, accessible label support,
      * and ARIA APG-compliant Arrow-key keyboard navigation.
@@ -1294,6 +1336,48 @@ export declare namespace JSX {
          */
         "open"?: boolean;
     }
+    export interface LmvzPopover {
+        /**
+         * The anchor element or its id. Used for positioning.
+         */
+        "anchor"?: string | HTMLElement;
+        /**
+         * Whether to move focus to the first focusable element on open.
+         * @default true
+         */
+        "autoFocus"?: boolean;
+        /**
+         * Accessible label for the popover container.
+         */
+        "label"?: string;
+        /**
+         * Fired before light-dismiss or Escape close. Call `event.preventDefault()` to veto the close.
+         */
+        "onLmvzCancel"?: (event: LmvzPopoverCustomEvent<void>) => void;
+        /**
+         * Fired after the popover closes.
+         */
+        "onLmvzClose"?: (event: LmvzPopoverCustomEvent<void>) => void;
+        /**
+         * Fired after the popover opens.
+         */
+        "onLmvzOpen"?: (event: LmvzPopoverCustomEvent<void>) => void;
+        /**
+         * Whether the popover is open.
+         * @default false
+         */
+        "open"?: boolean;
+        /**
+         * Preferred placement relative to the anchor.
+         * @default 'bottom-start'
+         */
+        "placement"?: Popover.Placement;
+        /**
+         * Controls the size variant of the card surface.
+         * @default 'sm'
+         */
+        "size"?: Popover.Size;
+    }
     /**
      * Radio button component with form association, ARIA validation, accessible label support,
      * and ARIA APG-compliant Arrow-key keyboard navigation.
@@ -1672,6 +1756,14 @@ export declare namespace JSX {
         "open": boolean;
         "closeLabel": string;
     }
+    export interface LmvzPopoverAttributes {
+        "open": boolean;
+        "anchor": string | HTMLElement;
+        "placement": Popover.Placement;
+        "size": Popover.Size;
+        "autoFocus": boolean;
+        "label": string;
+    }
     export interface LmvzRadioAttributes {
         "label": string;
         "checked": boolean;
@@ -1740,6 +1832,7 @@ export declare namespace JSX {
         "lmvz-menuitem": Omit<LmvzMenuitem, keyof LmvzMenuitemAttributes> & { [K in keyof LmvzMenuitem & keyof LmvzMenuitemAttributes]?: LmvzMenuitem[K] } & { [K in keyof LmvzMenuitem & keyof LmvzMenuitemAttributes as `attr:${K}`]?: LmvzMenuitemAttributes[K] } & { [K in keyof LmvzMenuitem & keyof LmvzMenuitemAttributes as `prop:${K}`]?: LmvzMenuitem[K] };
         "lmvz-message": Omit<LmvzMessage, keyof LmvzMessageAttributes> & { [K in keyof LmvzMessage & keyof LmvzMessageAttributes]?: LmvzMessage[K] } & { [K in keyof LmvzMessage & keyof LmvzMessageAttributes as `attr:${K}`]?: LmvzMessageAttributes[K] } & { [K in keyof LmvzMessage & keyof LmvzMessageAttributes as `prop:${K}`]?: LmvzMessage[K] };
         "lmvz-modal": Omit<LmvzModal, keyof LmvzModalAttributes> & { [K in keyof LmvzModal & keyof LmvzModalAttributes]?: LmvzModal[K] } & { [K in keyof LmvzModal & keyof LmvzModalAttributes as `attr:${K}`]?: LmvzModalAttributes[K] } & { [K in keyof LmvzModal & keyof LmvzModalAttributes as `prop:${K}`]?: LmvzModal[K] };
+        "lmvz-popover": Omit<LmvzPopover, keyof LmvzPopoverAttributes> & { [K in keyof LmvzPopover & keyof LmvzPopoverAttributes]?: LmvzPopover[K] } & { [K in keyof LmvzPopover & keyof LmvzPopoverAttributes as `attr:${K}`]?: LmvzPopoverAttributes[K] } & { [K in keyof LmvzPopover & keyof LmvzPopoverAttributes as `prop:${K}`]?: LmvzPopover[K] };
         "lmvz-radio": Omit<LmvzRadio, keyof LmvzRadioAttributes> & { [K in keyof LmvzRadio & keyof LmvzRadioAttributes]?: LmvzRadio[K] } & { [K in keyof LmvzRadio & keyof LmvzRadioAttributes as `attr:${K}`]?: LmvzRadioAttributes[K] } & { [K in keyof LmvzRadio & keyof LmvzRadioAttributes as `prop:${K}`]?: LmvzRadio[K] } & OneOf<"label", LmvzRadio["label"], LmvzRadioAttributes["label"]>;
         "lmvz-select": Omit<LmvzSelect, keyof LmvzSelectAttributes> & { [K in keyof LmvzSelect & keyof LmvzSelectAttributes]?: LmvzSelect[K] } & { [K in keyof LmvzSelect & keyof LmvzSelectAttributes as `attr:${K}`]?: LmvzSelectAttributes[K] } & { [K in keyof LmvzSelect & keyof LmvzSelectAttributes as `prop:${K}`]?: LmvzSelect[K] } & OneOf<"label", LmvzSelect["label"], LmvzSelectAttributes["label"]>;
         "lmvz-snackbar": Omit<LmvzSnackbar, keyof LmvzSnackbarAttributes> & { [K in keyof LmvzSnackbar & keyof LmvzSnackbarAttributes]?: LmvzSnackbar[K] } & { [K in keyof LmvzSnackbar & keyof LmvzSnackbarAttributes as `attr:${K}`]?: LmvzSnackbarAttributes[K] } & { [K in keyof LmvzSnackbar & keyof LmvzSnackbarAttributes as `prop:${K}`]?: LmvzSnackbar[K] };
@@ -1801,6 +1894,11 @@ export declare interface LmvzModalCustomEvent<T> extends CustomEvent<T> {
     target: HTMLLmvzModalElement;
 }
 
+export declare interface LmvzPopoverCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLLmvzPopoverElement;
+}
+
 export declare interface LmvzRadioCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLLmvzRadioElement;
@@ -1832,6 +1930,15 @@ export declare namespace Message {
 
 declare const messageTypes: readonly ["neutral", "warning"];
 
+export declare namespace Popover {
+    export type Placement = (typeof popoverPlacements)[number];
+    export type Size = (typeof popoverSizes)[number];
+}
+
+declare const popoverPlacements: readonly ["top", "bottom", "start", "end", "top-start", "top-end", "bottom-start", "bottom-end"];
+
+declare const popoverSizes: readonly ["sm", "md", "lg"];
+
 declare const scaleValues: readonly ["small", "default", "large"];
 
 export declare namespace Select {
@@ -1856,6 +1963,6 @@ declare const snackbarStatuses: readonly ["success", "warning", "error"];
 
 export declare type SVGString = string & Brand.Brand<'SVG'>;
 
-declare const variants: readonly ["primary", "secondary", "tertiary"];
+declare const variants: readonly ["primary", "secondary", "tertiary", "danger"];
 
 export { }

package/types/utils/async/async.util.d.ts

@@ -2,6 +2,9 @@ import type { EventEmitter } from '../../stencil-public-runtime';
 export declare const __zone_symbol__requestAnimationFrame: typeof window.requestAnimationFrame;
 export declare const requestAnimationFrame: typeof window.requestAnimationFrame;
 export declare const transitionEndAsync: (el: HTMLElement | null, expectedDuration?: number) => Promise<unknown>;
+export declare const nextFrame: () => Promise<void>;
+export declare const wait: () => Promise<void>;
+export declare const waitFrame: () => Promise<void>;
 export declare const raf: (h: FrameRequestCallback) => number;
 export declare const deferEvent: (event: EventEmitter) => EventEmitter;
 export declare const debounceEvent: (event: EventEmitter, wait: number) => EventEmitter;

package/types/utils/element/element.util.d.ts

@@ -16,6 +16,8 @@ export declare const hasShadowDom: (el: HTMLElement) => boolean;
 export declare const focusVisibleElement: (el: HTMLElement) => void;
 export declare const renderHiddenInput: (always: boolean, container: HTMLElement, name: string, value: string | undefined | null, disabled: boolean) => void;
 export declare function getDeepActiveElement(root?: Document): Element | null;
+export declare function walkShadowDOMUntil(start: Element | undefined, condition: (el: Element) => boolean): Element | undefined;
 export declare function canReceiveFocus(el: Element | undefined): boolean;
 export declare function findFormByRef(form: FormRef, el: HTMLElement): HTMLFormElement | null;
+export declare function isInteractiveElement(el: HTMLElement): boolean;
 export {};