@nvidia-elements/core 0.2.3 → 2.0.0

package/dist/bundles/index.d.ts

@@ -398,8 +398,6 @@ export declare const ICON_IMPORTS: {
 	"zoom-out": IconSVG;
 };
 export type IconName = keyof typeof ICON_IMPORTS;
-/** @deprecated */
-export type IconNames = IconName;
 export declare const ICON_NAMES: IconName[];
 /**
  * @element nve-icon
@@ -541,10 +539,6 @@ export type PopoverPosition = "center" | "top" | "bottom" | "left" | "right";
  * - `winloss` - Renders outcomes as binary or ternary bars to highlight wins, losses, and optional ties.
  */
 export type SparklineMark = "line" | "area" | "gradient" | "column" | "winloss";
-/** @deprecated Determines the flat container element interaction. */
-export type FlatInteraction = "flat" | "flat-emphasize" | `${"flat"}-${Interaction}`;
-/** @deprecated Determines if an element renders with an inverse contrast. */
-export type Inverse = "inverse";
 /** The Interaction type provides a way to show the intent of an interactive element. This can help users quickly understand what each interaction does and reduce the potential for confusion or errors.
  * - `emphasis` Shows the interaction targets emphasis or highlighting primary actions.
  * - `destructive` Shows the interaction targets destructive actions such as deleting or removing.
@@ -565,6 +559,10 @@ export interface KeynavListConfig {
 	loop?: boolean;
 	dir?: string | null;
 }
+export interface StateScrollConfig {
+	target?: HTMLElement;
+	scrollOffset?: number;
+}
 export interface NativePopover extends ReactiveElement {
 	anchor?: HTMLElement | string;
 	closeTimeout?: number;
@@ -879,11 +877,6 @@ export interface ButtonFormControlMixinInstance {
 	 * @reflect
 	 */
 	readOnly: boolean;
