@nvidia-elements/core 0.0.3 → 0.0.5

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 (216) hide show
  1. package/CHANGELOG.md +20 -17
  2. package/NOTICE.md +119 -0
  3. package/dist/accordion/accordion2.js +4 -4
  4. package/dist/alert/alert-group2.js +1 -1
  5. package/dist/alert/alert.examples.js.map +1 -1
  6. package/dist/alert/alert.examples.json +1 -1
  7. package/dist/alert/alert2.js +1 -1
  8. package/dist/alert/define.js +1 -2
  9. package/dist/alert/define.js.map +1 -1
  10. package/dist/alert/index.d.ts +0 -1
  11. package/dist/alert/index.js +1 -2
  12. package/dist/avatar/avatar-group2.js +1 -1
  13. package/dist/avatar/avatar2.js +1 -1
  14. package/dist/badge/badge2.js +1 -1
  15. package/dist/breadcrumb/breadcrumb2.js +1 -1
  16. package/dist/bundle.d.ts +2 -0
  17. package/dist/bundles/index.d.ts +176 -3
  18. package/dist/bundles/index.js +4 -4
  19. package/dist/button/button.examples.js.map +1 -1
  20. package/dist/button/button.examples.json +3 -3
  21. package/dist/button/button2.js +1 -1
  22. package/dist/button-group/button-group2.js +1 -1
  23. package/dist/card/card2.js +4 -4
  24. package/dist/chat-message/chat-message2.js +1 -1
  25. package/dist/checkbox/checkbox-group2.js +1 -1
  26. package/dist/checkbox/checkbox2.js +1 -1
  27. package/dist/color/color2.js +1 -1
  28. package/dist/combobox/combobox.d.ts +4 -0
  29. package/dist/combobox/combobox.examples.js.map +1 -1
  30. package/dist/combobox/combobox.examples.json +12 -1
  31. package/dist/combobox/combobox.js +1 -1
  32. package/dist/combobox/combobox.js.map +1 -1
  33. package/dist/combobox/combobox2.js +90 -62
  34. package/dist/combobox/combobox2.js.map +1 -1
  35. package/dist/copy-button/copy-button2.js +1 -1
  36. package/dist/custom-elements-jsx.d.ts +117 -69
  37. package/dist/custom-elements-vue.d.ts +117 -69
  38. package/dist/custom-elements.json +2284 -1630
  39. package/dist/data.html.json +202 -71
  40. package/dist/data.snippets.json +9 -0
  41. package/dist/date/date2.js +1 -1
  42. package/dist/datetime/datetime2.js +1 -1
  43. package/dist/dialog/dialog-footer2.js +1 -1
  44. package/dist/dialog/dialog-header2.js +1 -1
  45. package/dist/dialog/dialog2.js +1 -1
  46. package/dist/divider/divider2.js +1 -1
  47. package/dist/dot/dot2.js +1 -1
  48. package/dist/drawer/drawer-content2.js +1 -1
  49. package/dist/drawer/drawer-footer2.js +1 -1
  50. package/dist/drawer/drawer-header2.js +1 -1
  51. package/dist/drawer/drawer2.js +1 -1
  52. package/dist/dropdown/dropdown-footer2.js +1 -1
  53. package/dist/dropdown/dropdown-header2.js +1 -1
  54. package/dist/dropdown/dropdown2.js +1 -1
  55. package/dist/dropdown-group/dropdown-group.js +1 -1
  56. package/dist/dropzone/dropzone.examples.js.map +1 -1
  57. package/dist/dropzone/dropzone.examples.json +3 -1
  58. package/dist/dropzone/dropzone2.js +1 -1
  59. package/dist/file/file2.js +1 -1
  60. package/dist/format-datetime/define.d.ts +6 -0
  61. package/dist/format-datetime/define.js +7 -0
  62. package/dist/format-datetime/define.js.map +1 -0
  63. package/dist/format-datetime/format-datetime.d.ts +74 -0
  64. package/dist/format-datetime/format-datetime.examples.js +6 -0
  65. package/dist/format-datetime/format-datetime.examples.js.map +1 -0
  66. package/dist/format-datetime/format-datetime.examples.json +87 -0
  67. package/dist/format-datetime/format-datetime.js +6 -0
  68. package/dist/format-datetime/format-datetime.js.map +1 -0
  69. package/dist/format-datetime/format-datetime2.js +77 -0
  70. package/dist/format-datetime/format-datetime2.js.map +1 -0
  71. package/dist/format-datetime/index.d.ts +1 -0
  72. package/dist/format-datetime/index.js +2 -0
  73. package/dist/format-relative-time/define.d.ts +6 -0
  74. package/dist/format-relative-time/define.js +7 -0
  75. package/dist/format-relative-time/define.js.map +1 -0
  76. package/dist/format-relative-time/format-relative-time.d.ts +47 -0
  77. package/dist/format-relative-time/format-relative-time.examples.js +6 -0
  78. package/dist/format-relative-time/format-relative-time.examples.js.map +1 -0
  79. package/dist/format-relative-time/format-relative-time.examples.json +69 -0
  80. package/dist/format-relative-time/format-relative-time.js +6 -0
  81. package/dist/format-relative-time/format-relative-time.js.map +1 -0
  82. package/dist/format-relative-time/format-relative-time2.js +118 -0
  83. package/dist/format-relative-time/format-relative-time2.js.map +1 -0
  84. package/dist/format-relative-time/index.d.ts +1 -0
  85. package/dist/format-relative-time/index.js +2 -0
  86. package/dist/forms/control/control2.js +1 -1
  87. package/dist/forms/control-group/control-group2.js +1 -1
  88. package/dist/forms/control-message/control-message2.js +1 -1
  89. package/dist/forms/forms.examples.js.map +1 -1
  90. package/dist/forms/forms.examples.json +4 -2
  91. package/dist/grid/cell/cell2.js +1 -1
  92. package/dist/grid/column/column2.js +1 -1
  93. package/dist/grid/footer/footer2.js +1 -1
  94. package/dist/grid/grid.examples.js.map +1 -1
  95. package/dist/grid/grid.examples.json +1 -1
  96. package/dist/grid/grid2.js +1 -1
  97. package/dist/grid/header/header2.js +1 -1
  98. package/dist/grid/placeholder/placeholder2.js +1 -1
  99. package/dist/grid/row/row2.js +1 -1
  100. package/dist/icon/define.js +1 -33
  101. package/dist/icon/define.js.map +1 -1
  102. package/dist/icon/icon.d.ts +1 -1
  103. package/dist/icon/icon.js +1 -1
  104. package/dist/icon/icon.js.map +1 -1
  105. package/dist/icon/icon2.js +2 -2
  106. package/dist/icon/icon2.js.map +1 -1
  107. package/dist/icon/icons.d.ts +0 -2
  108. package/dist/icon/icons.js.map +1 -1
  109. package/dist/icon-button/icon-button.js +1 -1
  110. package/dist/icon-button/icon-button.js.map +1 -1
  111. package/dist/icon-button/icon-button2.js +1 -1
  112. package/dist/index.js +1 -1
  113. package/dist/input/input-group2.js +1 -1
  114. package/dist/input/input2.js +1 -1
  115. package/dist/internal/index.js +40 -40
  116. package/dist/internal/services/global.service.js +1 -1
  117. package/dist/internal/services/global.service.js.map +1 -1
  118. package/dist/internal/services/i18n.service.d.ts +1 -0
  119. package/dist/internal/services/i18n.service.js +2 -1
  120. package/dist/internal/services/i18n.service.js.map +1 -1
  121. package/dist/internal/types/index.d.ts +0 -2
  122. package/dist/internal/types/index.js.map +1 -1
  123. package/dist/internal/utils/dom.d.ts +8 -0
  124. package/dist/internal/utils/dom.js +7 -1
  125. package/dist/internal/utils/dom.js.map +1 -1
  126. package/dist/logo/logo2.js +1 -1
  127. package/dist/menu/menu-item2.js +1 -1
  128. package/dist/menu/menu2.js +1 -1
  129. package/dist/month/month2.js +1 -1
  130. package/dist/notification/notification-group2.js +1 -1
  131. package/dist/notification/notification2.js +1 -1
  132. package/dist/page/page-panel/page-panel-content2.js +1 -1
  133. package/dist/page/page-panel/page-panel-footer2.js +1 -1
  134. package/dist/page/page-panel/page-panel-header2.js +1 -1
  135. package/dist/page/page-panel/page-panel2.js +1 -1
  136. package/dist/page/page.examples.js.map +1 -1
  137. package/dist/page/page.examples.json +0 -11
  138. package/dist/page/page2.js +1 -1
  139. package/dist/page-header/page-header.examples.js.map +1 -1
  140. package/dist/page-header/page-header.examples.json +2 -2
  141. package/dist/page-header/page-header2.js +1 -1
  142. package/dist/page-loader/page-loader2.js +1 -1
  143. package/dist/pagination/pagination2.js +1 -1
  144. package/dist/panel/panel2.js +4 -4
  145. package/dist/password/password2.js +1 -1
  146. package/dist/preferences-input/preferences-input2.js +1 -1
  147. package/dist/progress-bar/progress-bar2.js +1 -1
  148. package/dist/progress-ring/progress-ring2.js +1 -1
  149. package/dist/progressive-filter-chip/progressive-filter-chip2.js +1 -1
  150. package/dist/pulse/pulse2.js +1 -1
  151. package/dist/radio/radio-group2.js +1 -1
  152. package/dist/radio/radio2.js +1 -1
  153. package/dist/range/range2.js +1 -1
  154. package/dist/resize-handle/resize-handle.examples.js.map +1 -1
  155. package/dist/resize-handle/resize-handle.examples.json +3 -1
  156. package/dist/resize-handle/resize-handle2.js +1 -1
  157. package/dist/search/search2.js +1 -1
  158. package/dist/select/select2.js +1 -1
  159. package/dist/skeleton/skeleton.examples.js.map +1 -1
  160. package/dist/skeleton/skeleton.examples.json +3 -1
  161. package/dist/skeleton/skeleton2.js +1 -1
  162. package/dist/sort-button/sort-button2.js +1 -1
  163. package/dist/sparkline/sparkline.examples.js.map +1 -1
  164. package/dist/sparkline/sparkline.examples.json +3 -1
  165. package/dist/sparkline/sparkline2.js +1 -1
  166. package/dist/star-rating/star-rating2.js +1 -1
  167. package/dist/steps/steps2.js +2 -2
  168. package/dist/switch/switch-group2.js +1 -1
  169. package/dist/switch/switch2.js +1 -1
  170. package/dist/tabs/define.d.ts +2 -1
  171. package/dist/tabs/define.js +2 -1
  172. package/dist/tabs/define.js.map +1 -1
  173. package/dist/tabs/index.d.ts +1 -0
  174. package/dist/tabs/index.js +2 -1
  175. package/dist/tabs/tabs-group.d.ts +51 -0
  176. package/dist/tabs/tabs-group.js +6 -0
  177. package/dist/tabs/tabs-group.js.map +1 -0
  178. package/dist/tabs/tabs-group2.js +144 -0
  179. package/dist/tabs/tabs-group2.js.map +1 -0
  180. package/dist/tabs/tabs.examples.js.map +1 -1
  181. package/dist/tabs/tabs.examples.json +38 -2
  182. package/dist/tabs/tabs2.js +2 -2
  183. package/dist/tag/tag2.js +1 -1
  184. package/dist/textarea/textarea2.js +1 -1
  185. package/dist/time/time2.js +1 -1
  186. package/dist/toast/toast2.js +1 -1
  187. package/dist/toggletip/toggletip-footer2.js +1 -1
  188. package/dist/toggletip/toggletip-header2.js +1 -1
  189. package/dist/toggletip/toggletip2.js +1 -1
  190. package/dist/toolbar/toolbar2.js +1 -1
  191. package/dist/tooltip/tooltip2.js +1 -1
  192. package/dist/tree/tree-node.d.ts +1 -1
  193. package/dist/tree/tree-node.js +1 -1
  194. package/dist/tree/tree-node.js.map +1 -1
  195. package/dist/tree/tree-node2.js +1 -1
  196. package/dist/tree/tree-node2.js.map +1 -1
  197. package/dist/tree/tree.examples.js.map +1 -1
  198. package/dist/tree/tree.examples.json +1 -10
  199. package/dist/tree/tree2.js +1 -1
  200. package/dist/week/week2.js +1 -1
  201. package/package.json +43 -23
  202. package/dist/alert/alert-banner.d.ts +0 -22
  203. package/dist/alert/alert-banner.js +0 -6
  204. package/dist/alert/alert-banner.js.map +0 -1
  205. package/dist/alert/alert-banner2.js +0 -20
  206. package/dist/alert/alert-banner2.js.map +0 -1
  207. package/dist/scoped/index.d.ts +0 -11
  208. package/dist/scoped/index.js +0 -16
  209. package/dist/scoped/index.js.map +0 -1
  210. package/dist/test/demo.d.ts +0 -41
  211. package/dist/test/demo.js +0 -244
  212. package/dist/test/demo.js.map +0 -1
  213. package/dist/test/index.d.ts +0 -26
  214. package/dist/test/index.js +0 -36
  215. package/dist/test/index.js.map +0 -1
  216. package/dist/test/setup.d.ts +0 -1
@@ -942,121 +942,49 @@
942
942
  },
943
943
  {
944
944
  "kind": "javascript-module",
945
- "path": "/src/alert/alert-banner.js",
945
+ "path": "/src/alert/alert-group.js",
946
946
  "declarations": [
947
947
  {
948
948
  "kind": "class",
949
- "description": "An alert banner is an element that displays a brief, important message outside the context of the current page.",
950
- "name": "AlertBanner",
949
+ "description": "An alert group is an element that displays a group of related and important messages in a way that attracts the user's attention without interrupting the user's task.",
950
+ "name": "AlertGroup",
951
951
  "cssProperties": [
952
952
  {
953
953
  "name": "--gap",
954
- "inheritedFrom": {
955
- "name": "AlertGroup",
956
- "module": "/src/alert/alert-group.js"
957
- },
958
954
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/gap)"
959
955
  },
960
956
  {
961
- "name": "--color",
962
- "inheritedFrom": {
963
- "name": "AlertGroup",
964
- "module": "/src/alert/alert-group.js"
965
- },
966
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
957
+ "name": "--font-size",
958
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
967
959
  },
968
960
  {
969
961
  "name": "--padding",
970
- "inheritedFrom": {
971
- "name": "AlertGroup",
972
- "module": "/src/alert/alert-group.js"
973
- },
974
962
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/padding)"
975
963
  },
976
964
  {
977
- "name": "--font-size",
978
- "inheritedFrom": {
979
- "name": "AlertGroup",
980
- "module": "/src/alert/alert-group.js"
981
- },
982
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
983
- },
984
- {
985
- "name": "--background",
986
- "inheritedFrom": {
987
- "name": "AlertGroup",
988
- "module": "/src/alert/alert-group.js"
989
- },
990
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
965
+ "name": "--border",
966
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border)"
991
967
  },
992
968
  {
993
969
  "name": "--border-radius",
994
- "inheritedFrom": {
995
- "name": "AlertGroup",
996
- "module": "/src/alert/alert-group.js"
997
- },
998
970
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)"
999
971
  },
1000
972
  {
1001
- "name": "--border",
1002
- "inheritedFrom": {
1003
- "name": "AlertGroup",
1004
- "module": "/src/alert/alert-group.js"
1005
- },
1006
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border)"
973
+ "name": "--color",
974
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
975
+ },
976
+ {
977
+ "name": "--background",
978
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
1007
979
  }
1008
980
  ],
1009
- "members": [
1010
- {
1011
- "name": "nve-layout",
1012
- "deprecated": true,
1013
- "description": "not supported on custom element tags",
1014
- "type": {
1015
- "text": "string",
1016
- "values": [
1017
- {
1018
- "value": "string",
1019
- "description": ""
1020
- },
1021
- {
1022
- "value": "string",
1023
- "description": ""
1024
- }
1025
- ],
1026
- "_sourceAliases": []
1027
- },
1028
- "attribute": "nve-layout",
1029
- "kind": "field",
1030
- "inheritedFrom": {
1031
- "name": "AlertGroup",
1032
- "module": "/src/alert/alert-group.js"
1033
- }
1034
- },
981
+ "slots": [
1035
982
  {
1036
- "name": "nve-text",
1037
- "deprecated": true,
1038
- "description": "not supported on custom element tags",
1039
- "type": {
1040
- "text": "string",
1041
- "values": [
1042
- {
1043
- "value": "string",
1044
- "description": ""
1045
- },
1046
- {
1047
- "value": "string",
1048
- "description": ""
1049
- }
1050
- ],
1051
- "_sourceAliases": []
1052
- },
1053
- "attribute": "nve-text",
1054
- "kind": "field",
1055
- "inheritedFrom": {
1056
- "name": "AlertGroup",
1057
- "module": "/src/alert/alert-group.js"
1058
- }
1059
- },
983
+ "description": "default slot for nve-alert",
984
+ "name": ""
985
+ }
986
+ ],
987
+ "members": [
1060
988
  {
1061
989
  "kind": "field",
1062
990
  "name": "status",
@@ -1087,10 +1015,6 @@
1087
1015
  "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.",
1088
1016
  "attribute": "status",
1089
1017
  "reflects": true,
1090
- "inheritedFrom": {
1091
- "name": "AlertGroup",
1092
- "module": "/src/alert/alert-group.js"
1093
- },
1094
1018
  "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
1095
1019
  },
1096
1020
  {
@@ -1109,10 +1033,6 @@
1109
1033
  "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `emphasis` Increases visual weight to draw attention and highlight important elements.",
1110
1034
  "attribute": "prominence",
1111
1035
  "reflects": true,
1112
- "inheritedFrom": {
1113
- "name": "AlertGroup",
1114
- "module": "/src/alert/alert-group.js"
1115
- },
1116
1036
  "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
1117
1037
  },
1118
1038
  {
@@ -1216,11 +1136,7 @@
1216
1136
  },
1217
1137
  "description": "Defines a base color from the theme color palette",
1218
1138
  "attribute": "color",
1219
- "reflects": true,
1220
- "inheritedFrom": {
1221
- "name": "AlertGroup",
1222
- "module": "/src/alert/alert-group.js"
1223
- }
1139
+ "reflects": true
1224
1140
  },
1225
1141
  {
1226
1142
  "kind": "field",
@@ -1238,14 +1154,8 @@
1238
1154
  "description": "Demonstrates different container styles to accommodate visual weight and context.\n- `full` Element container optimizes for filling its container bounds.",
1239
1155
  "attribute": "container",
1240
1156
  "reflects": true,
1241
- "inheritedFrom": {
1242
- "name": "AlertGroup",
1243
- "module": "/src/alert/alert-group.js"
1244
- },
1245
1157
  "descriptionText": "Demonstrates different container styles to accommodate visual weight and context."
1246
- }
1247
- ],
1248
- "attributes": [
1158
+ },
1249
1159
  {
1250
1160
  "name": "nve-layout",
1251
1161
  "deprecated": true,
@@ -1264,10 +1174,8 @@
1264
1174
  ],
1265
1175
  "_sourceAliases": []
1266
1176
  },
1267
- "inheritedFrom": {
1268
- "name": "AlertGroup",
1269
- "module": "/src/alert/alert-group.js"
1270
- }
1177
+ "attribute": "nve-layout",
1178
+ "kind": "field"
1271
1179
  },
1272
1180
  {
1273
1181
  "name": "nve-text",
@@ -1287,11 +1195,11 @@
1287
1195
  ],
1288
1196
  "_sourceAliases": []
1289
1197
  },
1290
- "inheritedFrom": {
1291
- "name": "AlertGroup",
1292
- "module": "/src/alert/alert-group.js"
1293
- }
1294
- },
1198
+ "attribute": "nve-text",
1199
+ "kind": "field"
1200
+ }
1201
+ ],
1202
+ "attributes": [
1295
1203
  {
1296
1204
  "name": "status",
1297
1205
  "type": {
@@ -1320,10 +1228,6 @@
1320
1228
  },
1321
1229
  "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.",
1322
1230
  "fieldName": "status",
1323
- "inheritedFrom": {
1324
- "name": "AlertGroup",
1325
- "module": "/src/alert/alert-group.js"
1326
- },
1327
1231
  "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
1328
1232
  },
1329
1233
  {
@@ -1340,10 +1244,6 @@
1340
1244
  },
1341
1245
  "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `emphasis` Increases visual weight to draw attention and highlight important elements.",
1342
1246
  "fieldName": "prominence",
1343
- "inheritedFrom": {
1344
- "name": "AlertGroup",
1345
- "module": "/src/alert/alert-group.js"
1346
- },
1347
1247
  "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
1348
1248
  },
1349
1249
  {
@@ -1445,11 +1345,7 @@
1445
1345
  ]
1446
1346
  },
1447
1347
  "description": "Defines a base color from the theme color palette",
1448
- "fieldName": "color",
1449
- "inheritedFrom": {
1450
- "name": "AlertGroup",
1451
- "module": "/src/alert/alert-group.js"
1452
- }
1348
+ "fieldName": "color"
1453
1349
  },
1454
1350
  {
1455
1351
  "name": "container",
@@ -1465,19 +1361,52 @@
1465
1361
  },
1466
1362
  "description": "Demonstrates different container styles to accommodate visual weight and context.\n- `full` Element container optimizes for filling its container bounds.",
1467
1363
  "fieldName": "container",
1468
- "inheritedFrom": {
1469
- "name": "AlertGroup",
1470
- "module": "/src/alert/alert-group.js"
1471
- },
1472
1364
  "descriptionText": "Demonstrates different container styles to accommodate visual weight and context."
1365
+ },
1366
+ {
1367
+ "name": "nve-layout",
1368
+ "deprecated": true,
1369
+ "description": "not supported on custom element tags",
1370
+ "type": {
1371
+ "text": "string",
1372
+ "values": [
1373
+ {
1374
+ "value": "string",
1375
+ "description": ""
1376
+ },
1377
+ {
1378
+ "value": "string",
1379
+ "description": ""
1380
+ }
1381
+ ],
1382
+ "_sourceAliases": []
1383
+ }
1384
+ },
1385
+ {
1386
+ "name": "nve-text",
1387
+ "deprecated": true,
1388
+ "description": "not supported on custom element tags",
1389
+ "type": {
1390
+ "text": "string",
1391
+ "values": [
1392
+ {
1393
+ "value": "string",
1394
+ "description": ""
1395
+ },
1396
+ {
1397
+ "value": "string",
1398
+ "description": ""
1399
+ }
1400
+ ],
1401
+ "_sourceAliases": []
1402
+ }
1473
1403
  }
1474
1404
  ],
1475
1405
  "superclass": {
1476
- "name": "AlertGroup",
1477
- "module": "/src/alert/alert-group.js"
1406
+ "name": "LitElement",
1407
+ "package": "lit"
1478
1408
  },
1479
- "deprecated": "true",
1480
- "tagName": "nve-alert-banner",
1409
+ "tagName": "nve-alert-group",
1481
1410
  "customElement": true,
