@nvidia-elements/core 2.9.0 → 2.11.0

package/dist/custom-elements-vue.d.ts

@@ -2256,6 +2256,25 @@ type LogoProps = {
   size?: "sm" | "md" | "lg" | undefined;
 };
 
+type MenuGroupProps = {
+  /** Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-expanded)
+- `true` The associated content expands and becomes visible to the user.
+
+- `false` The associated content collapses and hides from the user. */
+  expanded?: boolean;
+  /** This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-disabled)
+- `true` The element has a disabled state and does not accept interaction.
+
+- `false` The element has an enabled state and accepts interaction. */
+  disabled?: boolean;
+  /** Determines whether user activation automatically updates the expanded state. */
+  behaviorExpand?: boolean;
+  /** Dispatched when the user requests that the menu group open. */
+  onopen?: (e: CustomEvent<never>) => void;
+  /** Dispatched when the user requests that the menu group close. */
+  onclose?: (e: CustomEvent<never>) => void;
+};
+
 type MenuItemProps = {
   /** Establishes a relationship between a popover and its invoker button.
 https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/popoverTargetElement */
@@ -2329,6 +2348,11 @@ https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement/interestForEl
 };
 
 type MenuProps = {
+  /** Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.
+- `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. */
+  density?: "compact" | "default" | undefined;
   /** Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. */
   onscroll?: (e: CustomEvent<never>) => void;
 };
@@ -3783,6 +3807,8 @@ type ViewportGridlinesProps = {
   targetSpacing?: number;
 };
 
