@nvidia-elements/core 2.10.0 → 2.11.1

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+## [2.11.1](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.11.0...@nvidia-elements/core-v2.11.1) (2026-10-01)
+
+### Bug Fixes
+
+* **core:** debounce scroll tracking state updates ([ce5b688](https://github.com/NVIDIA/elements/commit/ce5b688310d13dcc51e26bd0434599fecc610e4b))
+* **docs:** correct example api mapping and summary fallback ([f0dd837](https://github.com/NVIDIA/elements/commit/f0dd837756f44f05f1c115384d18e02a40cff32d))
+
+## [2.11.0](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.10.0...@nvidia-elements/core-v2.11.0) (2026-09-30)
+
+### Features
+
+* **core:** menu group ([d9a24e9](https://github.com/NVIDIA/elements/commit/d9a24e961e1c5394367e7ae9bf931d9e1e2d58b0))
+
+### Bug Fixes
+
+* **cli:** ui resources ([166a537](https://github.com/NVIDIA/elements/commit/166a5374c9aa022a2cc86c262d5165acdee7112e))
+
 ## [2.10.0](https://github.com/NVIDIA/elements/compare/@nvidia-elements/core-v2.9.0...@nvidia-elements/core-v2.10.0) (2026-09-30)
 
 ### Features

package/dist/accordion/accordion2.js

@@ -28,7 +28,7 @@ var b = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-header",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	render() {
@@ -46,7 +46,7 @@ var x = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-content",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	render() {
@@ -62,7 +62,7 @@ var x = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion",
-			version: "2.10.0",
+			version: "2.11.1",
 			children: [
 				b.metadata.tag,
 				x.metadata.tag,
@@ -120,7 +120,7 @@ var C = class extends g {
 	static {
 		this.metadata = {
 			tag: "nve-accordion-group",
-			version: "2.10.0",
+			version: "2.11.1",
 			children: [S.metadata.tag]
 		};
 	}

package/dist/alert/alert-group2.js

@@ -19,7 +19,7 @@ var f = class extends c {
 	static {
 		this.metadata = {
 			tag: "nve-alert-group",
-			version: "2.10.0",
+			version: "2.11.1",
 			children: [o.metadata.tag]
 		};
 	}

package/dist/alert/alert2.js

@@ -28,7 +28,7 @@ var v = class extends m {
 	static {
 		this.metadata = {
 			tag: "nve-alert",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	static {

package/dist/avatar/avatar-group2.js

@@ -10,7 +10,7 @@ var a = class extends r {
 	static {
 		this.metadata = {
 			tag: "nve-avatar-group",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	render() {

package/dist/avatar/avatar2.js

@@ -11,7 +11,7 @@ var s = class extends i {
 	static {
 		this.metadata = {
 			tag: "nve-avatar",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	render() {

package/dist/badge/badge2.js

@@ -25,7 +25,7 @@ var g = class extends f {
 	static {
 		this.metadata = {
 			tag: "nve-badge",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	static {

package/dist/breadcrumb/breadcrumb2.js

@@ -24,7 +24,7 @@ var m = class extends u {
 	static {
 		this.metadata = {
 			tag: "nve-breadcrumb",
-			version: "2.10.0"
+			version: "2.11.1"
 		};
 	}
 	static {

package/dist/bundles/index.d.ts

@@ -78,19 +78,6 @@ export interface RenderOptions {
 	 */
 	isConnected?: boolean;
 }
-/** Coordinates and deltas use CSS pixels; movement is sample-relative and total displacement is start-relative. */
-export interface PointerMovementGesture {
-	readonly event: PointerEvent;
-	readonly clientX: number;
-	readonly clientY: number;
-	readonly movementX: number;
-	readonly movementY: number;
-	readonly startClientX: number;
-	readonly startClientY: number;
-	readonly totalDisplacementX: number;
-	readonly totalDisplacementY: number;
-}
-export type PointerEndReason = "up" | "cancel" | "lost-capture" | "buttons-released";
 export interface I18nStrings {
 	close: string;
 	copy: string;
@@ -538,9 +525,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.
- * - `condensed` Element container optimizes for small, summarized or contained spaces.
  */
-export type Container = "inline" | "flat" | "inset" | "full" | "condensed";
+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.
+ */
+export type Density = "compact" | "default";
 /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
  * - `accent` - Highlights important actions or draws attention to primary interactive elements.
  * - `warning` - Indicates cautionary actions that require careful consideration before proceeding.
@@ -1895,6 +1886,10 @@ export declare class Menu extends LitElement {
 		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 */
@@ -1903,6 +1898,55 @@ export declare class Menu extends LitElement {
 	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>;
 /**
@@ -1912,6 +1956,7 @@ declare const MenuItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
  * @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
@@ -4972,7 +5017,7 @@ export declare class StepsItem extends StepsItem_base {
 	/**
 	 * Determines whether the steps should display in condensed format with no text labels.
 	 */
-	container?: Extract<Container, "condensed">;
+	container?: "condensed";
 	/** @private */
 	index: number;
 	static styles: CSSResult[];
@@ -5008,7 +5053,7 @@ export declare class Steps extends LitElement {
 	/**
 	 * Determines whether the steps should display in condensed format with no text labels.
 	 */
-	container?: Extract<Container, "condensed">;
+	container?: "condensed";
 	/**
 	 * Determines whether the steps should handle selection behavior vs. defaults to off.
 	 */
@@ -5574,47 +5619,75 @@ export interface ViewportRect extends ViewportPoint {
 	readonly height: number;
 }
 export type ViewportPanBehavior = boolean | "space";
-export interface ViewportPointerPanDetail extends PointerMovementGesture {
-	readonly source: "pointer";
-	readonly start: ViewportTransform;
+export type ViewportNavigationSource = "pointer" | "wheel" | "pinch" | "keyboard" | "command" | "minimap" | "control";
+export interface ViewportPanProposal {
+	readonly source: ViewportNavigationSource;
+	readonly event: Event;
 	readonly next: ViewportTransform;
+	readonly clientX?: number;
+	readonly clientY?: number;
+	readonly deltaX?: number;
+	readonly deltaY?: number;
+}
+export type ViewportPanUpdateProposal = Omit<ViewportPanProposal, "source">;
+export interface ViewportPanDetail extends ViewportPanProposal {
+	readonly start: ViewportTransform;
+}
+export interface ViewportPointerPanDetail extends ViewportPanDetail {
+	readonly source: "pointer";
+	readonly event: PointerEvent;
+	readonly clientX: number;
+	readonly clientY: number;
+	readonly movementX: number;
+	readonly movementY: number;
+	readonly startClientX: number;
+	readonly startClientY: number;
+	readonly totalDisplacementX: number;
+	readonly totalDisplacementY: number;
 }
-export interface ViewportWheelPanDetail {
+export type ViewportWheelPanDetail = ViewportPanDetail & {
 	readonly source: "wheel";
 	readonly event: WheelEvent;
 	readonly clientX: number;
 	readonly clientY: number;
 	readonly deltaX: number;
 	readonly deltaY: number;
-	readonly start: ViewportTransform;
-	readonly next: ViewportTransform;
-}
-export interface ViewportDiscretePanDetail {
+};
+export type ViewportDiscretePanDetail = ViewportPanDetail & {
 	readonly source: "keyboard" | "command";
 	readonly event: KeyboardEvent | CommandEvent;
-	readonly start: ViewportTransform;
-	readonly next: ViewportTransform;
-}
-export type ViewportPanDetail = ViewportPointerPanDetail | ViewportWheelPanDetail | ViewportDiscretePanDetail;
-export type ViewportPanEndReason = PointerEndReason | "pinch";
-export interface ViewportPanEndDetail {
-	readonly source: "pointer";
-	readonly event: PointerEvent;
+};
+export type ViewportPanEndReason = "up" | "cancel" | "lost-capture" | "buttons-released" | "pinch";
+export interface ViewportPanEndRequest {
+	readonly event: Event;
 	readonly interrupted: boolean;
 	readonly reason: ViewportPanEndReason;
+}
+export interface ViewportPanEndDetail extends ViewportPanEndRequest {
+	readonly source: ViewportNavigationSource;
 	readonly start: ViewportTransform;
 	readonly transform: ViewportTransform;
 }
-export interface ViewportZoomDetail {
-	readonly source: "wheel" | "pinch" | "keyboard" | "command";
-	readonly event: WheelEvent | PointerEvent | KeyboardEvent | CommandEvent;
-	readonly clientX: number;
-	readonly clientY: number;
+export interface ViewportPanSession {
+	readonly start: ViewportTransform;
+	update(proposal: ViewportPanUpdateProposal): boolean;
+	end(request: ViewportPanEndRequest): void;
+}
+export interface ViewportZoomProposal {
+	readonly source: ViewportNavigationSource;
+	readonly event: Event;
+	readonly clientX?: number;
+	readonly clientY?: number;
 	readonly anchor: ViewportPoint;
 	readonly factor: number;
-	readonly start: ViewportTransform;
 	readonly next: ViewportTransform;
 }
+export interface ViewportZoomRequestOptions {
+	readonly animated?: boolean;
+}
+export interface ViewportZoomDetail extends ViewportZoomProposal {
+	readonly start: ViewportTransform;
+}
 export interface ViewportAnimationOptions {
 	readonly duration?: number;
 }
@@ -5633,11 +5706,13 @@ export interface ViewportRevealOptions {
  * @entrypoint \@nvidia-elements/core/viewport
  * @slot - Content positioned in the viewport's infinite content space.
  * @slot background - Custom content rendered behind viewport content and excluded from content fitting
- * @event panstart - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
- * @event pan - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
- * @event panend - Dispatched when a pointer pan ends, including its terminal reason.
- * @event zoom - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
+ * @slot overlay - Interactive content fixed above the transformed plane and excluded from content fitting
+ * @event panstart - Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session.
+ * @event pan - Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation.
+ * @event panend - Dispatched once when a sustained pan ends, including its terminal reason.
+ * @event zoom - Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation.
  * @event viewportchange - Dispatched once after a render that commits one or more viewport transform changes.
+ * @event capabilitieschange - Dispatched after effective user-input pan or zoom admission changes.
  * @cssprop --background - Background color of the fixed viewport area.
  * @cssprop --min-height
  * @cssprop --pan-cursor - Cursor shown over a background eligible for primary-pointer panning.
@@ -5683,6 +5758,10 @@ export declare class Viewport extends LitElement {
 	set behaviorPan(value: ViewportPanBehavior | null | undefined);
 	/** Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. */
 	behaviorZoom: boolean;
+	/** Whether the viewport may admit new user-input panning. */
+	get pannable(): boolean;
+	/** Whether the viewport may admit new user-input zooming. */
+	get zoomable(): boolean;
 	/** Fits measurable direct default-slot content once after initial layout. */
 	autoFit: boolean;
 	/** Default uniform CSS-pixel inset reserved around bounds when fitting content. */
@@ -5703,6 +5782,25 @@ export declare class Viewport extends LitElement {
 	getTransform(): ViewportTransform;
 	/** Returns the visible content-space rectangle. */
 	getVisibleRect(): ViewportRect;
+	/**
+	 * Requests one discrete user-originated pan. When pannable, the viewport dispatches
+	 * a cancelable `pan` and applies the default transform if no listener cancels the event.
+	 * Returns true only when that default changes the transform.
+	 */
+	requestPan(proposal: ViewportPanProposal): boolean;
+	/**
+	 * Requests one discrete user-originated zoom. When zoomable, the viewport dispatches
+	 * a cancelable `zoom` and applies the default transform if no listener cancels the event.
+	 * Set `options.animated` to animate the uncanceled default; the option is absent from the `zoom` detail.
+	 * Returns true when the default changes or schedules a change to the transform.
+	 */
+	requestZoom(proposal: ViewportZoomProposal, options?: ViewportZoomRequestOptions): boolean;
+	/**
+	 * Starts a sustained semantic pan after the caller crosses its activation threshold.
+	 * Dispatches `panstart`, performs the initial `pan` update, and returns a session for later updates
+	 * and one terminal `panend`. Returns undefined when pannable is false.
+	 */
+	startPan(proposal: ViewportPanProposal): ViewportPanSession | undefined;
 	/** Animates the viewport to the requested partial transform. */
 	animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void;
 	/** Centers or fits a content-space region within the viewport. */
@@ -5752,6 +5850,41 @@ export declare class ViewportGridlines extends LitElement {
 	protected willUpdate(changed: PropertyValues<this>): void;
 	render(): typeof nothing | TemplateResult<1>;
 }
+/**
+ * @element nve-viewport-minimap
+ * @description Provides a simplified overview and direct navigation for its parent viewport.
+ * @documentation https://nvidia.github.io/elements/docs/elements/viewport/
+ * @since 0.0.0
+ * @entrypoint \@nvidia-elements/core/viewport
+ * @cssprop --background - Color of the surface behind preview geometry.
+ * @cssprop --color - Color of automatically drawn root rectangles.
+ * @cssprop --indicator-color - Color of the current visible-region indicator.
+ * @cssprop --border-radius - Corner radius of the minimap.
+ * @cssprop --recenter-cursor - Cursor for clicking the background to center the viewport.
+ * @cssprop --pan-cursor - Cursor over a draggable visible region.
+ * @cssprop --panning-cursor - Cursor during a visible-region drag.
+ * @slot preview - Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles.
+ */
+export declare class ViewportMinimap extends LitElement {
+	#private;
+	static styles: CSSResult[];
+	static readonly metadata: {
+		tag: string;
+		version: string;
+	};
+	/** @private */
+	_internals: ElementInternals;
+	/** @private */
+	slot: string;
+	/** @private */
+	protected accessibilityHidden: string;
+	constructor();
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	/** Remeasures content bounds after preview or viewport roots move without resizing. */
+	refresh(): void;
+	render(): TemplateResult<1>;
+}
 /**
  * @element nve-week
  * @description A week picker is a control that enables users to choose a week value.