1482
1411
  "metadata": {
1483
1412
  "unitTests": true,
@@ -1488,44 +1417,35 @@
1488
1417
  "responsive": true,
1489
1418
  "themes": true,
1490
1419
  "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/alert/",
1491
- "entrypoint": "",
1420
+ "entrypoint": "@nvidia-elements/core/alert",
1492
1421
  "example": "",
1493
1422
  "package": true,
1423
+ "since": "0.3.0",
1494
1424
  "status": "stable",
1495
1425
  "behavior": "feedback",
1496
- "markdown": "## nve-alert-banner\n\nAn alert banner is an element that displays a brief, important message outside the context of the current page.\n\n### Import\n\n```javascript\nimport '/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for nve-alert |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| status | `'accent' \\| 'warning' \\| 'success' \\| 'danger' \\| \"default\"` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `accent` Highlights important actions or draws attention to primary interactive elements. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. - `danger` Signals destructive or irreversible actions that need extra attention and confirmation. |\n| prominence | `'emphasis' \\| \"default\"` | Controls the visual prominence to establish hierarchy and guide user attention. - `emphasis` Increases visual weight to draw attention and highlight important elements. |\n| color | `'red-cardinal' \\| 'gray-slate' \\| 'gray-denim' \\| 'blue-indigo' \\| 'blue-cobalt' \\| 'blue-sky' \\| 'teal-cyan' \\| 'green-mint' \\| 'teal-seafoam' \\| 'green-grass' \\| 'yellow-amber' \\| 'orange-pumpkin' \\| 'red-tomato' \\| 'pink-magenta' \\| 'purple-plum' \\| 'purple-violet' \\| 'purple-lavender' \\| 'pink-rose' \\| 'green-jade' \\| 'lime-pear' \\| 'yellow-nova' \\| 'brand-green'` | Defines a base color from the theme color palette |\n| container | `'full' \\| \"default\"` | Demonstrates different container styles to accommodate visual weight and context. - `full` Element container optimizes for filling its container bounds. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |"
1497
- },
1498
- "slots": [
1499
- {
1500
- "description": "default slot for nve-alert",
1501
- "name": "",
1502
- "inheritedFrom": {
1503
- "name": "AlertGroup",
1504
- "module": "/src/alert/alert-group.js"
1505
- }
1506
- }
1507
- ]
1426
+ "markdown": "## nve-alert-group\n\nAn alert group is an element that displays a group of related and important messages in a way that attracts the user's attention without interrupting the user's task.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/alert/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for nve-alert |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| status | `'accent' \\| 'warning' \\| 'success' \\| 'danger' \\| \"default\"` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `accent` Highlights important actions or draws attention to primary interactive elements. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. - `danger` Signals destructive or irreversible actions that need extra attention and confirmation. |\n| prominence | `'emphasis' \\| \"default\"` | Controls the visual prominence to establish hierarchy and guide user attention. - `emphasis` Increases visual weight to draw attention and highlight important elements. |\n| color | `'red-cardinal' \\| 'gray-slate' \\| 'gray-denim' \\| 'blue-indigo' \\| 'blue-cobalt' \\| 'blue-sky' \\| 'teal-cyan' \\| 'green-mint' \\| 'teal-seafoam' \\| 'green-grass' \\| 'yellow-amber' \\| 'orange-pumpkin' \\| 'red-tomato' \\| 'pink-magenta' \\| 'purple-plum' \\| 'purple-violet' \\| 'purple-lavender' \\| 'pink-rose' \\| 'green-jade' \\| 'lime-pear' \\| 'yellow-nova' \\| 'brand-green'` | Defines a base color from the theme color palette |\n| container | `'full' \\| \"default\"` | Demonstrates different container styles to accommodate visual weight and context. - `full` Element container optimizes for filling its container bounds. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |"
1427
+ }
1508
1428
  }
1509
1429
  ],
1510
1430
  "exports": [
1511
1431
  {
1512
1432
  "kind": "js",
1513
- "name": "AlertBanner",
1433
+ "name": "AlertGroup",
1514
1434
  "declaration": {
1515
- "name": "AlertBanner",
1516
- "module": "/src/alert/alert-banner.js"
1435
+ "name": "AlertGroup",
1436
+ "module": "/src/alert/alert-group.js"
1517
1437
  }
1518
1438
  }
1519
1439
  ]
1520
1440
  },
1521
1441
  {
1522
1442
  "kind": "javascript-module",
1523
- "path": "/src/alert/alert-group.js",
1443
+ "path": "/src/alert/alert.js",
1524
1444
  "declarations": [
1525
1445
  {
1526
1446
  "kind": "class",
1527
- "description": "An alert group is an element that displays a group of related and important messages in a way that attracts the user's attention without interrupting the user's task.",
1528
- "name": "AlertGroup",
1447
+ "description": "Alert is an element that displays a brief, important message in a way that attracts the user's attention without interrupting the user's task.",
1448
+ "name": "Alert",
1529
1449
  "cssProperties": [
1530
1450
  {
1531
1451
  "name": "--gap",
@@ -1536,29 +1456,65 @@
1536
1456
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
1537
1457
  },
1538
1458
  {
1539
- "name": "--padding",
1540
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/padding)"
1459
+ "name": "--color",
1460
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
1541
1461
  },
1542
1462
  {
1543
- "name": "--border",
1544
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border)"
1463
+ "name": "--icon-color",
1464
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
1545
1465
  },
1546
1466
  {
1547
- "name": "--border-radius",
1548
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/border-radius)"
1467
+ "name": "--icon-size",
1468
+ "description": ""
1549
1469
  },
1550
1470
  {
1551
- "name": "--color",
1552
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
1471
+ "name": "--font-weight",
1472
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight)"
1553
1473
  },
1554
1474
  {
1555
- "name": "--background",
1556
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/background)"
1475
+ "name": "--justify-content",
1476
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content)"
1477
+ },
1478
+ {
1479
+ "name": "--align-items",
1480
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/align-items)"
1481
+ },
1482
+ {
1483
+ "name": "--min-height",
1484
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height)"
1485
+ },
1486
+ {
1487
+ "name": "--text-transform",
1488
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-transform)"
1489
+ },
1490
+ {
1491
+ "name": "--height",
1492
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/height)"
1493
+ },
1494
+ {
1495
+ "name": "--width",
1496
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
1557
1497
  }
1558
1498
  ],
1559
1499
  "slots": [
1560
1500
  {
1561
- "description": "default slot for nve-alert",
1501
+ "description": "Icon slot renders on the left side of the alert. Icons typically represent the alert's status.",
1502
+ "name": "icon"
1503
+ },
1504
+ {
1505
+ "description": "Prefix slot renders between the icon and the content. Prefixes typically represent the alert's status.",
1506
+ "name": "prefix"
1507
+ },
1508
+ {
1509
+ "description": "Actions render on the right side of the alert. Actions are typically buttons, but can also be links. Use actions for steps the user can take to resolve the alert.",
1510
+ "name": "actions"
1511
+ },
1512
+ {
1513
+ "description": "Content for large overflow text.",
1514
+ "name": "content"
1515
+ },
1516
+ {
1517
+ "description": "Default content placed inside of the alert.",
1562
1518
  "name": ""
1563
1519
  }
1564
1520
  ],
@@ -1567,9 +1523,10 @@
1567
1523
  "kind": "field",
1568
1524
  "name": "status",
1569
1525
  "type": {
1570
- "text": "'accent' | 'warning' | 'success' | 'danger' | \"default\"",
1526
+ "text": "'accent' | 'warning' | 'success' | 'danger' | 'scheduled' | 'queued' | 'pending' | 'starting' | 'running' | 'restarting' | 'stopping' | 'finished' | 'failed' | 'unknown' | 'ignored' | 'muted' | \"default\"",
1571
1527
  "_sourceAliases": [
1572
- "SupportStatus"
1528
+ "SupportStatus",
1529
+ "TaskStatus"
1573
1530
  ],
1574
1531
  "values": [
1575
1532
  {
@@ -1587,152 +1544,89 @@
1587
1544
  {
1588
1545
  "value": "danger",
1589
1546
  "description": "Signals destructive or irreversible actions that need extra attention and confirmation."
1590
- }
1591
- ]
1592
- },
1593
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.",
1594
- "attribute": "status",
1595
- "reflects": true,
1596
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
1597
- },
1598
- {
1599
- "kind": "field",
1600
- "name": "prominence",
1601
- "type": {
1602
- "text": "'emphasis' | \"default\"",
1603
- "_sourceAliases": [],
1604
- "values": [
1605
- {
1606
- "value": "emphasis",
1607
- "description": "Increases visual weight to draw attention and highlight important elements."
1608
- }
1609
- ]
1610
- },
1611
- "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `emphasis` Increases visual weight to draw attention and highlight important elements.",
1612
- "attribute": "prominence",
1613
- "reflects": true,
1614
- "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
1615
- },
1616
- {
1617
- "kind": "field",
1618
- "name": "color",
1619
- "type": {
1620
- "text": "'red-cardinal' | 'gray-slate' | 'gray-denim' | 'blue-indigo' | 'blue-cobalt' | 'blue-sky' | 'teal-cyan' | 'green-mint' | 'teal-seafoam' | 'green-grass' | 'yellow-amber' | 'orange-pumpkin' | 'red-tomato' | 'pink-magenta' | 'purple-plum' | 'purple-violet' | 'purple-lavender' | 'pink-rose' | 'green-jade' | 'lime-pear' | 'yellow-nova' | 'brand-green'",
1621
- "_sourceAliases": [
1622
- "Color"
1623
- ],
1624
- "values": [
1625
- {
1626
- "value": "red-cardinal",
1627
- "description": ""
1628
- },
1629
- {
1630
- "value": "gray-slate",
1631
- "description": ""
1632
- },
1633
- {
1634
- "value": "gray-denim",
1635
- "description": ""
1636
- },
1637
- {
1638
- "value": "blue-indigo",
1639
- "description": ""
1640
- },
1641
- {
1642
- "value": "blue-cobalt",
1643
- "description": ""
1644
- },
1645
- {
1646
- "value": "blue-sky",
1647
- "description": ""
1648
- },
1649
- {
1650
- "value": "teal-cyan",
1651
- "description": ""
1652
- },
1653
- {
1654
- "value": "green-mint",
1655
- "description": ""
1656
- },
1657
- {
1658
- "value": "teal-seafoam",
1659
- "description": ""
1660
- },
1661
- {
1662
- "value": "green-grass",
1663
- "description": ""
1664
1547
  },
1665
1548
  {
1666
- "value": "yellow-amber",
1667
- "description": ""
1549
+ "value": "scheduled",
1550
+ "description": "Task has a scheduled future execution at a specific time."
1668
1551
  },
1669
1552
  {
1670
- "value": "orange-pumpkin",
1671
- "description": ""
1553
+ "value": "queued",
1554
+ "description": "Task is waiting in line to begin after other tasks complete."
1672
1555
  },
1673
1556
  {
1674
- "value": "red-tomato",
1675
- "description": ""
1557
+ "value": "pending",
1558
+ "description": "Task is awaiting approval, user input, or external conditions before proceeding."
1676
1559
  },
1677
1560
  {
1678
- "value": "pink-magenta",
1679
- "description": ""
1561
+ "value": "starting",
1562
+ "description": "Task is initializing and preparing to begin active execution."
1680
1563
  },
1681
1564
  {
1682
- "value": "purple-plum",
1683
- "description": ""
1565
+ "value": "running",
1566
+ "description": "Task is actively executing and making progress."
1684
1567
  },
1685
1568
  {
1686
- "value": "purple-violet",
1687
- "description": ""
1569
+ "value": "restarting",
1570
+ "description": "Task restarts after an interruption or reset."
1688
1571
  },
1689
1572
  {
1690
- "value": "purple-lavender",
1691
- "description": ""
1573
+ "value": "stopping",
1574
+ "description": "Task is gracefully shutting down and completing cleanup operations."
1692
1575
  },
1693
1576
  {
1694
- "value": "pink-rose",
1695
- "description": ""
1577
+ "value": "finished",
1578
+ "description": "Task has completed successfully with the expected outcome."
1696
1579
  },
1697
1580
  {
1698
- "value": "green-jade",
1699
- "description": ""
1581
+ "value": "failed",
1582
+ "description": "Task encountered an error and did not complete as intended."
1700
1583
  },
1701
1584
  {
1702
- "value": "lime-pear",
1703
- "description": ""
1585
+ "value": "unknown",
1586
+ "description": "Task status remains unknown or unavailable."
1704
1587
  },
1705
1588
  {
1706
- "value": "yellow-nova",
1707
- "description": ""
1589
+ "value": "ignored",
1590
+ "description": "Task was intentionally skipped or excluded from execution."
1708
1591
  },
1709
1592
  {
1710
- "value": "brand-green",
1593
+ "value": "muted",
1711
1594
  "description": ""
1712
1595
  }
1713
1596
  ]
1714
1597
  },
1715
- "description": "Defines a base color from the theme color palette",
1716
- "attribute": "color",
1717
- "reflects": true
1598
+ "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.\n\n- `scheduled` Task has a scheduled future execution at a specific time.\n\n- `queued` Task is waiting in line to begin after other tasks complete.\n\n- `pending` Task is awaiting approval, user input, or external conditions before proceeding.\n\n- `starting` Task is initializing and preparing to begin active execution.\n\n- `running` Task is actively executing and making progress.\n\n- `restarting` Task restarts after an interruption or reset.\n\n- `stopping` Task is gracefully shutting down and completing cleanup operations.\n\n- `finished` Task has completed successfully with the expected outcome.\n\n- `failed` Task encountered an error and did not complete as intended.\n\n- `unknown` Task status remains unknown or unavailable.\n\n- `ignored` Task was intentionally skipped or excluded from execution.",
1599
+ "attribute": "status",
1600
+ "reflects": true,
1601
+ "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
1718
1602
  },
1719
1603
  {
1720
1604
  "kind": "field",
1721
- "name": "container",
1605
+ "name": "closable",
1722
1606
  "type": {
1723
- "text": "'full' | \"default\"",
1607
+ "text": "boolean",
1724
1608
  "_sourceAliases": [],
1725
1609
  "values": [
1726
1610
  {
1727
- "value": "full",
1728
- "description": "Element container optimizes for filling its container bounds."
1611
+ "value": "true",
1612
+ "description": "The element displays a close control and the user can dismiss it."
1613
+ },
1614
+ {
1615
+ "value": "false",
1616
+ "description": "The user cannot close the element and must dismiss it programmatically."
1729
1617
  }
1730
1618
  ]
1731
1619
  },
1732
- "description": "Demonstrates different container styles to accommodate visual weight and context.\n- `full` Element container optimizes for filling its container bounds.",
1733
- "attribute": "container",
1734
- "reflects": true,
1735
- "descriptionText": "Demonstrates different container styles to accommodate visual weight and context."
1620
+ "default": "false",
1621
+ "description": "Indicates whether the user can dismiss or close the element.\n- `true` The element displays a close control and the user can dismiss it.\n\n- `false` The user cannot close the element and must dismiss it programmatically.",
1622
+ "attribute": "closable",
1623
+ "descriptionText": "Indicates whether the user can dismiss or close the element."
1624
+ },
1625
+ {
1626
+ "kind": "field",
1627
+ "name": "i18n",
1628
+ "description": "Enables updating internal string values for internationalization.",
1629
+ "attribute": "i18n"
1736
1630
  },
1737
1631
  {
1738
1632
  "name": "nve-layout",
@@ -1777,13 +1671,20 @@
1777
1671
  "kind": "field"
1778
1672
  }
1779
1673
  ],