-	/**
-	 * Use `readOnly`. The `readonly` attribute remains supported.
-	 * @deprecated Use `readOnly`. The `readonly` attribute remains supported.
-	 */
-	readonly: boolean;
 	/**
 	 * Like input form, sets a button to submit a form outside its parent form.
 	 * Returns a reference to the form element if available.
@@ -975,83 +968,635 @@ export interface ButtonFormControlMixinInstance {
 	interestForElement: HTMLElement | null;
 	_internals: ElementInternals;
 }
-export interface ButtonFormControlHost {
-	connectedCallback?(): void;
-	disconnectedCallback?(): void;
-	attributeChangedCallback?(name: string, oldValue: string | null, newValue: string | null): void;
-	requestUpdate?(name?: string, oldValue?: unknown): void;
-	updateComplete?: Promise<unknown>;
+export interface ButtonFormControlHost {
+	connectedCallback?(): void;
+	disconnectedCallback?(): void;
+	attributeChangedCallback?(name: string, oldValue: string | null, newValue: string | null): void;
+	requestUpdate?(name?: string, oldValue?: unknown): void;
+	updateComplete?: Promise<unknown>;
+}
+type Constructor$1 = (new (...args: any[]) => HTMLElement & ButtonFormControlHost) & {
+	observedAttributes?: string[];
+};
+export type ButtonFormControlConstructor<TBase extends Constructor$1> = new (...args: ConstructorParameters<TBase>) => InstanceType<TBase> & ButtonFormControlMixinInstance;
+export type ButtonFormControlMixinReturn<TBase extends Constructor$1> = ButtonFormControlConstructor<TBase> & {
+	formAssociated: boolean;
+	observedAttributes: string[];
+} & Omit<TBase, "prototype">;
+declare const Button_base: ButtonFormControlMixinReturn<typeof LitElement>;
+/**
+ * @element nve-button
+ * @description A button is a widget that enables users to trigger an action or event, such as submitting a form, opening a dialog, canceling an action, or performing a delete operation.
+ * @since 0.1.3
+ * @entrypoint \@nvidia-elements/core/button
+ * @slot - slot for button text content or icon, icon placement depends on whether `icon` appears before or after text content.
+ * @cssprop --background
+ * @cssprop --color
+ * @cssprop --padding
+ * @cssprop --border
+ * @cssprop --border-radius
+ * @cssprop --font-weight
+ * @cssprop --font-size
+ * @cssprop --text-decoration
+ * @cssprop --text-align
+ * @cssprop --cursor
+ * @cssprop --gap
+ * @cssprop --height
+ * @cssprop --text-transform
+ * @cssprop --line-height
+ * @cssprop --width
+ * @cssprop --min-width
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/button/
+ */
+export declare class Button extends Button_base {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/**
+	 * Determines the container of the button. Flat suits nesting within other containers or more muted style. Inline suits inline content such as text.
+	 */
+	container?: "flat" | "inline";
+	/**
+	 * Determines size of the button.
+	 */
+	size?: Size;
+	/**
+	 * The Interaction type provides a way to show the intended use case for a button or other interactive element. This can help users quickly understand what each interaction will do and reduce the potential for confusion or errors.
+	 */
+	interaction: Interaction;
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-icon-button
+ * @description An icon button is a button that displays only an icon without a visual label.
+ * @since 0.2.1
+ * @entrypoint \@nvidia-elements/core/icon-button
+ * @slot - default slot for custom icons
+ * @cssprop --border-radius
+ * @cssprop --padding
+ * @cssprop --line-height
+ * @cssprop --gap
+ * @cssprop --height
+ * @cssprop --width
+ * @cssprop --font-size
+ * @cssprop --color
+ * @cssprop --background
+ * @csspart icon - The icon element
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/button/
+ */
+export declare class IconButton extends Button {
+	/**
+	 * Sets the icon name, which determines which icon to display.
+	 */
+	iconName: IconName;
+	/**
+	 * Sets the direction of the icon.
+	 * Only supported by expand-panel/collapse-panel (horizontal axis) and arrow/caret/chevron icons (4-directions)
+	 */
+	direction: "up" | "down" | "left" | "right";
+	/**
+	 * Sets size of the icon button.
+	 */
+	size?: Size;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[Icon.metadata.tag]: typeof Icon;
+	};
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-accordion-header
+ * @description Provides the clickable heading region of an accordion that toggles the visibility of associated content.
+ * @since 0.12.0
+ * @entrypoint \@nvidia-elements/core/accordion
+ * @slot - default content slot
+ * @slot prefix - slot for prefix content
+ * @slot suffix - slot for suffix content
+ * @cssprop --cursor
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ */
+export declare class AccordionHeader extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** @private */
+	_internals: ElementInternals;
+	render(): TemplateResult<1>;
+	slot: string;
+	connectedCallback(): void;
+}
+/**
+ * @element nve-accordion-content
+ * @description Contains the collapsible body content that reveals or hides when the parent accordion expands or collapses.
+ * @since 0.12.0
+ * @entrypoint \@nvidia-elements/core/accordion
+ * @slot - This is a default/unnamed slot for accordion content
+ * @cssprop --padding
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ */
+export declare class AccordionContent extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-accordion
+ * @description An accordion is a vertical stack of interactive headings used to toggle the display of further information.
+ * @since 0.12.0
+ * @entrypoint \@nvidia-elements/core/accordion
+ * @command --open - use to open the accordion
+ * @command --close - use to close the accordion
+ * @command --toggle - use to toggle the accordion
+ * @slot - This is a default/unnamed slot for accordion content
+ * @slot icon-button - icon elements to display for expand/collapse
+ * @slot header - header element (Use `accordion-header` or custom content)
+ * @slot content - content element (Use `accordion-content` or custom content)
+ * @cssprop --background
+ * @cssprop --color
+ * @cssprop --border-radius
+ * @cssprop --header-padding
+ * @cssprop --cursor
+ * @cssprop --transition
+ * @csspart icon-button - The toggle icon button element
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ */
+export declare class Accordion extends LitElement implements ContainerElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	static elementDefinitions: {
+		[IconButton.metadata.tag]: typeof IconButton;
+	};
+	/** @private */
+	_internals: ElementInternals;
+	/**
+	 * Enables updating internal string values for internationalization.
+	 */
+	i18n: Partial<I18nStrings & {
+		__set: boolean;
+	}>;
+	/**
+	 * Determines the container styles of component. Flat suits nesting accordions within other containers. Inset suits more complex accordions where content needs distinct separation.
+	 */
+	container?: Extract<Container, "flat" | "inset">;
+	/**
+	 * Determines whether the accordion expands to display its contents.
+	 */
+	expanded: boolean;
+	/**
+	 * Determines whether the accordion is expandable
+	 */
+	disabled: boolean;
+	/**
+	 * Determines whether the accordion should opt-in to stateful expansion behavior (defaults to stateless)
+	 */
+	behaviorExpand: boolean;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	firstUpdated(props: PropertyValues<this>): Promise<void>;
+}
+/**
+ * @element nve-accordion-group
+ * @description Organizes many accordions into a cohesive group, enabling coordinated expand/collapse behavior such as single-item expansion.
+ * @since 0.12.0
+ * @entrypoint \@nvidia-elements/core/accordion
+ * @cssprop --padding
+ * @slot - This is a default slot for accordions within the group
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ */
+export declare class AccordionGroup extends LitElement {
+	#private;
+	_internals: ElementInternals;
+	static styles: CSSResult[];
+	/**
+	 * Determines whether the accordion should opt-in to stateful expansion behavior (defaults to stateless)
+	 */
+	behaviorExpand: boolean;
+	/**
+	 * Determines whether the accordion should opt-in to stateful expansion of a single accordion at a time
+	 */
+	behaviorExpandSingle: boolean;
+	/** flat (Borderless, container-less accordions), full (default), or inset (Rounded corner, contained accordion) */
+	container?: Extract<Container, "flat" | "inset">;
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	private accordions;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	updated(props: PropertyValues<this>): void;
+}
+/**
+ * @element nve-alert
+ * @description Alert is an element that displays a brief, important message in a way that attracts the user's attention without interrupting the user's task.
+ * @since 0.3.0
+ * @entrypoint \@nvidia-elements/core/alert
+ * @event close - Dispatched when the alert closes within an alert group.
+ * @command --close - Use to set the alert closed/hidden state.
+ * @slot icon - Icon slot renders on the left side of the alert. Icons typically represent the alert's status.
+ * @slot prefix - Prefix slot renders between the icon and the content. Prefixes typically represent the alert's status.
+ * @slot actions - Actions render on the right side of the alert. Actions are typically buttons, but can also be links. Use actions for steps the user can take to resolve the alert.
+ * @slot content - Content for large overflow text.
+ * @slot - Default content placed inside of the alert.
+ * @cssprop --gap
+ * @cssprop --font-size
+ * @cssprop --color
+ * @cssprop --icon-color
+ * @cssprop --icon-size
+ * @cssprop --font-weight
+ * @cssprop --justify-content
+ * @cssprop --align-items
+ * @cssprop --min-height
+ * @cssprop --text-transform
+ * @cssprop --height
+ * @cssprop --width
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+ */
+export declare class Alert extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[Icon.metadata.tag]: typeof Icon;
+		[IconButton.metadata.tag]: typeof IconButton;
+	};
+	/** Defines visual treatment to represent a ongoing task or support status. */
+	status?: SupportStatus | TaskStatus | "muted";
+	/** When used in an `alert-group` the `closable` property enables dismissing alerts within the same group. */
+	closable: boolean;
+	/** Enables updating internal string values for internationalization. */
+	i18n: Partial<I18nStrings & {
+		__set: boolean;
+	}>;
+	private prefixItems;
+	private actionItems;
+	/** @private */
+	_internals: ElementInternals;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+}
+/**
+ * @element nve-alert-group
+ * @description An alert group is an element that displays a group of related and important messages in a way that attracts the user's attention without interrupting the user's task.
+ * @since 0.3.0
+ * @entrypoint \@nvidia-elements/core/alert
+ * @cssprop --gap
+ * @cssprop --font-size
+ * @cssprop --padding
+ * @cssprop --border
+ * @cssprop --border-radius
+ * @cssprop --color
+ * @cssprop --background
+ * @slot - default slot for nve-alert
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+ */
+export declare class AlertGroup extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	/** Defines visual treatment to represent a ongoing task or support status. */
+	status?: SupportStatus;
+	/** Determines the visual prominence or weight, emphasis applies banner style alerts */
+	prominence?: Extract<Prominence, "emphasis">;
+	/** Allows colors not defined by semantic status definitions for non-status instances, such as callouts for tutorials or tips on a documentation site. */
+	color: Color;
+	/** Determines the container bounds of the element */
+	container?: Extract<Container, "full">;
+	/** @private */
+	_internals: ElementInternals;
+	private alerts;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	updated(props: PropertyValues<this>): void;
+}
+/**
+ * @element nve-avatar
+ * @description Avatar represents a user/bot within a UI. Typically with text or image content.
+ * @since 1.20.0
+ * @entrypoint \@nvidia-elements/core/avatar
+ * @slot - default slot for content
+ * @cssprop --background
+ * @cssprop --color
+ * @cssprop --border-radius
+ * @cssprop --height
+ * @cssprop --width
+ * @cssprop --font-size
+ * @cssprop --font-weight
+ * @cssprop --border
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+ *
+ */
+export declare class Avatar extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** Sets size of the avatar component. Update size through the `width + height` css props as an alternative. */
+	size?: Size | "xs";
+	/** Sets the color of the avatar component. */
+	color: Color;
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-avatar-group
+ * @description An avatar group displays a collection of user avatars in a compact and organized layout, showcasing many participants or contributors in a space-efficient way.
+ * @since 1.20.0
+ * @entrypoint \@nvidia-elements/core/avatar
+ * @slot - default slot for content
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+ *
+ */
+export declare class AvatarGroup extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** @private */
+	_internals: ElementInternals;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+}
+/**
+ * @element nve-badge
+ * @description A visual indicator that communicates a status description of an associated component. Status badges use short text, color, built in icons for quick recognition and render near the relevant content.
+ * @since 0.11.0
+ * @entrypoint \@nvidia-elements/core/badge
+ * @slot - default slot for content
+ * @slot prefix-icon - slot for prefix icon
+ * @slot suffix-icon - slot for suffix icon
+ * @cssprop --background
+ * @cssprop --color
+ * @cssprop --gap
+ * @cssprop --font-size
+ * @cssprop --icon-color
+ * @cssprop --padding
+ * @cssprop --border
+ * @cssprop --border-radius
+ * @cssprop --font-weight
+ * @cssprop --text-transform
+ * @cssprop --width
+ * @cssprop --height
+ * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img
+ */
+export declare class Badge extends LitElement {
+	#private;
+	/**
+	 * Visual treatment to represent a ongoing task, support status.
+	 */
+	status: TaskStatus | SupportStatus;
+	/**
+	 * Highlights content to draw attention and convey simple messages.
+	 */
+	color: Color;
+	/**
+	 * Determines the container styles of component. Flat suits nesting within other containers.
+	 */
+	container?: "flat";
+	/** Determines the visual prominence or weight */
+	prominence?: Extract<Prominence, "emphasis">;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[Icon.metadata.tag]: typeof Icon;
+	};
+	/** @private */
+	_internals: ElementInternals;
+	/**
+	 * Enables updating internal string values for internationalization.
+	 */
+	i18n: Partial<I18nStrings & {
+		__set: boolean;
+	}>;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	updated(props: PropertyValues<this>): void;
+}
+/**
+ * @element nve-breadcrumb
+ * @description Breadcrumb is a component that can help users establish their location while navigating a website with complex URLs and navigation paths.
+ * @since 0.11.0
+ * @entrypoint \@nvidia-elements/core/breadcrumb
+ * @cssprop --gap
+ * @cssprop --height
+ * @cssprop --font-size
+ * @cssprop --font-weight
+ * @cssprop --color
+ * @cssprop --border-radius
+ * @cssprop --padding
+ * @cssprop --width
+ * @cssprop --icon-width
+ * @cssprop --icon-height
+ * @cssprop --text-decoration
+ * @slot - default slot for `nve-button` and anchor elements
+ * @aria https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/navigation_role
+ */
+export declare class Breadcrumb extends LitElement {
+	#private;
+	get keynavListConfig(): KeynavListConfig;
+	/** @private */
+	_internals: ElementInternals;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[Icon.metadata.tag]: typeof Icon;
+	};
+	private breadcrumbItems;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+}
+/**
+ * @element nve-button-group
+ * @description A button group organizes related buttons and can support either mutually exclusive single or multi selection. Prefer usage within toolbars.
+ * @since 0.16.0
+ * @entrypoint \@nvidia-elements/core/button-group
+ * @slot - default slot for `nve-button` or `nve-icon-button`
+ * @cssprop --background
+ * @cssprop --border-radius
+ * @cssprop --padding
+ * @cssprop --gap
+ * @cssprop --width
+ * @cssprop --height
+ * @cssprop --color
+ * @aria https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/group_role
+ */
+export declare class ButtonGroup extends LitElement {
+	#private;
+	/** @private */
+	get keynavListConfig(): KeynavListConfig;
+	/** By default the button group is stateless. Add the `behavior-select` attribute and set to `single` or `multi` to enable stateful selction handling. */
+	behaviorSelect: "single" | "multi";
+	/** Set the style of the button group using the `container` property. Options are the default display when omitting the attribute, `flat` or `rounded`. */
+	container?: "flat" | "rounded";
+	/** Determines the orientation direction of the group. Vertical groups support icon buttons only. */
+	orientation?: "horizontal" | "vertical";
+	/** Use the `interaction` property on `button-group` in combination with `divider` for color-coded split buttons */
+	interaction: Interaction;
+	/** Determines size of button */
+	size?: Size;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	/** @private */
+	_internals: ElementInternals;
+	private dividers;
+	private iconButtons;
+	private buttons;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	updated(props: PropertyValues<this>): void;
+}
+/**
+ * @element nve-card
+ * @description A container for content representing a single entity.
+ * @since 0.1.3
+ * @entrypoint \@nvidia-elements/core/card
+ * @slot - use `<nve-card-header>`,`<nve-card-content>`,`<nve-card-footer>` for card content layout
+ * @cssprop --background
+ * @cssprop --color
+ * @cssprop --border-radius
+ * @cssprop --box-shadow
+ * @cssprop --border
+ * @aria https://github.com/w3c/aria-practices/issues
+ */
+export declare class Card extends LitElement implements ContainerElement {
+	/** flat (embed into parent container) or full (width of viewport) */
+	container?: "flat" | "full";
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-card-header
+ * @description Displays the title and optional actions at the top of a card, establishing the card's identity and purpose.
+ * @since 0.1.3
+ * @entrypoint \@nvidia-elements/core/card
+ * @slot - default slot
+ * @cssprop --padding
+ * @cssprop --border-bottom
+ * @cssprop --line-height
+ * @cssprop --gap
+ * @aria https://github.com/w3c/aria-practices/issues
+ */
+export declare class CardHeader extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+	};
+	slot: string;
+	render(): TemplateResult<1>;
+}
+/**
+ * @element nve-card-content
+ * @description Contains the primary body content of a card, providing a structured region for the main information or media.
+ * @since 0.1.3
+ * @entrypoint \@nvidia-elements/core/card
+ * @slot - This is a default/unnamed slot for card content
+ * @cssprop --padding
+ * @aria https://github.com/w3c/aria-practices/issues
+ */
+export declare class CardContent extends LitElement {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+	};
+	render(): TemplateResult<1>;
 }
