@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
@@ -26365,6 +26365,21 @@
26365
26365
  "values": []
26366
26366
  }
26367
26367
  },
26368
+ {
26369
+ "kind": "field",
26370
+ "name": "#scrollEndTimeout",
26371
+ "privacy": "private",
26372
+ "type": {
26373
+ "text": "ReturnType<typeof setTimeout> | undefined",
26374
+ "_sourceAliases": [],
26375
+ "values": [
26376
+ {
26377
+ "value": "ReturnType<typeof setTimeout>",
26378
+ "description": ""
26379
+ }
26380
+ ]
26381
+ }
26382
+ },
26368
26383
  {
26369
26384
  "kind": "field",
26370
26385
  "name": "#target",
@@ -26409,6 +26424,11 @@
26409
26424
  "name": "#onScroll",
26410
26425
  "privacy": "private"
26411
26426
  },
26427
+ {
26428
+ "kind": "method",
26429
+ "name": "#cancelScrollEnd",
26430
+ "privacy": "private"
26431
+ },
26412
26432
  {
26413
26433
  "kind": "method",
26414
26434
  "name": "#startScroll",
@@ -30620,6 +30640,14 @@
30620
30640
  "module": "home/runner/work/elements/elements/projects/core/src/menu/menu.js"
30621
30641
  }
30622
30642
  },
30643
+ {
30644
+ "kind": "js",
30645
+ "name": "*",
30646
+ "declaration": {
30647
+ "name": "*",
30648
+ "module": "home/runner/work/elements/elements/projects/core/src/menu/menu-group.js"
30649
+ }
30650
+ },
30623
30651
  {
30624
30652
  "kind": "js",
30625
30653
  "name": "*",
@@ -30632,37 +30660,21 @@
30632
30660
  },
30633
30661
  {
30634
30662
  "kind": "javascript-module",
30635
- "path": "/src/menu/menu-item.js",
30663
+ "path": "/src/menu/menu-group.js",
30636
30664
  "declarations": [
30637
30665
  {
30638
30666
  "kind": "class",
30639
- "description": "Represents a selectable option within a menu, providing an interactive button for navigation or actions.",
30640
- "name": "MenuItem",
30667
+ "description": "Organizes related menu items under a disclosure header that can show or hide one child menu.",
30668
+ "name": "MenuGroup",
30641
30669
  "cssProperties": [
30642
30670
  {
30643
30671
  "name": "--background",
30644
30672
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
30645
30673
  },
30646
- {
30647
- "name": "--border-radius",
30648
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)"
30649
- },
30650
- {
30651
- "name": "--border-background",
30652
- "description": ""
30653
- },
30654
30674
  {
30655
30675
  "name": "--font-size",
30656
30676
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
30657
30677
  },
30658
- {
30659
- "name": "--font-weight",
30660
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight)"
30661
- },
30662
- {
30663
- "name": "--color",
30664
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
30665
- },
30666
30678
  {
30667
30679
  "name": "--padding",
30668
30680
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/padding)"
@@ -30672,136 +30684,90 @@
30672
30684
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/gap)"
30673
30685
  },
30674
30686
  {
30675
- "name": "--width",
30676
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
30677
- },
30678
- {
30679
- "name": "--min-height",
30680
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height)"
30681
- },
30682
- {
30683
- "name": "--line-height",
30684
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/line-height)"
30687
+ "name": "--border-radius",
30688
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)"
30685
30689
  },
30686
30690
  {
30687
- "name": "--cursor",
30688
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor)"
30691
+ "name": "--color",
30692
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
30689
30693
  },
30690
30694
  {
30691
- "name": "--opacity",
30692
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/opacity)"
30695
+ "name": "--width",
30696
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
30693
30697
  },
30694
30698
  {
30695
- "name": "--text-transform",
30696
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-transform)"
30699
+ "name": "--min-height",
30700
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height)"
30697
30701
  }
30698
30702
  ],
30699
30703
  "slots": [
30700
30704
  {
30701
- "description": "Label and supporting content for the menu option.",
30705
+ "description": "Label content for the disclosure header.",
30702
30706
  "name": ""
30703
30707
  },
30704
30708
  {
30705
- "description": "slot for suffix icon",
30709
+ "description": "Non-interactive content before the header label, such as an icon or avatar.",
30710
+ "name": "prefix"
30711
+ },
30712
+ {
30713
+ "description": "Non-interactive content after the header label, such as a badge or count.",
30706
30714
  "name": "suffix"
30715
+ },
30716
+ {
30717
+ "description": "One `nve-menu` containing the grouped menu items. Direct menus use this slot automatically in browsers; server-rendered menus must set `slot=\"menu\"` explicitly.",
30718
+ "name": "menu"
30707
30719
  }
30708
30720
  ],
30709
30721
  "members": [
30710
30722
  {
30711
30723
  "kind": "field",
30712
- "name": "status",
30713
- "type": {
30714
- "text": "'danger'",
30715
- "_sourceAliases": [],
30716
- "values": [
30717
- {
30718
- "value": "danger",
30719
- "description": ""
30720
- }
30721
- ]
30722
- },
30723
- "description": "Applies danger styling to destructive or high-risk menu actions.",
30724
- "attribute": "status",
30725
- "reflects": true
30726
- },
30727
- {
30728
- "kind": "field",
30729
- "name": "type",
30730
- "type": {
30731
- "text": "'button' | 'submit' | 'reset'",
30732
- "_sourceAliases": [],
30733
- "values": [
30734
- {
30735
- "value": "button",
30736
- "description": ""
30737
- },
30738
- {
30739
- "value": "submit",
30740
- "description": ""
30741
- },
30742
- {
30743
- "value": "reset",
30744
- "description": ""
30745
- }
30746
- ]
30747
- },
30748
- "default": "'button'",
30749
- "description": "Defines the button behavior when associated within a form element.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type",
30750
- "attribute": "type"
30751
- },
30752
- {
30753
- "kind": "field",
30754
- "name": "pressed",
30724
+ "name": "expanded",
30755
30725
  "type": {
30756
30726
  "text": "boolean",
30757
30727
  "_sourceAliases": [],
30758
30728
  "values": [
30759
30729
  {
30760
30730
  "value": "true",
30761
- "description": "The button is in the pressed (on) state and the associated action or setting is active."
30731
+ "description": "The associated content expands and becomes visible to the user."
30762
30732
  },
30763
30733
  {
30764
30734
  "value": "false",
30765
- "description": "The button is in the unpressed (off) state and the associated action or setting is inactive."
30735
+ "description": "The associated content collapses and hides from the user."
30766
30736
  }
30767
30737
  ]
30768
30738
  },
30769
- "description": "Indicates the current state of a toggle button that switches on or off. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)\n- `true` The button is in the pressed (on) state and the associated action or setting is active.\n\n- `false` The button is in the unpressed (off) state and the associated action or setting is inactive.",
30770
- "inheritedFrom": {
30771
- "name": "ButtonFormControlMixin"
30772
- },
30773
- "attribute": "pressed",
30739
+ "default": "false",
30740
+ "description": "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)\n- `true` The associated content expands and becomes visible to the user.\n\n- `false` The associated content collapses and hides from the user.",
30741
+ "attribute": "expanded",
30774
30742
  "reflects": true,
30775
- "descriptionText": "Indicates the current state of a toggle button that switches on or off. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)"
30743
+ "descriptionText": "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)"
30776
30744
  },
30777
30745
  {
30778
30746
  "kind": "field",
30779
- "name": "expanded",
30747
+ "name": "disabled",
30780
30748
  "type": {
30781
30749
  "text": "boolean",
30782
30750
  "_sourceAliases": [],
30783
30751
  "values": [
30784
30752
  {
30785
30753
  "value": "true",
30786
- "description": "The associated content expands and becomes visible to the user."
30754
+ "description": "The element has a disabled state and does not accept interaction."
30787
30755
  },
30788
30756
  {
30789
30757
  "value": "false",
30790
- "description": "The associated content collapses and hides from the user."
30758
+ "description": "The element has an enabled state and accepts interaction."
30791
30759
  }
30792
30760
  ]
30793
30761
  },
30794
- "description": "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)\n- `true` The associated content expands and becomes visible to the user.\n\n- `false` The associated content collapses and hides from the user.",
30795
- "inheritedFrom": {
30796
- "name": "ButtonFormControlMixin"
30797
- },
30798
- "attribute": "expanded",
30762
+ "default": "false",
30763
+ "description": "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)\n- `true` The element has a disabled state and does not accept interaction.\n\n- `false` The element has an enabled state and accepts interaction.",
30764
+ "attribute": "disabled",
30799
30765
  "reflects": true,
30800
- "descriptionText": "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)"
30766
+ "descriptionText": "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)"
30801
30767
  },
30802
30768
  {
30803
30769
  "kind": "field",
30804
- "name": "readOnly",
30770
+ "name": "behaviorExpand",
30805
30771
  "type": {
30806
30772
  "text": "boolean",
30807
30773
  "_sourceAliases": [],
@@ -30816,70 +30782,44 @@
30816
30782
  }
30817
30783
  ]
30818
30784
  },