1674
+ "events": [
1675
+ {
1676
+ "description": "Dispatched when the alert closes within an alert group.",
1677
+ "name": "close"
1678
+ }
1679
+ ],
1780
1680
  "attributes": [
1781
1681
  {
1782
1682
  "name": "status",
1783
1683
  "type": {
1784
- "text": "'accent' | 'warning' | 'success' | 'danger' | \"default\"",
1684
+ "text": "'accent' | 'warning' | 'success' | 'danger' | 'scheduled' | 'queued' | 'pending' | 'starting' | 'running' | 'restarting' | 'stopping' | 'finished' | 'failed' | 'unknown' | 'ignored' | 'muted' | \"default\"",
1785
1685
  "_sourceAliases": [
1786
- "SupportStatus"
1686
+ "SupportStatus",
1687
+ "TaskStatus"
1787
1688
  ],
1788
1689
  "values": [
1789
1690
  {
@@ -1801,546 +1702,67 @@
1801
1702
  {
1802
1703
  "value": "danger",
1803
1704
  "description": "Signals destructive or irreversible actions that need extra attention and confirmation."
1804
- }
1805
- ]
1806
- },
1807
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.",
1808
- "fieldName": "status",
1809
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
1810
- },
1811
- {
1812
- "name": "prominence",
1813
- "type": {
1814
- "text": "'emphasis' | \"default\"",
1815
- "_sourceAliases": [],
1816
- "values": [
1817
- {
1818
- "value": "emphasis",
1819
- "description": "Increases visual weight to draw attention and highlight important elements."
1820
- }
1821
- ]
1822
- },
1823
- "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `emphasis` Increases visual weight to draw attention and highlight important elements.",
1824
- "fieldName": "prominence",
1825
- "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
1826
- },
1827
- {
1828
- "name": "color",
1829
- "type": {
1830
- "text": "'red-cardinal' | 'gray-slate' | 'gray-denim' | 'blue-indigo' | 'blue-cobalt' | 'blue-sky' | 'teal-cyan' | 'green-mint' | 'teal-seafoam' | 'green-grass' | 'yellow-amber' | 'orange-pumpkin' | 'red-tomato' | 'pink-magenta' | 'purple-plum' | 'purple-violet' | 'purple-lavender' | 'pink-rose' | 'green-jade' | 'lime-pear' | 'yellow-nova' | 'brand-green'",
1831
- "_sourceAliases": [
1832
- "Color"
1833
- ],
1834
- "values": [
1835
- {
1836
- "value": "red-cardinal",
1837
- "description": ""
1838
1705
  },
1839
1706
  {
1840
- "value": "gray-slate",
1841
- "description": ""
1707
+ "value": "scheduled",
1708
+ "description": "Task has a scheduled future execution at a specific time."
1842
1709
  },
1843
1710
  {
1844
- "value": "gray-denim",
1845
- "description": ""
1711
+ "value": "queued",
1712
+ "description": "Task is waiting in line to begin after other tasks complete."
1846
1713
  },
1847
1714
  {
1848
- "value": "blue-indigo",
1849
- "description": ""
1715
+ "value": "pending",
1716
+ "description": "Task is awaiting approval, user input, or external conditions before proceeding."
1850
1717
  },
1851
1718
  {
1852
- "value": "blue-cobalt",
1853
- "description": ""
1719
+ "value": "starting",
1720
+ "description": "Task is initializing and preparing to begin active execution."
1854
1721
  },
1855
1722
  {
1856
- "value": "blue-sky",
1857
- "description": ""
1723
+ "value": "running",
1724
+ "description": "Task is actively executing and making progress."
1858
1725
  },
1859
1726
  {
1860
- "value": "teal-cyan",
1861
- "description": ""
1727
+ "value": "restarting",
1728
+ "description": "Task restarts after an interruption or reset."
1862
1729
  },
1863
1730
  {
1864
- "value": "green-mint",
1865
- "description": ""
1731
+ "value": "stopping",
1732
+ "description": "Task is gracefully shutting down and completing cleanup operations."
1866
1733
  },
1867
1734
  {
1868
- "value": "teal-seafoam",
1869
- "description": ""
1735
+ "value": "finished",
1736
+ "description": "Task has completed successfully with the expected outcome."
1870
1737
  },
1871
1738
  {
1872
- "value": "green-grass",
1873
- "description": ""
1739
+ "value": "failed",
1740
+ "description": "Task encountered an error and did not complete as intended."
1874
1741
  },
1875
1742
  {
1876
- "value": "yellow-amber",
1877
- "description": ""
1743
+ "value": "unknown",
1744
+ "description": "Task status remains unknown or unavailable."
1878
1745
  },
1879
1746
  {
1880
- "value": "orange-pumpkin",
1881
- "description": ""
1747
+ "value": "ignored",
1748
+ "description": "Task was intentionally skipped or excluded from execution."
1882
1749
  },
1883
1750
  {
1884
- "value": "red-tomato",
1751
+ "value": "muted",
1885
1752
  "description": ""
1886
- },
1887
- {
1888
- "value": "pink-magenta",
1889
- "description": ""
1890
- },
1891
- {
1892
- "value": "purple-plum",
1893
- "description": ""
1894
- },
1895
- {
1896
- "value": "purple-violet",
1897
- "description": ""
1898
- },
1899
- {
1900
- "value": "purple-lavender",
1901
- "description": ""
1902
- },
1903
- {
1904
- "value": "pink-rose",
1905
- "description": ""
1906
- },
1907
- {
1908
- "value": "green-jade",
1909
- "description": ""
1910
- },
1911
- {
1912
- "value": "lime-pear",
1913
- "description": ""
1914
- },
1915
- {
1916
- "value": "yellow-nova",
1917
- "description": ""
1918
- },
1919
- {
1920
- "value": "brand-green",
1921
- "description": ""
1922
- }
1923
- ]
1924
- },
1925
- "description": "Defines a base color from the theme color palette",
1926
- "fieldName": "color"
1927
- },
1928
- {
1929
- "name": "container",
1930
- "type": {
1931
- "text": "'full' | \"default\"",
1932
- "_sourceAliases": [],
1933
- "values": [
1934
- {
1935
- "value": "full",
1936
- "description": "Element container optimizes for filling its container bounds."
1937
- }
1938
- ]
1939
- },
1940
- "description": "Demonstrates different container styles to accommodate visual weight and context.\n- `full` Element container optimizes for filling its container bounds.",
1941
- "fieldName": "container",
1942
- "descriptionText": "Demonstrates different container styles to accommodate visual weight and context."
1943
- },
1944
- {
1945
- "name": "nve-layout",
1946
- "deprecated": true,
1947
- "description": "not supported on custom element tags",
1948
- "type": {
1949
- "text": "string",
1950
- "values": [
1951
- {
1952
- "value": "string",
1953
- "description": ""
1954
- },
1955
- {
1956
- "value": "string",
1957
- "description": ""
1958
- }
1959
- ],
1960
- "_sourceAliases": []
1961
- }
1962
- },
1963
- {
1964
- "name": "nve-text",
1965
- "deprecated": true,
1966
- "description": "not supported on custom element tags",
1967
- "type": {
1968
- "text": "string",
1969
- "values": [
1970
- {
1971
- "value": "string",
1972
- "description": ""
1973
- },
1974
- {
1975
- "value": "string",
1976
- "description": ""
1977
- }
1978
- ],
1979
- "_sourceAliases": []
1980
- }
1981
- }
1982
- ],
1983
- "superclass": {
1984
- "name": "LitElement",
1985
- "package": "lit"
1986
- },
1987
- "tagName": "nve-alert-group",
1988
- "customElement": true,
1989
- "metadata": {
1990
- "unitTests": true,
1991
- "apiReview": true,
1992
- "performance": true,
1993
- "stable": true,
1994
- "vqa": true,
1995
- "responsive": true,
1996
- "themes": true,
1997
- "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/alert/",
1998
- "entrypoint": "@nvidia-elements/core/alert",
1999
- "example": "",
2000
- "package": true,
2001
- "since": "0.3.0",
2002
- "status": "stable",
2003
- "behavior": "feedback",
2004
- "markdown": "## nve-alert-group\n\nAn alert group is an element that displays a group of related and important messages in a way that attracts the user's attention without interrupting the user's task.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/alert/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for nve-alert |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| status | `'accent' \\| 'warning' \\| 'success' \\| 'danger' \\| \"default\"` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `accent` Highlights important actions or draws attention to primary interactive elements. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. - `danger` Signals destructive or irreversible actions that need extra attention and confirmation. |\n| prominence | `'emphasis' \\| \"default\"` | Controls the visual prominence to establish hierarchy and guide user attention. - `emphasis` Increases visual weight to draw attention and highlight important elements. |\n| color | `'red-cardinal' \\| 'gray-slate' \\| 'gray-denim' \\| 'blue-indigo' \\| 'blue-cobalt' \\| 'blue-sky' \\| 'teal-cyan' \\| 'green-mint' \\| 'teal-seafoam' \\| 'green-grass' \\| 'yellow-amber' \\| 'orange-pumpkin' \\| 'red-tomato' \\| 'pink-magenta' \\| 'purple-plum' \\| 'purple-violet' \\| 'purple-lavender' \\| 'pink-rose' \\| 'green-jade' \\| 'lime-pear' \\| 'yellow-nova' \\| 'brand-green'` | Defines a base color from the theme color palette |\n| container | `'full' \\| \"default\"` | Demonstrates different container styles to accommodate visual weight and context. - `full` Element container optimizes for filling its container bounds. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |"
2005
- }
2006
- }
2007
- ],
2008
- "exports": [
2009
- {
2010
- "kind": "js",
2011
- "name": "AlertGroup",
2012
- "declaration": {
2013
- "name": "AlertGroup",
2014
- "module": "/src/alert/alert-group.js"
2015
- }
2016
- }
2017
- ]
2018
- },
2019
- {
2020
- "kind": "javascript-module",
2021
- "path": "/src/alert/alert.js",
2022
- "declarations": [
2023
- {
2024
- "kind": "class",
2025
- "description": "Alert is an element that displays a brief, important message in a way that attracts the user's attention without interrupting the user's task.",
2026
- "name": "Alert",
2027
- "cssProperties": [
2028
- {
2029
- "name": "--gap",
2030
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/gap)"
2031
- },
2032
- {
2033
- "name": "--font-size",
2034
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-size)"
2035
- },
2036
- {
2037
- "name": "--color",
2038
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
2039
- },
2040
- {
2041
- "name": "--icon-color",
2042
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/color)"
2043
- },
2044
- {
2045
- "name": "--icon-size",
2046
- "description": ""
2047
- },
2048
- {
2049
- "name": "--font-weight",
2050
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight)"
2051
- },
2052
- {
2053
- "name": "--justify-content",
2054
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/justify-content)"
2055
- },
2056
- {
2057
- "name": "--align-items",
2058
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/align-items)"
2059
- },
2060
- {
2061
- "name": "--min-height",
2062
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/min-height)"
2063
- },
2064
- {
2065
- "name": "--text-transform",
2066
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/text-transform)"
2067
- },
2068
- {
2069
- "name": "--height",
2070
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/height)"
2071
- },
2072
- {
2073
- "name": "--width",
2074
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
2075
- }
2076
- ],
2077
- "slots": [
2078
- {
2079
- "description": "Icon slot renders on the left side of the alert. Icons typically represent the alert's status.",
2080
- "name": "icon"
2081
- },
2082
- {
2083
- "description": "Prefix slot renders between the icon and the content. Prefixes typically represent the alert's status.",
2084
- "name": "prefix"
2085
- },
2086
- {
2087
- "description": "Actions render on the right side of the alert. Actions are typically buttons, but can also be links. Use actions for steps the user can take to resolve the alert.",
2088
- "name": "actions"
2089
- },
2090
- {
2091
- "description": "Content for large overflow text.",
2092
- "name": "content"
2093
- },
2094
- {
2095
- "description": "Default content placed inside of the alert.",
2096
- "name": ""
2097
- }
2098
- ],
2099
- "members": [
2100
- {
2101
- "kind": "field",
2102
- "name": "status",
2103
- "type": {
2104
- "text": "'accent' | 'warning' | 'success' | 'danger' | 'scheduled' | 'queued' | 'pending' | 'starting' | 'running' | 'restarting' | 'stopping' | 'finished' | 'failed' | 'unknown' | 'ignored' | 'muted' | \"default\"",
2105
- "_sourceAliases": [
2106
- "SupportStatus",
2107
- "TaskStatus"
2108
- ],
2109
- "values": [
2110
- {
2111
- "value": "accent",
2112
- "description": "Highlights important actions or draws attention to primary interactive elements."
2113
- },
2114
- {
2115
- "value": "warning",
2116
- "description": "Indicates cautionary actions that require careful consideration before proceeding."
2117
- },
2118
- {
2119
- "value": "success",
2120
- "description": "Represents positive outcomes, confirmations, or constructive actions."
2121
- },
2122
- {
2123
- "value": "danger",
2124
- "description": "Signals destructive or irreversible actions that need extra attention and confirmation."
2125
- },
2126
- {
2127
- "value": "scheduled",
2128
- "description": "Task has a scheduled future execution at a specific time."
2129
- },
2130
- {
2131
- "value": "queued",
2132
- "description": "Task is waiting in line to begin after other tasks complete."
2133
- },
2134
- {
2135
- "value": "pending",
2136
- "description": "Task is awaiting approval, user input, or external conditions before proceeding."
2137
- },
2138
- {
2139
- "value": "starting",
2140
- "description": "Task is initializing and preparing to begin active execution."
2141
- },
2142
- {
2143
- "value": "running",
2144
- "description": "Task is actively executing and making progress."
2145
- },
2146
- {
2147
- "value": "restarting",
2148
- "description": "Task restarts after an interruption or reset."
2149
- },
2150
- {
2151
- "value": "stopping",
2152
- "description": "Task is gracefully shutting down and completing cleanup operations."
2153
- },
2154
- {
2155
- "value": "finished",
2156
- "description": "Task has completed successfully with the expected outcome."
2157
- },
2158
- {
2159
- "value": "failed",
2160
- "description": "Task encountered an error and did not complete as intended."
2161
- },
2162
- {
2163
- "value": "unknown",
2164
- "description": "Task status remains unknown or unavailable."
2165
- },
2166
- {
2167
- "value": "ignored",
2168
- "description": "Task was intentionally skipped or excluded from execution."
2169
- },
2170
- {
2171
- "value": "muted",
2172
- "description": ""
2173
- }
2174
- ]
2175
- },
2176
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.\n\n- `scheduled` Task has a scheduled future execution at a specific time.\n\n- `queued` Task is waiting in line to begin after other tasks complete.\n\n- `pending` Task is awaiting approval, user input, or external conditions before proceeding.\n\n- `starting` Task is initializing and preparing to begin active execution.\n\n- `running` Task is actively executing and making progress.\n\n- `restarting` Task restarts after an interruption or reset.\n\n- `stopping` Task is gracefully shutting down and completing cleanup operations.\n\n- `finished` Task has completed successfully with the expected outcome.\n\n- `failed` Task encountered an error and did not complete as intended.\n\n- `unknown` Task status remains unknown or unavailable.\n\n- `ignored` Task was intentionally skipped or excluded from execution.",
2177
- "attribute": "status",
2178
- "reflects": true,
2179
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
2180
- },
2181
- {
2182
- "kind": "field",
2183
- "name": "closable",
2184
- "type": {
2185
- "text": "boolean",
2186
- "_sourceAliases": [],
2187
- "values": [
2188
- {
2189
- "value": "true",
2190
- "description": "The element displays a close control and the user can dismiss it."
2191
- },
2192
- {
2193
- "value": "false",
2194
- "description": "The user cannot close the element and must dismiss it programmatically."
2195
- }
2196
- ]
2197
- },
2198
- "default": "false",
2199
- "description": "Indicates whether the user can dismiss or close the element.\n- `true` The element displays a close control and the user can dismiss it.\n\n- `false` The user cannot close the element and must dismiss it programmatically.",
2200
- "attribute": "closable",
2201
- "descriptionText": "Indicates whether the user can dismiss or close the element."
2202
- },
2203
- {
2204
- "kind": "field",
2205
- "name": "i18n",
2206
- "description": "Enables updating internal string values for internationalization.",
2207
- "attribute": "i18n"
2208
- },
2209
- {
2210
- "name": "nve-layout",
2211
- "deprecated": true,
2212
- "description": "not supported on custom element tags",
2213
- "type": {
2214
- "text": "string",
2215
- "values": [
2216
- {
2217
- "value": "string",
2218
- "description": ""
2219
- },
2220
- {
2221
- "value": "string",
2222
- "description": ""
2223
- }
2224
- ],
2225
- "_sourceAliases": []
2226
- },
2227
- "attribute": "nve-layout",
2228
- "kind": "field"
2229
- },
2230
- {
2231
- "name": "nve-text",
2232
- "deprecated": true,
2233
- "description": "not supported on custom element tags",
2234
- "type": {
2235
- "text": "string",
2236
- "values": [
2237
- {
2238
- "value": "string",
2239
- "description": ""
2240
- },
2241
- {
2242
- "value": "string",
2243
- "description": ""
2244
- }
2245
- ],
2246
- "_sourceAliases": []
2247
- },
2248
- "attribute": "nve-text",
2249
- "kind": "field"
2250
- }
2251
- ],
2252
- "events": [
2253
- {
2254
- "description": "Dispatched when the alert closes within an alert group.",
2255
- "name": "close"
2256
- }
2257
- ],
2258
- "attributes": [
2259
- {
2260
- "name": "status",
2261
- "type": {
2262
- "text": "'accent' | 'warning' | 'success' | 'danger' | 'scheduled' | 'queued' | 'pending' | 'starting' | 'running' | 'restarting' | 'stopping' | 'finished' | 'failed' | 'unknown' | 'ignored' | 'muted' | \"default\"",
2263
- "_sourceAliases": [
2264
- "SupportStatus",
2265
- "TaskStatus"
2266
- ],
2267
- "values": [
2268
- {
2269
- "value": "accent",
2270
- "description": "Highlights important actions or draws attention to primary interactive elements."
2271
- },
2272
- {
2273
- "value": "warning",
2274
- "description": "Indicates cautionary actions that require careful consideration before proceeding."
2275
- },
2276
- {
2277
- "value": "success",
2278
- "description": "Represents positive outcomes, confirmations, or constructive actions."
2279
- },
2280
- {
2281
- "value": "danger",
2282
- "description": "Signals destructive or irreversible actions that need extra attention and confirmation."
2283
- },
2284
- {
2285
- "value": "scheduled",
2286
- "description": "Task has a scheduled future execution at a specific time."
2287
- },
2288
- {
2289
- "value": "queued",
2290
- "description": "Task is waiting in line to begin after other tasks complete."
2291
- },
2292
- {
2293
- "value": "pending",
2294
- "description": "Task is awaiting approval, user input, or external conditions before proceeding."
2295
- },
2296
- {
2297
- "value": "starting",
2298
- "description": "Task is initializing and preparing to begin active execution."
2299
- },
2300
- {
2301
- "value": "running",
2302
- "description": "Task is actively executing and making progress."
2303
- },
2304
- {
2305
- "value": "restarting",
2306
- "description": "Task restarts after an interruption or reset."
2307
- },
2308
- {
2309
- "value": "stopping",
2310
- "description": "Task is gracefully shutting down and completing cleanup operations."
2311
- },
2312
- {
2313
- "value": "finished",
2314
- "description": "Task has completed successfully with the expected outcome."
2315
- },
2316
- {
2317
- "value": "failed",
2318
- "description": "Task encountered an error and did not complete as intended."
2319
- },
2320
- {
2321
- "value": "unknown",
2322
- "description": "Task status remains unknown or unavailable."
2323
- },
2324
- {
2325
- "value": "ignored",
2326
- "description": "Task was intentionally skipped or excluded from execution."
2327
- },
2328
- {
2329
- "value": "muted",
2330
- "description": ""
2331
- }
2332
- ]
2333
- },
2334
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.\n\n- `scheduled` Task has a scheduled future execution at a specific time.\n\n- `queued` Task is waiting in line to begin after other tasks complete.\n\n- `pending` Task is awaiting approval, user input, or external conditions before proceeding.\n\n- `starting` Task is initializing and preparing to begin active execution.\n\n- `running` Task is actively executing and making progress.\n\n- `restarting` Task restarts after an interruption or reset.\n\n- `stopping` Task is gracefully shutting down and completing cleanup operations.\n\n- `finished` Task has completed successfully with the expected outcome.\n\n- `failed` Task encountered an error and did not complete as intended.\n\n- `unknown` Task status remains unknown or unavailable.\n\n- `ignored` Task was intentionally skipped or excluded from execution.",
2335
- "fieldName": "status",
2336
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
2337
- },
2338
- {
2339
- "name": "closable",
2340
- "type": {
2341
- "text": "boolean",
2342
- "_sourceAliases": [],
2343
- "values": [
1753
+ }
1754
+ ]
1755
+ },
1756
+ "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `accent` Highlights important actions or draws attention to primary interactive elements.\n\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.\n\n- `danger` Signals destructive or irreversible actions that need extra attention and confirmation.\n\n- `scheduled` Task has a scheduled future execution at a specific time.\n\n- `queued` Task is waiting in line to begin after other tasks complete.\n\n- `pending` Task is awaiting approval, user input, or external conditions before proceeding.\n\n- `starting` Task is initializing and preparing to begin active execution.\n\n- `running` Task is actively executing and making progress.\n\n- `restarting` Task restarts after an interruption or reset.\n\n- `stopping` Task is gracefully shutting down and completing cleanup operations.\n\n- `finished` Task has completed successfully with the expected outcome.\n\n- `failed` Task encountered an error and did not complete as intended.\n\n- `unknown` Task status remains unknown or unavailable.\n\n- `ignored` Task was intentionally skipped or excluded from execution.",
1757
+ "fieldName": "status",
1758
+ "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
1759
+ },
1760
+ {
1761
+ "name": "closable",
1762
+ "type": {
1763
+ "text": "boolean",
1764
+ "_sourceAliases": [],
1765
+ "values": [
2344
1766
  {
2345
1767
  "value": "true",
2346
1768
  "description": "The element displays a close control and the user can dismiss it."
@@ -2468,14 +1890,6 @@
2468
1890
  "name": "*",
2469
1891
  "module": "home/runner/work/elements/elements/projects/core/src/alert/alert-group.js"
2470
1892
  }
2471
- },
2472
- {
2473
- "kind": "js",
2474
- "name": "*",
2475
- "declaration": {
2476
- "name": "*",
2477
- "module": "home/runner/work/elements/elements/projects/core/src/alert/alert-banner.js"
2478
- }
2479
1893
  }
2480
1894
  ]
2481
1895
  },
@@ -4024,6 +3438,22 @@
4024
3438
  "package": "@nvidia-elements/core/file"
4025
3439
  }
4026
3440
  },
3441
+ {
3442
+ "kind": "js",
3443
+ "name": "*",
3444
+ "declaration": {
3445
+ "name": "*",
3446
+ "package": "@nvidia-elements/core/format-datetime"
3447
+ }
3448
+ },
3449
+ {
3450
+ "kind": "js",
3451
+ "name": "*",
3452
+ "declaration": {
3453
+ "name": "*",
3454
+ "package": "@nvidia-elements/core/format-relative-time"
3455
+ }
3456
+ },
4027
3457
  {
4028
3458
  "kind": "js",
4029
3459
  "name": "*",
@@ -8841,6 +8271,10 @@
8841
8271
  {
8842
8272
  "description": "The icon element",
8843
8273
  "name": "icon"
8274
+ },
8275
+ {
8276
+ "description": "The menu item element for creating new options",
8277
+ "name": "create-option"
8844
8278
  }
8845
8279
  ],
8846
8280
  "slots": [
@@ -8910,139 +8344,8 @@
8910
8344
  "reflects": true
8911
8345
  },
8912
8346
  {
8913
- "kind": "method",
8914
- "name": "reset",
8915
- "description": "Resets control value to initial attribute value and clears any active validation rules.",
8916
- "inheritedFrom": {
8917
- "name": "Control",
8918
- "module": "/src/forms/control/control.js"
8919
- }
8920
- },
8921
- {
8922
- "kind": "method",
8923
- "name": "selectAll",
8924
- "description": "Select all options provided"
8925
- },
8926
- {
8927
- "name": "nve-layout",
8928
- "deprecated": true,
8929
- "description": "not supported on custom element tags",
8930
- "type": {
8931
- "text": "string",
8932
- "values": [
8933
- {
8934
- "value": "string",
8935
- "description": ""
8936
- },
8937
- {
8938
- "value": "string",
8939
- "description": ""
8940
- }
8941
- ],
8942
- "_sourceAliases": []
8943
- },
8944
- "attribute": "nve-layout",
8945
8347
  "kind": "field",
8946
- "inheritedFrom": {
8947
- "name": "Control",
8948
- "module": "/src/forms/control/control.js"
8949
- }
8950
- },
8951
- {
8952
- "name": "nve-text",
8953
- "deprecated": true,
8954
- "description": "not supported on custom element tags",
8955
- "type": {
8956
- "text": "string",
8957
- "values": [
8958
- {
8959
- "value": "string",
8960
- "description": ""
8961
- },
8962
- {
8963
- "value": "string",
8964
- "description": ""
8965
- }
8966
- ],
8967
- "_sourceAliases": []
8968
- },
8969
- "attribute": "nve-text",
8970
- "kind": "field",
8971
- "inheritedFrom": {
8972
- "name": "Control",
8973
- "module": "/src/forms/control/control.js"
8974
- }
8975
- },
8976
- {
8977
- "kind": "field",
8978
- "name": "status",
8979
- "type": {
8980
- "text": "'warning' | 'error' | 'success' | 'disabled'",
8981
- "_sourceAliases": [],
8982
- "values": [
8983
- {
8984
- "value": "warning",
8985
- "description": "Indicates cautionary actions that require careful consideration before proceeding."
8986
- },
8987
- {
8988
- "value": "success",
8989
- "description": "Represents positive outcomes, confirmations, or constructive actions."
8990
- },
8991
- {
8992
- "value": "error",
8993
- "description": ""
8994
- },
8995
- {
8996
- "value": "disabled",
8997
- "description": ""
8998
- }
8999
- ]
9000
- },
9001
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.",
9002
- "attribute": "status",
9003
- "inheritedFrom": {
9004
- "name": "Control",
9005
- "module": "/src/forms/control/control.js"
9006
- },
9007
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
9008
- },
9009
- {
9010
- "kind": "field",
9011
- "name": "layout",
9012
- "type": {
9013
- "text": "| 'vertical'\n | 'vertical-inline'\n | 'horizontal'\n | 'horizontal-inline'",
9014
- "_sourceAliases": [],
9015
- "values": [
9016
- {
9017
- "value": "vertical",
9018
- "description": "Arranges content in a vertical stack with block-level spacing."
9019
- },
9020
- {
9021
- "value": "vertical-inline",
9022
- "description": "Arranges content vertically with compact inline spacing for dense layouts."
9023
- },
9024
- {
9025
- "value": "horizontal",
9026
- "description": "Arranges content in a horizontal row with block-level spacing."
9027
- },
9028
- {
9029
- "value": "horizontal-inline",
9030
- "description": "Arranges content horizontally with compact inline spacing."
9031
- }
9032
- ]
9033
- },
9034
- "description": "Controls the directional arrangement and spacing behavior of the element's content.\n- `vertical` Arranges content in a vertical stack with block-level spacing.\n\n- `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts.\n\n- `horizontal` Arranges content in a horizontal row with block-level spacing.\n\n- `horizontal-inline` Arranges content horizontally with compact inline spacing.",
9035
- "attribute": "layout",
9036
- "reflects": true,
9037
- "inheritedFrom": {
9038
- "name": "Control",
9039
- "module": "/src/forms/control/control.js"
9040
- },
9041
- "descriptionText": "Controls the directional arrangement and spacing behavior of the element's content."
9042
- },
9043
- {
9044
- "kind": "field",
9045
- "name": "fitText",
8348
+ "name": "behaviorCreate",
9046
8349
  "type": {
9047
8350
  "text": "boolean",
9048
8351
  "_sourceAliases": [],
@@ -9057,154 +8360,332 @@
9057
8360
  }
9058
8361
  ]
9059
8362
  },
9060
- "default": "false",
9061
- "description": "Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)",
9062
- "attribute": "fit-text",
9063
- "reflects": true,
9064
- "inheritedFrom": {
9065
- "name": "Control",
9066
- "module": "/src/forms/control/control.js"
9067
- }
9068
- },
9069
- {
9070
- "kind": "field",
9071
- "name": "fitContent",
9072
- "type": {
9073
- "text": "boolean",
9074
- "_sourceAliases": [],
9075
- "values": [
9076
- {
9077
- "value": "true",
9078
- "description": ""
9079
- },
9080
- {
9081
- "value": "false",
9082
- "description": ""
9083
- }
9084
- ]
9085
- },
9086
- "default": "false",
9087
- "description": "Sets the input to match native default content block",
9088
- "attribute": "fit-content",
9089
- "reflects": true,
9090
- "inheritedFrom": {
9091
- "name": "Control",
9092
- "module": "/src/forms/control/control.js"
9093
- }
9094
- },
9095
- {
9096
- "kind": "field",
9097
- "name": "i18n",
9098
- "description": "Enables updating internal string values for internationalization.",
9099
- "attribute": "i18n",
9100
- "inheritedFrom": {
9101
- "name": "Control",
9102
- "module": "/src/forms/control/control.js"
9103
- }
9104
- },
9105
- {
9106
- "kind": "field",
9107
- "name": "prominence",
9108
- "type": {
9109
- "text": "'muted'",
9110
- "_sourceAliases": [],
9111
- "values": [
9112
- {
9113
- "value": "muted",
9114
- "description": "Reduces visual weight for supporting content that should remain subtle and unobtrusive."
9115
- }
9116
- ]
9117
- },
9118
- "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive.",
9119
- "attribute": "prominence",
9120
- "reflects": true,
9121
- "inheritedFrom": {
9122
- "name": "Control",
9123
- "module": "/src/forms/control/control.js"
9124
- },
9125
- "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
9126
- },
9127
- {
9128
- "kind": "field",
9129
- "name": "nveControl",
9130
- "type": {
9131
- "text": "string",
9132
- "_sourceAliases": [],
9133
- "values": [
9134
- {
9135
- "value": "string",
9136
- "description": ""
9137
- }
9138
- ]
9139
- },
9140
- "privacy": "protected",
9141
- "default": "''",
9142
- "inheritedFrom": {
9143
- "name": "Control",
9144
- "module": "/src/forms/control/control.js"
9145
- }
8363
+ "description": "Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail.",
8364
+ "attribute": "behavior-create",
8365
+ "reflects": true
9146
8366
  },
