@nvidia-elements/core 2.23.0 → 2.23.2

package/dist/bundles/index.d.ts

@@ -156,11 +156,13 @@ export interface I18nStrings {
 	joystickReturnedToCenter: string;
 }
 export type I18nDefaults = Readonly<Partial<I18nStrings>>;
+/** @public */
 export type Color = "red-cardinal" | "gray-slate" | "gray-denim" | "blue-indigo" | "blue-cobalt" | "blue-sky" | "teal-cyan" | "green-mint" | "teal-seafoam" | "green-grass" | "yellow-amber" | "orange-pumpkin" | "red-tomato" | "pink-magenta" | "purple-plum" | "purple-violet" | "purple-lavender" | "pink-rose" | "green-jade" | "lime-pear" | "yellow-nova" | "brand-green";
 /** Controls the visual scale of an element to match its importance and available space.
  * - `sm` - Compact size for dense layouts or secondary elements with less visual prominence.
  * - `md` - Standard size that works well in most contexts and provides balanced visibility.
  * - `lg` - Larger size for emphasizing important elements or improving touch targets in spacious layouts.
+ * @public
  */
 export type Size = "sm" | "md" | "lg";
 /** Controls the visual scale of an element to match its importance and available space.
@@ -169,11 +171,13 @@ export type Size = "sm" | "md" | "lg";
  * - `md` - Standard size that works well in most contexts and provides balanced visibility.
  * - `lg` - Larger size for emphasizing important elements or improving touch targets in spacious layouts.
  * - `xl` - Extra large size for emphasizing elements or sparse layouts.
+ * @public
  */
 export type SizeExpanded = "xs" | "sm" | "md" | "lg" | "xl";
 /** Controls the visual prominence to establish hierarchy and guide user attention.
  * - `emphasis` - Increases visual weight to draw attention and highlight important elements.
  * - `muted` - Reduces visual weight for supporting content that should remain subtle and unobtrusive.
+ * @public
  */
 export type Prominence = "emphasis" | "muted";
 /**
@@ -182,11 +186,13 @@ export type Prominence = "emphasis" | "muted";
  * - `inline` Element container reduces to fit within inline content such as a block of text.
  * - `inset` Element container optimizes for embedding or inset placement inside another containing element.
  * - `full` Element container optimizes for filling its container bounds.
+ * @public
  */
 export type Container = "inline" | "flat" | "inset" | "full";
 /** Controls the visual density of an element to match its context and available space.
  * - `compact` - Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.
  * - `default` - Standard size that works well in most contexts and provides balanced visibility.
+ * @public
  */
 export type Density = "compact" | "default";
 /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
@@ -194,12 +200,14 @@ export type Density = "compact" | "default";
  * - `warning` - Indicates cautionary actions that require careful consideration before proceeding.
  * - `success` - Represents positive outcomes, confirmations, or constructive actions.
  * - `danger` - Signals destructive or irreversible actions that need extra attention and confirmation.
+ * @public
  */
 export type SupportStatus = "accent" | "warning" | "success" | "danger";
 /** Controls how the chart connects intermediate values between points in a data series.
  * - `linear` - Connects points with straight line segments.
  * - `smooth` - Connects points with smooth bezier curves.
  * - `step` - Connects points with horizontal and vertical step segments.
+ * @public
  */
 export type Interpolation = "linear" | "smooth" | "step";
 /** Communicates the current state of a task or process to keep users informed of progress and outcomes.
@@ -214,6 +222,7 @@ export type Interpolation = "linear" | "smooth" | "step";
  * - `failed` - Task encountered an error and did not complete as intended.
  * - `unknown` - Task status remains unknown or unavailable.
  * - `ignored` - Task was intentionally skipped or excluded from execution.
+ * @public
  */
 export type TaskStatus = "scheduled" | "queued" | "pending" | "starting" | "running" | "restarting" | "stopping" | "finished" | "failed" | "unknown" | "ignored";
 /**
@@ -221,12 +230,14 @@ export type TaskStatus = "scheduled" | "queued" | "pending" | "starting" | "runn
  * - `auto` light dismiss, focus on open, return to trigger
  * - `manual` no light dismiss, no auto focus
  * - `hint` no light dismiss, no auto focus, open/close on hover/focus
+ * @public
  */
 export type PopoverType = "auto" | "manual" | "hint" | "inline";
 /** Controls how the popover aligns along the edge of its anchor element.
  * - `start` - Aligns the popover to the beginning edge of the anchor for left or top alignment.
  * - `end` - Aligns the popover to the ending edge of the anchor for right or bottom alignment.
  * - `center` - Centers the popover along the anchor's edge for balanced positioning.
+ * @public
  */
 export type PopoverAlign = "start" | "end" | "center";
 /** Controls the placement of the popover relative to its anchor element.
@@ -235,6 +246,7 @@ export type PopoverAlign = "start" | "end" | "center";
  * - `bottom` - Positions the popover below the anchor element.
  * - `left` - Positions the popover to the left side of the anchor element.
  * - `right` - Positions the popover to the right side of the anchor element.
+ * @public
  */
 export type PopoverPosition = "center" | "top" | "bottom" | "left" | "right";
 /** Controls how data points are visually encoded in a sparkline chart.
@@ -243,17 +255,22 @@ export type PopoverPosition = "center" | "top" | "bottom" | "left" | "right";
  * - `gradient` - Renders a line with gradient color treatment to communicate value intensity across the series.
  * - `column` - Renders data as vertical columns for easy comparison of discrete values.
  * - `winloss` - Renders outcomes as binary or ternary bars to highlight wins, losses, and optional ties.
+ * @public
  */
 export type SparklineMark = "line" | "area" | "gradient" | "column" | "winloss";
 /** 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.
+ * @public
  */
 export type Interaction = "emphasis" | "destructive";