30819
- "description": "Indicates whether the element is a noninteractive visual treatment instead of a button.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly",
30820
- "inheritedFrom": {
30821
- "name": "ButtonFormControlMixin"
30822
- },
30823
- "attribute": "readonly",
30824
- "reflects": true
30825
- },
30785
+ "default": "false",
30786
+ "description": "Determines whether user activation automatically updates the expanded state.",
30787
+ "attribute": "behavior-expand"
30788
+ }
30789
+ ],
30790
+ "events": [
30826
30791
  {
30827
- "kind": "field",
30828
- "name": "form",
30829
- "type": {
30830
- "text": "string | HTMLFormElement | null",
30831
- "_sourceAliases": [],
30832
- "values": []
30833
- },
30834
- "description": "Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only\nthe form ID. Reading the property returns the associated form element or `null`.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form",
30835
- "inheritedFrom": {
30836
- "name": "ButtonFormControlMixin"
30837
- },
30838
- "attribute": "form",
30839
- "reflects": false
30792
+ "description": "Dispatched when the user requests that the menu group open.",
30793
+ "name": "open"
30840
30794
  },
30841
30795
  {
30842
- "kind": "field",
30843
- "name": "name",
30844
- "type": {
30845
- "text": "string",
30846
- "_sourceAliases": [],
30847
- "values": [
30848
- {
30849
- "value": "string",
30850
- "description": ""
30851
- }
30852
- ]
30853
- },
30854
- "description": "The name of the button, submitted as a pair with the button value as part of the form data.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-name",
30855
- "inheritedFrom": {
30856
- "name": "ButtonFormControlMixin"
30857
- },
30858
- "attribute": "name",
30859
- "reflects": true
30860
- },
30796
+ "description": "Dispatched when the user requests that the menu group close.",
30797
+ "name": "close"
30798
+ }
30799
+ ],
30800
+ "attributes": [
30861
30801
  {
30862
- "kind": "field",
30863
- "name": "value",
30802
+ "name": "expanded",
30864
30803
  "type": {
30865
- "text": "string",
30804
+ "text": "boolean",
30866
30805
  "_sourceAliases": [],
30867
30806
  "values": [
30868
30807
  {
30869
- "value": "string",
30870
- "description": ""
30808
+ "value": "true",
30809
+ "description": "The associated content expands and becomes visible to the user."
30810
+ },
30811
+ {
30812
+ "value": "false",
30813
+ "description": "The associated content collapses and hides from the user."
30871
30814
  }
30872
30815
  ]
30873
30816
  },
30874
- "description": "Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#value)",
30875
- "inheritedFrom": {
30876
- "name": "ButtonFormControlMixin"
30877
- },
30878
- "attribute": "value",
30879
- "reflects": true
30817
+ "default": "false",
30818
+ "description": "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)\n- `true` The associated content expands and becomes visible to the user.\n\n- `false` The associated content collapses and hides from the user.",
30819
+ "fieldName": "expanded",
30820
+ "descriptionText": "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)"
30880
30821
  },
30881
30822
  {
30882
- "kind": "field",
30883
30823
  "name": "disabled",
30884
30824
  "type": {
30885
30825
  "text": "boolean",
@@ -30895,49 +30835,395 @@
30895
30835
  }
30896
30836
  ]
30897
30837
  },
30838
+ "default": "false",
30898
30839
  "description": "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)\n- `true` The element has a disabled state and does not accept interaction.\n\n- `false` The element has an enabled state and accepts interaction.",
30899
- "inheritedFrom": {
30900
- "name": "ButtonFormControlMixin"
30901
- },
30902
- "attribute": "disabled",
30903
- "reflects": true,
30840
+ "fieldName": "disabled",
30904
30841
  "descriptionText": "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)"
30905
30842
  },