9147
8367
  {
9148
8368
  "kind": "method",
9149
- "name": "showPicker",
9150
- "privacy": "protected",
9151
- "inheritedFrom": {
9152
- "name": "Control",
9153
- "module": "/src/forms/control/control.js"
9154
- }
9155
- }
9156
- ],
9157
- "events": [
9158
- {
9159
- "description": "Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.",
9160
- "name": "scroll"
9161
- },
9162
- {
9163
8369
  "name": "reset",
9164
- "type": {
9165
- "text": "CustomEvent"
9166
- },
8370
+ "description": "Resets control value to initial attribute value and clears any active validation rules.",
9167
8371
  "inheritedFrom": {
9168
8372
  "name": "Control",
9169
8373
  "module": "/src/forms/control/control.js"
9170
8374
  }
9171
- }
9172
- ],
9173
- "attributes": [
9174
- {
9175
- "name": "container",
9176
- "type": {
9177
- "text": "'flat'",
9178
- "_sourceAliases": [],
9179
- "values": [
9180
- {
9181
- "value": "flat",
9182
- "description": "Element has white space bounds but reduced visual container."
9183
- }
9184
- ]
9185
- },
9186
- "description": "Demonstrates different container styles to accommodate visual weight and context.\n- `flat` Element has white space bounds but reduced visual container.",
9187
- "fieldName": "container",
9188
- "descriptionText": "Demonstrates different container styles to accommodate visual weight and context."
9189
8375
  },
9190
8376
  {
9191
- "name": "notags",
9192
- "type": {
9193
- "text": "boolean",
9194
- "_sourceAliases": [],
9195
- "values": [
9196
- {
9197
- "value": "true",
9198
- "description": ""
9199
- },
9200
- {
9201
- "value": "false",
9202
- "description": ""
9203
- }
9204
- ]
9205
- },
9206
- "description": "Disable rendering of inline tags for many-item select",
9207
- "fieldName": "notags"
8377
+ "kind": "method",
8378
+ "name": "selectAll",
8379
+ "description": "Select all options provided"
8380
+ },
8381
+ {
8382
+ "name": "nve-layout",
8383
+ "deprecated": true,
8384
+ "description": "not supported on custom element tags",
8385
+ "type": {
8386
+ "text": "string",
8387
+ "values": [
8388
+ {
8389
+ "value": "string",
8390
+ "description": ""
8391
+ },
8392
+ {
8393
+ "value": "string",
8394
+ "description": ""
8395
+ }
8396
+ ],
8397
+ "_sourceAliases": []
8398
+ },
8399
+ "attribute": "nve-layout",
8400
+ "kind": "field",
8401
+ "inheritedFrom": {
8402
+ "name": "Control",
8403
+ "module": "/src/forms/control/control.js"
8404
+ }
8405
+ },
8406
+ {
8407
+ "name": "nve-text",
8408
+ "deprecated": true,
8409
+ "description": "not supported on custom element tags",
8410
+ "type": {
8411
+ "text": "string",
8412
+ "values": [
8413
+ {
8414
+ "value": "string",
8415
+ "description": ""
8416
+ },
8417
+ {
8418
+ "value": "string",
8419
+ "description": ""
8420
+ }
8421
+ ],
8422
+ "_sourceAliases": []
8423
+ },
8424
+ "attribute": "nve-text",
8425
+ "kind": "field",
8426
+ "inheritedFrom": {
8427
+ "name": "Control",
8428
+ "module": "/src/forms/control/control.js"
8429
+ }
8430
+ },
8431
+ {
8432
+ "kind": "field",
8433
+ "name": "status",
8434
+ "type": {
8435
+ "text": "'warning' | 'error' | 'success' | 'disabled'",
8436
+ "_sourceAliases": [],
8437
+ "values": [
8438
+ {
8439
+ "value": "warning",
8440
+ "description": "Indicates cautionary actions that require careful consideration before proceeding."
8441
+ },
8442
+ {
8443
+ "value": "success",
8444
+ "description": "Represents positive outcomes, confirmations, or constructive actions."
8445
+ },
8446
+ {
8447
+ "value": "error",
8448
+ "description": ""
8449
+ },
8450
+ {
8451
+ "value": "disabled",
8452
+ "description": ""
8453
+ }
8454
+ ]
8455
+ },
8456
+ "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.",
8457
+ "attribute": "status",
8458
+ "inheritedFrom": {
8459
+ "name": "Control",
8460
+ "module": "/src/forms/control/control.js"
8461
+ },
8462
+ "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
8463
+ },
8464
+ {
8465
+ "kind": "field",
8466
+ "name": "layout",
8467
+ "type": {
8468
+ "text": "| 'vertical'\n | 'vertical-inline'\n | 'horizontal'\n | 'horizontal-inline'",
8469
+ "_sourceAliases": [],
8470
+ "values": [
8471
+ {
8472
+ "value": "vertical",
8473
+ "description": "Arranges content in a vertical stack with block-level spacing."
8474
+ },
8475
+ {
8476
+ "value": "vertical-inline",
8477
+ "description": "Arranges content vertically with compact inline spacing for dense layouts."
8478
+ },
8479
+ {
8480
+ "value": "horizontal",
8481
+ "description": "Arranges content in a horizontal row with block-level spacing."
8482
+ },
8483
+ {
8484
+ "value": "horizontal-inline",
8485
+ "description": "Arranges content horizontally with compact inline spacing."
8486
+ }
8487
+ ]
8488
+ },
8489
+ "description": "Controls the directional arrangement and spacing behavior of the element's content.\n- `vertical` Arranges content in a vertical stack with block-level spacing.\n\n- `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts.\n\n- `horizontal` Arranges content in a horizontal row with block-level spacing.\n\n- `horizontal-inline` Arranges content horizontally with compact inline spacing.",
8490
+ "attribute": "layout",
8491
+ "reflects": true,
8492
+ "inheritedFrom": {
8493
+ "name": "Control",
8494
+ "module": "/src/forms/control/control.js"
8495
+ },
8496
+ "descriptionText": "Controls the directional arrangement and spacing behavior of the element's content."
8497
+ },
8498
+ {
8499
+ "kind": "field",
8500
+ "name": "fitText",
8501
+ "type": {
8502
+ "text": "boolean",
8503
+ "_sourceAliases": [],
8504
+ "values": [
8505
+ {
8506
+ "value": "true",
8507
+ "description": ""
8508
+ },
8509
+ {
8510
+ "value": "false",
8511
+ "description": ""
8512
+ }
8513
+ ]
8514
+ },
8515
+ "default": "false",
8516
+ "description": "Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)",
8517
+ "attribute": "fit-text",
8518
+ "reflects": true,
8519
+ "inheritedFrom": {
8520
+ "name": "Control",
8521
+ "module": "/src/forms/control/control.js"
8522
+ }
8523
+ },
8524
+ {
8525
+ "kind": "field",
8526
+ "name": "fitContent",
8527
+ "type": {
8528
+ "text": "boolean",
8529
+ "_sourceAliases": [],
8530
+ "values": [
8531
+ {
8532
+ "value": "true",
8533
+ "description": ""
8534
+ },
8535
+ {
8536
+ "value": "false",
8537
+ "description": ""
8538
+ }
8539
+ ]
8540
+ },
8541
+ "default": "false",
8542
+ "description": "Sets the input to match native default content block",
8543
+ "attribute": "fit-content",
8544
+ "reflects": true,
8545
+ "inheritedFrom": {
8546
+ "name": "Control",
8547
+ "module": "/src/forms/control/control.js"
8548
+ }
8549
+ },
8550
+ {
8551
+ "kind": "field",
8552
+ "name": "i18n",
8553
+ "description": "Enables updating internal string values for internationalization.",
8554
+ "attribute": "i18n",
8555
+ "inheritedFrom": {
8556
+ "name": "Control",
8557
+ "module": "/src/forms/control/control.js"
8558
+ }
8559
+ },
8560
+ {
8561
+ "kind": "field",
8562
+ "name": "prominence",
8563
+ "type": {
8564
+ "text": "'muted'",
8565
+ "_sourceAliases": [],
8566
+ "values": [
8567
+ {
8568
+ "value": "muted",
8569
+ "description": "Reduces visual weight for supporting content that should remain subtle and unobtrusive."
8570
+ }
8571
+ ]
8572
+ },
8573
+ "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive.",
8574
+ "attribute": "prominence",
8575
+ "reflects": true,
8576
+ "inheritedFrom": {
8577
+ "name": "Control",
8578
+ "module": "/src/forms/control/control.js"
8579
+ },
8580
+ "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
8581
+ },
8582
+ {
8583
+ "kind": "field",
8584
+ "name": "nveControl",
8585
+ "type": {
8586
+ "text": "string",
8587
+ "_sourceAliases": [],
8588
+ "values": [
8589
+ {
8590
+ "value": "string",
8591
+ "description": ""
8592
+ }
8593
+ ]
8594
+ },
8595
+ "privacy": "protected",
8596
+ "default": "''",
8597
+ "inheritedFrom": {
8598
+ "name": "Control",
8599
+ "module": "/src/forms/control/control.js"
8600
+ }
8601
+ },
8602
+ {
8603
+ "kind": "method",
8604
+ "name": "showPicker",
8605
+ "privacy": "protected",
8606
+ "inheritedFrom": {
8607
+ "name": "Control",
8608
+ "module": "/src/forms/control/control.js"
8609
+ }
8610
+ }
8611
+ ],
8612
+ "events": [
8613
+ {
8614
+ "name": "create",
8615
+ "type": {
8616
+ "text": "CustomEvent"
8617
+ },
8618
+ "description": "Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`."
8619
+ },
8620
+ {
8621
+ "description": "Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.",
8622
+ "name": "scroll"
8623
+ },
8624
+ {
8625
+ "name": "reset",
8626
+ "type": {
8627
+ "text": "CustomEvent"
8628
+ },
8629
+ "inheritedFrom": {
8630
+ "name": "Control",
8631
+ "module": "/src/forms/control/control.js"
8632
+ }
8633
+ }
8634
+ ],
8635
+ "attributes": [
8636
+ {
8637
+ "name": "container",
8638
+ "type": {
8639
+ "text": "'flat'",
8640
+ "_sourceAliases": [],
8641
+ "values": [
8642
+ {
8643
+ "value": "flat",
8644
+ "description": "Element has white space bounds but reduced visual container."
8645
+ }
8646
+ ]
8647
+ },
8648
+ "description": "Demonstrates different container styles to accommodate visual weight and context.\n- `flat` Element has white space bounds but reduced visual container.",
8649
+ "fieldName": "container",
8650
+ "descriptionText": "Demonstrates different container styles to accommodate visual weight and context."
8651
+ },
8652
+ {
8653
+ "name": "notags",
8654
+ "type": {
8655
+ "text": "boolean",
8656
+ "_sourceAliases": [],
8657
+ "values": [
8658
+ {
8659
+ "value": "true",
8660
+ "description": ""
8661
+ },
8662
+ {
8663
+ "value": "false",
8664
+ "description": ""
8665
+ }
8666
+ ]
8667
+ },
8668
+ "description": "Disable rendering of inline tags for many-item select",
8669
+ "fieldName": "notags"
8670
+ },
8671
+ {
8672
+ "name": "behavior-create",
8673
+ "type": {
8674
+ "text": "boolean",
8675
+ "_sourceAliases": [],
8676
+ "values": [
8677
+ {
8678
+ "value": "true",
8679
+ "description": ""
8680
+ },
8681
+ {
8682
+ "value": "false",
8683
+ "description": ""
8684
+ }
8685
+ ]
8686
+ },
8687
+ "description": "Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail.",
8688
+ "fieldName": "behaviorCreate"
9208
8689
  },
9209
8690
  {
9210
8691
  "name": "nve-layout",
@@ -9415,7 +8896,7 @@
9415
8896
  "since": "0.17.0",
9416
8897
  "status": "stable",
9417
8898
  "behavior": "form",
9418
- "markdown": "## nve-combobox\n\nAn editable combobox with autocomplete behavior and selection support.\n\n### Example\n\n```html\n<nve-combobox>\n <label>label</label>\n <input type=\"search\" />\n <datalist>\n <option value=\"status\"></option>\n <option value=\"priority\"></option>\n <option value=\"date\"></option>\n <option value=\"session\"></option>\n <option value=\"configuration\"></option>\n <option value=\"contains\"></option>\n </datalist>\n <nve-control-message>message</nve-control-message>\n</nve-combobox>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/combobox/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for an input and a datalist/select element |\n| prefix-icon | `string` | slot for icon before the input |\n| footer | `string` | slot for dropdown footer content |\n| label | `string` | Label element |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| container | `'flat'` | Demonstrates different container styles to accommodate visual weight and context. - `flat` Element has white space bounds but reduced visual container. |\n| notags | `boolean` | Disable rendering of inline tags for many-item select |\n| reset | | Resets control value to initial attribute value and clears any active validation rules. |\n| selectAll | | Select all options provided |\n| status | `'warning' \\| 'error' \\| 'success' \\| 'disabled'` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. |\n| layout | `\\| 'vertical'\n \\| 'vertical-inline'\n \\| 'horizontal'\n \\| 'horizontal-inline'` | Controls the directional arrangement and spacing behavior of the element's content. - `vertical` Arranges content in a vertical stack with block-level spacing. - `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts. - `horizontal` Arranges content in a horizontal row with block-level spacing. - `horizontal-inline` Arranges content horizontally with compact inline spacing. |\n| fitText (fit-text) | `boolean` | Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select) |\n| fitContent (fit-content) | `boolean` | Sets the input to match native default content block |\n| i18n | | Enables updating internal string values for internationalization. |\n| prominence | `'muted'` | Controls the visual prominence to establish hierarchy and guide user attention. - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. |\n| nveControl | `string` | |\n| showPicker | | |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| scroll | `CustomEvent` | Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. |\n| reset | `CustomEvent` | |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --scroll-height | `string` | |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --border-color | `string` | [MDN](https://mdn.dev/CSS/border-color) |\n| --max-height | `string` | [MDN](https://mdn.dev/CSS/max-height) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |\n| --accent-color | `string` | [MDN](https://mdn.dev/CSS/accent-color) |\n| --label-color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --label-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --label-font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --label-font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --control-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --control-height | `string` | [MDN](https://mdn.dev/CSS/height) |"
8899
+ "markdown": "## nve-combobox\n\nAn editable combobox with autocomplete behavior and selection support.\n\n### Example\n\n```html\n<nve-combobox>\n <label>label</label>\n <input type=\"search\" />\n <datalist>\n <option value=\"status\"></option>\n <option value=\"priority\"></option>\n <option value=\"date\"></option>\n <option value=\"session\"></option>\n <option value=\"configuration\"></option>\n <option value=\"contains\"></option>\n </datalist>\n <nve-control-message>message</nve-control-message>\n</nve-combobox>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/combobox/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for an input and a datalist/select element |\n| prefix-icon | `string` | slot for icon before the input |\n| footer | `string` | slot for dropdown footer content |\n| label | `string` | Label element |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| container | `'flat'` | Demonstrates different container styles to accommodate visual weight and context. - `flat` Element has white space bounds but reduced visual container. |\n| notags | `boolean` | Disable rendering of inline tags for many-item select |\n| behaviorCreate (behavior-create) | `boolean` | Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail. |\n| reset | | Resets control value to initial attribute value and clears any active validation rules. |\n| selectAll | | Select all options provided |\n| status | `'warning' \\| 'error' \\| 'success' \\| 'disabled'` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. |\n| layout | `\\| 'vertical'\n \\| 'vertical-inline'\n \\| 'horizontal'\n \\| 'horizontal-inline'` | Controls the directional arrangement and spacing behavior of the element's content. - `vertical` Arranges content in a vertical stack with block-level spacing. - `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts. - `horizontal` Arranges content in a horizontal row with block-level spacing. - `horizontal-inline` Arranges content horizontally with compact inline spacing. |\n| fitText (fit-text) | `boolean` | Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select) |\n| fitContent (fit-content) | `boolean` | Sets the input to match native default content block |\n| i18n | | Enables updating internal string values for internationalization. |\n| prominence | `'muted'` | Controls the visual prominence to establish hierarchy and guide user attention. - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. |\n| nveControl | `string` | |\n| showPicker | | |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| create | `CustomEvent` | Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`. |\n| scroll | `CustomEvent` | Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. |\n| reset | `CustomEvent` | |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --scroll-height | `string` | |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --border-color | `string` | [MDN](https://mdn.dev/CSS/border-color) |\n| --max-height | `string` | [MDN](https://mdn.dev/CSS/max-height) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |\n| --accent-color | `string` | [MDN](https://mdn.dev/CSS/accent-color) |\n| --label-color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --label-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --label-font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --label-font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --control-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --control-height | `string` | [MDN](https://mdn.dev/CSS/height) |"
9419
8900
  }
9420
8901
  }
9421
8902
  ],
@@ -16474,135 +15955,1374 @@
16474
15955
  "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/width)"
16475
15956
  },