+type ViewportMinimapProps = {};
+
 type ViewportProps = {
   /** Inclusive lower scale limit. */
   "min-scale"?: number;
@@ -3814,17 +3840,19 @@ type ViewportProps = {
   fitInset?: number;
   /** CSS-pixel pointer movement required before a pointer pan begins. */
   dragThreshold?: number;
+  /** Dispatched after effective user-input pan or zoom admission changes. */
+  oncapabilitieschange?: (e: CustomEvent<Event>) => void;
   /** Dispatched once after a render that commits one or more viewport transform changes. */
   onviewportchange?: (e: CustomEvent<CustomEvent>) => void;
   /**  */
   ontype?: (e: CustomEvent<CustomEvent>) => void;
-  /** Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. */
+  /** Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session. */
   onpanstart?: (e: CustomEvent<never>) => void;
-  /** Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. */
+  /** Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation. */
   onpan?: (e: CustomEvent<never>) => void;
-  /** Dispatched when a pointer pan ends, including its terminal reason. */
+  /** Dispatched once when a sustained pan ends, including its terminal reason. */
   onpanend?: (e: CustomEvent<never>) => void;
-  /** Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. */
+  /** Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation. */
   onzoom?: (e: CustomEvent<never>) => void;
 };
 
@@ -4698,13 +4726,13 @@ export type CustomElements = {
    *  - **change** - Dispatched when the value has changed (files located in event.target)
    *
    * ### **Methods:**
-   *  - **reportValidity()** - Reports whether the control satisfies its constraints.
+   *  - **reportValidity(): _boolean_** - Reports whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
-   * - **checkValidity()** - Checks whether the control satisfies its constraints.
+   * - **checkValidity(): _boolean_** - Checks whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
-   * - **setCustomValidity()** - Sets a custom validation message.
+   * - **setCustomValidity(message: _string_): _void_** - Sets a custom validation message.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
-   * - **reset()** - Resets the control value to its initial value.
+   * - **reset(): _void_** - Resets the control value to its initial value.
    *
    * ### **Slots:**
    *  - _default_ - Custom messaging that replaces the default upload instructions.
@@ -5158,6 +5186,33 @@ export type CustomElements = {
    */
   "nve-logo": DefineComponent<LogoProps>;
 
+  /**
+   * Organizes related menu items under a disclosure header that can show or hide one child menu.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **open** - Dispatched when the user requests that the menu group open.
+   * - **close** - Dispatched when the user requests that the menu group close.
+   *
+   * ### **Slots:**
+   *  - _default_ - Label content for the disclosure header.
+   * - **prefix** - Non-interactive content before the header label, such as an icon or avatar.
+   * - **suffix** - Non-interactive content after the header label, such as a badge or count.
+   * - **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.
+   *
+   * ### **CSS Properties:**
+   *  - **--background** - undefined _(default: undefined)_
+   * - **--font-size** - undefined _(default: undefined)_
+   * - **--padding** - undefined _(default: undefined)_
+   * - **--gap** - undefined _(default: undefined)_
+   * - **--border-radius** - undefined _(default: undefined)_
+   * - **--color** - undefined _(default: undefined)_
+   * - **--width** - undefined _(default: undefined)_
+   * - **--min-height** - undefined _(default: undefined)_
+   */
+  "nve-menu-group": DefineComponent<MenuGroupProps>;
+
   /**
    * Represents a selectable option within a menu, providing an interactive button for navigation or actions.
    * ---
@@ -5165,6 +5220,7 @@ export type CustomElements = {
    *
    * ### **Slots:**
    *  - _default_ - Label and supporting content for the menu option.
+   * - **prefix** - slot for prefix icon
    * - **suffix** - slot for suffix icon
    *
    * ### **CSS Properties:**
@@ -5444,13 +5500,13 @@ export type CustomElements = {
    * - **change** - Dispatched when the value (page) has changed
    *
    * ### **Methods:**
-   *  - **reportValidity()** - Reports whether the control satisfies its constraints.
+   *  - **reportValidity(): _boolean_** - Reports whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
-   * - **checkValidity()** - Checks whether the control satisfies its constraints.
+   * - **checkValidity(): _boolean_** - Checks whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
-   * - **setCustomValidity()** - Sets a custom validation message.
+   * - **setCustomValidity(message: _string_): _void_** - Sets a custom validation message.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
-   * - **reset()** - Resets the control value to its initial value.
+   * - **reset(): _void_** - Resets the control value to its initial value.
    *
    * ### **Slots:**
    *  - **suffix-label** - Overrides the "of total" label when the total is an approximation.
@@ -5596,13 +5652,13 @@ export type CustomElements = {
    * - **change** - Dispatched when the value has changed
    *
    * ### **Methods:**
-   *  - **reportValidity()** - Reports whether the control satisfies its constraints.
+   *  - **reportValidity(): _boolean_** - Reports whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
-   * - **checkValidity()** - Checks whether the control satisfies its constraints.
+   * - **checkValidity(): _boolean_** - Checks whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
-   * - **setCustomValidity()** - Sets a custom validation message.
+   * - **setCustomValidity(message: _string_): _void_** - Sets a custom validation message.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
-   * - **reset()** - Resets the control value to its initial value.
+   * - **reset(): _void_** - Resets the control value to its initial value.
    *
    * ### **CSS Properties:**
    *  - **--color** - undefined _(default: undefined)_
@@ -5794,13 +5850,13 @@ export type CustomElements = {
    *  - **toggle** - Dispatched when the resize handle is double clicked.
    *
    * ### **Methods:**
-   *  - **reportValidity()** - Reports whether the control satisfies its constraints.
+   *  - **reportValidity(): _boolean_** - Reports whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/reportValidity
-   * - **checkValidity()** - Checks whether the control satisfies its constraints.
+   * - **checkValidity(): _boolean_** - Checks whether the control satisfies its constraints.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/checkValidity
-   * - **setCustomValidity()** - Sets a custom validation message.
+   * - **setCustomValidity(message: _string_): _void_** - Sets a custom validation message.
    * https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/setCustomValidity
-   * - **reset()** - Resets the control value to its initial value.
+   * - **reset(): _void_** - Resets the control value to its initial value.
    *
    * ### **CSS Properties:**
    *  - **--background** - undefined _(default: undefined)_
@@ -6464,24 +6520,57 @@ export type CustomElements = {
    */
   "nve-viewport-gridlines": DefineComponent<ViewportGridlinesProps>;
 
+  /**
+   * Provides a simplified overview and direct navigation for its parent viewport.
+   * ---
+   *
+   *
+   * ### **Methods:**
+   *  - **refresh(): _void_** - Remeasures content bounds after preview or viewport roots move without resizing.
+   *
+   * ### **Slots:**
+   *  - **preview** - Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles.
+   *
+   * ### **CSS Properties:**
+   *  - **--background** - Color of the surface behind preview geometry. _(default: undefined)_
+   * - **--color** - Color of automatically drawn root rectangles. _(default: undefined)_
+   * - **--indicator-color** - Color of the current visible-region indicator. _(default: undefined)_
+   * - **--border-radius** - Corner radius of the minimap. _(default: undefined)_
+   * - **--recenter-cursor** - Cursor for clicking the background to center the viewport. _(default: undefined)_
+   * - **--pan-cursor** - Cursor over a draggable visible region. _(default: undefined)_
+   * - **--panning-cursor** - Cursor during a visible-region drag. _(default: undefined)_
+   */
+  "nve-viewport-minimap": DefineComponent<ViewportMinimapProps>;
+
   /**
    * A viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.
    * ---
    *
    *
    * ### **Events:**
-   *  - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
+   *  - **capabilitieschange** - Dispatched after effective user-input pan or zoom admission changes.
+   * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
    * - **type**
-   * - **panstart** - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
-   * - **pan** - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
-   * - **panend** - Dispatched when a pointer pan ends, including its terminal reason.
-   * - **zoom** - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
+   * - **panstart** - Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session.
+   * - **pan** - Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation.
+   * - **panend** - Dispatched once when a sustained pan ends, including its terminal reason.
+   * - **zoom** - Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation.
    *
    * ### **Methods:**
    *  - **toViewportCoords(contentX: _number_, contentY: _number_): _ViewportPoint_** - Converts a content-space point to viewport CSS pixels.
    * - **toContentCoords(viewportX: _number_, viewportY: _number_): _ViewportPoint_** - Converts a viewport CSS-pixel point to content space.
    * - **getTransform(): _ViewportTransform_** - Returns the current content-space origin and CSS-pixel scale.
    * - **getVisibleRect(): _ViewportRect_** - Returns the visible content-space rectangle.
+   * - **requestPan(proposal: _ViewportPanProposal_): _boolean_** - 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.
+   * - **requestZoom(proposal: _ViewportZoomProposal_, options: _ViewportZoomRequestOptions_): _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.
+   * - **startPan(proposal: _ViewportPanProposal_): _ViewportPanSession | undefined_** - 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.
    * - **animateTo(target: _Partial<ViewportTransform>_, options: _ViewportAnimationOptions_): _void_** - Animates the viewport to the requested partial transform.
    * - **reveal(region: _{ x: number; y: number; width?: number; height?: number }_, options: _ViewportRevealOptions_): _void_** - Centers or fits a content-space region within the viewport.
    * - **fitContents(options: _ViewportRevealOptions_): _void_** - Fits the union of direct default-slot element boxes within the viewport.
@@ -6489,6 +6578,7 @@ export type CustomElements = {
    * ### **Slots:**
    *  - _default_ - Content positioned in the viewport's infinite content space.
    * - **background** - Custom content rendered behind viewport content and excluded from content fitting
+   * - **overlay** - Interactive content fixed above the transformed plane and excluded from content fitting
    *
    * ### **CSS Properties:**
    *  - **--background** - Background color of the fixed viewport area. _(default: undefined)_