30906
30843
  {
30907
- "kind": "field",
30908
- "name": "selected",
30844
+ "name": "behavior-expand",
30909
30845
  "type": {
30910
30846
  "text": "boolean",
30911
30847
  "_sourceAliases": [],
30912
30848
  "values": [
30913
30849
  {
30914
30850
  "value": "true",
30915
- "description": "The element holds selection and represents the user's current choice within the group."
30851
+ "description": ""
30916
30852
  },
30917
30853
  {
30918
30854
  "value": "false",
30919
- "description": "The element does not hold selection and the user can choose it."
30855
+ "description": ""
30920
30856
  }
30921
30857
  ]
30922
30858
  },
30923
- "description": "Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)\n- `true` The element holds selection and represents the user's current choice within the group.\n\n- `false` The element does not hold selection and the user can choose it.",
30924
- "inheritedFrom": {
30925
- "name": "ButtonFormControlMixin"
30926
- },
30927
- "attribute": "selected",
30928
- "reflects": true,
30929
- "descriptionText": "Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)"
30930
- },
30931
- {
30932
- "kind": "field",
30933
- "name": "current",
30934
- "type": {
30935
- "text": "'page' | 'step'",
30936
- "_sourceAliases": [],
30937
- "values": [
30938
- {
30939
- "value": "page",
30940
- "description": "Marks the current page within a set of navigation links."
30859
+ "default": "false",
30860
+ "description": "Determines whether user activation automatically updates the expanded state.",
30861
+ "fieldName": "behaviorExpand"
30862
+ }
30863
+ ],
30864
+ "superclass": {
30865
+ "name": "LitElement",
30866
+ "package": "lit"
30867
+ },
30868
+ "tagName": "nve-menu-group",
30869
+ "customElement": true,
30870
+ "metadata": {
30871
+ "unitTests": true,
30872
+ "apiReview": true,
30873
+ "performance": true,
30874
+ "stable": false,
30875
+ "vqa": true,
30876
+ "responsive": true,
30877
+ "themes": true,
30878
+ "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/",
30879
+ "entrypoint": "@nvidia-elements/core/menu",
30880
+ "example": "",
30881
+ "package": true,
30882
+ "documentation": "https://nvidia.github.io/elements/docs/elements/menu/",
30883
+ "since": "0.0.0",
30884
+ "status": "beta",
30885
+ "behavior": "container",
30886
+ "markdown": "## nve-menu-group\n\nOrganizes related menu items under a disclosure header that can show or hide one child menu.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Label content for the disclosure header. |\n| menu | `string` | One `nve-menu` containing the grouped menu items. Direct menus use this slot automatically in browsers; server-rendered menus must set `slot=\"menu\"` explicitly. |\n| prefix | `string` | Non-interactive content before the header label, such as an icon or avatar. |\n| suffix | `string` | Non-interactive content after the header label, such as a badge or count. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| behaviorExpand (behavior-expand) | `boolean` | Determines whether user activation automatically updates the expanded state. |\n| disabled | `boolean` | This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://mdn.dev/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. |\n| expanded | `boolean` | Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://mdn.dev/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. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| close | `CustomEvent` | Dispatched when the user requests that the menu group close. |\n| open | `CustomEvent` | Dispatched when the user requests that the menu group open. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --close | `CommandEvent` | Closes the menu group. |\n| --open | `CommandEvent` | Opens the menu group. |\n| --toggle | `CommandEvent` | Toggles the menu group. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
30887
+ },
30888
+ "commands": [
30889
+ {
30890
+ "name": "--open",
30891
+ "description": "Opens the menu group."
30892
+ },
30893
+ {
30894
+ "name": "--close",
30895
+ "description": "Closes the menu group."
30896
+ },
30897
+ {
30898
+ "name": "--toggle",
30899
+ "description": "Toggles the menu group."
30900
+ }
30901
+ ]
30902
+ }
30903
+ ],
30904
+ "exports": [
30905
+ {
30906
+ "kind": "js",
30907
+ "name": "MenuGroup",
30908
+ "declaration": {
30909
+ "name": "MenuGroup",
30910
+ "module": "/src/menu/menu-group.js"
30911
+ }
30912
+ }
30913
+ ]
30914
+ },
30915
+ {
30916
+ "kind": "javascript-module",
30917
+ "path": "/src/menu/menu-item.js",
30918
+ "declarations": [
30919
+ {
30920
+ "kind": "class",
30921
+ "description": "Represents a selectable option within a menu, providing an interactive button for navigation or actions.",
30922
+ "name": "MenuItem",
30923
+ "cssProperties": [
30924
+ {
30925
+ "name": "--background",
30926
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
30927
+ },
30928
+ {
30929
+ "name": "--border-radius",
30930
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)"
30931
+ },
30932
+ {
30933
+ "name": "--border-background",
30934
+ "description": ""
30935
+ },
30936
+ {
30937
+ "name": "--font-size",
30938
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
30939
+ },
30940
+ {
30941
+ "name": "--font-weight",
30942
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight)"
30943
+ },
30944
+ {
30945
+ "name": "--color",
30946
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
30947
+ },
30948
+ {
30949
+ "name": "--padding",
30950
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/padding)"
30951
+ },
30952
+ {
30953
+ "name": "--gap",
30954
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/gap)"
30955
+ },
30956
+ {
30957
+ "name": "--width",
30958
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
30959
+ },
30960
+ {
30961
+ "name": "--min-height",
30962
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height)"
30963
+ },
30964
+ {
30965
+ "name": "--line-height",
30966
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/line-height)"
30967
+ },
30968
+ {
30969
+ "name": "--cursor",
30970
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/cursor)"
30971
+ },
30972
+ {
30973
+ "name": "--opacity",
30974
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/opacity)"
30975
+ },
30976
+ {
30977
+ "name": "--text-transform",
30978
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-transform)"
30979
+ }
30980
+ ],
30981
+ "slots": [
30982
+ {
30983
+ "description": "Label and supporting content for the menu option.",
30984
+ "name": ""
30985
+ },
30986
+ {
30987
+ "description": "slot for prefix icon",
30988
+ "name": "prefix"
30989
+ },
30990
+ {
30991
+ "description": "slot for suffix icon",
30992
+ "name": "suffix"
30993
+ }
30994
+ ],
30995
+ "members": [
30996
+ {
30997
+ "kind": "field",
30998
+ "name": "status",
30999
+ "type": {
31000
+ "text": "'danger'",
31001
+ "_sourceAliases": [],
31002
+ "values": [
31003
+ {
31004
+ "value": "danger",
31005
+ "description": ""
31006
+ }
31007
+ ]
31008
+ },
31009
+ "description": "Applies danger styling to destructive or high-risk menu actions.",
31010
+ "attribute": "status",
31011
+ "reflects": true
31012
+ },
31013
+ {
31014
+ "kind": "field",
31015
+ "name": "type",
31016
+ "type": {
31017
+ "text": "'button' | 'submit' | 'reset'",
31018
+ "_sourceAliases": [],
31019
+ "values": [
31020
+ {
31021
+ "value": "button",
31022
+ "description": ""
31023
+ },
31024
+ {
31025
+ "value": "submit",
31026
+ "description": ""
31027
+ },
31028
+ {
31029
+ "value": "reset",
31030
+ "description": ""
31031
+ }
31032
+ ]
31033
+ },
31034
+ "default": "'button'",
31035
+ "description": "Defines the button behavior when associated within a form element.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-type",
31036
+ "attribute": "type"
31037
+ },
31038
+ {
31039
+ "kind": "field",
31040
+ "name": "pressed",
31041
+ "type": {
31042
+ "text": "boolean",
31043
+ "_sourceAliases": [],
31044
+ "values": [
31045
+ {
31046
+ "value": "true",
31047
+ "description": "The button is in the pressed (on) state and the associated action or setting is active."
31048
+ },
31049
+ {
31050
+ "value": "false",
31051
+ "description": "The button is in the unpressed (off) state and the associated action or setting is inactive."
31052
+ }
31053
+ ]
31054
+ },
31055
+ "description": "Indicates the current state of a toggle button that switches on or off. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)\n- `true` The button is in the pressed (on) state and the associated action or setting is active.\n\n- `false` The button is in the unpressed (off) state and the associated action or setting is inactive.",
31056
+ "inheritedFrom": {
31057
+ "name": "ButtonFormControlMixin"
31058
+ },
31059
+ "attribute": "pressed",
31060
+ "reflects": true,
31061
+ "descriptionText": "Indicates the current state of a toggle button that switches on or off. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-pressed)"
31062
+ },
31063
+ {
31064
+ "kind": "field",
31065
+ "name": "expanded",
31066
+ "type": {
31067
+ "text": "boolean",
31068
+ "_sourceAliases": [],
31069
+ "values": [
31070
+ {
31071
+ "value": "true",
31072
+ "description": "The associated content expands and becomes visible to the user."
31073
+ },
31074
+ {
31075
+ "value": "false",
31076
+ "description": "The associated content collapses and hides from the user."
31077
+ }
31078
+ ]
31079
+ },
31080
+ "description": "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)\n- `true` The associated content expands and becomes visible to the user.\n\n- `false` The associated content collapses and hides from the user.",
31081
+ "inheritedFrom": {
31082
+ "name": "ButtonFormControlMixin"
31083
+ },
31084
+ "attribute": "expanded",
31085
+ "reflects": true,
31086
+ "descriptionText": "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)"
31087
+ },
31088
+ {
31089
+ "kind": "field",
31090
+ "name": "readOnly",
31091
+ "type": {
31092
+ "text": "boolean",
31093
+ "_sourceAliases": [],
31094
+ "values": [
31095
+ {
31096
+ "value": "true",
31097
+ "description": ""
31098
+ },
31099
+ {
31100
+ "value": "false",
31101
+ "description": ""
31102
+ }
31103
+ ]
31104
+ },
31105
+ "description": "Indicates whether the element is a noninteractive visual treatment instead of a button.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly",
31106
+ "inheritedFrom": {
31107
+ "name": "ButtonFormControlMixin"
31108
+ },
31109
+ "attribute": "readonly",
31110
+ "reflects": true
31111
+ },
31112
+ {
31113
+ "kind": "field",
31114
+ "name": "form",
31115
+ "type": {
31116
+ "text": "string | HTMLFormElement | null",
31117
+ "_sourceAliases": [],
31118
+ "values": []
31119
+ },
31120
+ "description": "Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only\nthe form ID. Reading the property returns the associated form element or `null`.\nhttps://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form",
31121
+ "inheritedFrom": {
31122
+ "name": "ButtonFormControlMixin"
31123
+ },
31124
+ "attribute": "form",
31125
+ "reflects": false
31126
+ },
31127
+ {
31128
+ "kind": "field",
31129
+ "name": "name",
31130
+ "type": {
31131
+ "text": "string",
31132
+ "_sourceAliases": [],
31133
+ "values": [
31134
+ {
31135
+ "value": "string",
31136
+ "description": ""
31137
+ }
31138
+ ]
31139
+ },
31140
+ "description": "The name of the button, submitted as a pair with the button value as part of the form data.\nhttps://developer.mozilla.org/en-US/docs/Web/HTML/Element/button#attr-name",
31141
+ "inheritedFrom": {
31142
+ "name": "ButtonFormControlMixin"
31143
+ },
31144
+ "attribute": "name",
31145
+ "reflects": true
31146
+ },
31147
+ {
31148
+ "kind": "field",
31149
+ "name": "value",
31150
+ "type": {
31151
+ "text": "string",
31152
+ "_sourceAliases": [],
31153
+ "values": [
31154
+ {
31155
+ "value": "string",
31156
+ "description": ""
31157
+ }
31158
+ ]
31159
+ },
31160
+ "description": "Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#value)",
31161
+ "inheritedFrom": {
31162
+ "name": "ButtonFormControlMixin"
31163
+ },
31164
+ "attribute": "value",
31165
+ "reflects": true
31166
+ },
31167
+ {
31168
+ "kind": "field",
31169
+ "name": "disabled",
31170
+ "type": {
31171
+ "text": "boolean",
31172
+ "_sourceAliases": [],
31173
+ "values": [
31174
+ {
31175
+ "value": "true",
31176
+ "description": "The element has a disabled state and does not accept interaction."
31177
+ },
31178
+ {
31179
+ "value": "false",
31180
+ "description": "The element has an enabled state and accepts interaction."
31181
+ }
31182
+ ]
31183
+ },
31184
+ "description": "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)\n- `true` The element has a disabled state and does not accept interaction.\n\n- `false` The element has an enabled state and accepts interaction.",
31185
+ "inheritedFrom": {
31186
+ "name": "ButtonFormControlMixin"
31187
+ },
31188
+ "attribute": "disabled",
31189
+ "reflects": true,
31190
+ "descriptionText": "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)"
31191
+ },
31192
+ {
31193
+ "kind": "field",
31194
+ "name": "selected",
31195
+ "type": {
31196
+ "text": "boolean",
31197
+ "_sourceAliases": [],
31198
+ "values": [
31199
+ {
31200
+ "value": "true",
31201
+ "description": "The element holds selection and represents the user's current choice within the group."
31202
+ },
31203
+ {
31204
+ "value": "false",
31205
+ "description": "The element does not hold selection and the user can choose it."
31206
+ }
31207
+ ]
31208
+ },
31209
+ "description": "Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)\n- `true` The element holds selection and represents the user's current choice within the group.\n\n- `false` The element does not hold selection and the user can choose it.",
31210
+ "inheritedFrom": {
31211
+ "name": "ButtonFormControlMixin"
31212
+ },
31213
+ "attribute": "selected",
31214
+ "reflects": true,
31215
+ "descriptionText": "Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)"
31216
+ },
31217
+ {
31218
+ "kind": "field",
31219
+ "name": "current",
31220
+ "type": {
31221
+ "text": "'page' | 'step'",
31222
+ "_sourceAliases": [],
31223
+ "values": [
31224
+ {
31225
+ "value": "page",
31226
+ "description": "Marks the current page within a set of navigation links."
30941
31227
  },
30942
31228
  {
30943
31229
  "value": "step",
@@ -31407,7 +31693,7 @@
31407
31693
  "since": "0.11.0",
31408
31694
  "status": "stable",
31409
31695
  "behavior": "button",
31410
- "markdown": "## nve-menu-item\n\nRepresents a selectable option within a menu, providing an interactive button for navigation or actions.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Label and supporting content for the menu option. |\n| suffix | `string` | slot for suffix icon |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| command | `string` | The command to execute on the element. https://mdn.dev/Invoker_Commands_API |\n| commandForElement (commandfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| current | `'page' \\| 'step'` | Indicates the element that represents the user's current location or position within a set. [MDN](https://mdn.dev/ARIA/Attributes/aria-current) - `page` Marks the current page within a set of navigation links. - `step` Marks the current step within a multi-step process or workflow. |\n| disabled | `boolean` | This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://mdn.dev/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. |\n| expanded | `boolean` | Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://mdn.dev/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. |\n| form | property: `string \\| HTMLFormElement \\| null`; attribute: `string` | 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://mdn.dev/ElementInternals/form |\n| interestForElement (interestfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n| name | `string` | The name of the button, submitted as a pair with the button value as part of the form data. https://mdn.dev/HTML/Element/button#attr-name |\n| popoverTargetAction (popovertargetaction) | `'show' \\| 'hide' \\| 'toggle'` | The popover target action to perform on the popover target element. https://mdn.dev/HTMLInputElement/popoverTargetAction |\n| popoverTargetElement (popovertarget) | property: `HTMLElement \\| null`; attribute: `string` | Establishes a relationship between a popover and its invoker button. https://mdn.dev/HTMLInputElement/popoverTargetElement |\n| pressed | `boolean` | Indicates the current state of a toggle button that switches on or off. [MDN](https://mdn.dev/ARIA/Attributes/aria-pressed) - `true` The button is in the pressed (on) state and the associated action or setting is active. - `false` The button is in the unpressed (off) state and the associated action or setting is inactive. |\n| readOnly (readonly) | `boolean` | Indicates whether the element is a noninteractive visual treatment instead of a button. https://mdn.dev/HTML/Attributes/readonly |\n| selected | `boolean` | Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://mdn.dev/ARIA/Attributes/aria-selected) - `true` The element holds selection and represents the user's current choice within the group. - `false` The element does not hold selection and the user can choose it. |\n| status | `'danger'` | Applies danger styling to destructive or high-risk menu actions. |\n| type | `'button' \\| 'submit' \\| 'reset'` | Defines the button behavior when associated within a form element. https://mdn.dev/HTML/Element/button#attr-type |\n| value | `string` | Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://mdn.dev/HTML/Element/input#value) |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-background | `string` | |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --line-height | `string` | [MDN](https://mdn.dev/CSS/line-height) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --opacity | `string` | [MDN](https://mdn.dev/CSS/opacity) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
31696
+ "markdown": "## nve-menu-item\n\nRepresents a selectable option within a menu, providing an interactive button for navigation or actions.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Label and supporting content for the menu option. |\n| prefix | `string` | slot for prefix icon |\n| suffix | `string` | slot for suffix icon |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| command | `string` | The command to execute on the element. https://mdn.dev/Invoker_Commands_API |\n| commandForElement (commandfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| current | `'page' \\| 'step'` | Indicates the element that represents the user's current location or position within a set. [MDN](https://mdn.dev/ARIA/Attributes/aria-current) - `page` Marks the current page within a set of navigation links. - `step` Marks the current step within a multi-step process or workflow. |\n| disabled | `boolean` | This Boolean attribute prevents the user from interacting with the element: it cannot receive press or focus events. [MDN](https://mdn.dev/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. |\n| expanded | `boolean` | Indicates whether collapsible content is currently visible or hidden from the user. [MDN](https://mdn.dev/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. |\n| form | property: `string \\| HTMLFormElement \\| null`; attribute: `string` | 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://mdn.dev/ElementInternals/form |\n| interestForElement (interestfor) | property: `HTMLElement \\| null`; attribute: `string` | The element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n| name | `string` | The name of the button, submitted as a pair with the button value as part of the form data. https://mdn.dev/HTML/Element/button#attr-name |\n| popoverTargetAction (popovertargetaction) | `'show' \\| 'hide' \\| 'toggle'` | The popover target action to perform on the popover target element. https://mdn.dev/HTMLInputElement/popoverTargetAction |\n| popoverTargetElement (popovertarget) | property: `HTMLElement \\| null`; attribute: `string` | Establishes a relationship between a popover and its invoker button. https://mdn.dev/HTMLInputElement/popoverTargetElement |\n| pressed | `boolean` | Indicates the current state of a toggle button that switches on or off. [MDN](https://mdn.dev/ARIA/Attributes/aria-pressed) - `true` The button is in the pressed (on) state and the associated action or setting is active. - `false` The button is in the unpressed (off) state and the associated action or setting is inactive. |\n| readOnly (readonly) | `boolean` | Indicates whether the element is a noninteractive visual treatment instead of a button. https://mdn.dev/HTML/Attributes/readonly |\n| selected | `boolean` | Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://mdn.dev/ARIA/Attributes/aria-selected) - `true` The element holds selection and represents the user's current choice within the group. - `false` The element does not hold selection and the user can choose it. |\n| status | `'danger'` | Applies danger styling to destructive or high-risk menu actions. |\n| type | `'button' \\| 'submit' \\| 'reset'` | Defines the button behavior when associated within a form element. https://mdn.dev/HTML/Element/button#attr-type |\n| value | `string` | Defines the value associated with the element's name when submitting the form data. The server receives this value in params when the form submits through this button. [MDN](https://mdn.dev/HTML/Element/input#value) |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-background | `string` | |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --line-height | `string` | [MDN](https://mdn.dev/CSS/line-height) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --opacity | `string` | [MDN](https://mdn.dev/CSS/opacity) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
31411
31697
  }
31412
31698
  }
31413
31699
  ],
@@ -31462,13 +31748,62 @@
31462
31748
  "name": ""
31463
31749
  }
31464
31750
  ],