-type Constructor$1 = (new (...args: any[]) => HTMLElement & ButtonFormControlHost) & {
-	observedAttributes?: string[];
-};
-export type ButtonFormControlConstructor<TBase extends Constructor$1> = new (...args: ConstructorParameters<TBase>) => InstanceType<TBase> & ButtonFormControlMixinInstance;
-export type ButtonFormControlMixinReturn<TBase extends Constructor$1> = ButtonFormControlConstructor<TBase> & {
-	formAssociated: boolean;
-	observedAttributes: string[];
-} & Omit<TBase, "prototype">;
-declare const Button_base: ButtonFormControlMixinReturn<typeof LitElement>;
-declare class Button extends Button_base {
+/**
+ * @element nve-card-footer
+ * @description Provides a designated area at the bottom of a card for actions, metadata, or supplementary information.
+ * @since 0.1.3
+ * @entrypoint \@nvidia-elements/core/card
+ * @slot - This is a default/unnamed slot for card footer content
+ * @cssprop --padding
+ * @cssprop --border-top
+ * @aria https://github.com/w3c/aria-practices/issues
+ */
+export declare class CardFooter extends LitElement {
 	static styles: CSSResult[];
 	static readonly metadata: {
 		tag: string;
 		version: string;
+		parents: string[];
 	};
-	/**
-	 * Determines the container of the button. Flat suits nesting within other containers or more muted style. Inline suits inline content such as text.
-	 */
-	container?: "flat" | "inline";
-	/**
-	 * Determines size of the button.
-	 */
-	size?: Size;
-	/**
-	 * The Interaction type provides a way to show the intended use case for a button or other interactive element. This can help users quickly understand what each interaction will do and reduce the potential for confusion or errors.
-	 */
-	interaction: Interaction | FlatInteraction | Inverse;
+	slot: string;
 	render(): TemplateResult<1>;
 }
 /**
- * @element nve-icon-button
- * @description An icon button is a button that displays only an icon without a visual label.
- * @since 0.2.1
- * @entrypoint \@nvidia-elements/core/icon-button
- * @slot - default slot for custom icons
- * @cssprop --border-radius
+ * @element nve-chat-message
+ * @description A chat message component displays a text message within a conversation, sent between users or bots
+ * @since 1.25.0
+ * @entrypoint \@nvidia-elements/core/chat-message
+ * @slot - default slot for content
+ * @slot prefix - for avatar/img content
+ * @slot suffix - for avatar/img content
+ * @cssprop --background
+ * @cssprop --color
  * @cssprop --padding
- * @cssprop --line-height
  * @cssprop --gap
- * @cssprop --height
- * @cssprop --width
+ * @cssprop --border-radius
  * @cssprop --font-size
- * @cssprop --color
- * @cssprop --background
- * @csspart icon - The icon element
- * @aria https://www.w3.org/WAI/ARIA/apg/patterns/button/
+ * @cssprop --line-height
+ * @cssprop --overflow
+ * @cssprop --top-offset - Vertical offset for aligning message with avatar
+
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+ * @stable false
  */
-export declare class IconButton extends Button {
-	/**
-	 * Sets the icon name, which determines which icon to display.
-	 */
-	iconName: IconName;
-	/**
-	 * Sets the direction of the icon.
-	 * Only supported by expand-panel/collapse-panel (horizontal axis) and arrow/caret/chevron icons (4-directions)
-	 */
-	direction: "up" | "down" | "left" | "right";
-	/**
-	 * Sets size of the icon button.
-	 */
-	size?: Size;
+export declare class ChatMessage extends LitElement {
 	static styles: CSSResult[];
 	static readonly metadata: {
 		tag: string;
 		version: string;
 	};
-	static elementDefinitions: {
-		[Icon.metadata.tag]: typeof Icon;
-	};
+	container: "flat";
+	color: Color;
+	arrowPosition: "top-start" | "top-end" | "bottom-start" | "bottom-end";
 	render(): TemplateResult<1>;
+	connectedCallback(): void;
 }
 /**
  * @element nve-control
@@ -1180,7 +1725,22 @@ export declare class ControlMessage extends LitElement {
 	slot: string;
 	render(): TemplateResult<1>;
 }
-declare class Checkbox extends Control {
+/**
+ * @element nve-checkbox
+ * @description A checkbox is a control that enables users to choose between two distinct mutually exclusive options (checked or unchecked, on or off) through a single click or tap.
+ * @since 0.3.0
+ * @entrypoint \@nvidia-elements/core/checkbox
+ * @cssprop --cursor
+ * @cssprop --width
+ * @cssprop --height
+ * @cssprop --border-width
+ * @cssprop --border-radius
+ * @cssprop --border-color
+ * @cssprop --background
+ * @cssprop --check-color
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/
+ */
+export declare class Checkbox extends Control {
 	protected nveControl: string;
 	static styles: CSSResult[];
 	/** @private - disable for inline control */
@@ -1193,6 +1753,48 @@ declare class Checkbox extends Control {
 		children: string[];
 	};
 }
+/**
+ * @element nve-checkbox-group
+ * @description Groups related checkboxes together with a shared label and validation messaging for multi-select form inputs.
+ * @since 0.3.0
+ * @entrypoint \@nvidia-elements/core/checkbox
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/checkbox/
+ */
+export declare class CheckboxGroup extends ControlGroup {
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+}
+/**
+ * @element nve-color
+ * @description A color picker is a control that enables users to choose a color value.
+ * @since 0.3.0
+ * @entrypoint \@nvidia-elements/core/color
+ * @cssprop --cursor
+ * @csspart icon-button - The eye dropper icon button element
+ * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/color
+ */
+declare class Color$1 extends Control implements ContainerElement {
+	#private;
+	/**
+	 * Reduces the visual container for a minimal borderless appearance while preserving whitespace bounds.
+	 * Use when embedding within another container such as a toolbar.
+	 */
+	container?: "flat";
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[IconButton.metadata.tag]: typeof IconButton;
+	};
+	protected get suffixContent(): TemplateResult<1>;
+	connectedCallback(): void;
+}
 declare const MenuItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
 /**
  * @element nve-menu-item
@@ -1435,6 +2037,73 @@ export declare class Tag extends Tag_base {
 	render(): TemplateResult<1>;
 	constructor();
 }
+/**
+ * @element nve-combobox
+ * @description An editable combobox with autocomplete behavior and selection support.
+ * @since 0.17.0
+ * @entrypoint \@nvidia-elements/core/combobox
+ * @slot - default slot for an input and a datalist/select element
+ * @slot prefix-icon - slot for icon before the input
+ * @slot footer - slot for dropdown footer content
+ * @cssprop --scroll-height
+ * @cssprop --padding
+ * @cssprop --font-size
+ * @cssprop --height
+ * @cssprop --background
+ * @cssprop --color
+ * @cssprop --border-radius
+ * @cssprop --border
+ * @cssprop --cursor
+ * @cssprop --font-weight
+ * @cssprop --width
+ * @cssprop --border-color
+ * @cssprop --max-height
+ * @cssprop --text-transform
+ * @csspart tag - The tag element for selected items
+ * @csspart dropdown - The dropdown popup element
+ * @csspart menu - The menu element
+ * @csspart menu-item - The menu item elements
+ * @csspart checkbox - The checkbox element
+ * @csspart icon - The icon element
+ * @event scroll - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
+ * @event create - Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`.
+ * @csspart create-option - The menu item element for creating new options
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/combobox/examples/combobox-autocomplete-list/
+ */
+export declare class Combobox extends Control implements ContainerElement {
+	#private;
+	/**
+	 * Reduces the visual container for a minimal borderless appearance while preserving whitespace bounds.
+	 * Use when embedding within another container such as a toolbar.
+	 */
+	container: "flat";
+	/** Manage inline tag rendering for many-item select */
+	tagLayout: "hidden" | "wrap";
+	/** Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail. */
+	behaviorCreate: boolean;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[Checkbox.metadata.tag]: typeof Checkbox;
+		[Icon.metadata.tag]: typeof Icon;
+		[Dropdown.metadata.tag]: typeof Dropdown;
+		[Menu.metadata.tag]: typeof Menu;
+		[MenuItem.metadata.tag]: typeof MenuItem;
+		[Tag.metadata.tag]: typeof Tag;
+	};
+	protected _associateDatalist: boolean;
+	protected get prefixContent(): TemplateResult<1>;
+	protected get suffixContent(): typeof nothing | TemplateResult<1>;
+	firstUpdated(props: PropertyValues<this>): Promise<void>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	reset(): void;
+	/** Select all options provided */
+	selectAll(): void;
+}
 /**
  * @element nve-toast
  * @description A contextual popup that displays a status. Toasts are [triggered](https://w3c.github.io/aria/#tooltip) by clicking, focusing, or tapping an element and cannot have interactive elements within them. [MDN Popover API](https://developer.mozilla.org/en-US/docs/Web/API/Popover_API)
@@ -1509,10 +2178,9 @@ export declare class Toast extends LitElement {
 	 */
 	closeTimeout: number;
 	/**
-	 * visual treatment to represent a ongoing task or support status
-	 * deprecated Use 'prominence="muted"' instead of status="muted"
+	 * Visual treatment to represent a support status.
 	 */
