@nvidia-elements/core 2.1.6 → 2.2.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 (190) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/dist/accordion/accordion.d.ts +7 -5
  3. package/dist/accordion/accordion2.js +4 -4
  4. package/dist/accordion/accordion2.js.map +1 -1
  5. package/dist/alert/alert-group2.js +1 -1
  6. package/dist/alert/alert2.js +1 -1
  7. package/dist/avatar/avatar-group.d.ts +1 -1
  8. package/dist/avatar/avatar-group2.js +1 -1
  9. package/dist/avatar/avatar-group2.js.map +1 -1
  10. package/dist/avatar/avatar.d.ts +1 -1
  11. package/dist/avatar/avatar2.js +1 -1
  12. package/dist/avatar/avatar2.js.map +1 -1
  13. package/dist/badge/badge.d.ts +1 -1
  14. package/dist/badge/badge2.js +1 -1
  15. package/dist/badge/badge2.js.map +1 -1
  16. package/dist/breadcrumb/breadcrumb2.js +1 -1
  17. package/dist/bundles/index.d.ts +81 -45
  18. package/dist/bundles/index.js +2 -2
  19. package/dist/button/button2.js +1 -1
  20. package/dist/button-group/button-group2.js +1 -1
  21. package/dist/card/card.d.ts +3 -1
  22. package/dist/card/card2.js +4 -4
  23. package/dist/card/card2.js.map +1 -1
  24. package/dist/chat-message/chat-message.d.ts +3 -1
  25. package/dist/chat-message/chat-message2.js +1 -1
  26. package/dist/chat-message/chat-message2.js.map +1 -1
  27. package/dist/checkbox/checkbox-group2.js +1 -1
  28. package/dist/checkbox/checkbox2.js +1 -1
  29. package/dist/color/color2.js +1 -1
  30. package/dist/combobox/combobox2.js +1 -1
  31. package/dist/copy-button/copy-button.d.ts +1 -1
  32. package/dist/copy-button/copy-button2.js +1 -1
  33. package/dist/copy-button/copy-button2.js.map +1 -1
  34. package/dist/custom-elements-jsx.d.ts +1340 -982
  35. package/dist/custom-elements-vue.d.ts +1048 -859
  36. package/dist/custom-elements.json +1382 -1948
  37. package/dist/data.html.json +330 -510
  38. package/dist/date/date2.js +1 -1
  39. package/dist/datetime/datetime2.js +1 -1
  40. package/dist/dialog/dialog-footer2.js +1 -1
  41. package/dist/dialog/dialog-header2.js +1 -1
  42. package/dist/dialog/dialog.d.ts +1 -1
  43. package/dist/dialog/dialog2.js +1 -1
  44. package/dist/dialog/dialog2.js.map +1 -1
  45. package/dist/divider/divider2.js +1 -1
  46. package/dist/dot/dot2.js +1 -1
  47. package/dist/drawer/drawer-content2.js +1 -1
  48. package/dist/drawer/drawer-footer2.js +1 -1
  49. package/dist/drawer/drawer-header2.js +1 -1
  50. package/dist/drawer/drawer.d.ts +1 -1
  51. package/dist/drawer/drawer2.js +1 -1
  52. package/dist/drawer/drawer2.js.map +1 -1
  53. package/dist/dropdown/dropdown-footer2.js +1 -1
  54. package/dist/dropdown/dropdown-header2.js +1 -1
  55. package/dist/dropdown/dropdown.d.ts +1 -0
  56. package/dist/dropdown/dropdown2.js +1 -1
  57. package/dist/dropdown/dropdown2.js.map +1 -1
  58. package/dist/dropdown-group/dropdown-group.d.ts +1 -2
  59. package/dist/dropdown-group/dropdown-group.js +1 -1
  60. package/dist/dropdown-group/dropdown-group.js.map +1 -1
  61. package/dist/dropzone/dropzone.d.ts +6 -3
  62. package/dist/dropzone/dropzone2.js +1 -1
  63. package/dist/dropzone/dropzone2.js.map +1 -1
  64. package/dist/file/file2.js +1 -1
  65. package/dist/format-datetime/format-datetime2.js +1 -1
  66. package/dist/format-number/format-number.d.ts +1 -1
  67. package/dist/format-number/format-number2.js +1 -1
  68. package/dist/format-number/format-number2.js.map +1 -1
  69. package/dist/format-relative-time/format-relative-time2.js +1 -1
  70. package/dist/forms/control/control2.js +1 -1
  71. package/dist/forms/control-group/control-group2.js +1 -1
  72. package/dist/forms/control-message/control-message.d.ts +2 -1
  73. package/dist/forms/control-message/control-message2.js +1 -1
  74. package/dist/forms/control-message/control-message2.js.map +1 -1
  75. package/dist/gauge/gauge2.js +1 -1
  76. package/dist/grid/cell/cell.d.ts +1 -1
  77. package/dist/grid/cell/cell2.js +1 -1
  78. package/dist/grid/cell/cell2.js.map +1 -1
  79. package/dist/grid/column/column.d.ts +1 -1
  80. package/dist/grid/column/column2.js +1 -1
  81. package/dist/grid/column/column2.js.map +1 -1
  82. package/dist/grid/footer/footer.d.ts +2 -1
  83. package/dist/grid/footer/footer2.js +1 -1
  84. package/dist/grid/footer/footer2.js.map +1 -1
  85. package/dist/grid/grid.d.ts +1 -1
  86. package/dist/grid/grid2.js +1 -1
  87. package/dist/grid/grid2.js.map +1 -1
  88. package/dist/grid/header/header2.js +1 -1
  89. package/dist/grid/placeholder/placeholder.d.ts +1 -1
  90. package/dist/grid/placeholder/placeholder2.js +1 -1
  91. package/dist/grid/placeholder/placeholder2.js.map +1 -1
  92. package/dist/grid/row/row2.js +1 -1
  93. package/dist/icon/icon2.js +2 -2
  94. package/dist/icon-button/icon-button2.js +1 -1
  95. package/dist/index.js +1 -1
  96. package/dist/input/input-group2.js +1 -1
  97. package/dist/input/input2.js +1 -1
  98. package/dist/internal/services/global.service.js +1 -1
  99. package/dist/internal/services/i18n.service.d.ts +14 -0
  100. package/dist/internal/services/i18n.service.js +15 -1
  101. package/dist/internal/services/i18n.service.js.map +1 -1
  102. package/dist/internal/types/index.d.ts +3 -3
  103. package/dist/internal/types/index.js.map +1 -1
  104. package/dist/logo/logo.d.ts +1 -1
  105. package/dist/logo/logo2.js +1 -1
  106. package/dist/logo/logo2.js.map +1 -1
  107. package/dist/menu/menu-item.d.ts +2 -1
  108. package/dist/menu/menu-item2.js +1 -1
  109. package/dist/menu/menu-item2.js.map +1 -1
  110. package/dist/menu/menu2.js +1 -1
  111. package/dist/month/month2.js +1 -1
  112. package/dist/notification/notification-group2.js +1 -1
  113. package/dist/notification/notification.d.ts +1 -1
  114. package/dist/notification/notification2.js +1 -1
  115. package/dist/notification/notification2.js.map +1 -1
  116. package/dist/page/page-panel/page-panel-content2.js +1 -1
  117. package/dist/page/page-panel/page-panel-footer.d.ts +1 -0
  118. package/dist/page/page-panel/page-panel-footer2.js +1 -1
  119. package/dist/page/page-panel/page-panel-footer2.js.map +1 -1
  120. package/dist/page/page-panel/page-panel-header.d.ts +1 -0
  121. package/dist/page/page-panel/page-panel-header2.js +1 -1
  122. package/dist/page/page-panel/page-panel-header2.js.map +1 -1
  123. package/dist/page/page-panel/page-panel.d.ts +1 -1
  124. package/dist/page/page-panel/page-panel2.js +1 -1
  125. package/dist/page/page-panel/page-panel2.js.map +1 -1
  126. package/dist/page/page2.js +1 -1
  127. package/dist/page-header/page-header2.js +1 -1
  128. package/dist/page-loader/page-loader.d.ts +1 -1
  129. package/dist/page-loader/page-loader2.js +1 -1
  130. package/dist/page-loader/page-loader2.js.map +1 -1
  131. package/dist/pagination/pagination.d.ts +4 -3
  132. package/dist/pagination/pagination2.js +5 -2
  133. package/dist/pagination/pagination2.js.map +1 -1
  134. package/dist/panel/panel2.js +4 -4
  135. package/dist/password/password2.js +1 -1
  136. package/dist/preferences-input/preferences-input.d.ts +2 -0
  137. package/dist/preferences-input/preferences-input2.js +1 -1
  138. package/dist/preferences-input/preferences-input2.js.map +1 -1
  139. package/dist/progress-bar/progress-bar2.js +1 -1
  140. package/dist/progress-ring/progress-ring2.js +1 -1
  141. package/dist/progressive-filter-chip/progressive-filter-chip.d.ts +1 -1
  142. package/dist/progressive-filter-chip/progressive-filter-chip2.js +1 -1
  143. package/dist/progressive-filter-chip/progressive-filter-chip2.js.map +1 -1
  144. package/dist/pulse/pulse2.js +1 -1
  145. package/dist/radio/radio-group2.js +1 -1
  146. package/dist/radio/radio2.js +1 -1
  147. package/dist/range/range2.js +1 -1
  148. package/dist/resize-handle/resize-handle2.js +1 -1
  149. package/dist/search/search2.js +1 -1
  150. package/dist/select/select2.js +1 -1
  151. package/dist/skeleton/skeleton.d.ts +2 -2
  152. package/dist/skeleton/skeleton2.js +1 -1
  153. package/dist/skeleton/skeleton2.js.map +1 -1
  154. package/dist/sort-button/sort-button2.js +1 -1
  155. package/dist/sparkline/sparkline2.js +1 -1
  156. package/dist/star-rating/star-rating2.js +1 -1
  157. package/dist/steps/steps.d.ts +1 -1
  158. package/dist/steps/steps2.js +2 -2
  159. package/dist/steps/steps2.js.map +1 -1
  160. package/dist/switch/switch-group2.js +1 -1
  161. package/dist/switch/switch2.js +1 -1
  162. package/dist/tabs/tabs-group2.js +1 -1
  163. package/dist/tabs/tabs.d.ts +1 -1
  164. package/dist/tabs/tabs2.js +2 -2
  165. package/dist/tabs/tabs2.js.map +1 -1
  166. package/dist/tag/tag.d.ts +1 -1
  167. package/dist/tag/tag2.js +1 -1
  168. package/dist/tag/tag2.js.map +1 -1
  169. package/dist/textarea/textarea2.js +1 -1
  170. package/dist/time/time2.js +1 -1
  171. package/dist/toast/toast.d.ts +1 -1
  172. package/dist/toast/toast2.js +1 -1
  173. package/dist/toast/toast2.js.map +1 -1
  174. package/dist/toggletip/toggletip-footer2.js +1 -1
  175. package/dist/toggletip/toggletip-header2.js +1 -1
  176. package/dist/toggletip/toggletip.d.ts +1 -0
  177. package/dist/toggletip/toggletip2.js +1 -1
  178. package/dist/toggletip/toggletip2.js.map +1 -1
  179. package/dist/toolbar/toolbar.d.ts +1 -1
  180. package/dist/toolbar/toolbar2.js +1 -1
  181. package/dist/toolbar/toolbar2.js.map +1 -1
  182. package/dist/tooltip/tooltip.d.ts +2 -1
  183. package/dist/tooltip/tooltip2.js +1 -1
  184. package/dist/tooltip/tooltip2.js.map +1 -1
  185. package/dist/tree/tree-node.d.ts +3 -0
  186. package/dist/tree/tree-node2.js +1 -1
  187. package/dist/tree/tree-node2.js.map +1 -1
  188. package/dist/tree/tree2.js +1 -1
  189. package/dist/week/week2.js +1 -1
  190. package/package.json +5 -5