16476
15957
  {
16477
- "name": "--control-height",
16478
- "inheritedFrom": {
16479
- "name": "Control",
16480
- "module": "/src/forms/control/control.js"
16481
- },
16482
- "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/height)"
15958
+ "name": "--control-height",
15959
+ "inheritedFrom": {
15960
+ "name": "Control",
15961
+ "module": "/src/forms/control/control.js"
15962
+ },
15963
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/height)"
15964
+ }
15965
+ ],
15966
+ "members": [
15967
+ {
15968
+ "name": "nve-layout",
15969
+ "deprecated": true,
15970
+ "description": "not supported on custom element tags",
15971
+ "type": {
15972
+ "text": "string",
15973
+ "values": [
15974
+ {
15975
+ "value": "string",
15976
+ "description": ""
15977
+ },
15978
+ {
15979
+ "value": "string",
15980
+ "description": ""
15981
+ }
15982
+ ],
15983
+ "_sourceAliases": []
15984
+ },
15985
+ "attribute": "nve-layout",
15986
+ "kind": "field",
15987
+ "inheritedFrom": {
15988
+ "name": "Control",
15989
+ "module": "/src/forms/control/control.js"
15990
+ }
15991
+ },
15992
+ {
15993
+ "name": "nve-text",
15994
+ "deprecated": true,
15995
+ "description": "not supported on custom element tags",
15996
+ "type": {
15997
+ "text": "string",
15998
+ "values": [
15999
+ {
16000
+ "value": "string",
16001
+ "description": ""
16002
+ },
16003
+ {
16004
+ "value": "string",
16005
+ "description": ""
16006
+ }
16007
+ ],
16008
+ "_sourceAliases": []
16009
+ },
16010
+ "attribute": "nve-text",
16011
+ "kind": "field",
16012
+ "inheritedFrom": {
16013
+ "name": "Control",
16014
+ "module": "/src/forms/control/control.js"
16015
+ }
16016
+ },
16017
+ {
16018
+ "kind": "field",
16019
+ "name": "status",
16020
+ "type": {
16021
+ "text": "'warning' | 'error' | 'success' | 'disabled'",
16022
+ "_sourceAliases": [],
16023
+ "values": [
16024
+ {
16025
+ "value": "warning",
16026
+ "description": "Indicates cautionary actions that require careful consideration before proceeding."
16027
+ },
16028
+ {
16029
+ "value": "success",
16030
+ "description": "Represents positive outcomes, confirmations, or constructive actions."
16031
+ },
16032
+ {
16033
+ "value": "error",
16034
+ "description": ""
16035
+ },
16036
+ {
16037
+ "value": "disabled",
16038
+ "description": ""
16039
+ }
16040
+ ]
16041
+ },
16042
+ "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.",
16043
+ "attribute": "status",
16044
+ "inheritedFrom": {
16045
+ "name": "Control",
16046
+ "module": "/src/forms/control/control.js"
16047
+ },
16048
+ "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
16049
+ },
16050
+ {
16051
+ "kind": "field",
16052
+ "name": "layout",
16053
+ "type": {
16054
+ "text": "| 'vertical'\n | 'vertical-inline'\n | 'horizontal'\n | 'horizontal-inline'",
16055
+ "_sourceAliases": [],
16056
+ "values": [
16057
+ {
16058
+ "value": "vertical",
16059
+ "description": "Arranges content in a vertical stack with block-level spacing."
16060
+ },
16061
+ {
16062
+ "value": "vertical-inline",
16063
+ "description": "Arranges content vertically with compact inline spacing for dense layouts."
16064
+ },
16065
+ {
16066
+ "value": "horizontal",
16067
+ "description": "Arranges content in a horizontal row with block-level spacing."
16068
+ },
16069
+ {
16070
+ "value": "horizontal-inline",
16071
+ "description": "Arranges content horizontally with compact inline spacing."
16072
+ }
16073
+ ]
16074
+ },
16075
+ "description": "Controls the directional arrangement and spacing behavior of the element's content.\n- `vertical` Arranges content in a vertical stack with block-level spacing.\n\n- `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts.\n\n- `horizontal` Arranges content in a horizontal row with block-level spacing.\n\n- `horizontal-inline` Arranges content horizontally with compact inline spacing.",
16076
+ "attribute": "layout",
16077
+ "reflects": true,
16078
+ "inheritedFrom": {
16079
+ "name": "Control",
16080
+ "module": "/src/forms/control/control.js"
16081
+ },
16082
+ "descriptionText": "Controls the directional arrangement and spacing behavior of the element's content."
16083
+ },
16084
+ {
16085
+ "kind": "field",
16086
+ "name": "fitText",
16087
+ "type": {
16088
+ "text": "boolean",
16089
+ "_sourceAliases": [],
16090
+ "values": [
16091
+ {
16092
+ "value": "true",
16093
+ "description": ""
16094
+ },
16095
+ {
16096
+ "value": "false",
16097
+ "description": ""
16098
+ }
16099
+ ]
16100
+ },
16101
+ "default": "false",
16102
+ "description": "Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)",
16103
+ "attribute": "fit-text",
16104
+ "reflects": true,
16105
+ "inheritedFrom": {
16106
+ "name": "Control",
16107
+ "module": "/src/forms/control/control.js"
16108
+ }
16109
+ },
16110
+ {
16111
+ "kind": "field",
16112
+ "name": "fitContent",
16113
+ "type": {
16114
+ "text": "boolean",
16115
+ "_sourceAliases": [],
16116
+ "values": [
16117
+ {
16118
+ "value": "true",
16119
+ "description": ""
16120
+ },
16121
+ {
16122
+ "value": "false",
16123
+ "description": ""
16124
+ }
16125
+ ]
16126
+ },
16127
+ "default": "false",
16128
+ "description": "Sets the input to match native default content block",
16129
+ "attribute": "fit-content",
16130
+ "reflects": true,
16131
+ "inheritedFrom": {
16132
+ "name": "Control",
16133
+ "module": "/src/forms/control/control.js"
16134
+ }
16135
+ },
16136
+ {
16137
+ "kind": "field",
16138
+ "name": "i18n",
16139
+ "description": "Enables updating internal string values for internationalization.",
16140
+ "attribute": "i18n",
16141
+ "inheritedFrom": {
16142
+ "name": "Control",
16143
+ "module": "/src/forms/control/control.js"
16144
+ }
16145
+ },
16146
+ {
16147
+ "kind": "field",
16148
+ "name": "prominence",
16149
+ "type": {
16150
+ "text": "'muted'",
16151
+ "_sourceAliases": [],
16152
+ "values": [
16153
+ {
16154
+ "value": "muted",
16155
+ "description": "Reduces visual weight for supporting content that should remain subtle and unobtrusive."
16156
+ }
16157
+ ]
16158
+ },
16159
+ "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive.",
16160
+ "attribute": "prominence",
16161
+ "reflects": true,
16162
+ "inheritedFrom": {
16163
+ "name": "Control",
16164
+ "module": "/src/forms/control/control.js"
16165
+ },
16166
+ "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
16167
+ },
16168
+ {
16169
+ "kind": "field",
16170
+ "name": "nveControl",
16171
+ "type": {
16172
+ "text": "string",
16173
+ "_sourceAliases": [],
16174
+ "values": [
16175
+ {
16176
+ "value": "string",
16177
+ "description": ""
16178
+ }
16179
+ ]
16180
+ },
16181
+ "privacy": "protected",
16182
+ "default": "''",
16183
+ "inheritedFrom": {
16184
+ "name": "Control",
16185
+ "module": "/src/forms/control/control.js"
16186
+ }
16187
+ },
16188
+ {
16189
+ "kind": "method",
16190
+ "name": "reset",
16191
+ "description": "Resets control value to initial attribute value and clears any active validation rules.",
16192
+ "inheritedFrom": {
16193
+ "name": "Control",
16194
+ "module": "/src/forms/control/control.js"
16195
+ }
16196
+ },
16197
+ {
16198
+ "kind": "method",
16199
+ "name": "showPicker",
16200
+ "privacy": "protected",
16201
+ "inheritedFrom": {
16202
+ "name": "Control",
16203
+ "module": "/src/forms/control/control.js"
16204
+ }
16205
+ }
16206
+ ],
16207
+ "attributes": [
16208
+ {
16209
+ "name": "nve-layout",
16210
+ "deprecated": true,
16211
+ "description": "not supported on custom element tags",
16212
+ "type": {
16213
+ "text": "string",
16214
+ "values": [
16215
+ {
16216
+ "value": "string",
16217
+ "description": ""
16218
+ },
16219
+ {
16220
+ "value": "string",
16221
+ "description": ""
16222
+ }
16223
+ ],
16224
+ "_sourceAliases": []
16225
+ },
16226
+ "inheritedFrom": {
16227
+ "name": "Control",
16228
+ "module": "/src/forms/control/control.js"
16229
+ }
16230
+ },
16231
+ {
16232
+ "name": "nve-text",
16233
+ "deprecated": true,
16234
+ "description": "not supported on custom element tags",
16235
+ "type": {
16236
+ "text": "string",
16237
+ "values": [
16238
+ {
16239
+ "value": "string",
16240
+ "description": ""
16241
+ },
16242
+ {
16243
+ "value": "string",
16244
+ "description": ""
16245
+ }
16246
+ ],
16247
+ "_sourceAliases": []
16248
+ },
16249
+ "inheritedFrom": {
16250
+ "name": "Control",
16251
+ "module": "/src/forms/control/control.js"
16252
+ }
16253
+ },
16254
+ {
16255
+ "name": "status",
16256
+ "type": {
16257
+ "text": "'warning' | 'error' | 'success' | 'disabled'",
16258
+ "_sourceAliases": [],
16259
+ "values": [
16260
+ {
16261
+ "value": "warning",
16262
+ "description": "Indicates cautionary actions that require careful consideration before proceeding."
16263
+ },
16264
+ {
16265
+ "value": "success",
16266
+ "description": "Represents positive outcomes, confirmations, or constructive actions."
16267
+ },
16268
+ {
16269
+ "value": "error",
16270
+ "description": ""
16271
+ },
16272
+ {
16273
+ "value": "disabled",
16274
+ "description": ""
16275
+ }
16276
+ ]
16277
+ },
16278
+ "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.",
16279
+ "fieldName": "status",
16280
+ "inheritedFrom": {
16281
+ "name": "Control",
16282
+ "module": "/src/forms/control/control.js"
16283
+ },
16284
+ "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
16285
+ },
16286
+ {
16287
+ "name": "layout",
16288
+ "type": {
16289
+ "text": "| 'vertical'\n | 'vertical-inline'\n | 'horizontal'\n | 'horizontal-inline'",
16290
+ "_sourceAliases": [],
16291
+ "values": [
16292
+ {
16293
+ "value": "vertical",
16294
+ "description": "Arranges content in a vertical stack with block-level spacing."
16295
+ },
16296
+ {
16297
+ "value": "vertical-inline",
16298
+ "description": "Arranges content vertically with compact inline spacing for dense layouts."
16299
+ },
16300
+ {
16301
+ "value": "horizontal",
16302
+ "description": "Arranges content in a horizontal row with block-level spacing."
16303
+ },
16304
+ {
16305
+ "value": "horizontal-inline",
16306
+ "description": "Arranges content horizontally with compact inline spacing."
16307
+ }
16308
+ ]
16309
+ },
16310
+ "description": "Controls the directional arrangement and spacing behavior of the element's content.\n- `vertical` Arranges content in a vertical stack with block-level spacing.\n\n- `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts.\n\n- `horizontal` Arranges content in a horizontal row with block-level spacing.\n\n- `horizontal-inline` Arranges content horizontally with compact inline spacing.",
16311
+ "fieldName": "layout",
16312
+ "inheritedFrom": {
16313
+ "name": "Control",
16314
+ "module": "/src/forms/control/control.js"
16315
+ },
16316
+ "descriptionText": "Controls the directional arrangement and spacing behavior of the element's content."
16317
+ },
16318
+ {
16319
+ "name": "fit-text",
16320
+ "type": {
16321
+ "text": "boolean",
16322
+ "_sourceAliases": [],
16323
+ "values": [
16324
+ {
16325
+ "value": "true",
16326
+ "description": ""
16327
+ },
16328
+ {
16329
+ "value": "false",
16330
+ "description": ""
16331
+ }
16332
+ ]
16333
+ },
16334
+ "default": "false",
16335
+ "description": "Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)",
16336
+ "fieldName": "fitText",
16337
+ "inheritedFrom": {
16338
+ "name": "Control",
16339
+ "module": "/src/forms/control/control.js"
16340
+ }
16341
+ },
16342
+ {
16343
+ "name": "fit-content",
16344
+ "type": {
16345
+ "text": "boolean",
16346
+ "_sourceAliases": [],
16347
+ "values": [
16348
+ {
16349
+ "value": "true",
16350
+ "description": ""
16351
+ },
16352
+ {
16353
+ "value": "false",
16354
+ "description": ""
16355
+ }
16356
+ ]
16357
+ },
16358
+ "default": "false",
16359
+ "description": "Sets the input to match native default content block",
16360
+ "fieldName": "fitContent",
16361
+ "inheritedFrom": {
16362
+ "name": "Control",
16363
+ "module": "/src/forms/control/control.js"
16364
+ }
16365
+ },
16366
+ {
16367
+ "name": "i18n",
16368
+ "description": "Enables updating internal string values for internationalization.",
16369
+ "fieldName": "i18n",
16370
+ "inheritedFrom": {
16371
+ "name": "Control",
16372
+ "module": "/src/forms/control/control.js"
16373
+ }
16374
+ },
16375
+ {
16376
+ "name": "prominence",
16377
+ "type": {
16378
+ "text": "'muted'",
16379
+ "_sourceAliases": [],
16380
+ "values": [
16381
+ {
16382
+ "value": "muted",
16383
+ "description": "Reduces visual weight for supporting content that should remain subtle and unobtrusive."
16384
+ }
16385
+ ]
16386
+ },
16387
+ "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive.",
16388
+ "fieldName": "prominence",
16389
+ "inheritedFrom": {
16390
+ "name": "Control",
16391
+ "module": "/src/forms/control/control.js"
16392
+ },
16393
+ "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
16394
+ }
16395
+ ],
16396
+ "superclass": {
16397
+ "name": "Control",
16398
+ "package": "@nvidia-elements/core/forms"
16399
+ },
16400
+ "tagName": "nve-file",
16401
+ "customElement": true,
16402
+ "metadata": {
16403
+ "unitTests": true,
16404
+ "apiReview": true,
16405
+ "performance": true,
16406
+ "stable": true,
16407
+ "vqa": true,
16408
+ "responsive": true,
16409
+ "themes": true,
16410
+ "aria": "https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file",
16411
+ "entrypoint": "@nvidia-elements/core/file",
16412
+ "example": "<nve-file>\n <label>file</label>\n <input type=\"file\" />\n <nve-control-message>message</nve-control-message>\n</nve-file>",
16413
+ "package": true,
16414
+ "since": "0.3.0",
16415
+ "status": "stable",
16416
+ "behavior": "form",
16417
+ "markdown": "## nve-file\n\nA file picker is a control that enables users to choose a file value.\n\n### Example\n\n```html\n<nve-file>\n <label>file</label>\n <input type=\"file\" />\n <nve-control-message>message</nve-control-message>\n</nve-file>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/file/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Control input element |\n| label | `string` | Label element |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| status | `'warning' \\| 'error' \\| 'success' \\| 'disabled'` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. |\n| layout | `\\| 'vertical'\n \\| 'vertical-inline'\n \\| 'horizontal'\n \\| 'horizontal-inline'` | Controls the directional arrangement and spacing behavior of the element's content. - `vertical` Arranges content in a vertical stack with block-level spacing. - `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts. - `horizontal` Arranges content in a horizontal row with block-level spacing. - `horizontal-inline` Arranges content horizontally with compact inline spacing. |\n| fitText (fit-text) | `boolean` | Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select) |\n| fitContent (fit-content) | `boolean` | Sets the input to match native default content block |\n| i18n | | Enables updating internal string values for internationalization. |\n| prominence | `'muted'` | Controls the visual prominence to establish hierarchy and guide user attention. - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. |\n| nveControl | `string` | |\n| reset | | Resets control value to initial attribute value and clears any active validation rules. |\n| showPicker | | |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| reset | `CustomEvent` | |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --text-decoration | `string` | [MDN](https://mdn.dev/CSS/text-decoration) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --accent-color | `string` | [MDN](https://mdn.dev/CSS/accent-color) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --label-color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --label-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --label-font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --label-font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --control-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --control-height | `string` | [MDN](https://mdn.dev/CSS/height) |"
16418
+ },
16419
+ "slots": [
16420
+ {
16421
+ "description": "Control input element",
16422
+ "name": "",
16423
+ "inheritedFrom": {
16424
+ "name": "Control",
16425
+ "module": "/src/forms/control/control.js"
16426
+ }
16427
+ },
16428
+ {
16429
+ "description": "Label element",
16430
+ "name": "label",
16431
+ "inheritedFrom": {
16432
+ "name": "Control",
16433
+ "module": "/src/forms/control/control.js"
16434
+ }
16435
+ }
16436
+ ],
16437
+ "events": [
16438
+ {
16439
+ "name": "reset",
16440
+ "type": {
16441
+ "text": "CustomEvent"
16442
+ },
16443
+ "inheritedFrom": {
16444
+ "name": "Control",
16445
+ "module": "/src/forms/control/control.js"
16446
+ }
16447
+ }
16448
+ ]
16449
+ }
16450
+ ],
16451
+ "exports": [
16452
+ {
16453
+ "kind": "js",
16454
+ "name": "File",
16455
+ "declaration": {
16456
+ "name": "File",
16457
+ "module": "/src/file/file.js"
16458
+ }
16459
+ }
16460
+ ]
16461
+ },
16462
+ {
16463
+ "kind": "javascript-module",
16464
+ "path": "/src/file/index.js",
16465
+ "declarations": [],
16466
+ "exports": [
16467
+ {
16468
+ "kind": "js",
16469
+ "name": "*",
16470
+ "declaration": {
16471
+ "name": "*",
16472
+ "module": "home/runner/work/elements/elements/projects/core/src/file/file.js"
16473
+ }
16474
+ }
16475
+ ]
16476
+ },
16477
+ {
16478
+ "kind": "javascript-module",
16479
+ "path": "/src/format-datetime/define.js",
16480
+ "declarations": [],
16481
+ "exports": []
16482
+ },
16483
+ {
16484
+ "kind": "javascript-module",
16485
+ "path": "/src/format-datetime/format-datetime.js",
16486
+ "declarations": [
16487
+ {
16488
+ "kind": "class",
16489
+ "description": "Formats a date/time value as localized text using the Intl.DateTimeFormat API. Renders inside a semantic time element.\nGranular options (weekday, year, month, day, hour, minute, second) mirror the Intl.DateTimeFormat API. 'numeric' omits zero-padding, '2-digit' zero-pads.",
16490
+ "name": "FormatDatetime",
16491
+ "slots": [
16492
+ {
16493
+ "description": "Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.",
16494
+ "name": ""
16495
+ }
16496
+ ],
16497
+ "members": [
16498
+ {
16499
+ "kind": "field",
16500
+ "name": "date",
16501
+ "type": {
16502
+ "text": "string | \"default\"",
16503
+ "_sourceAliases": [],
16504
+ "values": [
16505
+ {
16506
+ "value": "string",
16507
+ "description": ""
16508
+ }
16509
+ ]
16510
+ },
16511
+ "description": "Optional date string for values supplied by JavaScript or bound data.\nBy default, the component formats the element's text content, which also serves as the SSR fallback.\nWhen both are present, this property takes precedence.",
16512
+ "attribute": "date"
16513
+ },
16514
+ {
16515
+ "kind": "field",
16516
+ "name": "locale",
16517
+ "type": {
16518
+ "text": "string | \"default\"",
16519
+ "_sourceAliases": [],
16520
+ "values": [
16521
+ {
16522
+ "value": "string",
16523
+ "description": ""
16524
+ }
16525
+ ]
16526
+ },
16527
+ "description": "Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default.",
16528
+ "attribute": "locale"
16529
+ },
16530
+ {
16531
+ "kind": "field",
16532
+ "name": "weekday",
16533
+ "type": {
16534
+ "text": "'long' | 'short' | 'narrow' | \"default\"",
16535
+ "_sourceAliases": [],
16536
+ "values": [
16537
+ {
16538
+ "value": "long",
16539
+ "description": ""
16540
+ },
16541
+ {
16542
+ "value": "short",
16543
+ "description": ""
16544
+ },
16545
+ {
16546
+ "value": "narrow",
16547
+ "description": ""
16548
+ }
16549
+ ]
16550
+ },
16551
+ "description": "Weekday representation: 'long' | 'short' | 'narrow'.",
16552
+ "attribute": "weekday"
16553
+ },
16554
+ {
16555
+ "kind": "field",
16556
+ "name": "year",
16557
+ "type": {
16558
+ "text": "'numeric' | '2-digit' | \"default\"",
16559
+ "_sourceAliases": [],
16560
+ "values": [
16561
+ {
16562
+ "value": "numeric",
16563
+ "description": ""
16564
+ },
16565
+ {
16566
+ "value": "2-digit",
16567
+ "description": ""
16568
+ }
16569
+ ]
16570
+ },
16571
+ "description": "Year representation: 'numeric' | '2-digit'.",
16572
+ "attribute": "year"
16573
+ },
16574
+ {
16575
+ "kind": "field",
16576
+ "name": "month",
16577
+ "type": {
16578
+ "text": "'numeric' | '2-digit' | 'long' | 'short' | 'narrow' | \"default\"",
16579
+ "_sourceAliases": [],
16580
+ "values": [
16581
+ {
16582
+ "value": "numeric",
16583
+ "description": ""
16584
+ },
16585
+ {
16586
+ "value": "2-digit",
16587
+ "description": ""
16588
+ },
16589
+ {
16590
+ "value": "long",
16591
+ "description": ""
16592
+ },
16593
+ {
16594
+ "value": "short",
16595
+ "description": ""
16596
+ },
16597
+ {
16598
+ "value": "narrow",
16599
+ "description": ""
16600
+ }
16601
+ ]
16602
+ },
16603
+ "description": "Month representation: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow'.",
16604
+ "attribute": "month"
16605
+ },
16606
+ {
16607
+ "kind": "field",
16608
+ "name": "day",
16609
+ "type": {
16610
+ "text": "'numeric' | '2-digit' | \"default\"",
16611
+ "_sourceAliases": [],
16612
+ "values": [
16613
+ {
16614
+ "value": "numeric",
16615
+ "description": ""
16616
+ },
16617
+ {
16618
+ "value": "2-digit",
16619
+ "description": ""
16620
+ }
16621
+ ]
16622
+ },
16623
+ "description": "Day representation: 'numeric' | '2-digit'.",
16624
+ "attribute": "day"
16625
+ },
16626
+ {
16627
+ "kind": "field",
16628
+ "name": "hour",
16629
+ "type": {
16630
+ "text": "'numeric' | '2-digit' | \"default\"",
16631
+ "_sourceAliases": [],
16632
+ "values": [
16633
+ {
16634
+ "value": "numeric",
16635
+ "description": ""
16636
+ },
16637
+ {
16638
+ "value": "2-digit",
16639
+ "description": ""
16640
+ }
16641
+ ]
16642
+ },
16643
+ "description": "Hour representation: 'numeric' | '2-digit'.",
16644
+ "attribute": "hour"
16645
+ },
16646
+ {
16647
+ "kind": "field",
16648
+ "name": "minute",
16649
+ "type": {
16650
+ "text": "'numeric' | '2-digit' | \"default\"",
16651
+ "_sourceAliases": [],
16652
+ "values": [
16653
+ {
16654
+ "value": "numeric",
16655
+ "description": ""
16656
+ },
16657
+ {
16658
+ "value": "2-digit",
16659
+ "description": ""
16660
+ }
16661
+ ]
16662
+ },
16663
+ "description": "Minute representation: 'numeric' | '2-digit'.",
16664
+ "attribute": "minute"
16665
+ },
16666
+ {
16667
+ "kind": "field",
16668
+ "name": "second",
16669
+ "type": {
16670
+ "text": "'numeric' | '2-digit' | \"default\"",
16671
+ "_sourceAliases": [],
16672
+ "values": [
16673
+ {
16674
+ "value": "numeric",
16675
+ "description": ""
16676
+ },
16677
+ {
16678
+ "value": "2-digit",
16679
+ "description": ""
16680
+ }
16681
+ ]
16682
+ },
16683
+ "description": "Second representation: 'numeric' | '2-digit'.",
16684
+ "attribute": "second"
16685
+ },
16686
+ {
16687
+ "kind": "field",
16688
+ "name": "dateStyle",
16689
+ "type": {
16690
+ "text": "'full' | 'long' | 'medium' | 'short' | \"default\"",
16691
+ "_sourceAliases": [],
16692
+ "values": [
16693
+ {
16694
+ "value": "full",
16695
+ "description": ""
16696
+ },
16697
+ {
16698
+ "value": "long",
16699
+ "description": ""
16700
+ },
16701
+ {
16702
+ "value": "medium",
16703
+ "description": ""
16704
+ },
16705
+ {
16706
+ "value": "short",
16707
+ "description": ""
16708
+ }
16709
+ ]
16710
+ },
16711
+ "description": "Preset date formatting style: 'full' | 'long' | 'medium' | 'short'.\nPreset styles take precedence over granular date and time part options.",
16712
+ "attribute": "date-style"
16713
+ },
16714
+ {
16715
+ "kind": "field",
16716
+ "name": "timeStyle",
16717
+ "type": {
16718
+ "text": "'full' | 'long' | 'medium' | 'short' | \"default\"",
16719
+ "_sourceAliases": [],
16720
+ "values": [
16721
+ {
16722
+ "value": "full",
16723
+ "description": ""
16724
+ },
16725
+ {
16726
+ "value": "long",
16727
+ "description": ""
16728
+ },
16729
+ {
16730
+ "value": "medium",
16731
+ "description": ""
16732
+ },
16733
+ {
16734
+ "value": "short",
16735
+ "description": ""
16736
+ }
16737
+ ]
16738
+ },
16739
+ "description": "Preset time formatting style: 'full' | 'long' | 'medium' | 'short'.\nPreset styles take precedence over granular date and time part options.",
16740
+ "attribute": "time-style"
16741
+ },
16742
+ {
16743
+ "kind": "field",
16744
+ "name": "timeZoneName",
16745
+ "type": {
16746
+ "text": "'long' | 'short' | \"default\"",
16747
+ "_sourceAliases": [],
16748
+ "values": [
16749
+ {
16750
+ "value": "long",
16751
+ "description": ""
16752
+ },
16753
+ {
16754
+ "value": "short",
16755
+ "description": ""
16756
+ }
16757
+ ]
16758
+ },
16759
+ "description": "Time zone name display: 'long' | 'short'. Use it with granular options only; preset styles ignore it.",
16760
+ "attribute": "time-zone-name"
16761
+ },
16762
+ {
16763
+ "kind": "field",
16764
+ "name": "timeZone",
16765
+ "type": {
16766
+ "text": "string | \"default\"",
16767
+ "_sourceAliases": [],
16768
+ "values": [
16769
+ {
16770
+ "value": "string",
16771
+ "description": ""
16772
+ }
16773
+ ]
16774
+ },
16775
+ "description": "IANA time zone identifier (such as 'America/New_York', 'UTC').",
16776
+ "attribute": "time-zone"
16777
+ },
16778
+ {
16779
+ "name": "nve-layout",
16780
+ "deprecated": true,
16781
+ "description": "not supported on custom element tags",
16782
+ "type": {
16783
+ "text": "string",
16784
+ "values": [
16785
+ {
16786
+ "value": "string",
16787
+ "description": ""
16788
+ },
16789
+ {
16790
+ "value": "string",
16791
+ "description": ""
16792
+ }
16793
+ ],
16794
+ "_sourceAliases": []
16795
+ },
16796
+ "attribute": "nve-layout",
16797
+ "kind": "field"
16798
+ },
16799
+ {
16800
+ "name": "nve-text",
16801
+ "deprecated": true,
16802
+ "description": "not supported on custom element tags",
16803
+ "type": {
16804
+ "text": "string",
16805
+ "values": [
16806
+ {
16807
+ "value": "string",
16808
+ "description": ""
16809
+ },
16810
+ {
16811
+ "value": "string",
16812
+ "description": ""
16813
+ }
16814
+ ],
16815
+ "_sourceAliases": []
16816
+ },
16817
+ "attribute": "nve-text",
16818
+ "kind": "field"
16819
+ }
16820
+ ],
16821
+ "attributes": [
16822
+ {
16823
+ "name": "date",
16824
+ "type": {
16825
+ "text": "string | \"default\"",
16826
+ "_sourceAliases": [],
16827
+ "values": [
16828
+ {
16829
+ "value": "string",
16830
+ "description": ""
16831
+ }
16832
+ ]
16833
+ },
16834
+ "description": "Optional date string for values supplied by JavaScript or bound data.\nBy default, the component formats the element's text content, which also serves as the SSR fallback.\nWhen both are present, this property takes precedence.",
16835
+ "fieldName": "date"
16836
+ },
16837
+ {
16838
+ "name": "locale",
16839
+ "type": {
16840
+ "text": "string | \"default\"",
16841
+ "_sourceAliases": [],
16842
+ "values": [
16843
+ {
16844
+ "value": "string",
16845
+ "description": ""
16846
+ }
16847
+ ]
16848
+ },
16849
+ "description": "Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default.",
16850
+ "fieldName": "locale"
16851
+ },
16852
+ {
16853
+ "name": "weekday",
16854
+ "type": {
16855
+ "text": "'long' | 'short' | 'narrow' | \"default\"",
16856
+ "_sourceAliases": [],
16857
+ "values": [
16858
+ {
16859
+ "value": "long",
16860
+ "description": ""
16861
+ },
16862
+ {
16863
+ "value": "short",
16864
+ "description": ""
16865
+ },
16866
+ {
16867
+ "value": "narrow",
16868
+ "description": ""
16869
+ }
16870
+ ]
16871
+ },
16872
+ "description": "Weekday representation: 'long' | 'short' | 'narrow'.",
16873
+ "fieldName": "weekday"
16874
+ },
16875
+ {
16876
+ "name": "year",
16877
+ "type": {
16878
+ "text": "'numeric' | '2-digit' | \"default\"",
16879
+ "_sourceAliases": [],
16880
+ "values": [
16881
+ {
16882
+ "value": "numeric",
16883
+ "description": ""
16884
+ },
16885
+ {
16886
+ "value": "2-digit",
16887
+ "description": ""
16888
+ }
16889
+ ]
16890
+ },
16891
+ "description": "Year representation: 'numeric' | '2-digit'.",
16892
+ "fieldName": "year"
16893
+ },
16894
+ {
16895
+ "name": "month",
16896
+ "type": {
16897
+ "text": "'numeric' | '2-digit' | 'long' | 'short' | 'narrow' | \"default\"",
16898
+ "_sourceAliases": [],
16899
+ "values": [
16900
+ {
16901
+ "value": "numeric",
16902
+ "description": ""
16903
+ },
16904
+ {
16905
+ "value": "2-digit",
16906
+ "description": ""
16907
+ },
16908
+ {
16909
+ "value": "long",
16910
+ "description": ""
16911
+ },
16912
+ {
16913
+ "value": "short",
16914
+ "description": ""
16915
+ },
16916
+ {
16917
+ "value": "narrow",
16918
+ "description": ""
16919
+ }
16920
+ ]
16921
+ },
16922
+ "description": "Month representation: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow'.",
16923
+ "fieldName": "month"
16924
+ },
16925
+ {
16926
+ "name": "day",
16927
+ "type": {
16928
+ "text": "'numeric' | '2-digit' | \"default\"",
16929
+ "_sourceAliases": [],
16930
+ "values": [
16931
+ {
16932
+ "value": "numeric",
16933
+ "description": ""
16934
+ },
16935
+ {
16936
+ "value": "2-digit",
16937
+ "description": ""
16938
+ }
16939
+ ]
16940
+ },
16941
+ "description": "Day representation: 'numeric' | '2-digit'.",
16942
+ "fieldName": "day"
16943
+ },
16944
+ {
16945
+ "name": "hour",
16946
+ "type": {
16947
+ "text": "'numeric' | '2-digit' | \"default\"",
16948
+ "_sourceAliases": [],
16949
+ "values": [
16950
+ {
16951
+ "value": "numeric",
16952
+ "description": ""
16953
+ },
16954
+ {
16955
+ "value": "2-digit",
16956
+ "description": ""
16957
+ }
16958
+ ]
16959
+ },
16960
+ "description": "Hour representation: 'numeric' | '2-digit'.",
16961
+ "fieldName": "hour"
16962
+ },
16963
+ {
16964
+ "name": "minute",
16965
+ "type": {
16966
+ "text": "'numeric' | '2-digit' | \"default\"",
16967
+ "_sourceAliases": [],
16968
+ "values": [
16969
+ {
16970
+ "value": "numeric",
16971
+ "description": ""
16972
+ },
16973
+ {
16974
+ "value": "2-digit",
16975
+ "description": ""
16976
+ }
16977
+ ]
16978
+ },
16979
+ "description": "Minute representation: 'numeric' | '2-digit'.",
16980
+ "fieldName": "minute"
16981
+ },
16982
+ {
16983
+ "name": "second",
16984
+ "type": {
16985
+ "text": "'numeric' | '2-digit' | \"default\"",
16986
+ "_sourceAliases": [],
16987
+ "values": [
16988
+ {
16989
+ "value": "numeric",
16990
+ "description": ""
16991
+ },
16992
+ {
16993
+ "value": "2-digit",
16994
+ "description": ""
16995
+ }
16996
+ ]
16997
+ },
16998
+ "description": "Second representation: 'numeric' | '2-digit'.",
16999
+ "fieldName": "second"
17000
+ },
17001
+ {
17002
+ "name": "date-style",
17003
+ "type": {
17004
+ "text": "'full' | 'long' | 'medium' | 'short' | \"default\"",
17005
+ "_sourceAliases": [],
17006
+ "values": [
17007
+ {
17008
+ "value": "full",
17009
+ "description": ""
17010
+ },
17011
+ {
17012
+ "value": "long",
17013
+ "description": ""
17014
+ },
17015
+ {
17016
+ "value": "medium",
17017
+ "description": ""
17018
+ },
17019
+ {
17020
+ "value": "short",
17021
+ "description": ""
17022
+ }
17023
+ ]
17024
+ },
17025
+ "description": "Preset date formatting style: 'full' | 'long' | 'medium' | 'short'.\nPreset styles take precedence over granular date and time part options.",
17026
+ "fieldName": "dateStyle"
17027
+ },
17028
+ {
17029
+ "name": "time-style",
17030
+ "type": {
17031
+ "text": "'full' | 'long' | 'medium' | 'short' | \"default\"",
17032
+ "_sourceAliases": [],
17033
+ "values": [
17034
+ {
17035
+ "value": "full",
17036
+ "description": ""
17037
+ },
17038
+ {
17039
+ "value": "long",
17040
+ "description": ""
17041
+ },
17042
+ {
17043
+ "value": "medium",
17044
+ "description": ""
17045
+ },
17046
+ {
17047
+ "value": "short",
17048
+ "description": ""
17049
+ }
17050
+ ]
17051
+ },
17052
+ "description": "Preset time formatting style: 'full' | 'long' | 'medium' | 'short'.\nPreset styles take precedence over granular date and time part options.",
17053
+ "fieldName": "timeStyle"
17054
+ },
17055
+ {
17056
+ "name": "time-zone-name",
17057
+ "type": {
17058
+ "text": "'long' | 'short' | \"default\"",
17059
+ "_sourceAliases": [],
17060
+ "values": [
17061
+ {
17062
+ "value": "long",
17063
+ "description": ""
17064
+ },
17065
+ {
17066
+ "value": "short",
17067
+ "description": ""
17068
+ }
17069
+ ]
17070
+ },
17071
+ "description": "Time zone name display: 'long' | 'short'. Use it with granular options only; preset styles ignore it.",
17072
+ "fieldName": "timeZoneName"
17073
+ },
17074
+ {
17075
+ "name": "time-zone",
17076
+ "type": {
17077
+ "text": "string | \"default\"",
17078
+ "_sourceAliases": [],
17079
+ "values": [
17080
+ {
17081
+ "value": "string",
17082
+ "description": ""
17083
+ }
17084
+ ]
17085
+ },
17086
+ "description": "IANA time zone identifier (such as 'America/New_York', 'UTC').",
17087
+ "fieldName": "timeZone"
17088
+ },
17089
+ {
17090
+ "name": "nve-layout",
17091
+ "deprecated": true,
17092
+ "description": "not supported on custom element tags",
17093
+ "type": {
17094
+ "text": "string",
17095
+ "values": [
17096
+ {
17097
+ "value": "string",
17098
+ "description": ""
17099
+ },
17100
+ {
17101
+ "value": "string",
17102
+ "description": ""
17103
+ }
17104
+ ],
17105
+ "_sourceAliases": []
17106
+ }
17107
+ },
17108
+ {
17109
+ "name": "nve-text",
17110
+ "deprecated": true,
17111
+ "description": "not supported on custom element tags",
17112
+ "type": {
17113
+ "text": "string",
17114
+ "values": [
17115
+ {
17116
+ "value": "string",
17117
+ "description": ""
17118
+ },
17119
+ {
17120
+ "value": "string",
17121
+ "description": ""
17122
+ }
17123
+ ],
17124
+ "_sourceAliases": []
17125
+ }
17126
+ }
17127
+ ],
17128
+ "superclass": {
17129
+ "name": "LitElement",
17130
+ "package": "lit"
17131
+ },
17132
+ "tagName": "nve-format-datetime",
17133
+ "customElement": true,
17134
+ "metadata": {
17135
+ "unitTests": true,
17136
+ "apiReview": true,
17137
+ "performance": true,
17138
+ "stable": true,
17139
+ "vqa": true,
17140
+ "responsive": true,
17141
+ "themes": true,
17142
+ "aria": "#",
17143
+ "entrypoint": "@nvidia-elements/core/format-datetime",
17144
+ "example": "<nve-format-datetime date-style=\"long\">2023-07-28T04:20:17.434Z</nve-format-datetime>",
17145
+ "package": true,
17146
+ "since": "0.0.0",
17147
+ "status": "beta",
17148
+ "behavior": "content",
17149
+ "markdown": "## nve-format-datetime\n\nFormats a date/time value as localized text using the Intl.DateTimeFormat API. Renders inside a semantic time element.\nGranular options (weekday, year, month, day, hour, minute, second) mirror the Intl.DateTimeFormat API. 'numeric' omits zero-padding, '2-digit' zero-pads.\n\n### Example\n\n```html\n<nve-format-datetime date-style=\"long\">2023-07-28T04:20:17.434Z</nve-format-datetime>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/format-datetime/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| date | `string \\| \"default\"` | Optional date string for values supplied by JavaScript or bound data. By default, the component formats the element's text content, which also serves as the SSR fallback. When both are present, this property takes precedence. |\n| locale | `string \\| \"default\"` | Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. |\n| weekday | `'long' \\| 'short' \\| 'narrow' \\| \"default\"` | Weekday representation: 'long' \\| 'short' \\| 'narrow'. |\n| year | `'numeric' \\| '2-digit' \\| \"default\"` | Year representation: 'numeric' \\| '2-digit'. |\n| month | `'numeric' \\| '2-digit' \\| 'long' \\| 'short' \\| 'narrow' \\| \"default\"` | Month representation: 'numeric' \\| '2-digit' \\| 'long' \\| 'short' \\| 'narrow'. |\n| day | `'numeric' \\| '2-digit' \\| \"default\"` | Day representation: 'numeric' \\| '2-digit'. |\n| hour | `'numeric' \\| '2-digit' \\| \"default\"` | Hour representation: 'numeric' \\| '2-digit'. |\n| minute | `'numeric' \\| '2-digit' \\| \"default\"` | Minute representation: 'numeric' \\| '2-digit'. |\n| second | `'numeric' \\| '2-digit' \\| \"default\"` | Second representation: 'numeric' \\| '2-digit'. |\n| dateStyle (date-style) | `'full' \\| 'long' \\| 'medium' \\| 'short' \\| \"default\"` | Preset date formatting style: 'full' \\| 'long' \\| 'medium' \\| 'short'. Preset styles take precedence over granular date and time part options. |\n| timeStyle (time-style) | `'full' \\| 'long' \\| 'medium' \\| 'short' \\| \"default\"` | Preset time formatting style: 'full' \\| 'long' \\| 'medium' \\| 'short'. Preset styles take precedence over granular date and time part options. |\n| timeZoneName (time-zone-name) | `'long' \\| 'short' \\| \"default\"` | Time zone name display: 'long' \\| 'short'. Use it with granular options only; preset styles ignore it. |\n| timeZone (time-zone) | `string \\| \"default\"` | IANA time zone identifier (such as 'America/New_York', 'UTC'). |"
17150
+ }
17151
+ }
17152
+ ],
17153
+ "exports": [
17154
+ {
17155
+ "kind": "js",
17156
+ "name": "FormatDatetime",
17157
+ "declaration": {
17158
+ "name": "FormatDatetime",
17159
+ "module": "/src/format-datetime/format-datetime.js"
17160
+ }
17161
+ }
17162
+ ]
17163
+ },
17164
+ {
17165
+ "kind": "javascript-module",
17166
+ "path": "/src/format-datetime/index.js",
17167
+ "declarations": [],
17168
+ "exports": [
17169
+ {
17170
+ "kind": "js",
17171
+ "name": "*",
17172
+ "declaration": {
17173
+ "name": "*",
17174
+ "module": "home/runner/work/elements/elements/projects/core/src/format-datetime/format-datetime.js"
17175
+ }
17176
+ }
17177
+ ]
17178
+ },
17179
+ {
17180
+ "kind": "javascript-module",
17181
+ "path": "/src/format-relative-time/define.js",
17182
+ "declarations": [],
17183
+ "exports": []
17184
+ },
17185
+ {
17186
+ "kind": "javascript-module",
17187
+ "path": "/src/format-relative-time/format-relative-time.js",
17188
+ "declarations": [
17189
+ {
17190
+ "kind": "class",
17191
+ "description": "Formats a date/time value as localized relative text using the Intl.RelativeTimeFormat API. Renders inside a semantic time element.\nOptions mirror the Intl.RelativeTimeFormat API. When unit is 'auto', the component selects the best unit based on the time difference.",
17192
+ "name": "FormatRelativeTime",
17193
+ "slots": [
17194
+ {
17195
+ "description": "Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.",
17196
+ "name": ""
16483
17197
  }
16484
17198
  ],
16485
17199
  "members": [
16486
17200
  {
16487
- "name": "nve-layout",
16488
- "deprecated": true,
16489
- "description": "not supported on custom element tags",
17201
+ "kind": "field",
17202
+ "name": "date",
16490
17203
  "type": {
16491
- "text": "string",
17204
+ "text": "string | \"default\"",
17205
+ "_sourceAliases": [],
16492
17206
  "values": [
16493
17207
  {
16494
17208
  "value": "string",
16495
17209
  "description": ""
16496
- },
17210
+ }
17211
+ ]
17212
+ },
17213
+ "description": "Optional date string for values supplied by JavaScript or bound data.\nBy default, the component formats the element's text content, which also serves as the SSR fallback.\nWhen both are present, this property takes precedence.",
17214
+ "attribute": "date"
17215
+ },
17216
+ {
17217
+ "kind": "field",
17218
+ "name": "locale",
17219
+ "type": {
17220
+ "text": "string | \"default\"",
17221
+ "_sourceAliases": [],
17222
+ "values": [
16497
17223
  {
16498
17224
  "value": "string",
16499
17225
  "description": ""
16500
17226
  }
16501
- ],
16502
- "_sourceAliases": []
17227
+ ]
16503
17228
  },
16504
- "attribute": "nve-layout",
16505
- "kind": "field",
16506
- "inheritedFrom": {
16507
- "name": "Control",
16508
- "module": "/src/forms/control/control.js"
16509
- }
17229
+ "description": "Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default.",
17230
+ "attribute": "locale"
16510
17231
  },
16511
17232
  {
16512
- "name": "nve-text",
16513
- "deprecated": true,
16514
- "description": "not supported on custom element tags",
17233
+ "kind": "field",
17234
+ "name": "numeric",
16515
17235
  "type": {
16516
- "text": "string",
17236
+ "text": "'always' | 'auto'",
17237
+ "_sourceAliases": [],
16517
17238
  "values": [
16518
17239
  {
16519
- "value": "string",
17240
+ "value": "always",
16520
17241
  "description": ""
16521
17242
  },
16522
17243
  {
16523
- "value": "string",
17244
+ "value": "auto",
16524
17245
  "description": ""
16525
17246
  }
16526
- ],
16527
- "_sourceAliases": []
17247
+ ]
16528
17248
  },
16529
- "attribute": "nve-text",
16530
- "kind": "field",
16531
- "inheritedFrom": {
16532
- "name": "Control",
16533
- "module": "/src/forms/control/control.js"
16534
- }
17249
+ "default": "'always'",
17250
+ "description": "Numeric formatting: 'always' | 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'.",
17251
+ "attribute": "numeric"
16535
17252
  },
16536
17253
  {
16537
17254
  "kind": "field",
16538
- "name": "status",
17255
+ "name": "formatStyle",
16539
17256
  "type": {
16540
- "text": "'warning' | 'error' | 'success' | 'disabled'",
17257
+ "text": "'long' | 'short' | 'narrow'",
16541
17258
  "_sourceAliases": [],
16542
17259
  "values": [
16543
17260
  {
16544
- "value": "warning",
16545
- "description": "Indicates cautionary actions that require careful consideration before proceeding."
16546
- },
16547
- {
16548
- "value": "success",
16549
- "description": "Represents positive outcomes, confirmations, or constructive actions."
17261
+ "value": "long",
17262
+ "description": ""
16550
17263
  },
16551
17264
  {
16552
- "value": "error",
17265
+ "value": "short",
16553
17266
  "description": ""
16554
17267
  },
16555
17268
  {
16556
- "value": "disabled",
17269
+ "value": "narrow",
16557
17270
  "description": ""
16558
17271
  }
16559
17272
  ]
16560
17273
  },
16561
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.",
16562
- "attribute": "status",
16563
- "inheritedFrom": {
16564
- "name": "Control",
16565
- "module": "/src/forms/control/control.js"
16566
- },
16567
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
17274
+ "default": "'long'",
17275
+ "description": "Formatting length: 'long' | 'short' | 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option.",
17276
+ "attribute": "format-style"
16568
17277
  },
16569
17278
  {
16570
17279
  "kind": "field",
16571
- "name": "layout",
17280
+ "name": "unit",
16572
17281
  "type": {
16573
- "text": "| 'vertical'\n | 'vertical-inline'\n | 'horizontal'\n | 'horizontal-inline'",
17282
+ "text": "'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year' | 'auto'",
16574
17283
  "_sourceAliases": [],
16575
17284
  "values": [
16576
17285
  {
16577
- "value": "vertical",
16578
- "description": "Arranges content in a vertical stack with block-level spacing."
17286
+ "value": "second",
17287
+ "description": ""
16579
17288
  },
16580
17289
  {
16581
- "value": "vertical-inline",
16582
- "description": "Arranges content vertically with compact inline spacing for dense layouts."
17290
+ "value": "minute",
17291
+ "description": ""
16583
17292
  },
16584
17293
  {
16585
- "value": "horizontal",
16586
- "description": "Arranges content in a horizontal row with block-level spacing."
17294
+ "value": "hour",
17295
+ "description": ""
16587
17296
  },
16588
17297
  {
16589
- "value": "horizontal-inline",
16590
- "description": "Arranges content horizontally with compact inline spacing."
17298
+ "value": "day",
17299
+ "description": ""
17300
+ },
17301
+ {
17302
+ "value": "week",
17303
+ "description": ""
17304
+ },
17305
+ {
17306
+ "value": "month",
17307
+ "description": ""
17308
+ },
17309
+ {
17310
+ "value": "year",
17311
+ "description": ""
17312
+ },
17313
+ {
17314
+ "value": "auto",
17315
+ "description": ""
16591
17316
  }
16592
17317
  ]
16593
17318
  },
16594
- "description": "Controls the directional arrangement and spacing behavior of the element's content.\n- `vertical` Arranges content in a vertical stack with block-level spacing.\n\n- `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts.\n\n- `horizontal` Arranges content in a horizontal row with block-level spacing.\n\n- `horizontal-inline` Arranges content horizontally with compact inline spacing.",
16595
- "attribute": "layout",
16596
- "reflects": true,
16597
- "inheritedFrom": {
16598
- "name": "Control",
16599
- "module": "/src/forms/control/control.js"
16600
- },
16601
- "descriptionText": "Controls the directional arrangement and spacing behavior of the element's content."
17319
+ "default": "'auto'",
17320
+ "description": "Time unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year' | 'auto'. Use 'auto' to let the component select the most appropriate unit based on the time difference.",
17321
+ "attribute": "unit"
16602
17322
  },
16603
17323
  {
16604
17324
  "kind": "field",
16605
- "name": "fitText",
17325
+ "name": "sync",
16606
17326
  "type": {
16607
17327
  "text": "boolean",
16608
17328
  "_sourceAliases": [],
@@ -16618,77 +17338,57 @@
16618
17338
  ]
16619
17339
  },
16620
17340
  "default": "false",
16621
- "description": "Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)",
16622
- "attribute": "fit-text",
16623
- "reflects": true,
16624
- "inheritedFrom": {
16625
- "name": "Control",
16626
- "module": "/src/forms/control/control.js"
16627
- }
17341
+ "description": "When present, auto-updates the displayed relative time at appropriate intervals.",
17342
+ "attribute": "sync"
16628
17343
  },