31465
- "members": [],
31751
+ "members": [
31752
+ {
31753
+ "kind": "field",
31754
+ "name": "density",
31755
+ "type": {
31756
+ "text": "'compact' | 'default' | undefined",
31757
+ "_sourceAliases": [
31758
+ "Density"
31759
+ ],
31760
+ "values": [
31761
+ {
31762
+ "value": "compact",
31763
+ "description": "Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence."
31764
+ },
31765
+ {
31766
+ "value": "default",
31767
+ "description": "Standard size that works well in most contexts and provides balanced visibility."
31768
+ }
31769
+ ]
31770
+ },
31771
+ "description": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.\n- `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.\n\n- `default` Standard size that works well in most contexts and provides balanced visibility.",
31772
+ "attribute": "density",
31773
+ "reflects": true,
31774
+ "descriptionText": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot."
31775
+ }
31776
+ ],
31466
31777
  "events": [
31467
31778
  {
31468
31779
  "description": "Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.",
31469
31780
  "name": "scroll"
31470
31781
  }
31471
31782
  ],
31783
+ "attributes": [
31784
+ {
31785
+ "name": "density",
31786
+ "type": {
31787
+ "text": "'compact' | 'default' | undefined",
31788
+ "_sourceAliases": [
31789
+ "Density"
31790
+ ],
31791
+ "values": [
31792
+ {
31793
+ "value": "compact",
31794
+ "description": "Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence."
31795
+ },
31796
+ {
31797
+ "value": "default",
31798
+ "description": "Standard size that works well in most contexts and provides balanced visibility."
31799
+ }
31800
+ ]
31801
+ },
31802
+ "description": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot.\n- `compact` Reduces visual weight and spacing for dense layouts or secondary elements with less visual prominence.\n\n- `default` Standard size that works well in most contexts and provides balanced visibility.",
31803
+ "fieldName": "density",
31804
+ "descriptionText": "Determines if the menu is in a compact layout. This hides all menu item content except the prefix icon slot."
31805
+ }
31806
+ ],
31472
31807
  "superclass": {
31473
31808
  "name": "LitElement",
31474
31809
  "package": "lit"
@@ -31491,7 +31826,7 @@
31491
31826
  "since": "0.11.0",
31492
31827
  "status": "stable",
31493
31828
  "behavior": "navigation",
31494
- "markdown": "## nve-menu\n\nA 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.\n\n### Example\n\n```html\n<nve-menu>\n <nve-menu-item>item 1</nve-menu-item>\n <nve-menu-item>item 2</nve-menu-item>\n <nve-menu-item>item 3</nve-menu-item>\n <nve-menu-item>item 4</nve-menu-item>\n</nve-menu>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for `nve-menu-item` |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| scroll | `CustomEvent` | Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --max-height | `string` | [MDN](https://mdn.dev/CSS/max-height) |\n| --max-width | `string` | [MDN](https://mdn.dev/CSS/max-width) |\n| --min-width | `string` | [MDN](https://mdn.dev/CSS/min-width) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
31829
+ "markdown": "## nve-menu\n\nA 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.\n\n### Example\n\n```html\n<nve-menu>\n <nve-menu-item>item 1</nve-menu-item>\n <nve-menu-item>item 2</nve-menu-item>\n <nve-menu-item>item 3</nve-menu-item>\n <nve-menu-item>item 4</nve-menu-item>\n</nve-menu>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/menu/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for `nve-menu-item` |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| density | `'compact' \\| 'default' \\| undefined` | 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. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| scroll | `CustomEvent` | Fires when the user scrolls the menu list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --max-height | `string` | [MDN](https://mdn.dev/CSS/max-height) |\n| --max-width | `string` | [MDN](https://mdn.dev/CSS/max-width) |\n| --min-width | `string` | [MDN](https://mdn.dev/CSS/min-width) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
31495
31830
  }
31496
31831
  }
31497
31832
  ],
@@ -51067,6 +51402,14 @@
51067
51402
  "module": "home/runner/work/elements/elements/projects/core/src/viewport/viewport-gridlines.js"
51068
51403
  }
51069
51404
  },
51405
+ {
51406
+ "kind": "js",
51407
+ "name": "*",
51408
+ "declaration": {
51409
+ "name": "*",
51410
+ "module": "home/runner/work/elements/elements/projects/core/src/viewport/viewport-minimap.js"
51411
+ }
51412
+ },
51070
51413
  {
51071
51414
  "kind": "js",
51072
51415
  "name": "ViewportAnimationOptions",
@@ -51085,33 +51428,89 @@
51085
51428
  },
51086
51429
  {
51087
51430
  "kind": "js",
51088
- "name": "ViewportPanBehavior",
51431
+ "name": "ViewportPanBehavior",
51432
+ "declaration": {
51433
+ "name": "ViewportPanBehavior",
51434
+ "module": "./viewport.types.js"
51435
+ }
51436
+ },
51437
+ {
51438
+ "kind": "js",
51439
+ "name": "ViewportPanDetail",
51440
+ "declaration": {
51441
+ "name": "ViewportPanDetail",
51442
+ "module": "./viewport.types.js"
51443
+ }
51444
+ },
51445
+ {
51446
+ "kind": "js",
51447
+ "name": "ViewportPanEndDetail",
51448
+ "declaration": {
51449
+ "name": "ViewportPanEndDetail",
51450
+ "module": "./viewport.types.js"
51451
+ }
51452
+ },
51453
+ {
51454
+ "kind": "js",
51455
+ "name": "ViewportPanEndReason",
51456
+ "declaration": {
51457
+ "name": "ViewportPanEndReason",
51458
+ "module": "./viewport.types.js"
51459
+ }
51460
+ },
51461
+ {
51462
+ "kind": "js",
51463
+ "name": "ViewportNavigationSource",
51464
+ "declaration": {
51465
+ "name": "ViewportNavigationSource",
51466
+ "module": "./viewport.types.js"
51467
+ }
51468
+ },
51469
+ {
51470
+ "kind": "js",
51471
+ "name": "ViewportPanProposal",
51472
+ "declaration": {
51473
+ "name": "ViewportPanProposal",
51474
+ "module": "./viewport.types.js"
51475
+ }
51476
+ },
51477
+ {
51478
+ "kind": "js",
51479
+ "name": "ViewportPanUpdateProposal",
51480
+ "declaration": {
51481
+ "name": "ViewportPanUpdateProposal",
51482
+ "module": "./viewport.types.js"
51483
+ }
51484
+ },
51485
+ {
51486
+ "kind": "js",
51487
+ "name": "ViewportPanEndRequest",
51089
51488
  "declaration": {
51090
- "name": "ViewportPanBehavior",
51489
+ "name": "ViewportPanEndRequest",
51091
51490
  "module": "./viewport.types.js"
51092
51491
  }
51093
51492
  },
51094
51493
  {
51095
51494
  "kind": "js",
51096
- "name": "ViewportPanDetail",
51495
+ "name": "ViewportPanSession",
51097
51496
  "declaration": {
51098
- "name": "ViewportPanDetail",
51497
+ "name": "ViewportPanSession",
51099
51498
  "module": "./viewport.types.js"
51100
51499
  }
51101
51500
  },
51102
51501
  {
51103
51502
  "kind": "js",
51104
- "name": "ViewportPanEndDetail",
51503
+ "name": "ViewportZoomProposal",
51105
51504
  "declaration": {
51106
- "name": "ViewportPanEndDetail",
51505
+ "name": "ViewportZoomProposal",
51107
51506
  "module": "./viewport.types.js"
51108
51507
  }
51109
51508
  },
51110
51509
  {
51111
51510
  "kind": "js",
51112
- "name": "ViewportPanEndReason",
51511
+ "name": "ViewportZoomRequestOptions",
51113
51512
  "declaration": {
51114
- "name": "ViewportPanEndReason",
51513
+ "name": "ViewportZoomRequestOptions",
51115
51514
  "module": "./viewport.types.js"
51116
51515
  }
51117
51516
  },
