@nvidia-elements/core 2.10.0 → 2.11.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/dist/accordion/accordion2.js +4 -4
  3. package/dist/alert/alert-group2.js +1 -1
  4. package/dist/alert/alert2.js +1 -1
  5. package/dist/avatar/avatar-group2.js +1 -1
  6. package/dist/avatar/avatar2.js +1 -1
  7. package/dist/badge/badge2.js +1 -1
  8. package/dist/breadcrumb/breadcrumb2.js +1 -1
  9. package/dist/bundles/index.d.ts +176 -43
  10. package/dist/bundles/index.js +6 -6
  11. package/dist/button/button2.js +1 -1
  12. package/dist/button-group/button-group2.js +1 -1
  13. package/dist/card/card2.js +4 -4
  14. package/dist/chat-message/chat-message2.js +1 -1
  15. package/dist/checkbox/checkbox-group2.js +1 -1
  16. package/dist/checkbox/checkbox2.js +1 -1
  17. package/dist/color/color2.js +1 -1
  18. package/dist/combobox/combobox2.js +1 -1
  19. package/dist/copy-button/copy-button2.js +1 -1
  20. package/dist/custom-elements-jsx.d.ts +101 -9
  21. package/dist/custom-elements-vue.d.ts +99 -9
  22. package/dist/custom-elements.json +1055 -322
  23. package/dist/data.html.json +51 -3
  24. package/dist/date/date2.js +1 -1
  25. package/dist/datetime/datetime2.js +1 -1
  26. package/dist/dialog/dialog-footer2.js +1 -1
  27. package/dist/dialog/dialog-header2.js +1 -1
  28. package/dist/dialog/dialog2.js +1 -1
  29. package/dist/divider/divider2.js +1 -1
  30. package/dist/dot/dot2.js +1 -1
  31. package/dist/drawer/drawer-content2.js +1 -1
  32. package/dist/drawer/drawer-footer2.js +1 -1
  33. package/dist/drawer/drawer-header2.js +1 -1
  34. package/dist/drawer/drawer2.js +1 -1
  35. package/dist/dropdown/dropdown-footer2.js +1 -1
  36. package/dist/dropdown/dropdown-header2.js +1 -1
  37. package/dist/dropdown/dropdown2.js +1 -1
  38. package/dist/dropdown-group/dropdown-group.js +1 -1
  39. package/dist/dropzone/dropzone2.js +1 -1
  40. package/dist/file/file2.js +1 -1
  41. package/dist/format-bytes/format-bytes2.js +1 -1
  42. package/dist/format-datetime/format-datetime2.js +1 -1
  43. package/dist/format-number/format-number2.js +1 -1
  44. package/dist/format-relative-time/format-relative-time2.js +1 -1
  45. package/dist/format-truncate/format-truncate2.js +1 -1
  46. package/dist/forms/control/control2.js +1 -1
  47. package/dist/forms/control-group/control-group2.js +1 -1
  48. package/dist/forms/control-message/control-message2.js +1 -1
  49. package/dist/gauge/gauge2.js +1 -1
  50. package/dist/grid/cell/cell2.js +1 -1
  51. package/dist/grid/column/column2.js +1 -1
  52. package/dist/grid/footer/footer2.js +1 -1
  53. package/dist/grid/grid2.js +1 -1
  54. package/dist/grid/header/header2.js +1 -1
  55. package/dist/grid/placeholder/placeholder2.js +1 -1
  56. package/dist/grid/row/row2.js +1 -1
  57. package/dist/icon/icon2.js +2 -2
  58. package/dist/icon-button/icon-button2.js +1 -1
  59. package/dist/index.js +1 -1
  60. package/dist/input/input-group2.js +1 -1
  61. package/dist/input/input2.js +1 -1
  62. package/dist/internal/controllers/state-scroll.controller.js +27 -17
  63. package/dist/internal/controllers/state-scroll.controller.js.map +1 -1
  64. package/dist/internal/services/global.service.js +1 -1
  65. package/dist/internal/types/index.d.ts +6 -2
  66. package/dist/internal/types/index.js.map +1 -1
  67. package/dist/internal/utils/audit.js +1 -1
  68. package/dist/internal/utils/audit.js.map +1 -1
  69. package/dist/logo/logo2.js +1 -1
  70. package/dist/menu/define.d.ts +2 -1
  71. package/dist/menu/define.js +3 -2
  72. package/dist/menu/define.js.map +1 -1
  73. package/dist/menu/index.d.ts +1 -0
  74. package/dist/menu/index.js +3 -2
  75. package/dist/menu/menu-group.d.ts +50 -0
  76. package/dist/menu/menu-group.js +6 -0
  77. package/dist/menu/menu-group.js.map +1 -0
  78. package/dist/menu/menu-group2.js +53 -0
  79. package/dist/menu/menu-group2.js.map +1 -0
  80. package/dist/menu/menu-item.d.ts +1 -0
  81. package/dist/menu/menu-item.js +1 -1
  82. package/dist/menu/menu-item.js.map +1 -1
  83. package/dist/menu/menu-item2.js +2 -2
  84. package/dist/menu/menu-item2.js.map +1 -1
  85. package/dist/menu/menu.d.ts +6 -1
  86. package/dist/menu/menu.examples.js.map +1 -1
  87. package/dist/menu/menu.examples.json +53 -13
  88. package/dist/menu/menu.global.js +1 -1
  89. package/dist/menu/menu.global.js.map +1 -1
  90. package/dist/menu/menu2.js +16 -8
  91. package/dist/menu/menu2.js.map +1 -1
  92. package/dist/month/month2.js +1 -1
  93. package/dist/notification/notification-group2.js +1 -1
  94. package/dist/notification/notification2.js +1 -1
  95. package/dist/page/page-panel/page-panel-content2.js +1 -1
  96. package/dist/page/page-panel/page-panel-footer2.js +1 -1
  97. package/dist/page/page-panel/page-panel-header2.js +1 -1
  98. package/dist/page/page-panel/page-panel2.js +1 -1
  99. package/dist/page/page2.js +1 -1
  100. package/dist/page-header/page-header2.js +1 -1
  101. package/dist/page-loader/page-loader2.js +1 -1
  102. package/dist/pagination/pagination2.js +1 -1
  103. package/dist/panel/panel2.js +4 -4
  104. package/dist/password/password2.js +1 -1
  105. package/dist/preferences-input/preferences-input2.js +1 -1
  106. package/dist/progress-bar/progress-bar2.js +1 -1
  107. package/dist/progress-ring/progress-ring2.js +1 -1
  108. package/dist/progressive-filter-chip/progressive-filter-chip2.js +1 -1
  109. package/dist/pulse/pulse2.js +1 -1
  110. package/dist/radio/radio-group2.js +1 -1
  111. package/dist/radio/radio2.js +1 -1
  112. package/dist/range/range2.js +1 -1
  113. package/dist/resize-handle/resize-handle2.js +1 -1
  114. package/dist/search/search2.js +1 -1
  115. package/dist/select/select2.js +1 -1
  116. package/dist/skeleton/skeleton2.js +1 -1
  117. package/dist/sort-button/sort-button2.js +1 -1
  118. package/dist/sparkline/sparkline2.js +1 -1
  119. package/dist/star-rating/star-rating2.js +1 -1
  120. package/dist/steps/steps.d.ts +3 -3
  121. package/dist/steps/steps2.js +2 -2
  122. package/dist/steps/steps2.js.map +1 -1
  123. package/dist/switch/switch-group2.js +1 -1
  124. package/dist/switch/switch2.js +1 -1
  125. package/dist/tabs/tabs-group2.js +1 -1
  126. package/dist/tabs/tabs2.js +2 -2
  127. package/dist/tag/tag2.js +1 -1
  128. package/dist/textarea/textarea2.js +1 -1
  129. package/dist/time/time2.js +1 -1
  130. package/dist/toast/toast2.js +1 -1
  131. package/dist/toggletip/toggletip-footer2.js +1 -1
  132. package/dist/toggletip/toggletip-header2.js +1 -1
  133. package/dist/toggletip/toggletip2.js +1 -1
  134. package/dist/toolbar/toolbar2.js +1 -1
  135. package/dist/tooltip/tooltip2.js +1 -1
  136. package/dist/tree/tree-node2.js +1 -1
  137. package/dist/tree/tree2.js +1 -1
  138. package/dist/viewport/define.d.ts +2 -1
  139. package/dist/viewport/define.js +2 -1
  140. package/dist/viewport/define.js.map +1 -1
  141. package/dist/viewport/index.d.ts +2 -1
  142. package/dist/viewport/index.js +2 -1
  143. package/dist/viewport/viewport-gesture-navigation.controller.d.ts +8 -10
  144. package/dist/viewport/viewport-gesture-navigation.controller.js +73 -66
  145. package/dist/viewport/viewport-gesture-navigation.controller.js.map +1 -1
  146. package/dist/viewport/viewport-gridlines2.js +3 -3
  147. package/dist/viewport/viewport-gridlines2.js.map +1 -1
  148. package/dist/viewport/viewport-minimap.d.ts +36 -0
  149. package/dist/viewport/viewport-minimap.js +6 -0
  150. package/dist/viewport/viewport-minimap.js.map +1 -0
  151. package/dist/viewport/viewport-minimap.utils.d.ts +13 -0
  152. package/dist/viewport/viewport-minimap.utils.js +49 -0
  153. package/dist/viewport/viewport-minimap.utils.js.map +1 -0
  154. package/dist/viewport/viewport-minimap2.js +309 -0
  155. package/dist/viewport/viewport-minimap2.js.map +1 -0
  156. package/dist/viewport/viewport-navigation.controller.d.ts +7 -13
  157. package/dist/viewport/viewport-navigation.controller.js +14 -20
  158. package/dist/viewport/viewport-navigation.controller.js.map +1 -1
  159. package/dist/viewport/viewport-navigation.types.d.ts +0 -8
  160. package/dist/viewport/viewport.d.ts +30 -5
  161. package/dist/viewport/viewport.examples.js.map +1 -1
  162. package/dist/viewport/viewport.examples.json +15 -6
  163. package/dist/viewport/viewport.js +1 -1
  164. package/dist/viewport/viewport.js.map +1 -1
  165. package/dist/viewport/viewport.types.d.ts +50 -23
  166. package/dist/viewport/viewport2.js +173 -118
  167. package/dist/viewport/viewport2.js.map +1 -1
  168. package/dist/week/week2.js +1 -1
  169. package/package.json +1 -1