+/** @public */
 export interface ContainerElement {
 	container?: Partial<Container>;
 }
-/** An element that renders complex data structures (e.g., arrays, series, matrices) rather than composable UI content and values expressible with primitive attributes. */
+/** An element that renders complex data structures (e.g., arrays, series, matrices) rather than composable UI content and values expressible with primitive attributes.
+ * @public
+ */
 export interface DataElement<T extends unknown[] | Record<string, unknown>> {
 	data?: T;
 }
@@ -279,439 +296,10 @@ declare class TypeNativePopoverController<T extends NativePopover> implements Re
 	hostUpdated(): Promise<void>;
 	hostDisconnected(): void;
 }
-export type FormControlValue = string | number | boolean | File | File[] | FormData | null | object;
-export interface SchemaBase {
-	type: string;
-	description?: string;
-	format?: string;
-}
-export interface StringSchema extends SchemaBase {
-	type: "string";
-	minLength?: number;
-	maxLength?: number;
-	pattern?: string;
-}
-export interface NumberSchema extends SchemaBase {
-	type: "number";
-	minimum?: number;
-	maximum?: number;
-	multipleOf?: number;
-}
-export interface BooleanSchema extends SchemaBase {
-	type: "boolean";
-}
-export interface ArraySchema extends SchemaBase {
-	type: "array";
-	items: Schema;
-	minItems?: number;
-	maxItems?: number;
-}
-export interface ObjectSchema extends SchemaBase {
-	type: "object";
-	properties: Record<string, Schema>;
-	required?: string[];
-	additionalProperties?: boolean | Schema;
-}
-export interface EnumSchema extends SchemaBase {
-	type: "enum";
-	enum: Array<string | number>;
-}
-export type Schema = StringSchema | NumberSchema | BooleanSchema | ArraySchema | ObjectSchema | EnumSchema;
-export interface FormControlMetadata {
-	tag: string;
-	valueSchema: Schema;
-	version?: string;
-	validators?: Validator[];
-	strict?: boolean;
-}
-export interface FormControlInstance extends HTMLElement {
-	value: FormControlValue | undefined;
-	defaultValue: string;
-	form: HTMLFormElement | null;
-	readOnly: boolean;
-	disabled: boolean;
-	name: string;
-	noValidate: boolean;
-	willValidate: boolean;
-	validity: ValidityState;
-	validationMessage: string;
-	required: boolean;
-	pattern: string;
-	min: number | null;
-	max: number | null;
-	step: number | null;
-	minLength: number;
-	maxLength: number;
-	labels: NodeList;
-	composedLabel: string;
-	valueAsString: string;
-	valueAsNumber: number;
-	checkValidity(): boolean;
-	reportValidity(): boolean;
-	reset(): void;
-	setCustomValidity(message: string): void;
-}
-export interface ValidatorResult {
-	validity: Partial<ValidityState>;
-	message?: string;
-}
-export type Validator = (value: unknown, element: FormControlInstance) => ValidatorResult;
-export type Constructor = (new (...args: any[]) => HTMLElement & {
-	connectedCallback?(): void;
-	disconnectedCallback?(): void;
-	attributeChangedCallback?(name: string, oldValue: string | null, newValue: string | null): void;
-	requestUpdate?(name?: string, oldValue?: unknown): void;
-}) & {
-	observedAttributes?: string[];
-};
-export interface FormControlMixinInstance<T extends FormControlValue> {
-	/**
-	 * The initial value used when the parent form resets.
-	 */
-	defaultValue: string;
-	/**
-	 * Prevents the user from changing the control value.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly
-	 * @attr readonly
-	 * @reflect
-	 */
-	readOnly: boolean;
-	/**
-	 * Prevents the user from interacting with the control.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled
-	 * @attr disabled
-	 * @reflect
-	 */
-	disabled: boolean;
-	/**
-	 * Requires a value before the parent form can submit.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required
-	 * @attr required
-	 * @reflect
-	 */
-	required: boolean;
-	/**
-	 * Defines the pattern that text values must match.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/pattern
-	 * @attr pattern
-	 * @reflect
-	 */
-	pattern: string;
-	/**
-	 * Defines the minimum numeric value.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/min
-	 * @attr min
-	 * @reflect
-	 */
-	min: number | null;
-	/**
-	 * Defines the maximum numeric value.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/max
-	 * @attr max
-	 * @reflect
-	 */
-	max: number | null;
-	/**
-	 * Defines the value granularity for numeric inputs.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step
-	 * @attr step
-	 * @reflect
-	 */
-	step: number | null;
-	/**
-	 * Defines the minimum text length.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/minlength
-	 * @attr minlength
-	 * @reflect
-	 */
-	minLength: number;
-	/**
-	 * Defines the maximum text length.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/maxlength
-	 * @attr maxlength
-	 * @reflect
-	 */
-	maxLength: number;
-	/**
-	 * The name submitted with the control value as part of the form data.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/name
-	 * @attr name
-	 * @reflect
-	 */
-	name: string;
-	/**
-	 * Disables constraint validation for this control.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/novalidate
-	 * @attr novalidate
-	 * @reflect
-	 */
-	noValidate: boolean;
-	/**
-	 * The current form control value.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/value
-	 * @attr value
-	 * @reflect
-	 */
-	value: T | undefined;
-	/**
-	 * The form associated with the control.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form
-	 */
-	form: HTMLFormElement | null;
-	/**
-	 * Indicates whether the control participates in constraint validation.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/willValidate
-	 */
-	willValidate: boolean;
-	/**
-	 * The control validity state.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validity
-	 */
-	validity: ValidityState;
-	/**
-	 * The validation message shown when the control is invalid.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validationMessage
-	 */
-	validationMessage: string;
-	/**
-	 * The current value serialized as a string.
-	 */
-	valueAsString: string;
-	/**
-	 * The current value parsed as a number.
-	 */
-	valueAsNumber: number;
-	/**
-	 * The control type.
-	 */
-	type: string;
-	/**
-	 * Labels associated with the control.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels
-	 */
-	labels: NodeList;
-	/**
-	 * Text content from labels associated with the control.
-	 */
-	composedLabel: string;
-	_metadata: FormControlMetadata;
-	_initialValue: T | undefined;
-	_validators: NonNullable<FormControlMetadata["validators"]>;
-	_internals: ElementInternals;
-	updateValue(value: T): void;
-	_stopInternalPropagation(event: Event): void;
-	_handleAttributeChange(name: string, newValue: string | null): void;
-	formResetCallback(): void;
-	formDisabledCallback(disabled: boolean): void;
-	formStateRestoreCallback(state: T, reason: string): void;
-	/**
-	 * Reports whether the control satisfies its constraints.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
-	 */
-	reportValidity(): boolean;
-	/**
-	 * Checks whether the control satisfies its constraints.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
-	 */
-	checkValidity(): boolean;
-	setValidity(validity: Partial<ValidityState>, message?: string): void;
-	/**
-	 * Sets a custom validation message.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
-	 */
-	setCustomValidity(message: string): void;
-	/**
-	 * Resets the control value to its initial value.
-	 */
-	reset(): void;
-	dispatchInputEvent(): void;
-	dispatchChangeEvent(): void;
-	dispatchUpdateEvent(type: "input" | "change"): void;
-	_updateFormState(): void;
-	_requestUpdate(): void;
-}
-export type FormControlMixinReturn<TBase extends Constructor, T extends FormControlValue> = (new (...args: ConstructorParameters<TBase>) => InstanceType<TBase> & FormControlMixinInstance<T>) & {
-	formAssociated: boolean;
-	metadata: FormControlMetadata;
-	observedAttributes: string[];
-} & Omit<TBase, "prototype">;
-export type ButtonType = "button" | "submit" | "reset";
-export type CurrentState = "page" | "step";
-export type PopoverTargetAction = "show" | "hide" | "toggle";
-export interface ButtonFormControlMixinInstance {
-	/**
-	 * Use for toggle button types.
-	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed
-	 * @attr pressed
-	 * @reflect
-	 */
-	pressed: boolean;
-	/**
-	 * Use for buttons that expand or collapse content.
-	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded
-	 * @attr expanded
-	 * @reflect
-	 */
-	expanded: boolean;
-	/**
-	 * Indicates whether the element is a noninteractive visual treatment instead of a button.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly
-	 * @attr readonly
-	 * @reflect
-	 */
-	readOnly: boolean;
-	/** @deprecated Use readOnly instead. */
-	readonly: boolean;
-	/**
-	 * Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only
-	 * the form ID. Reading the property returns the associated form element or `null`.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form
-	 * @attr form
-	 */
-	form: HTMLFormElement | null | string;
-	/**
-	 * The name of the button, submitted as a pair with the button value as part of the form data.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-name
-	 * @attr name
-	 * @reflect
-	 */
-	name: string;
-	/**
-	 * Defines the value associated with the button name when submitting form data.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-value
-	 * @attr value
-	 * @reflect
-	 */
-	value: string;
-	/**
-	 * Defines the button behavior when associated within a form element.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type
-	 * @attr type
-	 * @reflect
-	 */
-	type: ButtonType;
-	/**
-	 * Prevents the user from interacting with the button.
-	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-disabled
-	 * @attr disabled
-	 * @reflect
-	 */
-	disabled: boolean;
-	/**
-	 * Sets selected state when the button belongs to a multi-choice selection group.
-	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected
-	 * @attr selected
-	 * @reflect
-	 */
-	selected: boolean;
-	/**
-	 * Sets the current state used to represent the current page or navigation link.
-	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current
-	 * @attr current
-	 * @reflect
-	 */
-	get current(): CurrentState;
-	set current(value: CurrentState | null | undefined);
-	/**
-	 * Establishes a relationship between a popover and its invoker button.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/popoverTargetElement
-	 * @attr popovertarget
-	 * @reflect
-	 */
-	popoverTargetElement: HTMLElement | null;
-	/**
-	 * The popover target action to perform on the popover target element.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/popoverTargetAction
-	 * @attr popovertargetaction
-	 * @reflect
-	 */
-	popoverTargetAction: PopoverTargetAction;
-	/**
-	 * The element that receives the command.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API
-	 * @attr commandfor
-	 * @reflect
-	 */
-	commandForElement: HTMLElement | null;
-	/**
-	 * The command to execute on the element.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API
-	 * @attr command
-	 * @reflect
-	 */
-	command: string;
-	/**
-	 * The element that receives the interest.
-	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement/interestForElement
-	 * @attr interestfor
-	 * @reflect
-	 */
-	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>;
-}
-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.
- * @documentation https://nvidia.github.io/elements/docs/elements/button/
- * @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>;
-}
-export interface IconSVG {
-	svg: () => Promise<string> | string;
+export declare const ICON_NAMES: IconName[];
+export declare const ICON_NAMES_SOLID: readonly IconNameSolid[];
+export interface IconSVG {
+	svg: () => Promise<string> | string;
 }
 export declare const ICON_IMPORTS: {
 	placeholder: IconSVG;
@@ -1014,13 +602,29 @@ export declare const ICON_IMPORTS: {
 	"zoom-out": IconSVG;
 };
 export type IconNameSolid = "bell" | "book" | "bookmark" | "chat-bubble" | "check-badge" | "checkmark-circle" | "circle-angled-line" | "delete" | "dot" | "exclamation-circle" | "exclamation-triangle" | "face-smile" | "filter" | "flag" | "gear" | "home" | "information-circle" | "lightning-bolt" | "lock" | "minus-circle" | "person" | "pin" | "plus-circle" | "pointer" | "question-mark-circle" | "sparkles" | "thumb" | "unlock" | "volume" | "wrench" | "x-circle";
-export declare const ICON_NAMES_SOLID: readonly IconNameSolid[];
-export declare const ICON_NAMES: IconName[];
+declare class IconRegistry {
+	#private;
+	icons: Record<string, IconSVG>;
+	constructor(importer?: () => Promise<Record<string, IconSVG>>);
+	add(name: string, icon: IconSVG, svg?: string | (() => string)): void;
+	alias(name: string, target: string): void;
+	sync(name: string): string | undefined;
+	aliasEntries(): MapIterator<[
+		string,
+		string
+	]>;
+	merge(other: IconRegistry): void;
+	loadCatalog(): Promise<Record<string, IconSVG>>;
+	resolve(input: string): Promise<string>;
+}
 /**
  * @element nve-icon
  * @since 0.1.3
  * @entrypoint \@nvidia-elements/core/icon
  * @description An icon is a graphic symbol designed to visually show the purpose of an interface element.
+ * Import `@nvidia-elements/core/icon/icons/person.js` to register one SVG before rendering.
+ * Import `person-solid.js` separately for solid appearance. Missing names load the built-in catalog on demand.
+ * Explicit imports reduce initial loading in application builds; the full browser bundle remains a single file.
  * @documentation https://nvidia.github.io/elements/docs/elements/icon/
  * @cssprop --color
  * @cssprop --width
@@ -1057,12 +661,9 @@ export declare class Icon extends LitElement {
 		tag: string;
 		version: string;
 	};
-	static _icons: {
-		[key: string]: IconSVG;
-	};
-	private static get _iconsRegistry();
-	private static set _iconsRegistry(value);
-	private static get registeredIcon();
+	static _registry: IconRegistry;
+	static get _icons(): Record<string, IconSVG>;
+	static set _icons(icons: Record<string, IconSVG>);
 	/** @private */
 	_internals: ElementInternals;
 	render(): TemplateResult<1>;
@@ -1077,6 +678,440 @@ export declare class Icon extends LitElement {
 	updated(props: PropertyValues<this>): Promise<void>;
 }
 export declare function mergeIcons(RegisteredIcon: typeof Icon): void;
+export type FormControlValue = string | number | boolean | File | File[] | FormData | null | object;
+export interface SchemaBase {
+	type: string;
+	description?: string;
+	format?: string;
+}
+export interface StringSchema extends SchemaBase {
+	type: "string";
+	minLength?: number;
+	maxLength?: number;
+	pattern?: string;
+}
+export interface NumberSchema extends SchemaBase {
+	type: "number";
+	minimum?: number;
+	maximum?: number;
+	multipleOf?: number;
+}
+export interface BooleanSchema extends SchemaBase {
+	type: "boolean";
+}
+export interface ArraySchema extends SchemaBase {
+	type: "array";
+	items: Schema;
+	minItems?: number;
+	maxItems?: number;
+}
+export interface ObjectSchema extends SchemaBase {
+	type: "object";
+	properties: Record<string, Schema>;
+	required?: string[];
+	additionalProperties?: boolean | Schema;
+}
+export interface EnumSchema extends SchemaBase {
+	type: "enum";
+	enum: Array<string | number>;
+}
+export type Schema = StringSchema | NumberSchema | BooleanSchema | ArraySchema | ObjectSchema | EnumSchema;
+export interface FormControlMetadata {
+	tag: string;
+	valueSchema: Schema;
+	version?: string;
+	validators?: Validator[];
+	strict?: boolean;
+}
+export interface FormControlInstance extends HTMLElement {
+	value: FormControlValue | undefined;
+	defaultValue: string;
+	form: HTMLFormElement | null;
+	readOnly: boolean;
+	disabled: boolean;
+	name: string;
+	noValidate: boolean;
+	willValidate: boolean;
+	validity: ValidityState;
+	validationMessage: string;
+	required: boolean;
+	pattern: string;
+	min: number | null;
+	max: number | null;
+	step: number | null;
+	minLength: number;
+	maxLength: number;
+	labels: NodeList;
+	composedLabel: string;
+	valueAsString: string;
+	valueAsNumber: number;
+	checkValidity(): boolean;
+	reportValidity(): boolean;
+	reset(): void;
+	setCustomValidity(message: string): void;
+}
+export interface ValidatorResult {
+	validity: Partial<ValidityState>;
+	message?: string;
+}
+export type Validator = (value: unknown, element: FormControlInstance) => ValidatorResult;
+export type Constructor = (new (...args: any[]) => HTMLElement & {
+	connectedCallback?(): void;
+	disconnectedCallback?(): void;
+	attributeChangedCallback?(name: string, oldValue: string | null, newValue: string | null): void;
+	requestUpdate?(name?: string, oldValue?: unknown): void;
+}) & {
+	observedAttributes?: string[];
+};
+export interface FormControlMixinInstance<T extends FormControlValue> {
+	/**
+	 * The initial value used when the parent form resets.
+	 */
+	defaultValue: string;
+	/**
+	 * Prevents the user from changing the control value.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly
+	 * @attr readonly
+	 * @reflect
+	 */
+	readOnly: boolean;
+	/**
+	 * Prevents the user from interacting with the control.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/disabled
+	 * @attr disabled
+	 * @reflect
+	 */
+	disabled: boolean;
+	/**
+	 * Requires a value before the parent form can submit.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/required
+	 * @attr required
+	 * @reflect
+	 */
+	required: boolean;
+	/**
+	 * Defines the pattern that text values must match.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/pattern
+	 * @attr pattern
+	 * @reflect
+	 */
+	pattern: string;
+	/**
+	 * Defines the minimum numeric value.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/min
+	 * @attr min
+	 * @reflect
+	 */
+	min: number | null;
+	/**
+	 * Defines the maximum numeric value.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/max
+	 * @attr max
+	 * @reflect
+	 */
+	max: number | null;
+	/**
+	 * Defines the value granularity for numeric inputs.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/step
+	 * @attr step
+	 * @reflect
+	 */
+	step: number | null;
+	/**
+	 * Defines the minimum text length.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/minlength
+	 * @attr minlength
+	 * @reflect
+	 */
+	minLength: number;
+	/**
+	 * Defines the maximum text length.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/maxlength
+	 * @attr maxlength
+	 * @reflect
+	 */
+	maxLength: number;
+	/**
+	 * The name submitted with the control value as part of the form data.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/name
+	 * @attr name
+	 * @reflect
+	 */
+	name: string;
+	/**
+	 * Disables constraint validation for this control.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/novalidate
+	 * @attr novalidate
+	 * @reflect
+	 */
+	noValidate: boolean;
+	/**
+	 * The current form control value.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/value
+	 * @attr value
+	 * @reflect
+	 */
+	value: T | undefined;
+	/**
+	 * The form associated with the control.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form
+	 */
+	form: HTMLFormElement | null;
+	/**
+	 * Indicates whether the control participates in constraint validation.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/willValidate
+	 */
+	willValidate: boolean;
+	/**
+	 * The control validity state.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validity
+	 */
+	validity: ValidityState;
+	/**
+	 * The validation message shown when the control is invalid.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/validationMessage
+	 */
+	validationMessage: string;
+	/**
+	 * The current value serialized as a string.
+	 */
+	valueAsString: string;
+	/**
+	 * The current value parsed as a number.
+	 */
+	valueAsNumber: number;
+	/**
+	 * The control type.
+	 */
+	type: string;
+	/**
+	 * Labels associated with the control.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels
+	 */
+	labels: NodeList;
+	/**
+	 * Text content from labels associated with the control.
+	 */
+	composedLabel: string;
+	_metadata: FormControlMetadata;
+	_initialValue: T | undefined;
+	_validators: NonNullable<FormControlMetadata["validators"]>;
+	_internals: ElementInternals;
+	updateValue(value: T): void;
+	_stopInternalPropagation(event: Event): void;
+	_handleAttributeChange(name: string, newValue: string | null): void;
+	formResetCallback(): void;
+	formDisabledCallback(disabled: boolean): void;
+	formStateRestoreCallback(state: T, reason: string): void;
+	/**
+	 * Reports whether the control satisfies its constraints.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
+	 */
+	reportValidity(): boolean;
+	/**
+	 * Checks whether the control satisfies its constraints.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
+	 */
+	checkValidity(): boolean;
+	setValidity(validity: Partial<ValidityState>, message?: string): void;
+	/**
+	 * Sets a custom validation message.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
+	 */
+	setCustomValidity(message: string): void;
+	/**
+	 * Resets the control value to its initial value.
+	 */
+	reset(): void;
+	dispatchInputEvent(): void;
+	dispatchChangeEvent(): void;
+	dispatchUpdateEvent(type: "input" | "change"): void;
+	_updateFormState(): void;
+	_requestUpdate(): void;
+}
+export type FormControlMixinReturn<TBase extends Constructor, T extends FormControlValue> = (new (...args: ConstructorParameters<TBase>) => InstanceType<TBase> & FormControlMixinInstance<T>) & {
+	formAssociated: boolean;
+	metadata: FormControlMetadata;
+	observedAttributes: string[];
+} & Omit<TBase, "prototype">;
+export type ButtonType = "button" | "submit" | "reset";
+export type CurrentState = "page" | "step";
+export type PopoverTargetAction = "show" | "hide" | "toggle";
+export interface ButtonFormControlMixinInstance {
+	/**
+	 * Use for toggle button types.
+	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed
+	 * @attr pressed
+	 * @reflect
+	 */
+	pressed: boolean;
+	/**
+	 * Use for buttons that expand or collapse content.
+	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded
+	 * @attr expanded
+	 * @reflect
+	 */
+	expanded: boolean;
+	/**
+	 * Indicates whether the element is a noninteractive visual treatment instead of a button.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly
+	 * @attr readonly
+	 * @reflect
+	 */
+	readOnly: boolean;
+	/** @deprecated Use readOnly instead. */
+	readonly: boolean;
+	/**
+	 * Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only
+	 * the form ID. Reading the property returns the associated form element or `null`.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form
+	 * @attr form
+	 */
+	form: HTMLFormElement | null | string;
+	/**
+	 * The name of the button, submitted as a pair with the button value as part of the form data.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-name
+	 * @attr name
+	 * @reflect
+	 */
+	name: string;
+	/**
+	 * Defines the value associated with the button name when submitting form data.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-value
+	 * @attr value
+	 * @reflect
+	 */
+	value: string;
+	/**
+	 * Defines the button behavior when associated within a form element.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type
+	 * @attr type
+	 * @reflect
+	 */
+	type: ButtonType;
+	/**
+	 * Prevents the user from interacting with the button.
+	 * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-disabled
+	 * @attr disabled
+	 * @reflect
+	 */
+	disabled: boolean;
+	/**
+	 * Sets selected state when the button belongs to a multi-choice selection group.
+	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected
+	 * @attr selected
+	 * @reflect
+	 */
+	selected: boolean;
+	/**
+	 * Sets the current state used to represent the current page or navigation link.
+	 * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-current
+	 * @attr current
+	 * @reflect
+	 */
+	get current(): CurrentState;
+	set current(value: CurrentState | null | undefined);
+	/**
+	 * Establishes a relationship between a popover and its invoker button.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/popoverTargetElement
+	 * @attr popovertarget
+	 * @reflect
+	 */
+	popoverTargetElement: HTMLElement | null;
+	/**
+	 * The popover target action to perform on the popover target element.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/popoverTargetAction
+	 * @attr popovertargetaction
+	 * @reflect
+	 */
+	popoverTargetAction: PopoverTargetAction;
+	/**
+	 * The element that receives the command.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API
+	 * @attr commandfor
+	 * @reflect
+	 */
+	commandForElement: HTMLElement | null;
+	/**
+	 * The command to execute on the element.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/Invoker_Commands_API
+	 * @attr command
+	 * @reflect
+	 */
+	command: string;
+	/**
+	 * The element that receives the interest.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement/interestForElement
+	 * @attr interestfor
+	 * @reflect
+	 */
+	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>;
+}
+type Constructor$1 = (new (...args: any[]) => HTMLElement & ButtonFormControlHost) & {
+	observedAttributes?: string[];
+};
+export type ButtonFormControlConstructor<TBase extends Constructor$1> = new (...args: ConstructorParameters<TBase>) => InstanceType<TBase> & ButtonFormControlMixinInstance;
+/** @public
+ * @public
+ */
+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.
+ * @documentation https://nvidia.github.io/elements/docs/elements/button/
+ * @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.
@@ -1876,134 +1911,6 @@ declare class Color$1 extends Control implements ContainerElement {
 	protected get suffixContent(): TemplateResult<1>;
 	connectedCallback(): void;
 }
-/**
- * @element nve-menu
- * @description A menu offers a list of choices to the user, such as a set of actions or functions. Choosing an item in a menu typically opens a sub menu, or invokes a command.
- * @documentation https://nvidia.github.io/elements/docs/elements/menu/
- * @since 0.11.0
- * @entrypoint \@nvidia-elements/core/menu
- * @slot - default slot for `nve-menu-item`
- * @cssprop --padding
- * @cssprop --gap
- * @cssprop --width
- * @cssprop --max-width
- * @cssprop --min-width
- * @cssprop --max-height
- * @event scroll - Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
- * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
- */
-export declare class Menu extends LitElement {
-	#private;
-	static styles: CSSResult[];
-	static readonly metadata: {
-		tag: string;
-		version: string;
-		children: string[];
-	};
-	static elementDefinitions: {};
-	/**
-	 * Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.
-	 */
-	density?: Density;
-	/** @private */
-	get keynavListConfig(): KeynavListConfig;
-	/** @private */
-	_internals: ElementInternals;
-	private items;
-	render(): TemplateResult<1>;
-	firstUpdated(): Promise<void>;
-	connectedCallback(): void;
-	disconnectedCallback(): void;
-}
-/**
- * @element nve-menu-group
- * @description Organizes related menu items under a disclosure header that can show or hide one child menu.
- * @documentation https://nvidia.github.io/elements/docs/elements/menu/
- * @since 0.0.0
- * @entrypoint \@nvidia-elements/core/menu
- * @command --open - Opens the menu group.
- * @command --close - Closes the menu group.
- * @command --toggle - Toggles the menu group.
- * @event open - Dispatched when the user requests that the menu group open.
- * @event close - Dispatched when the user requests that the menu group close.
- * @slot - Label content for the disclosure header.
- * @slot prefix - Non-interactive content before the header label, such as an icon or avatar.
- * @slot suffix - Non-interactive content after the header label, such as a badge or count.
- * @slot menu - One `nve-menu` containing the grouped menu items. Direct menus use this slot automatically in browsers; server-rendered menus must set `slot="menu"` explicitly.
- * @cssprop --background
- * @cssprop --font-size
- * @cssprop --padding
- * @cssprop --gap
- * @cssprop --border-radius
- * @cssprop --color
- * @cssprop --width
- * @cssprop --min-height
- * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
- * @stable false
- */
-export declare class MenuGroup extends LitElement {
-	#private;
-	static styles: CSSResult[];
-	static readonly metadata: {
-		tag: string;
-		version: string;
-		children: string[];
-	};
-	static elementDefinitions: {
-		[Icon.metadata.tag]: typeof Icon;
-	};
-	/** Determines whether the child menu is visible. */
-	expanded: boolean;
-	/** Prevents user activation of the disclosure header. */
-	disabled: boolean;
-	/** Determines whether user activation automatically updates the expanded state. */
-	behaviorExpand: boolean;
-	/** @private */
-	_internals: ElementInternals;
-	render(): TemplateResult<1>;
-	connectedCallback(): void;
-}
-declare const MenuItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
-/**
- * @element nve-menu-item
- * @description Represents a selectable option within a menu, providing an interactive button for navigation or actions.
- * @documentation https://nvidia.github.io/elements/docs/elements/menu/
- * @since 0.11.0
- * @entrypoint \@nvidia-elements/core/menu
- * @slot - Label and supporting content for the menu option.
- * @slot prefix - slot for prefix icon
- * @slot suffix - slot for suffix icon
- * @cssprop --background
- * @cssprop --border-radius
- * @cssprop --border-background
- * @cssprop --font-size
- * @cssprop --font-weight
- * @cssprop --color
- * @cssprop --padding
- * @cssprop --gap
- * @cssprop --width
- * @cssprop --min-height
- * @cssprop --line-height
- * @cssprop --cursor
- * @cssprop --opacity
- * @cssprop --text-transform
-
- * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
- */
-export declare class MenuItem extends MenuItem_base {
-	static styles: CSSResult[];
-	/** Applies danger styling to destructive or high-risk menu actions. */
-	status: "danger";
-	static readonly metadata: {
-		tag: string;
-		version: string;
-		parents: string[];
-	};
-	static elementDefinitions: {};
-	render(): TemplateResult<1>;
-	constructor();
-	connectedCallback(): void;
-}
 /**
  * @element nve-dropdown
  * @description Generic dropdown element for rendering a variety of different content such as interactive navigation or form controls.
@@ -2133,6 +2040,134 @@ export declare class DropdownHeader extends LitElement {
 	render(): TemplateResult<1>;
 	connectedCallback(): void;
 }
+/**
+ * @element nve-menu
+ * @description A menu offers a list of choices to the user, such as a set of actions or functions. Choosing an item in a menu typically opens a sub menu, or invokes a command.
+ * @documentation https://nvidia.github.io/elements/docs/elements/menu/
+ * @since 0.11.0
+ * @entrypoint \@nvidia-elements/core/menu
+ * @slot - default slot for `nve-menu-item`
+ * @cssprop --padding
+ * @cssprop --gap
+ * @cssprop --width
+ * @cssprop --max-width
+ * @cssprop --min-width
+ * @cssprop --max-height
+ * @event scroll - Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
+ */
+export declare class Menu extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	static elementDefinitions: {};
+	/**
+	 * Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.
+	 */
+	density?: Density;
+	/** @private */
+	get keynavListConfig(): KeynavListConfig;
+	/** @private */
+	_internals: ElementInternals;
+	private items;
+	render(): TemplateResult<1>;
+	firstUpdated(): Promise<void>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+}
+/**
+ * @element nve-menu-group
+ * @description Organizes related menu items under a disclosure header that can show or hide one child menu.
+ * @documentation https://nvidia.github.io/elements/docs/elements/menu/
+ * @since 0.0.0
+ * @entrypoint \@nvidia-elements/core/menu
+ * @command --open - Opens the menu group.
+ * @command --close - Closes the menu group.
+ * @command --toggle - Toggles the menu group.
+ * @event open - Dispatched when the user requests that the menu group open.
+ * @event close - Dispatched when the user requests that the menu group close.
+ * @slot - Label content for the disclosure header.
+ * @slot prefix - Non-interactive content before the header label, such as an icon or avatar.
+ * @slot suffix - Non-interactive content after the header label, such as a badge or count.
+ * @slot menu - One `nve-menu` containing the grouped menu items. Direct menus use this slot automatically in browsers; server-rendered menus must set `slot="menu"` explicitly.
+ * @cssprop --background
+ * @cssprop --font-size
+ * @cssprop --padding
+ * @cssprop --gap
+ * @cssprop --border-radius
+ * @cssprop --color
+ * @cssprop --width
+ * @cssprop --min-height
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/
+ * @stable false
+ */
+export declare class MenuGroup extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		children: string[];
+	};
+	static elementDefinitions: {
+		[Icon.metadata.tag]: typeof Icon;
+	};
+	/** Determines whether the child menu is visible. */
+	expanded: boolean;
+	/** Prevents user activation of the disclosure header. */
+	disabled: boolean;
+	/** Determines whether user activation automatically updates the expanded state. */
+	behaviorExpand: boolean;
+	/** @private */
+	_internals: ElementInternals;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+}
+declare const MenuItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
+/**
+ * @element nve-menu-item
+ * @description Represents a selectable option within a menu, providing an interactive button for navigation or actions.
+ * @documentation https://nvidia.github.io/elements/docs/elements/menu/
+ * @since 0.11.0
+ * @entrypoint \@nvidia-elements/core/menu
+ * @slot - Label and supporting content for the menu option.
+ * @slot prefix - slot for prefix icon
+ * @slot suffix - slot for suffix icon
+ * @cssprop --background
+ * @cssprop --border-radius
+ * @cssprop --border-background
+ * @cssprop --font-size
+ * @cssprop --font-weight
+ * @cssprop --color
+ * @cssprop --padding
+ * @cssprop --gap
+ * @cssprop --width
+ * @cssprop --min-height
+ * @cssprop --line-height
+ * @cssprop --cursor
+ * @cssprop --opacity
+ * @cssprop --text-transform
+
+ * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
+ */
+export declare class MenuItem extends MenuItem_base {
+	static styles: CSSResult[];
+	/** Applies danger styling to destructive or high-risk menu actions. */
+	status: "danger";
+	static readonly metadata: {
+		tag: string;
+		version: string;
+		parents: string[];
+	};
+	static elementDefinitions: {};
+	render(): TemplateResult<1>;
+	constructor();
+	connectedCallback(): void;
+}
 declare const Tag_base: ButtonFormControlMixinReturn<typeof LitElement>;
 /**
  * @element nve-tag
@@ -2243,7 +2278,7 @@ export declare class Combobox extends Control implements ContainerElement {
 	};
 	protected _associateDatalist: boolean;
 	protected get prefixContent(): TemplateResult<1>;
-	protected get suffixContent(): TemplateResult<1> | typeof nothing;
+	protected get suffixContent(): typeof nothing | TemplateResult<1>;
 	firstUpdated(props: PropertyValues<this>): Promise<void>;
 	updated(props: PropertyValues<this>): void;
 	connectedCallback(): void;
@@ -4411,7 +4446,7 @@ export declare class Select extends Control {
 	i18n: Partial<I18nStrings & {
 		__set: boolean;
 	}>;
-	protected get prefixContent(): TemplateResult<1> | typeof nothing;
+	protected get prefixContent(): typeof nothing | TemplateResult<1>;
 	protected get suffixContent(): TemplateResult<1>;
 	firstUpdated(props: PropertyValues<this>): Promise<void>;
 	connectedCallback(): void;
@@ -4979,7 +5014,7 @@ declare class Range$1 extends Control {
 	connectedCallback(): void;
 	firstUpdated(props: PropertyValues<this>): void;
 	updated(props: PropertyValues<this>): void;
-	protected get suffixContent(): TemplateResult<1> | typeof nothing;
+	protected get suffixContent(): typeof nothing | TemplateResult<1>;
 }
 declare const ResizeHandle_base: FormControlMixinReturn<typeof LitElement, number>;
 /**