-	status: SupportStatus | "muted";
+	status: SupportStatus;
 	/**
 	 * Updates internal string values for internationalization.
 	 */
@@ -1599,6 +2267,60 @@ export declare class Tooltip extends LitElement {
 	render(): TemplateResult<1>;
 	connectedCallback(): void;
 }
+/**
+ * @element nve-copy-button
+ * @description A copy button is a button that easily enables the copy to clipboard pattern.
+ * @since 1.1.4
+ * @entrypoint \@nvidia-elements/core/copy-button
+ * @slot - default
+ * @slot icon - slot for custom icon
+ * @cssprop --color
+ * @cssprop --background
+ * @cssprop --border-radius
+ * @cssprop --padding
+ * @cssprop --height
+ * @cssprop --min-width
+ * @cssprop --font-size
+ * @cssprop --line-height
+ * @csspart icon - The icon element
+ * @csspart toast - The toast notification element
+ * @csspart tooltip - The tooltip element
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/button/
+ *
+ */
+export declare class CopyButton extends Button {
+	#private;
+	private copied;
+	private showToast;
+	private showTooltip;
+	/**
+	 * Enables internal string values to update for internationalization.
+	 */
+	i18n: Partial<I18nStrings & {
+		__set: boolean;
+	}>;
+	/**
+	 * Determines if the copy button should auto write to clipboard by the trigger.
+	 */
+	behaviorCopy: boolean;
+	/**
+	 * Defines the value that copies to the user clipboard. Use `aria-label` to set the tooltip hint.
+	 */
+	value: string;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static elementDefinitions: {
+		[Icon.metadata.tag]: typeof Icon;
+		[Toast.metadata.tag]: typeof Toast;
+		[Tooltip.metadata.tag]: typeof Tooltip;
+	};
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+}
 /**
  * @element nve-date
  * @description A date picker is a control that enables users to choose a date value.
@@ -2014,6 +2736,34 @@ export declare class DrawerHeader extends LitElement {
 	render(): TemplateResult<1>;
 	connectedCallback(): void;
 }
+/**
+ * @element nve-dropdown-group
+ * @description A Dropdown Group streamlines the management of linked dropdowns and supports nested dropdowns for a more organized and intuitive user experience
+ * @since 1.30.1
+ * @entrypoint \@nvidia-elements/core/dropdown-group
+ * @slot - default slot for dropdown content
+ * @event open - Dispatched when a dropdown in the group opens
+ * @event close - Dispatched when a dropdown in the group closes
+ * @cssprop --nve-dropdown-group-spacing
+ * @cssprop --nve-dropdown-group-transition
+ * @cssprop --arrow-transform - Transform applied to the popover arrow
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
+ * @stable false
+ */
+export declare class DropdownGroup extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	protected dropdowns: Dropdown[];
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	close(): void;
+}
 declare function fileTypeValidator(value: unknown, element: unknown): ValidatorResult;
 declare const Dropzone_base: FormControlMixinReturn<typeof LitElement, File[]>;
 /**
@@ -2484,6 +3234,7 @@ export declare class Grid extends LitElement implements ContainerElement {
 		rows: (GridRow | GridHeader)[];
 		cells: (GridColumn | GridCell)[];
 	};
+	get stateScrollConfig(): StateScrollConfig;
 	/** @private */
 	_internals: ElementInternals;
 	render(): TemplateResult<1>;