16629
17344
  {
16630
- "kind": "field",
16631
- "name": "fitContent",
17345
+ "name": "nve-layout",
17346
+ "deprecated": true,
17347
+ "description": "not supported on custom element tags",
16632
17348
  "type": {
16633
- "text": "boolean",
16634
- "_sourceAliases": [],
17349
+ "text": "string",
16635
17350
  "values": [
16636
17351
  {
16637
- "value": "true",
17352
+ "value": "string",
16638
17353
  "description": ""
16639
17354
  },
16640
17355
  {
16641
- "value": "false",
17356
+ "value": "string",
16642
17357
  "description": ""
16643
17358
  }
16644
- ]
17359
+ ],
17360
+ "_sourceAliases": []
16645
17361
  },
16646
- "default": "false",
16647
- "description": "Sets the input to match native default content block",
16648
- "attribute": "fit-content",
16649
- "reflects": true,
16650
- "inheritedFrom": {
16651
- "name": "Control",
16652
- "module": "/src/forms/control/control.js"
16653
- }
16654
- },
16655
- {
16656
- "kind": "field",
16657
- "name": "i18n",
16658
- "description": "Enables updating internal string values for internationalization.",
16659
- "attribute": "i18n",
16660
- "inheritedFrom": {
16661
- "name": "Control",
16662
- "module": "/src/forms/control/control.js"
16663
- }
17362
+ "attribute": "nve-layout",
17363
+ "kind": "field"
16664
17364
  },
16665
17365
  {
16666
- "kind": "field",
16667
- "name": "prominence",
17366
+ "name": "nve-text",
17367
+ "deprecated": true,
17368
+ "description": "not supported on custom element tags",
16668
17369
  "type": {
16669
- "text": "'muted'",
16670
- "_sourceAliases": [],
17370
+ "text": "string",
16671
17371
  "values": [
16672
17372
  {
16673
- "value": "muted",
16674
- "description": "Reduces visual weight for supporting content that should remain subtle and unobtrusive."
17373
+ "value": "string",
17374
+ "description": ""
17375
+ },
17376
+ {
17377
+ "value": "string",
17378
+ "description": ""
16675
17379
  }
16676
- ]
16677
- },
16678
- "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive.",
16679
- "attribute": "prominence",
16680
- "reflects": true,
16681
- "inheritedFrom": {
16682
- "name": "Control",
16683
- "module": "/src/forms/control/control.js"
17380
+ ],
17381
+ "_sourceAliases": []
16684
17382
  },
16685
- "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
16686
- },
17383
+ "attribute": "nve-text",
17384
+ "kind": "field"
17385
+ }
17386
+ ],
17387
+ "attributes": [
16687
17388
  {
16688
- "kind": "field",
16689
- "name": "nveControl",
17389
+ "name": "date",
16690
17390
  "type": {
16691
- "text": "string",
17391
+ "text": "string | \"default\"",
16692
17392
  "_sourceAliases": [],
16693
17393
  "values": [
16694
17394
  {
@@ -16697,145 +17397,114 @@
16697
17397
  }
16698
17398
  ]
16699
17399
  },
16700
- "privacy": "protected",
16701
- "default": "''",
16702
- "inheritedFrom": {
16703
- "name": "Control",
16704
- "module": "/src/forms/control/control.js"
16705
- }
16706
- },
16707
- {
16708
- "kind": "method",
16709
- "name": "reset",
16710
- "description": "Resets control value to initial attribute value and clears any active validation rules.",
16711
- "inheritedFrom": {
16712
- "name": "Control",
16713
- "module": "/src/forms/control/control.js"
16714
- }
17400
+ "description": "Optional date string for values supplied by JavaScript or bound data.\nBy default, the component formats the element's text content, which also serves as the SSR fallback.\nWhen both are present, this property takes precedence.",
17401
+ "fieldName": "date"
16715
17402
  },
16716
17403
  {
16717
- "kind": "method",
16718
- "name": "showPicker",
16719
- "privacy": "protected",
16720
- "inheritedFrom": {
16721
- "name": "Control",
16722
- "module": "/src/forms/control/control.js"
16723
- }
16724
- }
16725
- ],
16726
- "attributes": [
16727
- {
16728
- "name": "nve-layout",
16729
- "deprecated": true,
16730
- "description": "not supported on custom element tags",
17404
+ "name": "locale",
16731
17405
  "type": {
16732
- "text": "string",
17406
+ "text": "string | \"default\"",
17407
+ "_sourceAliases": [],
16733
17408
  "values": [
16734
- {
16735
- "value": "string",
16736
- "description": ""
16737
- },
16738
17409
  {
16739
17410
  "value": "string",
16740
17411
  "description": ""
16741
17412
  }
16742
- ],
16743
- "_sourceAliases": []
17413
+ ]
16744
17414
  },
16745
- "inheritedFrom": {
16746
- "name": "Control",
16747
- "module": "/src/forms/control/control.js"
16748
- }
17415
+ "description": "Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default.",
17416
+ "fieldName": "locale"
16749
17417
  },
16750
17418
  {
16751
- "name": "nve-text",
16752
- "deprecated": true,
16753
- "description": "not supported on custom element tags",
17419
+ "name": "numeric",
16754
17420
  "type": {
16755
- "text": "string",
17421
+ "text": "'always' | 'auto'",
17422
+ "_sourceAliases": [],
16756
17423
  "values": [
16757
17424
  {
16758
- "value": "string",
17425
+ "value": "always",
16759
17426
  "description": ""
16760
17427
  },
16761
17428
  {
16762
- "value": "string",
17429
+ "value": "auto",
16763
17430
  "description": ""
16764
17431
  }
16765
- ],
16766
- "_sourceAliases": []
17432
+ ]
16767
17433
  },
16768
- "inheritedFrom": {
16769
- "name": "Control",
16770
- "module": "/src/forms/control/control.js"
16771
- }
17434
+ "default": "'always'",
17435
+ "description": "Numeric formatting: 'always' | 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'.",
17436
+ "fieldName": "numeric"
16772
17437
  },