@@ -51697,7 +52096,7 @@
51697
52096
  "declarations": [
51698
52097
  {
51699
52098
  "kind": "class",
51700
- "description": "Coordinates the viewport's opt-in pointer, touch, pinch, and wheel navigation behavior.",
52099
+ "description": "",
51701
52100
  "name": "ViewportGestureNavigationController",
51702
52101
  "members": [
51703
52102
  {
@@ -51874,8 +52273,7 @@
51874
52273
  "type": {
51875
52274
  "text": "void"
51876
52275
  }
51877
- },
51878
- "description": "Rebase in-progress pointer math synchronously after an independent transform change."
52276
+ }
51879
52277
  },
51880
52278
  {
51881
52279
  "kind": "method",
@@ -51895,15 +52293,7 @@
51895
52293
  "type": {
51896
52294
  "text": "void"
51897
52295
  }
51898
- },
51899
- "parameters": [
51900
- {
51901
- "name": "panBehavior",
51902
- "type": {
51903
- "text": "ViewportPanBehavior"
51904
- }
51905
- }
51906
- ]
52296
+ }
51907
52297
  },
51908
52298
  {
51909
52299
  "kind": "field",
@@ -52091,18 +52481,18 @@
52091
52481
  },
52092
52482
  {
52093
52483
  "kind": "method",
52094
- "name": "#dispatchPointerPanAndApplyDefault",
52484
+ "name": "#pointerPanProposal",
52095
52485
  "privacy": "private",
52096
52486
  "return": {
52097
52487
  "type": {
52098
- "text": "void"
52488
+ "text": "ViewportPanUpdateProposal"
52099
52489
  }
52100
52490
  },
52101
52491
  "parameters": [
52102
52492
  {
52103
- "name": "pointerId",
52493
+ "name": "gesture",
52104
52494
  "type": {
52105
- "text": "number"
52495
+ "text": "PointerMovementGesture & { readonly kind: 'pan' }"
52106
52496
  }
52107
52497
  },
52108
52498
  {
@@ -52110,29 +52500,23 @@
52110
52500
  "type": {
52111
52501
  "text": "PointerPanSession"
52112
52502
  }
52113
- },
52114
- {
52115
- "name": "detail",
52116
- "type": {
52117
- "text": "ViewportPointerPanDetail"
52118
- }
52119
52503
  }
52120
52504
  ]
52121
52505
  },
52122
52506
  {
52123
52507
  "kind": "method",
52124
- "name": "#activatePendingPan",
52508
+ "name": "#activatePointerPan",
52125
52509
  "privacy": "private",
52126
52510
  "return": {
52127
52511
  "type": {
52128
- "text": "boolean"
52512
+ "text": "void"
52129
52513
  }
52130
52514
  },
52131
52515
  "parameters": [
52132
52516
  {
52133
- "name": "pointerId",
52517
+ "name": "gesture",
52134
52518
  "type": {
52135
- "text": "number"
52519
+ "text": "PointerMovementGesture & { readonly kind: 'pan' }"
52136
52520
  }
52137
52521
  },
52138
52522
  {
@@ -52142,9 +52526,9 @@
52142
52526
  }
52143
52527
  },
52144
52528
  {
52145
- "name": "gesture",
52529
+ "name": "proposal",
52146
52530
  "type": {
52147
- "text": "PointerMovementGesture"
52531
+ "text": "ViewportPanUpdateProposal"
52148
52532
  }
52149
52533
  }
52150
52534
  ]
@@ -52602,90 +52986,276 @@
52602
52986
  "reflects": true
52603
52987
  },