@@ -116,6 +116,20 @@ export interface I18nStrings {
116
116
  browseFiles: string;
117
117
  maxFileSize: string;
118
118
  create: string;
119
+ currentTime: string;
120
+ enterFullscreen: string;
121
+ exitFullscreen: string;
122
+ muteMedia: string;
123
+ pauseMedia: string;
124
+ playMedia: string;
125
+ playbackRate: string;
126
+ playbackRateOption: string;
127
+ seekBackward: string;
128
+ seekForward: string;
129
+ seekToEnd: string;
130
+ seekToStart: string;
131
+ unmuteMedia: string;
132
+ volume: string;
119
133
  }
120
134
  export interface IconSVG {
121
135
  svg: () => Promise<string> | string;
@@ -862,15 +876,15 @@ export interface ButtonFormControlMixinInstance {
862
876
  */
863
877
  expanded: boolean;
864
878
  /**
865
- * Like input readonly, sets a button semantically as visual treatment only.
879
+ * Indicates whether the element is a noninteractive visual treatment instead of a button.
866
880
  * https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/readonly
867
881
  * @attr readonly
868
882
  * @reflect
869
883
  */
870
884
  readOnly: boolean;
871
885
  /**
872
- * Like input form, sets a button to submit a form outside its parent form.
873
- * Returns a reference to the form element if available.
886
+ * Associates the button with a form. Set the property to a form element or its ID. The HTML attribute accepts only
887
+ * the form ID. Reading the property returns the associated form element or `null`.
874
888
  * https://developer.mozilla.org/en-US/docs/Web/API/ElementInternals/form
875
889
  * @attr form
876
890
  */
@@ -1064,7 +1078,7 @@ export declare class IconButton extends Button {
1064
1078
  * @documentation https://nvidia.github.io/elements/docs/elements/accordion/
1065
1079
  * @since 0.12.0
1066
1080
  * @entrypoint \@nvidia-elements/core/accordion
1067
- * @slot - default content slot
1081
+ * @slot - Heading text and supporting content that labels the accordion section.
1068
1082
  * @slot prefix - slot for prefix content
1069
1083
  * @slot suffix - slot for suffix content
1070
1084
  * @cssprop --cursor
@@ -1079,6 +1093,7 @@ export declare class AccordionHeader extends LitElement {
1079
1093
  /** @private */
1080
1094
  _internals: ElementInternals;
1081
1095
  render(): TemplateResult<1>;
1096
+ /** @private */
1082
1097
  slot: string;
1083
1098
  connectedCallback(): void;
1084
1099
  }
@@ -1109,14 +1124,13 @@ export declare class AccordionContent extends LitElement {
1109
1124
  * @command --open - use to open the accordion
1110
1125
  * @command --close - use to close the accordion
1111
1126
  * @command --toggle - use to toggle the accordion
1112
- * @slot - This is a default/unnamed slot for accordion content
1127
+ * @slot - Content displayed in the collapsible region, typically an `nve-accordion-content` element.
1113
1128
  * @slot icon-button - icon elements to display for expand/collapse
1114
1129
  * @slot header - header element (Use `accordion-header` or custom content)
1115
- * @slot content - content element (Use `accordion-content` or custom content)
1116
1130
  * @cssprop --background
1117
1131
  * @cssprop --color
1118
1132
  * @cssprop --border-radius
1119
- * @cssprop --header-padding
1133
+ * @cssprop --header-padding - Padding around the header content.
1120
1134
  * @cssprop --cursor
1121
1135
  * @cssprop --transition
1122
1136
  * @csspart icon-button - The toggle icon button element
@@ -1183,7 +1197,9 @@ export declare class AccordionGroup extends LitElement {
1183
1197
  * Determines whether the accordion should opt-in to stateful expansion of a single accordion at a time
1184
1198
  */
1185
1199
  behaviorExpandSingle: boolean;
1186
- /** flat (Borderless, container-less accordions), full (default), or inset (Rounded corner, contained accordion) */
1200
+ /**
1201
+ * Controls the container style applied to child accordions. `flat` removes the visual container, `inset` adds rounded containment, and omission uses the default divided presentation.
1202
+ */
1187
1203
  container?: Extract<Container, "flat" | "inset">;
1188
1204
  static readonly metadata: {
1189
1205
  tag: string;
@@ -1294,7 +1310,7 @@ export declare class AlertGroup extends LitElement {
1294
1310
  * @documentation https://nvidia.github.io/elements/docs/elements/avatar/
1295
1311
  * @since 1.20.0
1296
1312
  * @entrypoint \@nvidia-elements/core/avatar
1297
- * @slot - default slot for content
1313
+ * @slot - Initials, an image, or other content that identifies the represented user or bot.
1298
1314
  * @cssprop --background
1299
1315
  * @cssprop --color
1300
1316
  * @cssprop --border-radius
@@ -1323,7 +1339,7 @@ export declare class Avatar extends LitElement {
1323
1339
  * @description An avatar group displays a collection of user avatars in a compact and organized layout, showcasing many participants or contributors in a space-efficient way.
1324
1340
  * @since 1.20.0
1325
1341
  * @entrypoint \@nvidia-elements/core/avatar
1326
- * @slot - default slot for content
1342
+ * @slot - `nve-avatar` elements that represent the group members.
1327
1343
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/alert/
1328
1344
  *
1329
1345
  */
@@ -1344,7 +1360,7 @@ export declare class AvatarGroup extends LitElement {
1344
1360
  * @documentation https://nvidia.github.io/elements/docs/elements/badge/
1345
1361
  * @since 0.11.0
1346
1362
  * @entrypoint \@nvidia-elements/core/badge
1347
- * @slot - default slot for content
1363
+ * @slot - Short text that communicates the badge status.
1348
1364
  * @slot prefix-icon - slot for prefix icon
1349
1365
  * @slot suffix-icon - slot for suffix icon
1350
1366
  * @cssprop --background
@@ -1510,7 +1526,7 @@ export declare class Card extends LitElement implements ContainerElement {
1510
1526
  * @documentation https://nvidia.github.io/elements/docs/elements/card/
1511
1527
  * @since 0.1.3
1512
1528
  * @entrypoint \@nvidia-elements/core/card
1513
- * @slot - default slot
1529
+ * @slot - Card title, supporting text, and optional action controls.
1514
1530
  * @cssprop --padding
1515
1531
  * @cssprop --border-bottom
1516
1532
  * @cssprop --line-height
@@ -1524,6 +1540,7 @@ export declare class CardHeader extends LitElement {
1524
1540
  version: string;
1525
1541
  parents: string[];
1526
1542
  };
1543
+ /** @private */
1527
1544
  slot: string;
1528
1545
  render(): TemplateResult<1>;
1529
1546
  }
@@ -1564,6 +1581,7 @@ export declare class CardFooter extends LitElement {
1564
1581
  version: string;
1565
1582
  parents: string[];
1566
1583
  };
1584
+ /** @private */
1567
1585
  slot: string;
1568
1586
  render(): TemplateResult<1>;
1569
1587
  }
@@ -1573,7 +1591,7 @@ export declare class CardFooter extends LitElement {
1573
1591
  * @documentation https://nvidia.github.io/elements/docs/elements/chat-message/
1574
1592
  * @since 1.25.0
1575
1593
  * @entrypoint \@nvidia-elements/core/chat-message
1576
- * @slot - default slot for content
1594
+ * @slot - The message body displayed between the prefix and suffix content.
1577
1595
  * @slot prefix - for avatar/img content
1578
1596
  * @slot suffix - for avatar/img content
1579
1597
  * @cssprop --background
@@ -1593,8 +1611,10 @@ export declare class ChatMessage extends LitElement {
1593
1611
  tag: string;
1594
1612
  version: string;
1595
1613
  };
1614
+ /** Applies a transparent background and reduced horizontal padding for embedding the message in another container. */
1596
1615
  container: "flat";
1597
1616
  color: Color;
1617
+ /** Removes the border radius from the selected message corner to indicate the speaker direction. */
1598
1618
  arrowPosition: "top-start" | "top-end" | "bottom-start" | "bottom-end";
1599
1619
  render(): TemplateResult<1>;
1600
1620
  connectedCallback(): void;
@@ -1700,7 +1720,7 @@ export type ValidityStateError = "badInput" | "customError" | "patternMismatch"
1700
1720
  * @documentation https://nvidia.github.io/elements/docs/elements/control/
1701
1721
  * @since 0.3.0
1702
1722
  * @entrypoint \@nvidia-elements/core/forms
1703
- * @slot - default slot for content
1723
+ * @slot - Validation or supporting message text for the associated control.
1704
1724
  * @cssprop --color
1705
1725
  * @cssprop --font-weight
1706
1726
  * @cssprop --font-size
@@ -1726,6 +1746,7 @@ export declare class ControlMessage extends LitElement {
1726
1746
  static elementDefinitions: {
1727
1747
  [Icon.metadata.tag]: typeof Icon;
1728
1748
  };
1749
+ /** @private */
1729
1750
  slot: string;
1730
1751
  render(): TemplateResult<1>;
1731
1752
  }
@@ -1842,7 +1863,7 @@ declare const MenuItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
1842
1863
  * @documentation https://nvidia.github.io/elements/docs/elements/menu/
1843
1864
  * @since 0.11.0
1844
1865
  * @entrypoint \@nvidia-elements/core/menu
1845
- * @slot - default slot for content
1866
+ * @slot - Label and supporting content for the menu option.
1846
1867
  * @slot suffix - slot for suffix icon
1847
1868
  * @cssprop --background
1848
1869
  * @cssprop --border-radius
@@ -1863,6 +1884,7 @@ declare const MenuItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
1863
1884
  */
1864
1885
  export declare class MenuItem extends MenuItem_base {
1865
1886
  static styles: CSSResult[];
1887
+ /** Applies danger styling to destructive or high-risk menu actions. */
1866
1888
  status: "danger";
1867
1889
  static readonly metadata: {
1868
1890
  tag: string;
@@ -1947,6 +1969,7 @@ export declare class Dropdown extends LitElement {
1947
1969
  modal: boolean;
1948
1970
  /** @private */
1949
1971
  popoverType: PopoverType;
1972
+ /** @private */
1950
1973
  popoverArrow: HTMLElement;
1951
1974
  protected typeNativePopoverController: TypeNativePopoverController<Dropdown>;
1952
1975
  /** @private */
@@ -2009,7 +2032,7 @@ declare const Tag_base: ButtonFormControlMixinReturn<typeof LitElement>;
2009
2032
  * @documentation https://nvidia.github.io/elements/docs/elements/tag/
2010
2033
  * @since 0.10.0
2011
2034
  * @entrypoint \@nvidia-elements/core/tag
2012
- * @slot - default slot for content
2035
+ * @slot - Text or other content that identifies the category or group.
2013
2036
  * @cssprop --background
2014
2037
  * @cssprop --color
2015
2038
  * @cssprop --gap
@@ -2127,7 +2150,7 @@ export declare class Combobox extends Control implements ContainerElement {
2127
2150
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
2128
2151
  * @event open - Dispatched when the toast opens.
2129
2152
  * @event close - Dispatched when the toast closes.
2130
- * @slot - default content slot
2153
+ * @slot - The message communicated by the toast.
2131
2154
  * @slot prefix - custom status icon slot
2132
2155
  * @cssprop --padding
2133
2156
  * @cssprop --justify-content
@@ -2219,7 +2242,7 @@ export declare class Toast extends LitElement {
2219
2242
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
2220
2243
  * @event open - Dispatched when the tooltip opens.
2221
2244
  * @event close - Dispatched when the tooltip closes.
2222
- * @slot - default content slot
2245
+ * @slot - Noninteractive text or other descriptive content shown in the tooltip.
2223
2246
  * @cssprop --border-radius
2224
2247
  * @cssprop --background
2225
2248
  * @cssprop --color
@@ -2273,6 +2296,7 @@ export declare class Tooltip extends LitElement {
2273
2296
  * @deprecated Use interest-delay-start css property instead
2274
2297
  */
2275
2298
  openDelay: number;
2299
+ /** @private */
2276
2300
  popoverArrow: HTMLElement;
2277
2301
  /** @private */
2278
2302
  readonly popoverType: PopoverType;
@@ -2288,7 +2312,7 @@ export declare class Tooltip extends LitElement {
2288
2312
  * @documentation https://nvidia.github.io/elements/docs/elements/copy-button/
2289
2313
  * @since 1.1.4
2290
2314
  * @entrypoint \@nvidia-elements/core/copy-button
2291
- * @slot - default
2315
+ * @slot - Text label displayed before the copy icon.
2292
2316
  * @slot icon - slot for custom icon
2293
2317
  * @cssprop --color
2294
2318
  * @cssprop --background
@@ -2423,7 +2447,7 @@ export declare class Datetime extends Control implements ContainerElement {
2423
2447
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
2424
2448
  * @event open - Dispatched when the dialog opens.
2425
2449
  * @event close - Dispatched when the dialog closes.
2426
- * @slot - default content slot
2450
+ * @slot - Dialog body content displayed between the header and footer.
2427
2451
  * @cssprop --border
2428
2452
  * @cssprop --border-radius
2429
2453
  * @cssprop --background
@@ -2619,7 +2643,7 @@ export declare class Dot extends LitElement {
2619
2643
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
2620
2644
  * @event open - Dispatched when the drawer opens.
2621
2645
  * @event close - Dispatched when the drawer closes.
2622
- * @slot - default content slot
2646
+ * @slot - Drawer body content displayed between the header and footer.
2623
2647
  * @cssprop --border
2624
2648
  * @cssprop --background
2625
2649
  * @cssprop --color
@@ -2771,8 +2795,6 @@ export declare class DrawerHeader extends LitElement {
2771
2795
  * @slot - default slot for dropdown content
2772
2796
  * @event open - Dispatched when a dropdown in the group opens
2773
2797
  * @event close - Dispatched when a dropdown in the group closes
2774
- * @cssprop --nve-dropdown-group-spacing
2775
- * @cssprop --nve-dropdown-group-transition
2776
2798
  * @cssprop --arrow-transform - Transform applied to the popover arrow
2777
2799
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/menubar/
2778
2800
  */
@@ -2788,6 +2810,7 @@ export declare class DropdownGroup extends LitElement {
2788
2810
  render(): TemplateResult<1>;
2789
2811
  connectedCallback(): void;
2790
2812
  disconnectedCallback(): void;
2813
+ /** Closes every descendant dropdown in the group. */
2791
2814
  close(): void;
2792
2815
  }
2793
2816
  declare function fileTypeValidator(value: unknown, element: unknown): ValidatorResult;
@@ -2798,22 +2821,24 @@ declare const Dropzone_base: FormControlMixinReturn<typeof LitElement, File[]>;
2798
2821
  * @documentation https://nvidia.github.io/elements/docs/elements/dropzone/
2799
2822
  * @since 1.29.0
2800
2823
  * @entrypoint \@nvidia-elements/core/dropzone
2824
+ * @property {File[]} value - Files selected or dropped by the user. Assign files through the JavaScript property; the HTML `value` attribute is not supported.
2801
2825
  * @event change - Dispatched when the value has changed (files located in event.target)
2802
- * @slot - use only when custom messaging requires it
2826
+ * @slot - Custom messaging that replaces the default upload instructions.
2803
2827
  * @cssprop --background
2804
2828
  * @cssprop --border-color
2805
2829
  * @cssprop --border-radius
2806
2830
  * @cssprop --padding
2807
2831
  * @cssprop --min-height
2808
2832
  * @cssprop --color
2809
- * @slot icon - default slot for icon
2810
- * @slot content - default slot for content
2833
+ * @slot icon - Custom icon that replaces the default upload icon.
2811
2834
  * @csspart icon - The upload icon element
2812
2835
  * @aria https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file
2813
2836
  */
2814
2837
  export declare class Dropzone extends Dropzone_base {
2815
2838
  #private;
2839
+ /** Comma-separated file extensions or MIME types accepted by the dropzone. */
2816
2840
  accept: string;
2841
+ /** File size limit in bytes. */
2817
2842
  maxFileSize: number;
2818
2843
  /**
2819
2844
  * Enables internal string values to update for internationalization.
@@ -2848,6 +2873,7 @@ export declare class Dropzone extends Dropzone_base {
2848
2873
  static elementDefinitions: {
2849
2874
  [Icon.metadata.tag]: typeof Icon;
2850
2875
  };
2876
+ /** @protected */
2851
2877
  formResetCallback(): void;
2852
2878
  constructor();
2853
2879
  connectedCallback(): void;
@@ -3028,7 +3054,7 @@ export declare class FormatNumber extends LitElement {
3028
3054
  /**
3029
3055
  * Grouping separators: 'auto' | 'always' | 'min2' | 'true' | 'false'.
3030
3056
  */
3031
- useGrouping?: string;
3057
+ useGrouping?: "auto" | "always" | "min2" | "true" | "false" | boolean;
3032
3058
  /**
3033
3059
  * Pad fraction output to at least this many digits (0-20).
3034
3060
  */
@@ -3147,7 +3173,7 @@ export declare class Gauge extends LitElement {
3147
3173
  * @documentation https://nvidia.github.io/elements/docs/elements/data-grid/
3148
3174
  * @since 0.11.0
3149
3175
  * @entrypoint \@nvidia-elements/core/grid
3150
- * @slot - default slot for content
3176
+ * @slot - Column heading text or controls.
3151
3177
  * @slot actions - slot for column actions
3152
3178
  * @cssprop --color
3153
3179
  * @cssprop --padding
@@ -3257,7 +3283,7 @@ export declare class GridRow extends LitElement {
3257
3283
  * @documentation https://nvidia.github.io/elements/docs/elements/data-grid/
3258
3284
  * @since 0.11.0
3259
3285
  * @entrypoint \@nvidia-elements/core/grid
3260
- * @slot - default slot for content
3286
+ * @slot - Data or interactive controls displayed within the cell.
3261
3287
  * @cssprop --background
3262
3288
  * @cssprop --color
3263
3289
  * @cssprop --padding
@@ -3288,7 +3314,7 @@ export declare class GridCell extends LitElement {
3288
3314
  * @documentation https://nvidia.github.io/elements/docs/elements/data-grid/
3289
3315
  * @since 0.11.0
3290
3316
  * @entrypoint \@nvidia-elements/core/grid
3291
- * @slot - default slot for content
3317
+ * @slot - `nve-grid-header`, `nve-grid-row`, and `nve-grid-placeholder` elements.
3292
3318
  * @slot footer - slot for grid-footer or toolbar
3293
3319
  * @cssprop --background
3294
3320
  * @cssprop --color
@@ -3338,7 +3364,7 @@ export declare class Grid extends LitElement implements ContainerElement {
3338
3364
  * @since 0.11.0
3339
3365
  * @entrypoint \@nvidia-elements/core/grid
3340
3366
  * @description Grid footer displays contextual information or user actions such as pagination.
3341
- * @slot - default slot for content
3367
+ * @slot - Grid summary, pagination, or other footer controls.
3342
3368
  * @cssprop --background
3343
3369
  * @cssprop --color
3344
3370
  * @cssprop --padding
@@ -3354,6 +3380,7 @@ export declare class GridFooter extends LitElement {
3354
3380
  static elementDefinitions: {};
3355
3381
  /** @private */
3356
3382
  _internals: ElementInternals;
3383
+ /** @private */
3357
3384
  slot: string;
3358
3385
  render(): TemplateResult<1>;
3359
3386
  connectedCallback(): void;
@@ -3363,7 +3390,7 @@ export declare class GridFooter extends LitElement {
3363
3390
  * @since 0.11.0
3364
3391
  * @entrypoint \@nvidia-elements/core/grid
3365
3392
  * @description Placeholder displays a message while data loads for the grid or shows empty states for datasets.
3366
- * @slot - default slot for content
3393
+ * @slot - Loading or empty-state message displayed in place of grid rows.
3367
3394
  * @cssprop --color
3368
3395
  * @cssprop --padding
3369
3396
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/grid/
@@ -3446,7 +3473,7 @@ export declare class InputGroup extends ControlGroup {
3446
3473
  * @documentation https://nvidia.github.io/elements/docs/elements/logo/
3447
3474
  * @since 0.10.0
3448
3475
  * @entrypoint \@nvidia-elements/core/logo
3449
- * @slot - default slot for content
3476
+ * @slot - Text, an image, or other visual content representing the brand or application.
3450
3477
  * @cssprop --background
3451
3478
  * @cssprop --gap
3452
3479
  * @cssprop --color
@@ -3517,7 +3544,7 @@ export declare class Month extends Control implements ContainerElement {
3517
3544
  * @event toggle - Dispatched on a popover element just after showing or hiding. [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/toggle_event)
3518
3545
  * @event open - Dispatched when the notification opens.
3519
3546
  * @event close - Dispatched when the notification closes.
3520
- * @slot - default content slot
3547
+ * @slot - The message communicated by the notification.
3521
3548
  * @slot icon - content slot for the status icon
3522
3549
  * @cssprop --border-radius
3523
3550
  * @cssprop --background
@@ -3698,7 +3725,7 @@ export declare class Page extends LitElement {
3698
3725
  * @since 1.15.0
3699
3726
  * @event open - Dispatched after an invoker command removes `hidden` and opens the panel.
3700
3727
  * @event close - Dispatched after an invoker command sets `hidden` and closes the panel.
3701
- * @slot - default content slot
3728
+ * @slot - `nve-page-panel-content` elements that provide the panel body.
3702
3729
  * @slot actions - slot for action / dismiss buttons
3703
3730
  * @command --open - Removes `hidden` and dispatches `open`.
3704
3731
  * @command --close - Sets `hidden` and dispatches `close`.
@@ -3781,6 +3808,7 @@ export declare class PagePanelFooter extends LitElement {
3781
3808
  tag: string;
3782
3809
  version: string;
3783
3810
  };
3811
+ /** @private */
3784
3812
  slot: string;
3785
3813
  render(): TemplateResult<1>;
3786
3814
  }
@@ -3803,6 +3831,7 @@ export declare class PagePanelHeader extends LitElement {
3803
3831
  tag: string;
3804
3832
  version: string;
3805
3833
  };
3834
+ /** @private */
3806
3835
  slot: string;
3807
3836
  render(): TemplateResult<1>;
3808
3837
  }
@@ -3887,7 +3916,7 @@ export declare class ProgressRing extends LitElement {
3887
3916
  * @documentation https://nvidia.github.io/elements/docs/elements/page-loader/
3888
3917
  * @since 0.19.0
3889
3918
  * @entrypoint \@nvidia-elements/core/page-loader
3890
- * @slot - default slot for content
3919
+ * @slot - Loading status text displayed with the progress indicator.
3891
3920
  * @cssprop --gap
3892
3921
  * @cssprop --animation-duration - Duration of page loader open/close animations
3893
3922
  * @csspart progress-ring - The progress ring element
@@ -3988,8 +4017,8 @@ declare const Pagination_base: FormControlMixinReturn<typeof LitElement, number>
3988
4017
  * @event change - Dispatched when the value (page) has changed
3989
4018
  * @event first-page - Dispatched when the first page is active
3990
4019
  * @event last-page - Dispatched when the last page is active
3991
- * @slot - default slot for content
3992
- * @slot suffix-label - slot for overriding the "n of total" label when total is an approximation
4020
+ * @event step-change - Dispatched after the page size changes with the current page size in `detail`. The event bubbles and crosses shadow boundaries.
4021
+ * @slot suffix-label - Overrides the "of total" label when the total is an approximation.
3993
4022
  * @cssprop --background
3994
4023
  * @cssprop --font-size
3995
4024
  * @cssprop --width
@@ -4001,6 +4030,7 @@ declare const Pagination_base: FormControlMixinReturn<typeof LitElement, number>
4001
4030
  * @csspart select - The page size select element
4002
4031
  * @aria https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/
4003
4032
  * @property {number} value - value the current page number
4033
+ * @attribute {string} step-sizes - A JSON-serialized array of page-size options available in the selector.
4004
4034
  */
4005
4035
  export declare class Pagination extends Pagination_base {
4006
4036
  #private;
@@ -4009,7 +4039,7 @@ export declare class Pagination extends Pagination_base {
4009
4039
  */
4010
4040
  step: number;
4011
4041
  /**
4012
- * The array of custom step-size.
4042
+ * Page-size options available in the selector.
4013
4043
  */
4014
4044
  stepSizes: number[];
4015
4045
  /**
@@ -4268,6 +4298,8 @@ declare const PreferencesInput_base: FormControlMixinReturn<typeof LitElement, P
4268
4298
  * @documentation https://nvidia.github.io/elements/docs/elements/preferences-input/
4269
4299
  * @since 1.23.7
4270
4300
  * @entrypoint \@nvidia-elements/core/preferences-input
4301
+ * @property {PreferencesInputValue} value - Contains the current color scheme, scale, and reduced motion preferences. Assign an object through JavaScript or provide its JSON serialization in the HTML `value` attribute.
4302
+ * @attribute {string} value - JSON object parsed as `PreferencesInputValue`.
4271
4303
  * @event input - Dispatched when the value has changed
4272
4304
  * @event change - Dispatched when the value has changed
4273
4305
  * @cssprop --color
@@ -4357,7 +4389,7 @@ export declare class ProgressBar extends LitElement {
4357
4389
  * @documentation https://nvidia.github.io/elements/docs/elements/progressive-filter-chip/
4358
4390
  * @since 0.16.0
4359
4391
  * @entrypoint \@nvidia-elements/core/progressive-filter-chip
4360
- * @slot - default slot for content
4392
+ * @slot - `input`, `select`, `nve-button`, or other `[nve-control]` elements used to build the filter.
4361
4393
  * @event close - Dispatched when the filter chip closes.
4362
4394
  * @cssprop --gap
4363
4395
  * @cssprop --border-radius
@@ -4600,7 +4632,7 @@ export declare class Search extends Control implements ContainerElement {
4600
4632
  * @documentation https://nvidia.github.io/elements/docs/elements/skeleton/
4601
4633
  * @since 1.44.0
4602
4634
  * @entrypoint \@nvidia-elements/core/skeleton
4603
- * @slot - default content slot
4635
+ * @slot - Loaded content that replaces the placeholder when provided.
4604
4636
  * @cssprop --background
4605
4637
  * @cssprop --border-radius
4606
4638
  * @cssprop --min-height
@@ -4617,7 +4649,7 @@ export declare class Skeleton extends LitElement {
4617
4649
  effect: "shimmer" | "pulse";
4618
4650
  /** Geometry of the placeholder — rounded corners or a full pill outline. */
4619
4651
  shape: "round" | "pill";
4620
- /** Whether the skeleton hides its content */
4652
+ /** Hides the skeleton host when `true` and sets `aria-busy` to the inverse visibility state. */
4621
4653
  hidden: boolean;
4622
4654
  /** @private */
4623
4655
  _internals: ElementInternals;
@@ -4787,7 +4819,7 @@ export declare class StepsItem extends StepsItem_base {
4787
4819
  */
4788
4820
  selected: boolean;
4789
4821
  /**
4790
- * Four visual treatments represent the `status` of tasks. When `status` has a value of `warning`, `success`, or `danger`, the component embeds appropriate icons.
4822
+ * Controls the step status. `accent` has no default status icon, `danger` displays an alert icon, `success` displays a check icon, and `pending` displays a progress indicator. Omit the property to display the step number.
4791
4823
  */
4792
4824
  status?: "accent" | "danger" | "success" | "pending";
4793
4825
  /**
@@ -4857,7 +4889,7 @@ declare const TabsItem_base: ButtonFormControlMixinReturn<typeof LitElement>;
4857
4889
  * @documentation https://nvidia.github.io/elements/docs/elements/tabs/
4858
4890
  * @since 0.10.0
4859
4891
  * @entrypoint \@nvidia-elements/core/tabs
4860
- * @slot - default slot for content
4892
+ * @slot - The label displayed for the tab.
4861
4893
  * @cssprop --font-size
4862
4894
  * @cssprop --width
4863
4895
  * @cssprop --padding
@@ -5117,6 +5149,7 @@ export declare class Toggletip extends LitElement {
5117
5149
  * Determines if the component renders an arrow.
5118
5150
  */
5119
5151
  arrow: boolean;
5152
+ /** @private */
5120
5153
  popoverArrow: HTMLElement;
5121
5154
  /** @private */
5122
5155
  readonly popoverType: PopoverType;
@@ -5182,7 +5215,7 @@ export declare class ToggletipHeader extends LitElement {
5182
5215
  * @documentation https://nvidia.github.io/elements/docs/elements/toolbar/
5183
5216
  * @since 0.19.0
5184
5217
  * @entrypoint \@nvidia-elements/core/toolbar
5185
- * @slot - default slot for content
5218
+ * @slot - Primary buttons, inputs, and other toolbar controls.
5186
5219
  * @slot prefix - slot for prefix content
5187
5220
  * @slot suffix - slot for suffix content
5188
5221
  * @cssprop --background
@@ -5297,8 +5330,11 @@ export declare class TreeNode extends LitElement {
5297
5330
  * Returns list of child nodes
5298
5331
  */
5299
5332
  readonly nodes: TreeNode[];
5333
+ /** @private */
5300
5334
  indeterminate: boolean;
5335
+ /** @private */
5301
5336
  behaviorExpand: boolean;
5337
+ /** @private */
5302
5338
  behaviorSelect: boolean;
5303
5339
  static metadata: {
5304
5340
  tag: string;