16773
17438
  {
16774
- "name": "status",
17439
+ "name": "format-style",
16775
17440
  "type": {
16776
- "text": "'warning' | 'error' | 'success' | 'disabled'",
17441
+ "text": "'long' | 'short' | 'narrow'",
16777
17442
  "_sourceAliases": [],
16778
17443
  "values": [
16779
17444
  {
16780
- "value": "warning",
16781
- "description": "Indicates cautionary actions that require careful consideration before proceeding."
16782
- },
16783
- {
16784
- "value": "success",
16785
- "description": "Represents positive outcomes, confirmations, or constructive actions."
17445
+ "value": "long",
17446
+ "description": ""
16786
17447
  },
16787
17448
  {
16788
- "value": "error",
17449
+ "value": "short",
16789
17450
  "description": ""
16790
17451
  },
16791
17452
  {
16792
- "value": "disabled",
17453
+ "value": "narrow",
16793
17454
  "description": ""
16794
17455
  }
16795
17456
  ]
16796
17457
  },
16797
- "description": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.\n- `warning` Indicates cautionary actions that require careful consideration before proceeding.\n\n- `success` Represents positive outcomes, confirmations, or constructive actions.",
16798
- "fieldName": "status",
16799
- "inheritedFrom": {
16800
- "name": "Control",
16801
- "module": "/src/forms/control/control.js"
16802
- },
16803
- "descriptionText": "Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions."
17458
+ "default": "'long'",
17459
+ "description": "Formatting length: 'long' | 'short' | 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option.",
17460
+ "fieldName": "formatStyle"
16804
17461
  },
16805
17462
  {
16806
- "name": "layout",
17463
+ "name": "unit",
16807
17464
  "type": {
16808
- "text": "| 'vertical'\n | 'vertical-inline'\n | 'horizontal'\n | 'horizontal-inline'",
17465
+ "text": "'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year' | 'auto'",
16809
17466
  "_sourceAliases": [],
16810
17467
  "values": [
16811
17468
  {
16812
- "value": "vertical",
16813
- "description": "Arranges content in a vertical stack with block-level spacing."
17469
+ "value": "second",
17470
+ "description": ""
16814
17471
  },
16815
17472
  {
16816
- "value": "vertical-inline",
16817
- "description": "Arranges content vertically with compact inline spacing for dense layouts."
17473
+ "value": "minute",
17474
+ "description": ""
16818
17475
  },
16819
17476
  {
16820
- "value": "horizontal",
16821
- "description": "Arranges content in a horizontal row with block-level spacing."
17477
+ "value": "hour",
17478
+ "description": ""
16822
17479
  },
16823
17480
  {
16824
- "value": "horizontal-inline",
16825
- "description": "Arranges content horizontally with compact inline spacing."
17481
+ "value": "day",
17482
+ "description": ""
17483
+ },
17484
+ {
17485
+ "value": "week",
17486
+ "description": ""
17487
+ },
17488
+ {
17489
+ "value": "month",
17490
+ "description": ""
17491
+ },
17492
+ {
17493
+ "value": "year",
17494
+ "description": ""
17495
+ },
17496
+ {
17497
+ "value": "auto",
17498
+ "description": ""
16826
17499
  }
16827
17500
  ]
16828
17501
  },
16829
- "description": "Controls the directional arrangement and spacing behavior of the element's content.\n- `vertical` Arranges content in a vertical stack with block-level spacing.\n\n- `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts.\n\n- `horizontal` Arranges content in a horizontal row with block-level spacing.\n\n- `horizontal-inline` Arranges content horizontally with compact inline spacing.",
16830
- "fieldName": "layout",
16831
- "inheritedFrom": {
16832
- "name": "Control",
16833
- "module": "/src/forms/control/control.js"
16834
- },
16835
- "descriptionText": "Controls the directional arrangement and spacing behavior of the element's content."
17502
+ "default": "'auto'",
17503
+ "description": "Time unit: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year' | 'auto'. Use 'auto' to let the component select the most appropriate unit based on the time difference.",
17504
+ "fieldName": "unit"
16836
17505
  },
16837
17506
  {
16838
- "name": "fit-text",
17507
+ "name": "sync",
16839
17508
  "type": {
16840
17509
  "text": "boolean",
16841
17510
  "_sourceAliases": [],
@@ -16851,72 +17520,53 @@
16851
17520
  ]
16852
17521
  },
16853
17522
  "default": "false",
16854
- "description": "Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select)",
16855
- "fieldName": "fitText",
16856
- "inheritedFrom": {
16857
- "name": "Control",
16858
- "module": "/src/forms/control/control.js"
16859
- }
17523
+ "description": "When present, auto-updates the displayed relative time at appropriate intervals.",
17524
+ "fieldName": "sync"
16860
17525
  },
16861
17526
  {
16862
- "name": "fit-content",
17527
+ "name": "nve-layout",
17528
+ "deprecated": true,
17529
+ "description": "not supported on custom element tags",
16863
17530
  "type": {
16864
- "text": "boolean",
16865
- "_sourceAliases": [],
17531
+ "text": "string",
16866
17532
  "values": [
16867
17533
  {
16868
- "value": "true",
17534
+ "value": "string",
16869
17535
  "description": ""
16870
17536
  },
16871
17537
  {
16872
- "value": "false",
17538
+ "value": "string",
16873
17539
  "description": ""
16874
17540
  }
16875
- ]
16876
- },
16877
- "default": "false",
16878
- "description": "Sets the input to match native default content block",
16879
- "fieldName": "fitContent",
16880
- "inheritedFrom": {
16881
- "name": "Control",
16882
- "module": "/src/forms/control/control.js"
16883
- }
16884
- },
16885
- {
16886
- "name": "i18n",
16887
- "description": "Enables updating internal string values for internationalization.",
16888
- "fieldName": "i18n",
16889
- "inheritedFrom": {
16890
- "name": "Control",
16891
- "module": "/src/forms/control/control.js"
17541
+ ],
17542
+ "_sourceAliases": []
16892
17543
  }
16893
17544
  },
16894
17545
  {
16895
- "name": "prominence",
17546
+ "name": "nve-text",
17547
+ "deprecated": true,
17548
+ "description": "not supported on custom element tags",
16896
17549
  "type": {
16897
- "text": "'muted'",
16898
- "_sourceAliases": [],
17550
+ "text": "string",
16899
17551
  "values": [
16900
17552
  {
16901
- "value": "muted",
16902
- "description": "Reduces visual weight for supporting content that should remain subtle and unobtrusive."
17553
+ "value": "string",
17554
+ "description": ""
17555
+ },
17556
+ {
17557
+ "value": "string",
17558
+ "description": ""
16903
17559
  }
16904
- ]
16905
- },
16906
- "description": "Controls the visual prominence to establish hierarchy and guide user attention.\n- `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive.",
16907
- "fieldName": "prominence",
16908
- "inheritedFrom": {
16909
- "name": "Control",
16910
- "module": "/src/forms/control/control.js"
16911
- },
16912
- "descriptionText": "Controls the visual prominence to establish hierarchy and guide user attention."
17560
+ ],
17561
+ "_sourceAliases": []
17562
+ }
16913
17563
  }
16914
17564
  ],
16915
17565
  "superclass": {
16916
- "name": "Control",
16917
- "package": "@nvidia-elements/core/forms"
17566
+ "name": "LitElement",
17567
+ "package": "lit"
16918
17568
  },
16919
- "tagName": "nve-file",
17569
+ "tagName": "nve-format-relative-time",
16920
17570
  "customElement": true,
16921
17571
  "metadata": {
16922
17572
  "unitTests": true,
@@ -16926,61 +17576,31 @@
16926
17576
  "vqa": true,
16927
17577
  "responsive": true,
16928
17578
  "themes": true,
16929
- "aria": "https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file",
16930
- "entrypoint": "@nvidia-elements/core/file",
16931
- "example": "<nve-file>\n <label>file</label>\n <input type=\"file\" />\n <nve-control-message>message</nve-control-message>\n</nve-file>",
17579
+ "aria": "#",
17580
+ "entrypoint": "@nvidia-elements/core/format-relative-time",
17581
+ "example": "<div nve-layout=\"column gap:sm\">\n <nve-format-relative-time>2020-01-15T12:00:00.000Z</nve-format-relative-time>\n <nve-format-relative-time>2024-06-15T12:00:00.000Z</nve-format-relative-time>\n <nve-format-relative-time>2025-12-01T12:00:00.000Z</nve-format-relative-time>\n</div>",
16932
17582
  "package": true,
16933
- "since": "0.3.0",
16934
- "status": "stable",
16935
- "behavior": "form",
16936
- "markdown": "## nve-file\n\nA file picker is a control that enables users to choose a file value.\n\n### Example\n\n```html\n<nve-file>\n <label>file</label>\n <input type=\"file\" />\n <nve-control-message>message</nve-control-message>\n</nve-file>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/file/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Control input element |\n| label | `string` | Label element |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| status | `'warning' \\| 'error' \\| 'success' \\| 'disabled'` | Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions. - `warning` Indicates cautionary actions that require careful consideration before proceeding. - `success` Represents positive outcomes, confirmations, or constructive actions. |\n| layout | `\\| 'vertical'\n \\| 'vertical-inline'\n \\| 'horizontal'\n \\| 'horizontal-inline'` | Controls the directional arrangement and spacing behavior of the element's content. - `vertical` Arranges content in a vertical stack with block-level spacing. - `vertical-inline` Arranges content vertically with compact inline spacing for dense layouts. - `horizontal` Arranges content in a horizontal row with block-level spacing. - `horizontal-inline` Arranges content horizontally with compact inline spacing. |\n| fitText (fit-text) | `boolean` | Sets the input to match the width of the active text content of the control value. Only applicable to vertical input box type controls (input, select) |\n| fitContent (fit-content) | `boolean` | Sets the input to match native default content block |\n| i18n | | Enables updating internal string values for internationalization. |\n| prominence | `'muted'` | Controls the visual prominence to establish hierarchy and guide user attention. - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. |\n| nveControl | `string` | |\n| reset | | Resets control value to initial attribute value and clears any active validation rules. |\n| showPicker | | |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| reset | `CustomEvent` | |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --background | `string` | [MDN](https://mdn.dev/CSS/background) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --border | `string` | [MDN](https://mdn.dev/CSS/border) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --text-decoration | `string` | [MDN](https://mdn.dev/CSS/text-decoration) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --accent-color | `string` | [MDN](https://mdn.dev/CSS/accent-color) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --label-color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --label-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --label-font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --label-font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --control-width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --control-height | `string` | [MDN](https://mdn.dev/CSS/height) |"
16937
- },
16938
- "slots": [
16939
- {
16940
- "description": "Control input element",
16941
- "name": "",
16942
- "inheritedFrom": {
16943
- "name": "Control",
16944
- "module": "/src/forms/control/control.js"
16945
- }
16946
- },
16947
- {
16948
- "description": "Label element",
16949
- "name": "label",
16950
- "inheritedFrom": {
16951
- "name": "Control",
16952
- "module": "/src/forms/control/control.js"
16953
- }
16954
- }
16955
- ],
16956
- "events": [
16957
- {
16958
- "name": "reset",
16959
- "type": {
16960
- "text": "CustomEvent"
16961
- },
16962
- "inheritedFrom": {
16963
- "name": "Control",
16964
- "module": "/src/forms/control/control.js"
16965
- }
16966
- }
16967
- ]
17583
+ "since": "0.0.0",
17584
+ "status": "beta",
17585
+ "behavior": "content",
17586
+ "markdown": "## nve-format-relative-time\n\nFormats a date/time value as localized relative text using the Intl.RelativeTimeFormat API. Renders inside a semantic time element.\nOptions mirror the Intl.RelativeTimeFormat API. When unit is 'auto', the component selects the best unit based on the time difference.\n\n### Example\n\n```html\n<div nve-layout=\"column gap:sm\">\n <nve-format-relative-time>2020-01-15T12:00:00.000Z</nve-format-relative-time>\n <nve-format-relative-time>2024-06-15T12:00:00.000Z</nve-format-relative-time>\n <nve-format-relative-time>2025-12-01T12:00:00.000Z</nve-format-relative-time>\n</div>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/format-relative-time/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| date | `string \\| \"default\"` | Optional date string for values supplied by JavaScript or bound data. By default, the component formats the element's text content, which also serves as the SSR fallback. When both are present, this property takes precedence. |\n| locale | `string \\| \"default\"` | Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. |\n| numeric | `'always' \\| 'auto'` | Numeric formatting: 'always' \\| 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'. |\n| formatStyle (format-style) | `'long' \\| 'short' \\| 'narrow'` | Formatting length: 'long' \\| 'short' \\| 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option. |\n| unit | `'second' \\| 'minute' \\| 'hour' \\| 'day' \\| 'week' \\| 'month' \\| 'year' \\| 'auto'` | Time unit: 'second' \\| 'minute' \\| 'hour' \\| 'day' \\| 'week' \\| 'month' \\| 'year' \\| 'auto'. Use 'auto' to let the component select the most appropriate unit based on the time difference. |\n| sync | `boolean` | When present, auto-updates the displayed relative time at appropriate intervals. |"
17587
+ }
16968
17588
  }
16969
17589
  ],
16970
17590
  "exports": [
16971
17591
  {
16972
17592
  "kind": "js",
16973
- "name": "File",
17593
+ "name": "FormatRelativeTime",
16974
17594
  "declaration": {
16975
- "name": "File",
16976
- "module": "/src/file/file.js"
17595
+ "name": "FormatRelativeTime",
17596
+ "module": "/src/format-relative-time/format-relative-time.js"
16977
17597
  }
16978
17598
  }
16979
17599
  ]
16980
17600
  },
16981
17601
  {
16982
17602
  "kind": "javascript-module",
16983
- "path": "/src/file/index.js",
17603
+ "path": "/src/format-relative-time/index.js",
16984
17604
  "declarations": [],
16985
17605
  "exports": [
16986
17606
  {
@@ -16988,7 +17608,7 @@
16988
17608
  "name": "*",
16989
17609
  "declaration": {
16990
17610
  "name": "*",
16991
- "module": "home/runner/work/elements/elements/projects/core/src/file/file.js"
17611
+ "module": "home/runner/work/elements/elements/projects/core/src/format-relative-time/format-relative-time.js"
16992
17612
  }
16993
17613
  }
16994
17614
  ]
@@ -26181,14 +26801,6 @@
26181
26801
  "module": "./icons.js"
26182
26802
  }
26183
26803
  },
26184
- {
26185
- "kind": "js",
26186
- "name": "IconNames",
26187
- "declaration": {
26188
- "name": "IconNames",
26189
- "module": "./icons.js"
26190
- }
26191
- },
26192
26804
  {
26193
26805
  "kind": "js",
26194
26806
  "name": "IconSVG",
@@ -30921,11 +31533,6 @@
30921
31533
  },
30922
31534
  "default": "{ debug: (log = console.log) => log( `%cElements\\n%c${JSON.stringify(globalThis.NVE_ELEMENTS.state, null, 2)}`, 'color: #69b027', 'color: inherit' ), state: { bundle: false, env: getEnv(), ...getHostDetails(), versions: [], scopedRegistry: {}, elementRegistry: {}, i18nRegistry: {}, audit: {} } }"
30923
31535
  },
30924
- {
30925
- "kind": "field",
30926
- "name": "MLV_ELEMENTS",
30927
- "deprecated": "MLV_ELEMENTS"
30928
- },
30929
31536
  {
30930
31537
  "kind": "field",
30931
31538
  "name": "versions"
@@ -32343,6 +32950,51 @@
32343
32950
  }
32344
32951
  }
32345
32952
  ]
32953
+ },
32954
+ {
32955
+ "kind": "function",
32956
+ "name": "sameOrderedStringArray",
32957
+ "return": {
32958
+ "type": {
32959
+ "text": "boolean"
32960
+ }
32961
+ },
32962
+ "parameters": [
32963
+ {
32964
+ "name": "a",
32965
+ "type": {
32966
+ "text": "readonly string[]",
32967
+ "_sourceAliases": []
32968
+ }
32969
+ },
32970
+ {
32971
+ "name": "b",
32972
+ "type": {
32973
+ "text": "readonly string[]",
32974
+ "_sourceAliases": []
32975
+ }
32976
+ }
32977
+ ],
32978
+ "description": "Returns true when both arrays have the same length and each index is strictly equal (`===`)."
32979
+ },
32980
+ {
32981
+ "kind": "function",
32982
+ "name": "uniqueNonEmptyStrings",
32983
+ "return": {
32984
+ "type": {
32985
+ "text": "string[]"
32986
+ }
32987
+ },
32988
+ "parameters": [
32989
+ {
32990
+ "name": "values",
32991
+ "type": {
32992
+ "text": "Iterable<string | null | undefined>",
32993
+ "_sourceAliases": []
32994
+ }
32995
+ }
32996
+ ],
32997
+ "description": "Returns unique non-empty strings in first-seen order (insertion order of a `Set` over the filtered list)."
32346
32998
  }
32347
32999
  ],
32348
33000
  "exports": [
@@ -32640,6 +33292,22 @@
32640
33292
  "name": "appendAnchorName",
32641
33293
  "module": "/src/internal/utils/dom.js"
32642
33294
  }
33295
+ },
33296
+ {
33297
+ "kind": "js",
33298
+ "name": "sameOrderedStringArray",
33299
+ "declaration": {
33300
+ "name": "sameOrderedStringArray",
33301
+ "module": "/src/internal/utils/dom.js"
33302
+ }
33303
+ },
33304
+ {
33305
+ "kind": "js",
33306
+ "name": "uniqueNonEmptyStrings",
33307
+ "declaration": {
33308
+ "name": "uniqueNonEmptyStrings",
33309
+ "module": "/src/internal/utils/dom.js"
33310
+ }
32643
33311
  }
32644
33312
  ]
32645
33313
  },
@@ -43614,45 +44282,6 @@
43614
44282
  }
43615
44283
  ]
43616
44284
  },
43617
- {
43618
- "kind": "javascript-module",
43619
- "path": "/src/scoped/index.js",
43620
- "declarations": [
43621
- {
43622
- "kind": "function",
43623
- "name": "scope",
43624
- "return": {
43625
- "type": {
43626
- "text": "typeof element"
43627
- }
43628
- },
43629
- "parameters": [
43630
- {
43631
- "name": "element",
43632
- "type": {
43633
- "text": "LitElementConstructor & { elementDefinitions?: Record<string, LitElementConstructor> }",
43634
- "_sourceAliases": []
43635
- }
43636
- },
43637
- {
43638
- "name": "Mixin",
43639
- "default": "ScopedRegistryHost"
43640
- }
43641
- ],
43642
- "deprecated": "Utility for applying mixin recursively to all Elements, used for scoped element registry polyfills and shims"
43643
- }
43644
- ],
43645
- "exports": [
43646
- {
43647
- "kind": "js",
43648
- "name": "scope",
43649
- "declaration": {
43650
- "name": "scope",
43651
- "module": "/src/scoped/index.js"
43652
- }
43653
- }
43654
- ]
43655
- },
43656
44285
  {
43657
44286
  "kind": "javascript-module",
43658
44287
  "path": "/src/search/define.js",
@@ -50881,6 +51510,231 @@
50881
51510
  "name": "*",
50882
51511
  "module": "home/runner/work/elements/elements/projects/core/src/tabs/tabs.js"
50883
51512
  }
51513
+ },
51514
+ {
51515
+ "kind": "js",
51516
+ "name": "*",
51517
+ "declaration": {
51518
+ "name": "*",
51519
+ "module": "home/runner/work/elements/elements/projects/core/src/tabs/tabs-group.js"
51520
+ }
51521
+ }
51522
+ ]
51523
+ },
51524
+ {
51525
+ "kind": "javascript-module",
51526
+ "path": "/src/tabs/tabs-group.js",
51527
+ "declarations": [
51528
+ {
51529
+ "kind": "class",
51530
+ "description": "Coordinates tabs with matching panel content using Invoker Commands and slot-matched panels.",
51531
+ "name": "TabsGroup",
51532
+ "cssProperties": [
51533
+ {
51534
+ "name": "--padding",
51535
+ "description": "[MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/padding)"
51536
+ }
51537
+ ],
51538
+ "slots": [
51539
+ {
51540
+ "description": "Default slot for a single nve-tabs element. Do not use behavior-select on nve-tabs when using this group.",
51541
+ "name": ""
51542
+ },
51543
+ {
51544
+ "type": {
51545
+ "text": "value"
51546
+ },
51547
+ "description": "Named panel content where the slot name matches a nve-tabs-item value.",
51548
+ "name": "value",
51549
+ "dynamic": true
51550
+ }
51551
+ ],
51552
+ "members": [
51553
+ {
51554
+ "kind": "field",
51555
+ "name": "alignment",
51556
+ "type": {
51557
+ "text": "'top' | 'start' | 'end'",
51558
+ "_sourceAliases": [
51559
+ "TabsGroupAlignment"
51560
+ ],
51561
+ "values": [
51562
+ {
51563
+ "value": "top",
51564
+ "description": ""
51565
+ },
51566
+ {
51567
+ "value": "start",
51568
+ "description": ""
51569
+ },
51570
+ {
51571
+ "value": "end",
51572
+ "description": ""
51573
+ }
51574
+ ]
51575
+ },
51576
+ "default": "'top'",
51577
+ "description": "Determines the alignment of the popover relative to the provided anchor element.",
51578
+ "attribute": "alignment",
51579
+ "reflects": true
51580
+ },
51581
+ {
51582
+ "name": "nve-layout",
51583
+ "deprecated": true,
51584
+ "description": "not supported on custom element tags",
51585
+ "type": {
51586
+ "text": "string",
51587
+ "values": [
51588
+ {
51589
+ "value": "string",
51590
+ "description": ""
51591
+ },
51592
+ {
51593
+ "value": "string",
51594
+ "description": ""
51595
+ }
51596
+ ],
51597
+ "_sourceAliases": []
51598
+ },
51599
+ "attribute": "nve-layout",
51600
+ "kind": "field"
51601
+ },
51602
+ {
51603
+ "name": "nve-text",
51604
+ "deprecated": true,
51605
+ "description": "not supported on custom element tags",
51606
+ "type": {
51607
+ "text": "string",
51608
+ "values": [
51609
+ {
51610
+ "value": "string",
51611
+ "description": ""
51612
+ },
51613
+ {
51614
+ "value": "string",
51615
+ "description": ""
51616
+ }
51617
+ ],
51618
+ "_sourceAliases": []
51619
+ },
51620
+ "attribute": "nve-text",
51621
+ "kind": "field"
51622
+ }
51623
+ ],
51624
+ "events": [
51625
+ {
51626
+ "name": "select",
51627
+ "type": {
51628
+ "text": "CustomEvent"
51629
+ },
51630
+ "description": "Dispatched when the selected tab value changes after an invoker `--toggle` updates selection"
51631
+ }
51632
+ ],
51633
+ "attributes": [
51634
+ {
51635
+ "name": "alignment",
51636
+ "type": {
51637
+ "text": "'top' | 'start' | 'end'",
51638
+ "_sourceAliases": [
51639
+ "TabsGroupAlignment"
51640
+ ],
51641
+ "values": [
51642
+ {
51643
+ "value": "top",
51644
+ "description": ""
51645
+ },
51646
+ {
51647
+ "value": "start",
51648
+ "description": ""
51649
+ },
51650
+ {
51651
+ "value": "end",
51652
+ "description": ""
51653
+ }
51654
+ ]
51655
+ },
51656
+ "default": "'top'",
51657
+ "description": "Determines the alignment of the popover relative to the provided anchor element.",
51658
+ "fieldName": "alignment"
51659
+ },
51660
+ {
51661
+ "name": "nve-layout",
51662
+ "deprecated": true,
51663
+ "description": "not supported on custom element tags",
51664
+ "type": {
51665
+ "text": "string",
51666
+ "values": [
51667
+ {
51668
+ "value": "string",
51669
+ "description": ""
51670
+ },
51671
+ {
51672
+ "value": "string",
51673
+ "description": ""
51674
+ }
51675
+ ],
51676
+ "_sourceAliases": []
51677
+ }
51678
+ },
51679
+ {
51680
+ "name": "nve-text",
51681
+ "deprecated": true,
51682
+ "description": "not supported on custom element tags",
51683
+ "type": {
51684
+ "text": "string",
51685
+ "values": [
51686
+ {
51687
+ "value": "string",
51688
+ "description": ""
51689
+ },
51690
+ {
51691
+ "value": "string",
51692
+ "description": ""
51693
+ }
51694
+ ],
51695
+ "_sourceAliases": []
51696
+ }
51697
+ }
51698
+ ],
51699
+ "superclass": {
51700
+ "name": "LitElement",
51701
+ "package": "lit"
51702
+ },
51703
+ "tagName": "nve-tabs-group",
51704
+ "customElement": true,
51705
+ "metadata": {
51706
+ "unitTests": true,
51707
+ "apiReview": true,
51708
+ "performance": true,
51709
+ "stable": true,
51710
+ "vqa": true,
51711
+ "responsive": false,
51712
+ "themes": true,
51713
+ "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/",
51714
+ "entrypoint": "@nvidia-elements/core/tabs",
51715
+ "example": "",
51716
+ "package": true,
51717
+ "since": "1.67.0",
51718
+ "status": "stable",
51719
+ "behavior": "navigation",
51720
+ "markdown": "## nve-tabs-group\n\nCoordinates tabs with matching panel content using Invoker Commands and slot-matched panels.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tabs/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Default slot for a single nve-tabs element. Do not use behavior-select on nve-tabs when using this group. |\n| {value} | `string` | Named panel content where the slot name matches a nve-tabs-item value. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| alignment | `'top' \\| 'start' \\| 'end'` | Determines the alignment of the popover relative to the provided anchor element. |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| select | `CustomEvent` | Dispatched when the selected tab value changes after an invoker `--toggle` updates selection |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --toggle | `CommandEvent` | Select the matching tab and reveal the panel whose slot matches the invoker value. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |"
51721
+ },
51722
+ "commands": [
51723
+ {
51724
+ "name": "--toggle",
51725
+ "description": "Select the matching tab and reveal the panel whose slot matches the invoker value."
51726
+ }
51727
+ ]
51728
+ }
51729
+ ],
51730
+ "exports": [
51731
+ {
51732
+ "kind": "js",
51733
+ "name": "TabsGroup",
51734
+ "declaration": {
51735
+ "name": "TabsGroup",
51736
+ "module": "/src/tabs/tabs-group.js"
51737
+ }
50884
51738
  }
50885
51739
  ]
50886
51740
  },