52604
52988
  {
52605
- "kind": "field",
52606
- "name": "targetSpacing",
52607
- "type": {
52608
- "text": "number",
52609
- "_sourceAliases": [],
52610
- "values": [
52611
- {
52612
- "value": "number",
52613
- "description": ""
52614
- }
52615
- ]
52616
- },
52617
- "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
52618
- "attribute": "target-spacing",
52619
- "reflects": true
52620
- }
52621
- ],
52622
- "attributes": [
52989
+ "kind": "field",
52990
+ "name": "targetSpacing",
52991
+ "type": {
52992
+ "text": "number",
52993
+ "_sourceAliases": [],
52994
+ "values": [
52995
+ {
52996
+ "value": "number",
52997
+ "description": ""
52998
+ }
52999
+ ]
53000
+ },
53001
+ "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
53002
+ "attribute": "target-spacing",
53003
+ "reflects": true
53004
+ }
53005
+ ],
53006
+ "attributes": [
53007
+ {
53008
+ "name": "step",
53009
+ "type": {
53010
+ "text": "number",
53011
+ "_sourceAliases": [],
53012
+ "values": [
53013
+ {
53014
+ "value": "number",
53015
+ "description": ""
53016
+ }
53017
+ ]
53018
+ },
53019
+ "description": "Smallest gridline interval in content-space units.",
53020
+ "fieldName": "step"
53021
+ },
53022
+ {
53023
+ "name": "origin-x",
53024
+ "type": {
53025
+ "text": "number",
53026
+ "_sourceAliases": [],
53027
+ "values": [
53028
+ {
53029
+ "value": "number",
53030
+ "description": ""
53031
+ }
53032
+ ]
53033
+ },
53034
+ "description": "Content-space x coordinate of the grid origin.",
53035
+ "fieldName": "originX"
53036
+ },
53037
+ {
53038
+ "name": "origin-y",
53039
+ "type": {
53040
+ "text": "number",
53041
+ "_sourceAliases": [],
53042
+ "values": [
53043
+ {
53044
+ "value": "number",
53045
+ "description": ""
53046
+ }
53047
+ ]
53048
+ },
53049
+ "description": "Content-space y coordinate of the grid origin.",
53050
+ "fieldName": "originY"
53051
+ },
53052
+ {
53053
+ "name": "target-spacing",
53054
+ "type": {
53055
+ "text": "number",
53056
+ "_sourceAliases": [],
53057
+ "values": [
53058
+ {
53059
+ "value": "number",
53060
+ "description": ""
53061
+ }
53062
+ ]
53063
+ },
53064
+ "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
53065
+ "fieldName": "targetSpacing"
53066
+ }
53067
+ ],
53068
+ "superclass": {
53069
+ "name": "LitElement",
53070
+ "package": "lit"
53071
+ },
53072
+ "tagName": "nve-viewport-gridlines",
53073
+ "customElement": true,
53074
+ "metadata": {
53075
+ "unitTests": true,
53076
+ "apiReview": true,
53077
+ "performance": true,
53078
+ "stable": true,
53079
+ "vqa": true,
53080
+ "responsive": true,
53081
+ "themes": true,
53082
+ "aria": "#",
53083
+ "entrypoint": "@nvidia-elements/core/viewport",
53084
+ "example": "",
53085
+ "package": true,
53086
+ "documentation": "https://nvidia.github.io/elements/docs/elements/viewport/",
53087
+ "since": "0.0.0",
53088
+ "status": "beta",
53089
+ "behavior": "content",
53090
+ "markdown": "## nve-viewport-gridlines\n\nRenders origin-stable, zoom-adaptive gridlines behind viewport content.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| originX (origin-x) | `number` | Content-space x coordinate of the grid origin. |\n| originY (origin-y) | `number` | Content-space y coordinate of the grid origin. |\n| step | `number` | Smallest gridline interval in content-space units. |\n| targetSpacing (target-spacing) | `number` | Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --color | `string` | Sets the gridline stroke color. [MDN](https://mdn.dev/CSS/color) |\n| --line-width | `string` | Sets the approximate stroke width in CSS pixels. |"
53091
+ }
53092
+ }
53093
+ ],
53094
+ "exports": [
53095
+ {
53096
+ "kind": "js",
53097
+ "name": "ViewportGridlines",
53098
+ "declaration": {
53099
+ "name": "ViewportGridlines",
53100
+ "module": "/src/viewport/viewport-gridlines.js"
53101
+ }
53102
+ }
53103
+ ]
53104
+ },
53105
+ {
53106
+ "kind": "javascript-module",
53107
+ "path": "/src/viewport/viewport-gridlines.utils.js",
53108
+ "declarations": [
53109
+ {
53110
+ "kind": "function",
53111
+ "name": "selectGridlineInterval",
53112
+ "return": {
53113
+ "type": {
53114
+ "text": "number"
53115
+ }
53116
+ },
53117
+ "parameters": [
53118
+ {
53119
+ "name": "options",
53120
+ "type": {
53121
+ "text": "GridlineIntervalOptions",
53122
+ "_sourceAliases": []
53123
+ }
53124
+ }
53125
+ ]
53126
+ },
53127
+ {
53128
+ "kind": "function",
53129
+ "name": "createGridlineCoverage",
53130
+ "return": {
53131
+ "type": {
53132
+ "text": "ViewportRect"
53133
+ }
53134
+ },
53135
+ "parameters": [
53136
+ {
53137
+ "name": "visible",
53138
+ "type": {
53139
+ "text": "ViewportRect",
53140
+ "_sourceAliases": []
53141
+ }
53142
+ }
53143
+ ]
53144
+ },
53145
+ {
53146
+ "kind": "function",
53147
+ "name": "gridlineCoverageNeedsUpdate",
53148
+ "return": {
53149
+ "type": {
53150
+ "text": "boolean"
53151
+ }
53152
+ },
53153
+ "parameters": [
53154
+ {
53155
+ "name": "coverage",
53156
+ "type": {
53157
+ "text": "ViewportRect | undefined",
53158
+ "_sourceAliases": []
53159
+ }
53160
+ },
53161
+ {
53162
+ "name": "visible",
53163
+ "type": {
53164
+ "text": "ViewportRect",
53165
+ "_sourceAliases": []
53166
+ }
53167
+ }
53168
+ ]
53169
+ }
53170
+ ],
53171
+ "exports": [
53172
+ {
53173
+ "kind": "js",
53174
+ "name": "selectGridlineInterval",
53175
+ "declaration": {
53176
+ "name": "selectGridlineInterval",
53177
+ "module": "/src/viewport/viewport-gridlines.utils.js"
53178
+ }
53179
+ },
53180
+ {
53181
+ "kind": "js",
53182
+ "name": "createGridlineCoverage",
53183
+ "declaration": {
53184
+ "name": "createGridlineCoverage",
53185
+ "module": "/src/viewport/viewport-gridlines.utils.js"
53186
+ }
53187
+ },
53188
+ {
53189
+ "kind": "js",
53190
+ "name": "gridlineCoverageNeedsUpdate",
53191
+ "declaration": {
53192
+ "name": "gridlineCoverageNeedsUpdate",
53193
+ "module": "/src/viewport/viewport-gridlines.utils.js"
53194
+ }
53195
+ }
53196
+ ]
53197
+ },
53198
+ {
53199
+ "kind": "javascript-module",
53200
+ "path": "/src/viewport/viewport-minimap.js",
53201
+ "declarations": [
53202
+ {
53203
+ "kind": "class",
53204
+ "description": "Provides a simplified overview and direct navigation for its parent viewport.",
53205
+ "name": "ViewportMinimap",
53206
+ "cssProperties": [
53207
+ {
53208
+ "description": "Color of the surface behind preview geometry. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)",
53209
+ "name": "--background"
53210
+ },
53211
+ {
53212
+ "description": "Color of automatically drawn root rectangles. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)",
53213
+ "name": "--color"
53214
+ },
53215
+ {
53216
+ "description": "Color of the current visible-region indicator.",
53217
+ "name": "--indicator-color"
53218
+ },
52623
53219
  {
52624
- "name": "step",
52625
- "type": {
52626
- "text": "number",
52627
- "_sourceAliases": [],
52628
- "values": [
52629
- {
52630
- "value": "number",
52631
- "description": ""
52632
- }
52633
- ]
52634
- },
52635
- "description": "Smallest gridline interval in content-space units.",
52636
- "fieldName": "step"
53220
+ "description": "Corner radius of the minimap. [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)",
53221
+ "name": "--border-radius"
52637
53222
  },
52638
53223
  {
52639
- "name": "origin-x",
52640
- "type": {
52641
- "text": "number",
52642
- "_sourceAliases": [],
52643
- "values": [
52644
- {
52645
- "value": "number",
52646
- "description": ""
52647
- }
52648
- ]
52649
- },
52650
- "description": "Content-space x coordinate of the grid origin.",
52651
- "fieldName": "originX"
53224
+ "description": "Cursor for clicking the background to center the viewport.",
53225
+ "name": "--recenter-cursor"
52652
53226
  },
52653
53227
  {
52654
- "name": "origin-y",
52655
- "type": {
52656
- "text": "number",
52657
- "_sourceAliases": [],
52658
- "values": [
52659
- {
52660
- "value": "number",
52661
- "description": ""
52662
- }
52663
- ]
52664
- },
52665
- "description": "Content-space y coordinate of the grid origin.",
52666
- "fieldName": "originY"
53228
+ "description": "Cursor over a draggable visible region.",
53229
+ "name": "--pan-cursor"
52667
53230
  },
52668
53231
  {
52669
- "name": "target-spacing",
52670
- "type": {
52671
- "text": "number",
52672
- "_sourceAliases": [],
52673
- "values": [
52674
- {
52675
- "value": "number",
52676
- "description": ""
52677
- }
52678
- ]
53232
+ "description": "Cursor during a visible-region drag.",
53233
+ "name": "--panning-cursor"
53234
+ }
53235
+ ],
53236
+ "slots": [
53237
+ {
53238
+ "description": "Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles.",
53239
+ "name": "preview"
53240
+ }
53241
+ ],
53242
+ "members": [
53243
+ {
53244
+ "kind": "method",
53245
+ "name": "refresh",
53246
+ "return": {
53247
+ "type": {
53248
+ "text": "void"
53249
+ }
52679
53250
  },
52680
- "description": "Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels.",
52681
- "fieldName": "targetSpacing"
53251
+ "description": "Remeasures content bounds after preview or viewport roots move without resizing."
52682
53252
  }
52683
53253
  ],
52684
53254
  "superclass": {
52685
53255
  "name": "LitElement",
52686
53256
  "package": "lit"
52687
53257
  },
52688
- "tagName": "nve-viewport-gridlines",
53258
+ "tagName": "nve-viewport-minimap",
52689
53259
  "customElement": true,
52690
53260
  "metadata": {
52691
53261
  "unitTests": true,
@@ -52703,38 +53273,38 @@
52703
53273
  "since": "0.0.0",
52704
53274
  "status": "beta",
52705
53275
  "behavior": "content",
52706
- "markdown": "## nve-viewport-gridlines\n\nRenders origin-stable, zoom-adaptive gridlines behind viewport content.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| originX (origin-x) | `number` | Content-space x coordinate of the grid origin. |\n| originY (origin-y) | `number` | Content-space y coordinate of the grid origin. |\n| step | `number` | Smallest gridline interval in content-space units. |\n| targetSpacing (target-spacing) | `number` | Target on-screen separation used to choose the adaptive gridline interval, in CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --color | `string` | Sets the gridline stroke color. [MDN](https://mdn.dev/CSS/color) |\n| --line-width | `string` | Sets the approximate stroke width in CSS pixels. |"
53276
+ "markdown": "## nve-viewport-minimap\n\nProvides a simplified overview and direct navigation for its parent viewport.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| preview | `string` | Optional simplified content drawn in viewport content coordinates. Replaces automatic root rectangles. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| refresh | `refresh(): void` | Remeasures content bounds after preview or viewport roots move without resizing. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | Color of the surface behind preview geometry. [MDN](https://mdn.dev/CSS/background) |\n| --border-radius | `string` | Corner radius of the minimap. [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | Color of automatically drawn root rectangles. [MDN](https://mdn.dev/CSS/color) |\n| --indicator-color | `string` | Color of the current visible-region indicator. |\n| --pan-cursor | `string` | Cursor over a draggable visible region. |\n| --panning-cursor | `string` | Cursor during a visible-region drag. |\n| --recenter-cursor | `string` | Cursor for clicking the background to center the viewport. |"
52707
53277
  }
52708
53278
  }
52709
53279
  ],
52710
53280
  "exports": [
52711
53281
  {
52712
53282
  "kind": "js",
52713
- "name": "ViewportGridlines",
53283
+ "name": "ViewportMinimap",
52714
53284
  "declaration": {
52715
- "name": "ViewportGridlines",
52716
- "module": "/src/viewport/viewport-gridlines.js"
53285
+ "name": "ViewportMinimap",
53286
+ "module": "/src/viewport/viewport-minimap.js"
52717
53287
  }
52718
53288
  }
52719
53289
  ]
52720
53290
  },
52721
53291
  {
52722
53292
  "kind": "javascript-module",
52723
- "path": "/src/viewport/viewport-gridlines.utils.js",
53293
+ "path": "/src/viewport/viewport-minimap.utils.js",
52724
53294
  "declarations": [
52725
53295
  {
52726
53296
  "kind": "function",
52727
- "name": "selectGridlineInterval",
53297
+ "name": "hasPositiveFiniteRect",
52728
53298
  "return": {
52729
53299
  "type": {
52730
- "text": "number"
53300
+ "text": "boolean"
52731
53301
  }
52732
53302
  },
52733
53303
  "parameters": [
52734
53304
  {
52735
- "name": "options",
53305
+ "name": "rect",
52736
53306
  "type": {
52737
- "text": "GridlineIntervalOptions",
53307
+ "text": "ViewportRect",
52738
53308
  "_sourceAliases": []
52739
53309
  }
52740
53310
  }
@@ -52742,42 +53312,81 @@
52742
53312
  },
52743
53313
  {
52744
53314
  "kind": "function",
52745
- "name": "createGridlineCoverage",
53315
+ "name": "createViewportMinimapProjection",
52746
53316
  "return": {
52747
53317
  "type": {
52748
- "text": "ViewportRect"
53318
+ "text": "ViewportMinimapProjection | undefined"
52749
53319
  }
52750
53320
  },
52751
53321
  "parameters": [
53322
+ {
53323
+ "name": "content",
53324
+ "type": {
53325
+ "text": "readonly ViewportRect[]",
53326
+ "_sourceAliases": []
53327
+ }
53328
+ },
52752
53329
  {
52753
53330
  "name": "visible",
52754
53331
  "type": {
52755
53332
  "text": "ViewportRect",
52756
53333
  "_sourceAliases": []
52757
53334
  }
53335
+ },
53336
+ {
53337
+ "name": "size",
53338
+ "type": {
53339
+ "text": "{ readonly width: number; readonly height: number }",
53340
+ "_sourceAliases": []
53341
+ }
52758
53342
  }
52759
53343
  ]
52760
53344
  },
52761
53345
  {
52762
53346
  "kind": "function",
52763
- "name": "gridlineCoverageNeedsUpdate",
53347
+ "name": "projectViewportMinimapRect",
52764
53348
  "return": {
52765
53349
  "type": {
52766
- "text": "boolean"
53350
+ "text": "ViewportRect"
52767
53351
  }
52768
53352
  },
52769
53353
  "parameters": [
52770
53354
  {
52771
- "name": "coverage",
53355
+ "name": "rect",
52772
53356
  "type": {
52773
- "text": "ViewportRect | undefined",
53357
+ "text": "ViewportRect",
52774
53358
  "_sourceAliases": []
52775
53359
  }
52776
53360
  },
52777
53361
  {
52778
- "name": "visible",
53362
+ "name": "projection",
52779
53363
  "type": {
52780
- "text": "ViewportRect",
53364
+ "text": "ViewportMinimapProjection",
53365
+ "_sourceAliases": []
53366
+ }
53367
+ }
53368
+ ]
53369
+ },
53370
+ {
53371
+ "kind": "function",
53372
+ "name": "unprojectViewportMinimapPoint",
53373
+ "return": {
53374
+ "type": {
53375
+ "text": "ViewportPoint"
53376
+ }
53377
+ },
53378
+ "parameters": [
53379
+ {
53380
+ "name": "point",
53381
+ "type": {
53382
+ "text": "ViewportPoint",
53383
+ "_sourceAliases": []
53384
+ }
53385
+ },
53386
+ {
53387
+ "name": "projection",
53388
+ "type": {
53389
+ "text": "ViewportMinimapProjection",
52781
53390
  "_sourceAliases": []
52782
53391
  }
52783
53392
  }
@@ -52787,26 +53396,34 @@
52787
53396
  "exports": [
52788
53397
  {
52789
53398
  "kind": "js",
52790
- "name": "selectGridlineInterval",
53399
+ "name": "hasPositiveFiniteRect",
52791
53400
  "declaration": {
52792
- "name": "selectGridlineInterval",
52793
- "module": "/src/viewport/viewport-gridlines.utils.js"
53401
+ "name": "hasPositiveFiniteRect",
53402
+ "module": "/src/viewport/viewport-minimap.utils.js"
52794
53403
  }
52795
53404
  },
52796
53405
  {
52797
53406
  "kind": "js",
52798
- "name": "createGridlineCoverage",
53407
+ "name": "createViewportMinimapProjection",
52799
53408
  "declaration": {
52800
- "name": "createGridlineCoverage",
52801
- "module": "/src/viewport/viewport-gridlines.utils.js"
53409
+ "name": "createViewportMinimapProjection",
53410
+ "module": "/src/viewport/viewport-minimap.utils.js"
52802
53411
  }
52803
53412
  },
52804
53413
  {
52805
53414
  "kind": "js",
52806
- "name": "gridlineCoverageNeedsUpdate",
53415
+ "name": "projectViewportMinimapRect",
52807
53416
  "declaration": {
52808
- "name": "gridlineCoverageNeedsUpdate",
52809
- "module": "/src/viewport/viewport-gridlines.utils.js"
53417
+ "name": "projectViewportMinimapRect",
53418
+ "module": "/src/viewport/viewport-minimap.utils.js"
53419
+ }
53420
+ },
53421
+ {
53422
+ "kind": "js",
53423
+ "name": "unprojectViewportMinimapPoint",
53424
+ "declaration": {
53425
+ "name": "unprojectViewportMinimapPoint",
53426
+ "module": "/src/viewport/viewport-minimap.utils.js"
52810
53427
  }
52811
53428
  }
52812
53429
  ]
@@ -52817,7 +53434,7 @@
52817
53434
  "declarations": [
52818
53435
  {
52819
53436
  "kind": "class",
52820
- "description": "Coordinates the viewport's opt-in keyboard and Invoker navigation behavior.",
53437
+ "description": "",
52821
53438
  "name": "ViewportNavigationController",
52822
53439
  "members": [
52823
53440
  {
@@ -53015,10 +53632,6 @@
53015
53632
  {
53016
53633
  "kind": "variable",
53017
53634
  "name": "next"
53018
- },
53019
- {
53020
- "kind": "variable",
53021
- "name": "start"
53022
53635
  }
53023
53636
  ],
53024
53637
  "exports": [
@@ -53200,6 +53813,10 @@
53200
53813
  {
53201
53814
  "description": "Custom content rendered behind viewport content and excluded from content fitting",
53202
53815
  "name": "background"
53816
+ },
53817
+ {
53818
+ "description": "Interactive content fixed above the transformed plane and excluded from content fitting",
53819
+ "name": "overlay"
53203
53820
  }
53204
53821
  ],
53205
53822
  "members": [
@@ -53330,6 +53947,46 @@
53330
53947
  "attribute": "behavior-zoom",
53331
53948
  "reflects": true
53332
53949
  },
53950
+ {
53951
+ "kind": "field",
53952
+ "name": "pannable",
53953
+ "type": {
53954
+ "text": "boolean",
53955
+ "_sourceAliases": [],
53956
+ "values": [
53957
+ {
53958
+ "value": "true",
53959
+ "description": ""
53960
+ },
53961
+ {
53962
+ "value": "false",
53963
+ "description": ""
53964
+ }
53965
+ ]
53966
+ },
53967
+ "description": "Whether the viewport may admit new user-input panning.",
53968
+ "readonly": true
53969
+ },
53970
+ {
53971
+ "kind": "field",
53972
+ "name": "zoomable",
53973
+ "type": {
53974
+ "text": "boolean",
53975
+ "_sourceAliases": [],
53976
+ "values": [
53977
+ {
53978
+ "value": "true",
53979
+ "description": ""
53980
+ },
53981
+ {
53982
+ "value": "false",
53983
+ "description": ""
53984
+ }
53985
+ ]
53986
+ },
53987
+ "description": "Whether the viewport may admit new user-input zooming.",
53988
+ "readonly": true
53989
+ },
53333
53990
  {
53334
53991
  "kind": "field",
53335
53992
  "name": "autoFit",
@@ -53454,6 +54111,67 @@
53454
54111
  },
53455
54112
  "description": "Returns the visible content-space rectangle."
53456
54113
  },
54114
+ {
54115
+ "kind": "method",
54116
+ "name": "requestPan",
54117
+ "return": {
54118
+ "type": {
54119
+ "text": "boolean"
54120
+ }
54121
+ },
54122
+ "parameters": [
54123
+ {
54124
+ "name": "proposal",
54125
+ "type": {
54126
+ "text": "ViewportPanProposal"
54127
+ }
54128
+ }
54129
+ ],
54130
+ "description": "Requests one discrete user-originated pan. When pannable, the viewport dispatches\na cancelable `pan` and applies the default transform if no listener cancels the event.\nReturns true only when that default changes the transform."
54131
+ },
54132
+ {
54133
+ "kind": "method",
54134
+ "name": "requestZoom",
54135
+ "return": {
54136
+ "type": {
54137
+ "text": "boolean"
54138
+ }
54139
+ },
54140
+ "parameters": [
54141
+ {
54142
+ "name": "proposal",
54143
+ "type": {
54144
+ "text": "ViewportZoomProposal"
54145
+ }
54146
+ },
54147
+ {
54148
+ "name": "options",
54149
+ "default": "{}",
54150
+ "type": {
54151
+ "text": "ViewportZoomRequestOptions"
54152
+ }
54153
+ }
54154
+ ],
54155
+ "description": "Requests one discrete user-originated zoom. When zoomable, the viewport dispatches\na cancelable `zoom` and applies the default transform if no listener cancels the event.\nSet `options.animated` to animate the uncanceled default; the option is absent from the `zoom` detail.\nReturns true when the default changes or schedules a change to the transform."
54156
+ },
54157
+ {
54158
+ "kind": "method",
54159
+ "name": "startPan",
54160
+ "return": {
54161
+ "type": {
54162
+ "text": "ViewportPanSession | undefined"
54163
+ }
54164
+ },
54165
+ "parameters": [
54166
+ {
54167
+ "name": "proposal",
54168
+ "type": {
54169
+ "text": "ViewportPanProposal"
54170
+ }
54171
+ }
54172
+ ],
54173
+ "description": "Starts a sustained semantic pan after the caller crosses its activation threshold.\nDispatches `panstart`, performs the initial `pan` update, and returns a session for later updates\nand one terminal `panend`. Returns undefined when pannable is false."
54174
+ },
53457
54175
  {
53458
54176
  "kind": "method",
53459
54177
  "name": "animateTo",
@@ -53525,6 +54243,13 @@
53525
54243
  }
53526
54244
  ],
53527
54245
  "events": [
54246
+ {
54247
+ "name": "capabilitieschange",
54248
+ "type": {
54249
+ "text": "Event"
54250
+ },
54251
+ "description": "Dispatched after effective user-input pan or zoom admission changes."
54252
+ },
53528
54253
  {
53529
54254
  "name": "viewportchange",
53530
54255
  "type": {
@@ -53539,19 +54264,19 @@
53539
54264
  }
53540
54265
  },
53541
54266
  {
53542
- "description": "Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence.",
54267
+ "description": "Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session.",
53543
54268
  "name": "panstart"
53544
54269
  },
53545
54270
  {
53546
- "description": "Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation.",
54271
+ "description": "Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation.",
53547
54272
  "name": "pan"
53548
54273
  },
53549
54274
  {
53550
- "description": "Dispatched when a pointer pan ends, including its terminal reason.",
54275
+ "description": "Dispatched once when a sustained pan ends, including its terminal reason.",
53551
54276
  "name": "panend"
53552
54277
  },
53553
54278
  {
53554
- "description": "Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation.",
54279
+ "description": "Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation.",
53555
54280
  "name": "zoom"
53556
54281
  }
53557
54282
  ],
@@ -53739,13 +54464,13 @@
53739
54464
  "themes": true,
53740
54465
  "aria": "#",
53741
54466
  "entrypoint": "@nvidia-elements/core/viewport",
53742
- "example": "<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n <nve-viewport-gridlines></nve-viewport-gridlines>\n <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"710\" height=\"410\" viewBox=\"0 0 710 410\" style=\"position: absolute; left: 0; top: 0\">\n <circle cx=\"100\" cy=\"300\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n <rect x=\"250\" y=\"0\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n <path d=\"M 600 190 L 710 300 L 600 410 L 490 300 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n </svg>\n</nve-viewport>",
54467
+ "example": "<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n <nve-viewport-gridlines></nve-viewport-gridlines>\n <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"900\" height=\"600\" viewBox=\"0 0 900 600\" style=\"position: absolute; left: 0; top: 0\">\n <circle cx=\"200\" cy=\"400\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n <rect x=\"350\" y=\"100\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n <path d=\"M 700 290 L 810 400 L 700 510 L 590 400 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n <rect x=\"1\" y=\"1\" width=\"898\" height=\"598\" rx=\"24\" fill=\"none\" stroke=\"var(--nve-ref-border-color-emphasis)\" stroke-width=\"2\" stroke-dasharray=\"32 20\" vector-effect=\"non-scaling-stroke\"></rect>\n </svg>\n <nve-viewport-minimap></nve-viewport-minimap>\n</nve-viewport>",
53743
54468
  "package": true,
53744
54469
  "documentation": "https://nvidia.github.io/elements/docs/elements/viewport/",
53745
54470
  "since": "0.0.0",
53746
54471
  "status": "beta",
53747
54472
  "behavior": "content",
53748
- "markdown": "## nve-viewport\n\nA viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.\n\n### Example\n\n```html\n<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n <nve-viewport-gridlines></nve-viewport-gridlines>\n <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"710\" height=\"410\" viewBox=\"0 0 710 410\" style=\"position: absolute; left: 0; top: 0\">\n <circle cx=\"100\" cy=\"300\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n <rect x=\"250\" y=\"0\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n <path d=\"M 600 190 L 710 300 L 600 410 L 490 300 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n </svg>\n</nve-viewport>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Content positioned in the viewport's infinite content space. |\n| background | `string` | Custom content rendered behind viewport content and excluded from content fitting |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| autoFit | `boolean` | Fits measurable direct default-slot content once after initial layout. |\n| behaviorPan (behavior-pan) | `boolean \\| 'space'` | Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. |\n| behaviorZoom (behavior-zoom) | `boolean` | Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. |\n| dragThreshold (drag-threshold) | `number` | CSS-pixel pointer movement required before a pointer pan begins. |\n| fitInset (fit-inset) | `number` | Default uniform CSS-pixel inset reserved around bounds when fitting content. |\n| maxScale (max-scale) | `number` | Inclusive upper scale limit. |\n| minScale (min-scale) | `number` | Inclusive lower scale limit. |\n| scale | `number` | Content-to-viewport CSS-pixel scale. |\n| x | `number` | Horizontal content-space coordinate at the viewport origin. |\n| y | `number` | Vertical content-space coordinate at the viewport origin. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| pan | `CustomEvent` | Dispatched when pointer, wheel, keyboard, or command input requests a pan. Cancel to skip the proposed transform mutation. |\n| panend | `CustomEvent` | Dispatched when a pointer pan ends, including its terminal reason. |\n| panstart | `CustomEvent` | Dispatched when pointer movement crosses the pan threshold. Cancel to disable built-in pointer panning for the sequence. |\n| type | `CustomEvent` | |\n| viewportchange | `CustomEvent` | Dispatched once after a render that commits one or more viewport transform changes. |\n| zoom | `CustomEvent` | Dispatched when wheel, pinch, or command input requests a scale change. Cancel to skip the proposed transform mutation. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --pan-down | `CommandEvent` | With behavior-pan enabled, pans down by one discrete step. |\n| --pan-left | `CommandEvent` | With behavior-pan enabled, pans left by one discrete step. |\n| --pan-right | `CommandEvent` | With behavior-pan enabled, pans right by one discrete step. |\n| --pan-up | `CommandEvent` | With behavior-pan enabled, pans up by one discrete step. |\n| --zoom-in | `CommandEvent` | With behavior-zoom enabled, animates to the next permitted scale step. |\n| --zoom-out | `CommandEvent` | With behavior-zoom enabled, animates to the previous permitted scale step. |\n| --zoom-reset | `CommandEvent` | With behavior-zoom enabled, animates to 100% scale. |\n| --zoom-to-fit | `CommandEvent` | With behavior-zoom enabled, animates to fit direct default-slot element boxes. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| animateTo | `animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void` | Animates the viewport to the requested partial transform. |\n| fitContents | `fitContents(options?: ViewportRevealOptions): void` | Fits the union of direct default-slot element boxes within the viewport. |\n| getTransform | `getTransform(): ViewportTransform` | Returns the current content-space origin and CSS-pixel scale. |\n| getVisibleRect | `getVisibleRect(): ViewportRect` | Returns the visible content-space rectangle. |\n| reveal | `reveal(region: { x: number; y: number; width?: number; height?: number }, options?: ViewportRevealOptions): void` | Centers or fits a content-space region within the viewport. |\n| toContentCoords | `toContentCoords(viewportX: number, viewportY: number): ViewportPoint` | Converts a viewport CSS-pixel point to content space. |\n| toViewportCoords | `toViewportCoords(contentX: number, contentY: number): ViewportPoint` | Converts a content-space point to viewport CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | Background color of the fixed viewport area. [MDN](https://mdn.dev/CSS/background) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --pan-cursor | `string` | Cursor shown over a background eligible for primary-pointer panning. |\n| --panning-cursor | `string` | Cursor shown while a pointer pan is active. |"
54473
+ "markdown": "## nve-viewport\n\nA viewport provides a spatial surface for arbitrary content, with optional pan and zoom navigation.\n\n### Example\n\n```html\n<nve-viewport autofit fit-inset=\"24\" behavior-pan behavior-zoom style=\"height: 420px\">\n <nve-viewport-gridlines></nve-viewport-gridlines>\n <svg role=\"img\" aria-label=\"Three geometric forms in a spatial field\" width=\"900\" height=\"600\" viewBox=\"0 0 900 600\" style=\"position: absolute; left: 0; top: 0\">\n <circle cx=\"200\" cy=\"400\" r=\"100\" fill=\"var(--nve-ref-color-green-jade-600)\"></circle>\n <rect x=\"350\" y=\"100\" width=\"200\" height=\"200\" rx=\"50\" fill=\"var(--nve-ref-color-blue-cobalt-600)\"></rect>\n <path d=\"M 700 290 L 810 400 L 700 510 L 590 400 Z\" fill=\"var(--nve-ref-color-purple-lavender-600)\"></path>\n <rect x=\"1\" y=\"1\" width=\"898\" height=\"598\" rx=\"24\" fill=\"none\" stroke=\"var(--nve-ref-border-color-emphasis)\" stroke-width=\"2\" stroke-dasharray=\"32 20\" vector-effect=\"non-scaling-stroke\"></rect>\n </svg>\n <nve-viewport-minimap></nve-viewport-minimap>\n</nve-viewport>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/viewport/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Content positioned in the viewport's infinite content space. |\n| background | `string` | Custom content rendered behind viewport content and excluded from content fitting |\n| overlay | `string` | Interactive content fixed above the transformed plane and excluded from content fitting |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| autoFit | `boolean` | Fits measurable direct default-slot content once after initial layout. |\n| behaviorPan (behavior-pan) | `boolean \\| 'space'` | Enables panning by pointer, focused wheel, focused keyboard, and Invoker commands; requires Space for primary-pointer dragging when set to space. |\n| behaviorZoom (behavior-zoom) | `boolean` | Enables zooming by pinch, focused modified wheel, focused keyboard, and Invoker commands. |\n| dragThreshold (drag-threshold) | `number` | CSS-pixel pointer movement required before a pointer pan begins. |\n| fitInset (fit-inset) | `number` | Default uniform CSS-pixel inset reserved around bounds when fitting content. |\n| maxScale (max-scale) | `number` | Inclusive upper scale limit. |\n| minScale (min-scale) | `number` | Inclusive lower scale limit. |\n| pannable | `boolean` | Whether the viewport may admit new user-input panning. |\n| scale | `number` | Content-to-viewport CSS-pixel scale. |\n| x | `number` | Horizontal content-space coordinate at the viewport origin. |\n| y | `number` | Vertical content-space coordinate at the viewport origin. |\n| zoomable | `boolean` | Whether the viewport may admit new user-input zooming. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| capabilitieschange | `CustomEvent` | Dispatched after effective user-input pan or zoom admission changes. |\n| pan | `CustomEvent` | Dispatched for admitted user pan proposals. Cancel to skip the proposed transform mutation. |\n| panend | `CustomEvent` | Dispatched once when a sustained pan ends, including its terminal reason. |\n| panstart | `CustomEvent` | Dispatched when a sustained pointer or control pan begins. Cancel to suppress the default for its session. |\n| type | `CustomEvent` | |\n| viewportchange | `CustomEvent` | Dispatched once after a render that commits one or more viewport transform changes. |\n| zoom | `CustomEvent` | Dispatched for admitted user zoom proposals. Cancel to skip the proposed transform mutation. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --pan-down | `CommandEvent` | With behavior-pan enabled, pans down by one discrete step. |\n| --pan-left | `CommandEvent` | With behavior-pan enabled, pans left by one discrete step. |\n| --pan-right | `CommandEvent` | With behavior-pan enabled, pans right by one discrete step. |\n| --pan-up | `CommandEvent` | With behavior-pan enabled, pans up by one discrete step. |\n| --zoom-in | `CommandEvent` | With behavior-zoom enabled, animates to the next permitted scale step. |\n| --zoom-out | `CommandEvent` | With behavior-zoom enabled, animates to the previous permitted scale step. |\n| --zoom-reset | `CommandEvent` | With behavior-zoom enabled, animates to 100% scale. |\n| --zoom-to-fit | `CommandEvent` | With behavior-zoom enabled, animates to fit direct default-slot element boxes. |\n\n### Methods\n\n| method | signatures | description |\n| ------ | ---------- | ----------- |\n| animateTo | `animateTo(target: Partial<ViewportTransform>, options?: ViewportAnimationOptions): void` | Animates the viewport to the requested partial transform. |\n| fitContents | `fitContents(options?: ViewportRevealOptions): void` | Fits the union of direct default-slot element boxes within the viewport. |\n| getTransform | `getTransform(): ViewportTransform` | Returns the current content-space origin and CSS-pixel scale. |\n| getVisibleRect | `getVisibleRect(): ViewportRect` | Returns the visible content-space rectangle. |\n| requestPan | `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. |\n| requestZoom | `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. |\n| reveal | `reveal(region: { x: number; y: number; width?: number; height?: number }, options?: ViewportRevealOptions): void` | Centers or fits a content-space region within the viewport. |\n| startPan | `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. |\n| toContentCoords | `toContentCoords(viewportX: number, viewportY: number): ViewportPoint` | Converts a viewport CSS-pixel point to content space. |\n| toViewportCoords | `toViewportCoords(contentX: number, contentY: number): ViewportPoint` | Converts a content-space point to viewport CSS pixels. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | Background color of the fixed viewport area. [MDN](https://mdn.dev/CSS/background) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --pan-cursor | `string` | Cursor shown over a background eligible for primary-pointer panning. |\n| --panning-cursor | `string` | Cursor shown while a pointer pan is active. |"
53749
54474
  },
53750
54475
  "commands": [
53751
54476
  {
@@ -53781,6 +54506,14 @@
53781
54506
  "description": "With behavior-zoom enabled, animates to fit direct default-slot element boxes."
53782
54507
  }
53783
54508
  ]
54509
+ },
54510
+ {
54511
+ "kind": "variable",
54512
+ "name": "next"
54513
+ },
54514
+ {
54515
+ "kind": "variable",
54516
+ "name": "source"
53784
54517
  }
53785
54518
  ],
53786
54519
  "exports": [