@@ -2762,6 +3513,7 @@ declare class Notification$1 extends LitElement {
 	};
 	render(): TemplateResult<1>;
 	connectedCallback(): void;
+	disconnectedCallback(): void;
 	firstUpdated(props: PropertyValues<this>): Promise<void>;
 	updated(props: PropertyValues<this>): void;
 	hidePopover(): void;
@@ -2865,8 +3617,6 @@ export declare class Page extends LitElement {
  * @cssprop --max-width
  * @cssprop --max-height
  * @cssprop --animation-duration - Duration of panel open/close animations
-
- * @csspart icon-button - The close/collapse icon button element
  * @aria https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Roles/region_role
  *
  */
@@ -2876,16 +3626,6 @@ export declare class PagePanel extends LitElement {
 	 * Sets the max size of the panel.
 	 */
 	size?: Size;
-	/**
-	 * Determines if a closable button should render within page panel.
-	 * @deprecated use the `actions` slot instead
-	 */
-	closable: boolean;
-	/**
-	 * Determines if a expandable button should render within page panel.
-	 * @deprecated use the `actions` slot instead
-	 */
-	expandable: boolean;
 	/**
 	 * Enables updating internal string values for internationalization.
 	 */
@@ -2898,9 +3638,7 @@ export declare class PagePanel extends LitElement {
 		version: string;
 		parents: string[];
 	};
-	static elementDefinitions: {
-		[IconButton.metadata.tag]: typeof IconButton;
-	};
+	constructor();
 	/** @private */
 	_internals: ElementInternals;
 	render(): TemplateResult<1>;
@@ -3003,7 +3741,6 @@ export declare class PageHeader extends LitElement {
  * @since 0.17.0
  * @entrypoint \@nvidia-elements/core/progress-ring
  * @slot - Content to display in the ring center. Defaults to a status icon.
- * @slot status-icon - (deprecated) Use the default slot instead.
  * @cssprop --background-color
  * @cssprop --ring-color
  * @cssprop --ring-background-opacity
@@ -3039,7 +3776,6 @@ export declare class ProgressRing extends LitElement {
 	i18n: Partial<I18nStrings & {
 		__set: boolean;
 	}>;
-	private _deprecatedStatusIconSlot;
 	render(): TemplateResult<1>;
 	connectedCallback(): void;
 	updated(props: PropertyValues<this>): void;
@@ -3224,7 +3960,7 @@ export declare class Pagination extends Pagination_base {
  * @cssprop --padding
  * @cssprop --border-bottom
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
- * @deprecated use `nve-page-panel` with `nve-page` instead
+ * @deprecated use `nve-page-panel-header` with `nve-page-panel` instead
  */
 export declare class PanelHeader extends LitElement {
 	static styles: CSSResult[];
@@ -3243,6 +3979,7 @@ export declare class PanelHeader extends LitElement {
  * @slot - This is a default/unnamed slot for panel content
  * @cssprop --padding
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ * @deprecated use `nve-page-panel-content` with `nve-page-panel` instead
  */
 export declare class PanelContent extends LitElement {
 	static styles: CSSResult[];
@@ -3262,6 +3999,7 @@ export declare class PanelContent extends LitElement {
  * @cssprop --border-top
  * @cssprop --gap
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ * @deprecated use `nve-page-panel-footer` with `nve-page-panel` instead
  */
 export declare class PanelFooter extends LitElement {
 	static styles: CSSResult[];
@@ -3289,6 +4027,7 @@ export declare class PanelFooter extends LitElement {
  * @cssprop --panel-button-border-radius - Border radius of the panel expand/collapse button
  * @csspart icon-button - The expand/collapse icon button element
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ * @deprecated use `nve-page-panel` with `nve-page` instead
  */
 export declare class Panel extends LitElement {
 	#private;
@@ -3994,10 +4733,6 @@ declare const TabsItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
  * @entrypoint \@nvidia-elements/core/tabs
  * @slot - default slot for content
  * @cssprop --font-size
- * @cssprop --border-width
- * @cssprop --border-height
- * @cssprop --border-top
- * @cssprop --border-background
  * @cssprop --width
  * @cssprop --padding
  * @cssprop --font-size
@@ -4532,6 +5267,7 @@ export declare class Week extends Control implements ContainerElement {
 }
 
 export {
+	Color$1 as Color,
 	Date$1 as Date,
 	File$1 as File,
 	Notification$1 as Notification,