@nvidia-elements/core 2.23.1 → 2.23.2

package/dist/bundles/index.d.ts

@@ -296,440 +296,8 @@ 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;
-/** @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>;
-}
+export declare const ICON_NAMES: IconName[];
+export declare const ICON_NAMES_SOLID: readonly IconNameSolid[];
 export interface IconSVG {
 	svg: () => Promise<string> | string;
 }
@@ -1034,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
@@ -1051,52 +635,483 @@ export declare const ICON_NAMES: IconName[];
 export declare class Icon extends LitElement {
 	#private;
 	/**
-	 * Visual treatment to represent current support status.
+	 * Visual treatment to represent current support status.
+	 */
+	status?: "warning" | "danger" | "success" | "accent";
+	/**
+	 * Controls the bounding box size of the icon given a t-shirt style value.
+	 */
+	size?: Size | "xs" | "xl";
+	/**
+	 * 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";
+	/**
+	 * Selects the outline or solid form of the named icon. Solid icons use an optional `-solid` asset and fall back to
+	 * the outline form when that asset is unavailable.
+	 */
+	appearance?: "outline" | "solid";
+	/**
+	 * The name of the icon SVG sprite to render.
+	 */
+	name?: IconName;
+	private svg;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	static _registry: IconRegistry;
+	static get _icons(): Record<string, IconSVG>;
+	static set _icons(icons: Record<string, IconSVG>);
+	/** @private */
+	_internals: ElementInternals;
+	render(): TemplateResult<1>;
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	static add(icons: {
+		[key: string]: IconSVG;
+	}): Promise<void>;
+	static alias(aliases: {
+		[key: string]: IconName | string;
+	}): void;
+	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
 	 */
-	status?: "warning" | "danger" | "success" | "accent";
+	validationMessage: string;
 	/**
-	 * Controls the bounding box size of the icon given a t-shirt style value.
+	 * The current value serialized as a string.
 	 */
-	size?: Size | "xs" | "xl";
+	valueAsString: string;
 	/**
-	 * Sets the direction of the icon. Only supported by expand-panel/collapse-panel (horizontal axis) and arrow/caret/chevron icons (4-directions)
+	 * The current value parsed as a number.
 	 */
-	direction?: "up" | "down" | "left" | "right";
+	valueAsNumber: number;
 	/**
-	 * Selects the outline or solid form of the named icon. Solid icons use an optional `-solid` asset and fall back to
-	 * the outline form when that asset is unavailable.
+	 * The control type.
 	 */
-	appearance?: "outline" | "solid";
+	type: string;
 	/**
-	 * The name of the icon SVG sprite to render.
+	 * Labels associated with the control.
+	 * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/labels
 	 */
-	name?: IconName;
-	private svg;
+	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;
 	};
-	static _icons: {
-		[key: string]: IconSVG;
-	};
-	private static get _iconsRegistry();
-	private static set _iconsRegistry(value);
-	private static get registeredIcon();
-	/** @private */
-	_internals: ElementInternals;
+	/**
+	 * 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>;
-	connectedCallback(): void;
-	disconnectedCallback(): void;
-	static add(icons: {
-		[key: string]: IconSVG;
-	}): Promise<void>;
-	static alias(aliases: {
-		[key: string]: IconName | string;
-	}): void;
-	updated(props: PropertyValues<this>): Promise<void>;
 }
-export declare function mergeIcons(RegisteredIcon: typeof Icon): void;
 /**
  * @element nve-icon-button
  * @description An icon button is a button that displays only an icon without a visual label.
@@ -1896,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.
@@ -2153,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
@@ -2263,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;
@@ -4431,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;
@@ -4999,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>;
 /**