@@ -12,7 +12,7 @@ var s = class extends o(r) {
12
12
  static {
13
13
  this.metadata = {
14
14
  tag: "nve-button",
15
- version: "2.10.0"
15
+ version: "2.11.1"
16
16
  };
17
17
  }
18
18
  render() {
@@ -26,7 +26,7 @@ var f = class extends c {
26
26
  static {
27
27
  this.metadata = {
28
28
  tag: "nve-button-group",
29
- version: "2.10.0",
29
+ version: "2.11.1",
30
30
  children: [
31
31
  "nve-button",
32
32
  "nve-icon-button",
@@ -16,7 +16,7 @@ var d = class extends c {
16
16
  static {
17
17
  this.metadata = {
18
18
  tag: "nve-card",
19
- version: "2.10.0"
19
+ version: "2.11.1"
20
20
  };
21
21
  }
22
22
  render() {
@@ -37,7 +37,7 @@ var f = class extends c {
37
37
  static {
38
38
  this.metadata = {
39
39
  tag: "nve-card-header",
40
- version: "2.10.0",
40
+ version: "2.11.1",
41
41
  parents: ["nve-card"]
42
42
  };
43
43
  }
@@ -53,7 +53,7 @@ var p = class extends c {
53
53
  static {
54
54
  this.metadata = {
55
55
  tag: "nve-card-content",
56
- version: "2.10.0",
56
+ version: "2.11.1",
57
57
  parents: ["nve-card"]
58
58
  };
59
59
  }
@@ -72,7 +72,7 @@ var m = class extends c {
72
72
  static {
73
73
  this.metadata = {
74
74
  tag: "nve-card-footer",
75
- version: "2.10.0",
75
+ version: "2.11.1",
76
76
  parents: ["nve-card"]
77
77
  };
78
78
  }
@@ -13,7 +13,7 @@ var l = class extends o {
13
13
  static {
14
14
  this.metadata = {
15
15
  tag: "nve-chat-message",
16
- version: "2.10.0"
16
+ version: "2.11.1"
17
17
  };
18
18
  }
19
19
  render() {
@@ -12,7 +12,7 @@ var o = class extends i {
12
12
  static {
13
13
  this.metadata = {
14
14
  tag: "nve-checkbox-group",
15
- version: "2.10.0",
15
+ version: "2.11.1",
16
16
  children: [
17
17
  "label",
18
18
  "nve-control-message",
@@ -15,7 +15,7 @@ var o = class extends i {
15
15
  static {
16
16
  this.metadata = {
17
17
  tag: "nve-checkbox",
18
- version: "2.10.0",
18
+ version: "2.11.1",
19
19
  children: [
20
20
  "label",
21
21
  "input",
@@ -21,7 +21,7 @@ var f = class extends a {
21
21
  static {
22
22
  this.metadata = {
23
23
  tag: "nve-color",
24
- version: "2.10.0"
24
+ version: "2.11.1"
25
25
  };
26
26
  }
27
27
  static {
@@ -31,7 +31,7 @@ var S = class extends l {
31
31
  static {
32
32
  this.metadata = {
33
33
  tag: "nve-combobox",
34
- version: "2.10.0"
34
+ version: "2.11.1"
35
35
  };
36
36
  }
37
37
  static {
@@ -32,7 +32,7 @@ var p = class extends a {
32
32
  static {
33
33
  this.metadata = {
34
34
  tag: "nve-copy-button",
35
- version: "2.10.0"
35
+ version: "2.11.1"
36
36
  };
37
37
  }
38
38
  static {
@@ -2391,6 +2391,27 @@ export type LogoProps = {
2391
2391
  size?: "sm" | "md" | "lg" | undefined;
2392
2392
  };
2393
2393
 
2394
+ export type MenuGroupProps = {
2395
+ /** Determines whether user activation automatically updates the expanded state. */
2396
+ "behavior-expand"?: boolean;
2397
+ /** 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)
2398
+ - `true` The associated content expands and becomes visible to the user.
2399
+
2400
+ - `false` The associated content collapses and hides from the user. */
2401
+ expanded?: boolean;
2402
+ /** 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)
2403
+ - `true` The element has a disabled state and does not accept interaction.
2404
+
2405
+ - `false` The element has an enabled state and accepts interaction. */
2406
+ disabled?: boolean;
2407
+ /** Determines whether user activation automatically updates the expanded state. */
2408
+ behaviorExpand?: boolean;
2409
+ /** Dispatched when the user requests that the menu group open. */
2410
+ onopen?: (e: CustomEvent<never>) => void;
2411
+ /** Dispatched when the user requests that the menu group close. */
2412
+ onclose?: (e: CustomEvent<never>) => void;
2413
+ };
2414
+
2394
2415
  export type MenuItemProps = {
2395
2416
  /** Indicates whether the element is a noninteractive visual treatment instead of a button.
2396
2417
  https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly */
@@ -2467,6 +2488,11 @@ https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement/interestForEl
2467
2488
  };
2468
2489
 
2469
2490
  export type MenuProps = {
2491
+ /** Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.
2492
+ - `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.
2493
+
2494
+ - `default` Standard size that works well in most contexts and provides balanced visibility. */
2495
+ density?: "compact" | "default" | undefined;
2470
2496
  /** Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. */
2471
2497
  onscroll?: (e: CustomEvent<never>) => void;
2472
2498
  };
@@ -4021,6 +4047,8 @@ export type ViewportGridlinesProps = {
4021
4047
  targetSpacing?: number;
4022
4048
  };
4023
4049
 
4050
+ export type ViewportMinimapProps = {};
4051
+
4024
4052
  export type ViewportProps = {
4025
4053
  /** Inclusive lower scale limit. */
4026
4054
  "min-scale"?: number;
@@ -4054,17 +4082,19 @@ export type ViewportProps = {
4054
4082
  fitInset?: number;
4055
4083
  /** CSS-pixel pointer movement required before a pointer pan begins. */
4056
4084
  dragThreshold?: number;
4085
+ /** Dispatched after effective user-input pan or zoom admission changes. */
4086
+ oncapabilitieschange?: (e: CustomEvent<Event>) => void;
4057
4087
  /** Dispatched once after a render that commits one or more viewport transform changes. */
4058
4088
  onviewportchange?: (e: CustomEvent<CustomEvent>) => void;
4059
4089
  /** */
4060
4090
  ontype?: (e: CustomEvent<CustomEvent>) => void;
4061
- /** Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. */
4091
+ /** Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session. */
4062
4092
  onpanstart?: (e: CustomEvent<never>) => void;
4063
- /** Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. */
4093
+ /** Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation. */
4064
4094
  onpan?: (e: CustomEvent<never>) => void;
4065
- /** Dispatched when a pointer pan ends, including its terminal reason. */
4095
+ /** Dispatched once when a sustained pan ends, including its terminal reason. */
4066
4096
  onpanend?: (e: CustomEvent<never>) => void;
4067
- /** Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. */
4097
+ /** Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation. */
4068
4098
  onzoom?: (e: CustomEvent<never>) => void;
4069
4099
  };
4070
4100
 
@@ -5402,6 +5432,33 @@ export type CustomElements = {
5402
5432
  */
5403
5433
  "nve-logo": Partial<LogoProps & BaseProps & BaseEvents>;
5404
5434
 
5435
+ /**
5436
+ * Organizes related menu items under a disclosure header that can show or hide one child menu.
5437
+ * ---
5438
+ *
5439
+ *
5440
+ * ### **Events:**
5441
+ * - **open** - Dispatched when the user requests that the menu group open.
5442
+ * - **close** - Dispatched when the user requests that the menu group close.
5443
+ *
5444
+ * ### **Slots:**
5445
+ * - _default_ - Label content for the disclosure header.
5446
+ * - **prefix** - Non-interactive content before the header label, such as an icon or avatar.
5447
+ * - **suffix** - Non-interactive content after the header label, such as a badge or count.
5448
+ * - **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.
5449
+ *
5450
+ * ### **CSS Properties:**
5451
+ * - **--background** - undefined _(default: undefined)_
5452
+ * - **--font-size** - undefined _(default: undefined)_
5453
+ * - **--padding** - undefined _(default: undefined)_
5454
+ * - **--gap** - undefined _(default: undefined)_
5455
+ * - **--border-radius** - undefined _(default: undefined)_
5456
+ * - **--color** - undefined _(default: undefined)_
5457
+ * - **--width** - undefined _(default: undefined)_
5458
+ * - **--min-height** - undefined _(default: undefined)_
5459
+ */
5460
+ "nve-menu-group": Partial<MenuGroupProps & BaseProps & BaseEvents>;
5461
+
5405
5462
  /**
5406
5463
  * Represents a selectable option within a menu, providing an interactive button for navigation or actions.
5407
5464
  * ---
@@ -5409,6 +5466,7 @@ export type CustomElements = {
5409
5466
  *
5410
5467
  * ### **Slots:**
5411
5468
  * - _default_ - Label and supporting content for the menu option.
5469
+ * - **prefix** - slot for prefix icon
5412
5470
  * - **suffix** - slot for suffix icon
5413
5471
  *
5414
5472
  * ### **CSS Properties:**
@@ -6708,24 +6766,57 @@ export type CustomElements = {
6708
6766
  */
6709
6767
  "nve-viewport-gridlines": Partial<ViewportGridlinesProps & BaseProps & BaseEvents>;
6710
6768
 
6769
+ /**
6770
+ * Provides a simplified overview and direct navigation for its parent viewport.
6771
+ * ---
6772
+ *
6773
+ *
6774
+ * ### **Methods:**
6775
+ * - **refresh(): _void_** - Remeasures content bounds after preview or viewport roots move without resizing.
6776
+ *
6777
+ * ### **Slots:**
6778
+ * - **preview** - Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles.
6779
+ *
6780
+ * ### **CSS Properties:**
6781
+ * - **--background** - Color of the surface behind preview geometry. _(default: undefined)_
6782
+ * - **--color** - Color of automatically drawn root rectangles. _(default: undefined)_
6783
+ * - **--indicator-color** - Color of the current visible-region indicator. _(default: undefined)_
6784
+ * - **--border-radius** - Corner radius of the minimap. _(default: undefined)_
6785
+ * - **--recenter-cursor** - Cursor for clicking the background to center the viewport. _(default: undefined)_
6786
+ * - **--pan-cursor** - Cursor over a draggable visible region. _(default: undefined)_
6787
+ * - **--panning-cursor** - Cursor during a visible-region drag. _(default: undefined)_
6788
+ */
6789
+ "nve-viewport-minimap": Partial<ViewportMinimapProps & BaseProps & BaseEvents>;
6790
+
6711
6791
  /**
6712
6792
  * A viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.
6713
6793
  * ---
6714
6794
  *
6715
6795
  *
6716
6796
  * ### **Events:**
6717
- * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
6797
+ * - **capabilitieschange** - Dispatched after effective user-input pan or zoom admission changes.
6798
+ * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
6718
6799
  * - **type**
6719
- * - **panstart** - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
6720
- * - **pan** - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
6721
- * - **panend** - Dispatched when a pointer pan ends, including its terminal reason.
6722
- * - **zoom** - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
6800
+ * - **panstart** - Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session.
6801
+ * - **pan** - Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation.
6802
+ * - **panend** - Dispatched once when a sustained pan ends, including its terminal reason.
6803
+ * - **zoom** - Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation.
6723
6804
  *
6724
6805
  * ### **Methods:**
6725
6806
  * - **toViewportCoords(contentX: _number_, contentY: _number_): _ViewportPoint_** - Converts a content-space point to viewport CSS pixels.
6726
6807
  * - **toContentCoords(viewportX: _number_, viewportY: _number_): _ViewportPoint_** - Converts a viewport CSS-pixel point to content space.
6727
6808
  * - **getTransform(): _ViewportTransform_** - Returns the current content-space origin and CSS-pixel scale.
6728
6809
  * - **getVisibleRect(): _ViewportRect_** - Returns the visible content-space rectangle.
6810
+ * - **requestPan(proposal: _ViewportPanProposal_): _boolean_** - Requests one discrete user-originated pan. When pannable, the viewport dispatches
6811
+ * a cancelable `pan` and applies the default transform if no listener cancels the event.
6812
+ * Returns true only when that default changes the transform.
6813
+ * - **requestZoom(proposal: _ViewportZoomProposal_, options: _ViewportZoomRequestOptions_): _boolean_** - Requests one discrete user-originated zoom. When zoomable, the viewport dispatches
6814
+ * a cancelable `zoom` and applies the default transform if no listener cancels the event.
6815
+ * Set `options.animated` to animate the uncanceled default; the option is absent from the `zoom` detail.
6816
+ * Returns true when the default changes or schedules a change to the transform.
6817
+ * - **startPan(proposal: _ViewportPanProposal_): _ViewportPanSession | undefined_** - Starts a sustained semantic pan after the caller crosses its activation threshold.
6818
+ * Dispatches `panstart`, performs the initial `pan` update, and returns a session for later updates
6819
+ * and one terminal `panend`. Returns undefined when pannable is false.
6729
6820
  * - **animateTo(target: _Partial<ViewportTransform>_, options: _ViewportAnimationOptions_): _void_** - Animates the viewport to the requested partial transform.
6730
6821
  * - **reveal(region: _{ x: number; y: number; width?: number; height?: number }_, options: _ViewportRevealOptions_): _void_** - Centers or fits a content-space region within the viewport.
6731
6822
  * - **fitContents(options: _ViewportRevealOptions_): _void_** - Fits the union of direct default-slot element boxes within the viewport.
@@ -6733,6 +6824,7 @@ export type CustomElements = {
6733
6824
  * ### **Slots:**
6734
6825
  * - _default_ - Content positioned in the viewport's infinite content space.
6735
6826
  * - **background** - Custom content rendered behind viewport content and excluded from content fitting
6827
+ * - **overlay** - Interactive content fixed above the transformed plane and excluded from content fitting
6736
6828
  *
6737
6829
  * ### **CSS Properties:**
6738
6830
  * - **--background** - Background color of the fixed viewport area. _(default: undefined)_
@@ -2256,6 +2256,25 @@ type LogoProps = {
2256
2256
  size?: "sm" | "md" | "lg" | undefined;
2257
2257
  };
2258
2258
 
2259
+ type MenuGroupProps = {
2260
+ /** 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)
2261
+ - `true` The associated content expands and becomes visible to the user.
2262
+
2263
+ - `false` The associated content collapses and hides from the user. */
2264
+ expanded?: boolean;
2265
+ /** 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)
2266
+ - `true` The element has a disabled state and does not accept interaction.
2267
+
2268
+ - `false` The element has an enabled state and accepts interaction. */
2269
+ disabled?: boolean;
2270
+ /** Determines whether user activation automatically updates the expanded state. */
2271
+ behaviorExpand?: boolean;
2272
+ /** Dispatched when the user requests that the menu group open. */
2273
+ onopen?: (e: CustomEvent<never>) => void;
2274
+ /** Dispatched when the user requests that the menu group close. */
2275
+ onclose?: (e: CustomEvent<never>) => void;
2276
+ };
2277
+
2259
2278
  type MenuItemProps = {
2260
2279
  /** Establishes a relationship between a popover and its invoker button.
2261
2280
  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
2329
2348
  };
2330
2349
 
2331
2350
  type MenuProps = {
2351
+ /** Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.
2352
+ - `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.
2353
+
2354
+ - `default` Standard size that works well in most contexts and provides balanced visibility. */
2355
+ density?: "compact" | "default" | undefined;
2332
2356
  /** Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. */
2333
2357
  onscroll?: (e: CustomEvent<never>) => void;
2334
2358
  };
@@ -3783,6 +3807,8 @@ type ViewportGridlinesProps = {
3783
3807
  targetSpacing?: number;
3784
3808
  };
3785
3809
 
3810
+ type ViewportMinimapProps = {};
3811
+
3786
3812
  type ViewportProps = {
3787
3813
  /** Inclusive lower scale limit. */
3788
3814
  "min-scale"?: number;
@@ -3814,17 +3840,19 @@ type ViewportProps = {
3814
3840
  fitInset?: number;
3815
3841
  /** CSS-pixel pointer movement required before a pointer pan begins. */
3816
3842
  dragThreshold?: number;
3843
+ /** Dispatched after effective user-input pan or zoom admission changes. */
3844
+ oncapabilitieschange?: (e: CustomEvent<Event>) => void;
3817
3845
  /** Dispatched once after a render that commits one or more viewport transform changes. */
3818
3846
  onviewportchange?: (e: CustomEvent<CustomEvent>) => void;
3819
3847
  /** */
3820
3848
  ontype?: (e: CustomEvent<CustomEvent>) => void;
3821
- /** Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. */
3849
+ /** Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session. */
3822
3850
  onpanstart?: (e: CustomEvent<never>) => void;
3823
- /** Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. */
3851
+ /** Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation. */
3824
3852
  onpan?: (e: CustomEvent<never>) => void;
3825
- /** Dispatched when a pointer pan ends, including its terminal reason. */
3853
+ /** Dispatched once when a sustained pan ends, including its terminal reason. */
3826
3854
  onpanend?: (e: CustomEvent<never>) => void;
3827
- /** Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. */
3855
+ /** Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation. */
3828
3856
  onzoom?: (e: CustomEvent<never>) => void;
3829
3857
  };
3830
3858
 
@@ -5158,6 +5186,33 @@ export type CustomElements = {
5158
5186
  */
5159
5187
  "nve-logo": DefineComponent<LogoProps>;
5160
5188
 
5189
+ /**
5190
+ * Organizes related menu items under a disclosure header that can show or hide one child menu.
5191
+ * ---
5192
+ *
5193
+ *
5194
+ * ### **Events:**
5195
+ * - **open** - Dispatched when the user requests that the menu group open.
5196
+ * - **close** - Dispatched when the user requests that the menu group close.
5197
+ *
5198
+ * ### **Slots:**
5199
+ * - _default_ - Label content for the disclosure header.
5200
+ * - **prefix** - Non-interactive content before the header label, such as an icon or avatar.
5201
+ * - **suffix** - Non-interactive content after the header label, such as a badge or count.
5202
+ * - **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.
5203
+ *
5204
+ * ### **CSS Properties:**
5205
+ * - **--background** - undefined _(default: undefined)_
5206
+ * - **--font-size** - undefined _(default: undefined)_
5207
+ * - **--padding** - undefined _(default: undefined)_
5208
+ * - **--gap** - undefined _(default: undefined)_
5209
+ * - **--border-radius** - undefined _(default: undefined)_
5210
+ * - **--color** - undefined _(default: undefined)_
5211
+ * - **--width** - undefined _(default: undefined)_
5212
+ * - **--min-height** - undefined _(default: undefined)_
5213
+ */
5214
+ "nve-menu-group": DefineComponent<MenuGroupProps>;
5215
+
5161
5216
  /**
5162
5217
  * Represents a selectable option within a menu, providing an interactive button for navigation or actions.
5163
5218
  * ---
@@ -5165,6 +5220,7 @@ export type CustomElements = {
5165
5220
  *
5166
5221
  * ### **Slots:**
5167
5222
  * - _default_ - Label and supporting content for the menu option.
5223
+ * - **prefix** - slot for prefix icon
5168
5224
  * - **suffix** - slot for suffix icon
5169
5225
  *
5170
5226
  * ### **CSS Properties:**
@@ -6464,24 +6520,57 @@ export type CustomElements = {
6464
6520
  */
6465
6521
  "nve-viewport-gridlines": DefineComponent<ViewportGridlinesProps>;
6466
6522
 
6523
+ /**
6524
+ * Provides a simplified overview and direct navigation for its parent viewport.
6525
+ * ---
6526
+ *
6527
+ *
6528
+ * ### **Methods:**
6529
+ * - **refresh(): _void_** - Remeasures content bounds after preview or viewport roots move without resizing.
6530
+ *
6531
+ * ### **Slots:**
6532
+ * - **preview** - Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles.
6533
+ *
6534
+ * ### **CSS Properties:**
6535
+ * - **--background** - Color of the surface behind preview geometry. _(default: undefined)_
6536
+ * - **--color** - Color of automatically drawn root rectangles. _(default: undefined)_
6537
+ * - **--indicator-color** - Color of the current visible-region indicator. _(default: undefined)_
6538
+ * - **--border-radius** - Corner radius of the minimap. _(default: undefined)_
6539
+ * - **--recenter-cursor** - Cursor for clicking the background to center the viewport. _(default: undefined)_
6540
+ * - **--pan-cursor** - Cursor over a draggable visible region. _(default: undefined)_
6541
+ * - **--panning-cursor** - Cursor during a visible-region drag. _(default: undefined)_
6542
+ */
6543
+ "nve-viewport-minimap": DefineComponent<ViewportMinimapProps>;
6544
+
6467
6545
  /**
6468
6546
  * A viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.
6469
6547
  * ---
6470
6548
  *
6471
6549
  *
6472
6550
  * ### **Events:**
6473
- * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
6551
+ * - **capabilitieschange** - Dispatched after effective user-input pan or zoom admission changes.
6552
+ * - **viewportchange** - Dispatched once after a render that commits one or more viewport transform changes.
6474
6553
  * - **type**
6475
- * - **panstart** - Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.
6476
- * - **pan** - Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.
6477
- * - **panend** - Dispatched when a pointer pan ends, including its terminal reason.
6478
- * - **zoom** - Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.
6554
+ * - **panstart** - Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session.
6555
+ * - **pan** - Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation.
6556
+ * - **panend** - Dispatched once when a sustained pan ends, including its terminal reason.
6557
+ * - **zoom** - Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation.
6479
6558
  *
6480
6559
  * ### **Methods:**
6481
6560
  * - **toViewportCoords(contentX: _number_, contentY: _number_): _ViewportPoint_** - Converts a content-space point to viewport CSS pixels.
6482
6561
  * - **toContentCoords(viewportX: _number_, viewportY: _number_): _ViewportPoint_** - Converts a viewport CSS-pixel point to content space.
6483
6562
  * - **getTransform(): _ViewportTransform_** - Returns the current content-space origin and CSS-pixel scale.
6484
6563
  * - **getVisibleRect(): _ViewportRect_** - Returns the visible content-space rectangle.
6564
+ * - **requestPan(proposal: _ViewportPanProposal_): _boolean_** - Requests one discrete user-originated pan. When pannable, the viewport dispatches
6565
+ * a cancelable `pan` and applies the default transform if no listener cancels the event.
6566
+ * Returns true only when that default changes the transform.
6567
+ * - **requestZoom(proposal: _ViewportZoomProposal_, options: _ViewportZoomRequestOptions_): _boolean_** - Requests one discrete user-originated zoom. When zoomable, the viewport dispatches
6568
+ * a cancelable `zoom` and applies the default transform if no listener cancels the event.
6569
+ * Set `options.animated` to animate the uncanceled default; the option is absent from the `zoom` detail.
6570
+ * Returns true when the default changes or schedules a change to the transform.
6571
+ * - **startPan(proposal: _ViewportPanProposal_): _ViewportPanSession | undefined_** - Starts a sustained semantic pan after the caller crosses its activation threshold.
6572
+ * Dispatches `panstart`, performs the initial `pan` update, and returns a session for later updates
6573
+ * and one terminal `panend`. Returns undefined when pannable is false.
6485
6574
  * - **animateTo(target: _Partial<ViewportTransform>_, options: _ViewportAnimationOptions_): _void_** - Animates the viewport to the requested partial transform.
6486
6575
  * - **reveal(region: _{ x: number; y: number; width?: number; height?: number }_, options: _ViewportRevealOptions_): _void_** - Centers or fits a content-space region within the viewport.
6487
6576
  * - **fitContents(options: _ViewportRevealOptions_): _void_** - Fits the union of direct default-slot element boxes within the viewport.
@@ -6489,6 +6578,7 @@ export type CustomElements = {
6489
6578
  * ### **Slots:**
6490
6579
  * - _default_ - Content positioned in the viewport's infinite content space.
6491
6580
  * - **background** - Custom content rendered behind viewport content and excluded from content fitting
6581
+ * - **overlay** - Interactive content fixed above the transformed plane and excluded from content fitting
6492
6582
  *
6493
6583
  * ### **CSS Properties:**
6494
6584
  * - **--background** - Background color of the fixed viewport area. _(default: undefined)_