@@ -51935,12 +52789,12 @@
51935
52789
  "themes": true,
51936
52790
  "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/",
51937
52791
  "entrypoint": "@nvidia-elements/core/tabs",
51938
- "example": "<nve-tabs behavior-select>\n <nve-tabs-item selected>Tab 1</nve-tabs-item>\n <nve-tabs-item>Tab 2</nve-tabs-item>\n <nve-tabs-item>Tab 3</nve-tabs-item>\n <nve-tabs-item>Tab 4</nve-tabs-item>\n <nve-tabs-item disabled>Disabled</nve-tabs-item>\n</nve-tabs>",
52792
+ "example": "<nve-tabs-group id=\"tab-group-default\">\n <nve-tabs>\n <nve-tabs-item selected command=\"--toggle\" commandfor=\"tab-group-default\" value=\"overview\">Overview</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"details\">Details</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"settings\">Settings</nve-tabs-item>\n </nve-tabs>\n <div slot=\"overview\">overview content</div>\n <div slot=\"details\">details content</div>\n <div slot=\"settings\">settings content</div>\n</nve-tabs-group>",
51939
52793
  "package": true,
51940
52794
  "since": "0.10.0",
51941
52795
  "status": "stable",
51942
52796
  "behavior": "button",
51943
- "markdown": "## nve-tabs-item\n\nRepresents an individual tab within a tablist, providing a selectable button for switching between content views.\n\n### Example\n\n```html\n<nve-tabs behavior-select>\n <nve-tabs-item selected>Tab 1</nve-tabs-item>\n <nve-tabs-item>Tab 2</nve-tabs-item>\n <nve-tabs-item>Tab 3</nve-tabs-item>\n <nve-tabs-item>Tab 4</nve-tabs-item>\n <nve-tabs-item disabled>Disabled</nve-tabs-item>\n</nve-tabs>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tabs/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for content |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\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| type | `'button' \\| 'submit' \\| 'reset'` | Defines the button behavior when associated within an <form> element. https://mdn.dev/HTML/Element/button#attr-type |\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| 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| readonly | `boolean` | Indicates whether the user can change the element's value while it remains visible and focusable. [MDN](https://mdn.dev/HTML/Attributes/readonly) - `true` The element has a readonly state: the user cannot change its value, but can still focus and copy it. - `false` The element allows editing and the user can change its value through interaction. |\n| form | `HTMLFormElement \\| null \\| string` | Like input form, sets a button to submit a form outside its parent form. Returns a reference to the form element if available. https://mdn.dev/ElementInternals/form |\n| name | `string` | The name of the button, submitted as a pair with the button's value as part of the form data, when that button submits the form. https://mdn.dev/HTML/Element/button#attr-name |\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| 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| 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| popoverTargetElement | `HTMLElement \\| null` | Establishing a relationship between a popover and its invoker button. https://mdn.dev/HTMLInputElement/popoverTargetElement |\n| popovertarget | `string` | The idref of the element that receives the popover. https://mdn.dev/HTML/Reference/Elements/button#popovertarget |\n| popoverTargetAction (popovertargetaction) | `'show' \\| 'hide' \\| 'toggle'` | The popover target action to perform on the popover target element. https://mdn.dev/HTMLInputElement/popoverTargetAction |\n| commandForElement | `HTMLElement \\| null` | The element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| commandfor | `string \\| null` | The idref of the element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| command | `string` | The command to execute on the element. https://mdn.dev/Invoker_Commands_API |\n| interestForElement | `HTMLElement \\| null` | The element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n| interestfor | `string \\| null` | The idref of the element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --border-width | `string` | [MDN](https://mdn.dev/CSS/border-width) |\n| --border-height | `string` | |\n| --border-top | `string` | [MDN](https://mdn.dev/CSS/border-top) |\n| --border-background | `string` | |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |"
52797
+ "markdown": "## nve-tabs-item\n\nRepresents an individual tab within a tablist, providing a selectable button for switching between content views.\n\n### Example\n\n```html\n<nve-tabs-group id=\"tab-group-default\">\n <nve-tabs>\n <nve-tabs-item selected command=\"--toggle\" commandfor=\"tab-group-default\" value=\"overview\">Overview</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"details\">Details</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"settings\">Settings</nve-tabs-item>\n </nve-tabs>\n <div slot=\"overview\">overview content</div>\n <div slot=\"details\">details content</div>\n <div slot=\"settings\">settings content</div>\n</nve-tabs-group>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tabs/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for content |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\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| type | `'button' \\| 'submit' \\| 'reset'` | Defines the button behavior when associated within an <form> element. https://mdn.dev/HTML/Element/button#attr-type |\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| 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| readonly | `boolean` | Indicates whether the user can change the element's value while it remains visible and focusable. [MDN](https://mdn.dev/HTML/Attributes/readonly) - `true` The element has a readonly state: the user cannot change its value, but can still focus and copy it. - `false` The element allows editing and the user can change its value through interaction. |\n| form | `HTMLFormElement \\| null \\| string` | Like input form, sets a button to submit a form outside its parent form. Returns a reference to the form element if available. https://mdn.dev/ElementInternals/form |\n| name | `string` | The name of the button, submitted as a pair with the button's value as part of the form data, when that button submits the form. https://mdn.dev/HTML/Element/button#attr-name |\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| 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| 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| popoverTargetElement | `HTMLElement \\| null` | Establishing a relationship between a popover and its invoker button. https://mdn.dev/HTMLInputElement/popoverTargetElement |\n| popovertarget | `string` | The idref of the element that receives the popover. https://mdn.dev/HTML/Reference/Elements/button#popovertarget |\n| popoverTargetAction (popovertargetaction) | `'show' \\| 'hide' \\| 'toggle'` | The popover target action to perform on the popover target element. https://mdn.dev/HTMLInputElement/popoverTargetAction |\n| commandForElement | `HTMLElement \\| null` | The element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| commandfor | `string \\| null` | The idref of the element that receives the command. https://mdn.dev/Invoker_Commands_API |\n| command | `string` | The command to execute on the element. https://mdn.dev/Invoker_Commands_API |\n| interestForElement | `HTMLElement \\| null` | The element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n| interestfor | `string \\| null` | The idref of the element that receives the interest. https://mdn.dev/HTMLAnchorElement/interestForElement |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --border-width | `string` | [MDN](https://mdn.dev/CSS/border-width) |\n| --border-height | `string` | |\n| --border-top | `string` | [MDN](https://mdn.dev/CSS/border-top) |\n| --border-background | `string` | |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |\n| --padding | `string` | [MDN](https://mdn.dev/CSS/padding) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --height | `string` | [MDN](https://mdn.dev/CSS/height) |\n| --cursor | `string` | [MDN](https://mdn.dev/CSS/cursor) |\n| --text-transform | `string` | [MDN](https://mdn.dev/CSS/text-transform) |"
51944
52798
  }
51945
52799
  },
51946
52800
  {
@@ -52200,12 +53054,12 @@
52200
53054
  "themes": true,
52201
53055
  "aria": "https://www.w3.org/WAI/ARIA/apg/patterns/tabs/",
52202
53056
  "entrypoint": "@nvidia-elements/core/tabs",
52203
- "example": "<nve-tabs behavior-select>\n <nve-tabs-item selected>Tab 1</nve-tabs-item>\n <nve-tabs-item>Tab 2</nve-tabs-item>\n <nve-tabs-item>Tab 3</nve-tabs-item>\n <nve-tabs-item>Tab 4</nve-tabs-item>\n <nve-tabs-item disabled>Disabled</nve-tabs-item>\n</nve-tabs>",
53057
+ "example": "<nve-tabs-group id=\"tab-group-default\">\n <nve-tabs>\n <nve-tabs-item selected command=\"--toggle\" commandfor=\"tab-group-default\" value=\"overview\">Overview</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"details\">Details</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"settings\">Settings</nve-tabs-item>\n </nve-tabs>\n <div slot=\"overview\">overview content</div>\n <div slot=\"details\">details content</div>\n <div slot=\"settings\">settings content</div>\n</nve-tabs-group>",
52204
53058
  "package": true,
52205
53059
  "since": "0.10.0",
52206
53060
  "status": "stable",
52207
53061
  "behavior": "navigation",
52208
- "markdown": "## nve-tabs\n\nTabs provide a selection UX, typically used for swapping content shown on a page, or within a navigation context.\n\n### Example\n\n```html\n<nve-tabs behavior-select>\n <nve-tabs-item selected>Tab 1</nve-tabs-item>\n <nve-tabs-item>Tab 2</nve-tabs-item>\n <nve-tabs-item>Tab 3</nve-tabs-item>\n <nve-tabs-item>Tab 4</nve-tabs-item>\n <nve-tabs-item disabled>Disabled</nve-tabs-item>\n</nve-tabs>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tabs/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for tab-item |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| vertical | `boolean` | Determines whether the tabs should display in a vertical layout vs. defaulting to horizontal. |\n| borderless | `boolean` | Determines whether the tabs should display a border on selected items vs. defaults to show border. |\n| behaviorSelect (behavior-select) | `boolean` | Determines whether the tabs should handle selection behavior vs. defaults to off. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --indicator-background | `string` | |\n| --indicator-border-radius | `string` | |\n| --indicator-height | `string` | |\n| --border-inset | `string` | |"
53062
+ "markdown": "## nve-tabs\n\nTabs provide a selection UX, typically used for swapping content shown on a page, or within a navigation context.\n\n### Example\n\n```html\n<nve-tabs-group id=\"tab-group-default\">\n <nve-tabs>\n <nve-tabs-item selected command=\"--toggle\" commandfor=\"tab-group-default\" value=\"overview\">Overview</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"details\">Details</nve-tabs-item>\n <nve-tabs-item command=\"--toggle\" commandfor=\"tab-group-default\" value=\"settings\">Settings</nve-tabs-item>\n </nve-tabs>\n <div slot=\"overview\">overview content</div>\n <div slot=\"details\">details content</div>\n <div slot=\"settings\">settings content</div>\n</nve-tabs-group>\n```\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tabs/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | default slot for tab-item |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\n| vertical | `boolean` | Determines whether the tabs should display in a vertical layout vs. defaulting to horizontal. |\n| borderless | `boolean` | Determines whether the tabs should display a border on selected items vs. defaults to show border. |\n| behaviorSelect (behavior-select) | `boolean` | Determines whether the tabs should handle selection behavior vs. defaults to off. |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --gap | `string` | [MDN](https://mdn.dev/CSS/gap) |\n| --indicator-background | `string` | |\n| --indicator-border-radius | `string` | |\n| --indicator-height | `string` | |\n| --border-inset | `string` | |"
52209
53063
  }
52210
53064
  }
52211
53065
  ],
@@ -53612,206 +54466,6 @@
53612
54466
  }
53613
54467
  ]
53614
54468
  },
53615
- {
53616
- "kind": "javascript-module",
53617
- "path": "/src/test/demo.js",
53618
- "declarations": [
53619
- {
53620
- "kind": "function",
53621
- "name": "getItems",
53622
- "return": {
53623
- "type": {
53624
- "text": "DemoItem[]"
53625
- }
53626
- },
53627
- "parameters": [
53628
- {
53629
- "name": "rows",
53630
- "default": "10"
53631
- }
53632
- ],
53633
- "description": "demo data for examples only"
53634
- },
53635
- {
53636
- "kind": "function",
53637
- "name": "grid",
53638
- "parameters": [
53639
- {
53640
- "name": "rows",
53641
- "default": "9"
53642
- },
53643
- {
53644
- "name": "columns",
53645
- "default": "4"
53646
- }
53647
- ],
53648
- "description": "demo data for datagrid examples only"
53649
- }
53650
- ],
53651
- "exports": [
53652
- {
53653
- "kind": "js",
53654
- "name": "getItems",
53655
- "declaration": {
53656
- "name": "getItems",
53657
- "module": "/src/test/demo.js"
53658
- }
53659
- },
53660
- {
53661
- "kind": "js",
53662
- "name": "grid",
53663
- "declaration": {
53664
- "name": "grid",
53665
- "module": "/src/test/demo.js"
53666
- }
53667
- }
53668
- ]
53669
- },
53670
- {
53671
- "kind": "javascript-module",
53672
- "path": "/src/test/index.js",
53673
- "declarations": [
53674
- {
53675
- "kind": "function",
53676
- "name": "createFixture",
53677
- "return": {
53678
- "type": {
53679
- "text": "Promise<HTMLElement>"
53680
- }
53681
- },
53682
- "parameters": [
53683
- {
53684
- "name": "template",
53685
- "optional": true,
53686
- "type": {
53687
- "text": "TemplateResult",
53688
- "_sourceAliases": []
53689
- }
53690
- }
53691
- ],
53692
- "deprecated": "Creates a test fixture DOM element for testing.\nFixture is ready when the registry defines all custom elements."
53693
- },
53694
- {
53695
- "kind": "function",
53696
- "name": "removeFixture",
53697
- "parameters": [
53698
- {
53699
- "name": "fixture",
53700
- "type": {
53701
- "text": "HTMLElement",
53702
- "_sourceAliases": []
53703
- }
53704
- }
53705
- ],
53706
- "deprecated": "Removes test fixture DOM element."
53707
- },
53708
- {
53709
- "kind": "function",
53710
- "name": "elementIsStable",
53711
- "parameters": [
53712
- {
53713
- "name": "element",
53714
- "type": {
53715
- "text": "any",
53716
- "_sourceAliases": []
53717
- }
53718
- }
53719
- ],
53720
- "deprecated": "Awaits until Lit element has rendered and has no pending updates"
53721
- },
53722
- {
53723
- "kind": "function",
53724
- "name": "emulateClick",
53725
- "parameters": [
53726
- {
53727
- "name": "component",
53728
- "type": {
53729
- "text": "HTMLElement | Element",
53730
- "_sourceAliases": []
53731
- }
53732
- }
53733
- ],
53734
- "deprecated": "true"
53735
- },
53736
- {
53737
- "kind": "function",
53738
- "name": "untilEvent",
53739
- "parameters": [
53740
- {
53741
- "name": "element",
53742
- "type": {
53743
- "text": "HTMLElement | Document",
53744
- "_sourceAliases": []
53745
- }
53746
- },
53747
- {
53748
- "name": "event",
53749
- "type": {
53750
- "text": "string",
53751
- "_sourceAliases": []
53752
- }
53753
- }
53754
- ],
53755
- "deprecated": "true"
53756
- }
53757
- ],
53758
- "exports": [
53759
- {
53760
- "kind": "js",
53761
- "name": "*",
53762
- "declaration": {
53763
- "name": "*",
53764
- "module": "home/runner/work/elements/elements/projects/core/src/test/demo.js"
53765
- }
53766
- },
53767
- {
53768
- "kind": "js",
53769
- "name": "createFixture",
53770
- "declaration": {
53771
- "name": "createFixture",
53772
- "module": "/src/test/index.js"
53773
- }
53774
- },
53775
- {
53776
- "kind": "js",
53777
- "name": "removeFixture",
53778
- "declaration": {
53779
- "name": "removeFixture",
53780
- "module": "/src/test/index.js"
53781
- }
53782
- },
53783
- {
53784
- "kind": "js",
53785
- "name": "elementIsStable",
53786
- "declaration": {
53787
- "name": "elementIsStable",
53788
- "module": "/src/test/index.js"
53789
- }
53790
- },
53791
- {
53792
- "kind": "js",
53793
- "name": "emulateClick",
53794
- "declaration": {
53795
- "name": "emulateClick",
53796
- "module": "/src/test/index.js"
53797
- }
53798
- },
53799
- {
53800
- "kind": "js",
53801
- "name": "untilEvent",
53802
- "declaration": {
53803
- "name": "untilEvent",
53804
- "module": "/src/test/index.js"
53805
- }
53806
- }
53807
- ]
53808
- },
53809
- {
53810
- "kind": "javascript-module",
53811
- "path": "/src/test/setup.js",
53812
- "declarations": [],
53813
- "exports": []
53814
- },
53815
54469
  {
53816
54470
  "kind": "javascript-module",
53817
54471
  "path": "/src/textarea/define.js",
@@ -57710,7 +58364,7 @@
57710
58364
  "name": ""
57711
58365
  },
57712
58366
  {
57713
- "description": "Use for extended long form content containing interactive elements or form inputs.",
58367
+ "description": "Use only for extended long form content containing interactive elements or form inputs.",
57714
58368
  "name": "content"
57715
58369
  }
57716
58370
  ],
@@ -58108,7 +58762,7 @@
58108
58762
  "since": "1.2.0",
58109
58763
  "status": "stable",
58110
58764
  "behavior": "list",
58111
- "markdown": "## nve-tree-node\n\nA tree view widget presents a hierarchical list. Any item in the hierarchy may have child items, and items that have children can expand or collapse to show or hide the children.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tree/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Use default slot for basic text content or nested <nve-tree-node> elements. |\n| content | `string` | Use for extended long form content containing interactive elements or form inputs. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\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| 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| expandable | `boolean` | Determines whether a node can be expandable. Expandable by default if slotted nodes exist. |\n| selectable | `'single' \\| 'multi'` | Determines whether a node can be in a selected state. Nodes can be in a single or multi select state. |\n| highlighted | `boolean` | Determines the highlighted state of the element. Highlighted states serve non-interactive selections where nodes may relate to other selected portions of the UI. |\n| i18n | | Enables updating internal string values for internationalization. |\n| indeterminate | `boolean` | |\n| behaviorExpand | `boolean` | |\n| behaviorSelect | `boolean` | |\n| open | | opens and sets the expanded state automatically if behaviorExpand is true |\n| close | | closes and sets the expanded state automatically if behaviorExpand is true |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| open | `CustomEvent` | Dispatched when the node opens. |\n| close | `CustomEvent` | Dispatched when the node closes. |\n| select | `CustomEvent` | Dispatched when the node selection state changes. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --select | `CommandEvent` | use to select the node |\n| --deselect | `CommandEvent` | use to deselect the node |\n| --toggle-select | `CommandEvent` | use to toggle the node selection state |\n| --open | `CommandEvent` | use to open the node |\n| --close | `CommandEvent` | use to close the node |\n| --toggle | `CommandEvent` | use to toggle open / closed state of the node |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --text-wrap | `string` | [MDN](https://mdn.dev/CSS/text-wrap) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
58765
+ "markdown": "## nve-tree-node\n\nA tree view widget presents a hierarchical list. Any item in the hierarchy may have child items, and items that have children can expand or collapse to show or hide the children.\n\n### Import\n\n```javascript\nimport '@nvidia-elements/core/tree/define.js';\n```\n\n### Slots\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| (default) | `string` | Use default slot for basic text content or nested <nve-tree-node> elements. |\n| content | `string` | Use only for extended long form content containing interactive elements or form inputs. |\n\n### Properties / Attributes\n\n| property (attribute) | value | description |\n| -------------------- | ----- | ----------- |\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| 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| expandable | `boolean` | Determines whether a node can be expandable. Expandable by default if slotted nodes exist. |\n| selectable | `'single' \\| 'multi'` | Determines whether a node can be in a selected state. Nodes can be in a single or multi select state. |\n| highlighted | `boolean` | Determines the highlighted state of the element. Highlighted states serve non-interactive selections where nodes may relate to other selected portions of the UI. |\n| i18n | | Enables updating internal string values for internationalization. |\n| indeterminate | `boolean` | |\n| behaviorExpand | `boolean` | |\n| behaviorSelect | `boolean` | |\n| open | | opens and sets the expanded state automatically if behaviorExpand is true |\n| close | | closes and sets the expanded state automatically if behaviorExpand is true |\n\n### Events\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| open | `CustomEvent` | Dispatched when the node opens. |\n| close | `CustomEvent` | Dispatched when the node closes. |\n| select | `CustomEvent` | Dispatched when the node selection state changes. |\n\n### Invoker Commands\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --select | `CommandEvent` | use to select the node |\n| --deselect | `CommandEvent` | use to deselect the node |\n| --toggle-select | `CommandEvent` | use to toggle the node selection state |\n| --open | `CommandEvent` | use to open the node |\n| --close | `CommandEvent` | use to close the node |\n| --toggle | `CommandEvent` | use to toggle open / closed state of the node |\n\n### CSS Properties\n\n| name | value | description |\n| ---- | ----- | ----------- |\n| --color | `string` | [MDN](https://mdn.dev/CSS/color) |\n| --border-radius | `string` | [MDN](https://mdn.dev/CSS/border-radius) |\n| --font-size | `string` | [MDN](https://mdn.dev/CSS/font-size) |\n| --min-height | `string` | [MDN](https://mdn.dev/CSS/min-height) |\n| --text-wrap | `string` | [MDN](https://mdn.dev/CSS/text-wrap) |\n| --font-weight | `string` | [MDN](https://mdn.dev/CSS/font-weight) |\n| --width | `string` | [MDN](https://mdn.dev/CSS/width) |"
58112
58766
  },
58113
58767
  "commands": [
58114
58768
  {