@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
@@ -131,52 +131,6 @@ export type AccordionGroupProps = {
131
131
  "nve-text"?: string;
132
132
  };
133
133
 
134
- export type AlertBannerProps = {
135
- /** @deprecated - not supported on custom element tags */
136
- "nve-layout"?: string;
137
- /** @deprecated - not supported on custom element tags */
138
- "nve-text"?: string;
139
- /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
140
- - `accent` Highlights important actions or draws attention to primary interactive elements.
141
-
142
- - `warning` Indicates cautionary actions that require careful consideration before proceeding.
143
-
144
- - `success` Represents positive outcomes, confirmations, or constructive actions.
145
-
146
- - `danger` Signals destructive or irreversible actions that need extra attention and confirmation. */
147
- status?: "accent" | "warning" | "success" | "danger" | "default";
148
- /** Controls the visual prominence to establish hierarchy and guide user attention.
149
- - `emphasis` Increases visual weight to draw attention and highlight important elements. */
150
- prominence?: "emphasis" | "default";
151
- /** Defines a base color from the theme color palette */
152
- color?:
153
- | "red-cardinal"
154
- | "gray-slate"
155
- | "gray-denim"
156
- | "blue-indigo"
157
- | "blue-cobalt"
158
- | "blue-sky"
159
- | "teal-cyan"
160
- | "green-mint"
161
- | "teal-seafoam"
162
- | "green-grass"
163
- | "yellow-amber"
164
- | "orange-pumpkin"
165
- | "red-tomato"
166
- | "pink-magenta"
167
- | "purple-plum"
168
- | "purple-violet"
169
- | "purple-lavender"
170
- | "pink-rose"
171
- | "green-jade"
172
- | "lime-pear"
173
- | "yellow-nova"
174
- | "brand-green";
175
- /** Demonstrates different container styles to accommodate visual weight and context.
176
- - `full` Element container optimizes for filling its container bounds. */
177
- container?: "full" | "default";
178
- };
179
-
180
134
  export type AlertGroupProps = {
181
135
  /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
182
136
  - `accent` Highlights important actions or draws attention to primary interactive elements.
@@ -710,6 +664,8 @@ export type ComboboxProps = {
710
664
  container?: "flat";
711
665
  /** Disable rendering of inline tags for many-item select */
712
666
  notags?: boolean;
667
+ /** Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail. */
668
+ "behavior-create"?: boolean;
713
669
  /** @deprecated - not supported on custom element tags */
714
670
  "nve-layout"?: string;
715
671
  /** @deprecated - not supported on custom element tags */
@@ -738,6 +694,8 @@ export type ComboboxProps = {
738
694
  - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. */
739
695
  prominence?: "muted";
740
696
 
697
+ /** Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`. */
698
+ oncreate?: (e: CustomEvent<CustomEvent>) => void;
741
699
  /** Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. */
742
700
  onscroll?: (e: CustomEvent<never>) => void;
743
701
  /** */
@@ -1254,6 +1212,64 @@ export type FileProps = {
1254
1212
  onreset?: (e: CustomEvent<CustomEvent>) => void;
1255
1213
  };
1256
1214
 
1215
+ export type FormatDatetimeProps = {
1216
+ /** Optional date string for values supplied by JavaScript or bound data.
1217
+ By default, the component formats the element's text content, which also serves as the SSR fallback.
1218
+ When both are present, this property takes precedence. */
1219
+ date?: string | "default";
1220
+ /** Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. */
1221
+ locale?: string | "default";
1222
+ /** Weekday representation: 'long' | 'short' | 'narrow'. */
1223
+ weekday?: "long" | "short" | "narrow" | "default";
1224
+ /** Year representation: 'numeric' | '2-digit'. */
1225
+ year?: "numeric" | "2-digit" | "default";
1226
+ /** Month representation: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow'. */
1227
+ month?: "numeric" | "2-digit" | "long" | "short" | "narrow" | "default";
1228
+ /** Day representation: 'numeric' | '2-digit'. */
1229
+ day?: "numeric" | "2-digit" | "default";
1230
+ /** Hour representation: 'numeric' | '2-digit'. */
1231
+ hour?: "numeric" | "2-digit" | "default";
1232
+ /** Minute representation: 'numeric' | '2-digit'. */
1233
+ minute?: "numeric" | "2-digit" | "default";
1234
+ /** Second representation: 'numeric' | '2-digit'. */
1235
+ second?: "numeric" | "2-digit" | "default";
1236
+ /** Preset date formatting style: 'full' | 'long' | 'medium' | 'short'.
1237
+ Preset styles take precedence over granular date and time part options. */
1238
+ "date-style"?: "full" | "long" | "medium" | "short" | "default";
1239
+ /** Preset time formatting style: 'full' | 'long' | 'medium' | 'short'.
1240
+ Preset styles take precedence over granular date and time part options. */
1241
+ "time-style"?: "full" | "long" | "medium" | "short" | "default";
1242
+ /** Time zone name display: 'long' | 'short'. Use it with granular options only; preset styles ignore it. */
1243
+ "time-zone-name"?: "long" | "short" | "default";
1244
+ /** IANA time zone identifier (such as 'America/New_York', 'UTC'). */
1245
+ "time-zone"?: string | "default";
1246
+ /** @deprecated - not supported on custom element tags */
1247
+ "nve-layout"?: string;
1248
+ /** @deprecated - not supported on custom element tags */
1249
+ "nve-text"?: string;
1250
+ };
1251
+
1252
+ export type FormatRelativeTimeProps = {
1253
+ /** Optional date string for values supplied by JavaScript or bound data.
1254
+ By default, the component formats the element's text content, which also serves as the SSR fallback.
1255
+ When both are present, this property takes precedence. */
1256
+ date?: string | "default";
1257
+ /** Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. */
1258
+ locale?: string | "default";
1259
+ /** Numeric formatting: 'always' | 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'. */
1260
+ numeric?: "always" | "auto";
1261
+ /** Formatting length: 'long' | 'short' | 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option. */
1262
+ "format-style"?: "long" | "short" | "narrow";
1263
+ /** 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. */
1264
+ unit?: "second" | "minute" | "hour" | "day" | "week" | "month" | "year" | "auto";
1265
+ /** When present, auto-updates the displayed relative time at appropriate intervals. */
1266
+ sync?: boolean;
1267
+ /** @deprecated - not supported on custom element tags */
1268
+ "nve-layout"?: string;
1269
+ /** @deprecated - not supported on custom element tags */
1270
+ "nve-text"?: string;
1271
+ };
1272
+
1257
1273
  export type ControlGroupProps = {
1258
1274
  /** Controls the directional arrangement and spacing behavior of the element's content.
1259
1275
  - `vertical` Arranges content in a vertical stack with block-level spacing.
@@ -3260,6 +3276,18 @@ export type SwitchProps = {
3260
3276
  onreset?: (e: CustomEvent<CustomEvent>) => void;
3261
3277
  };
3262
3278
 
3279
+ export type TabsGroupProps = {
3280
+ /** Determines the alignment of the popover relative to the provided anchor element. */
3281
+ alignment?: "top" | "start" | "end";
3282
+ /** @deprecated - not supported on custom element tags */
3283
+ "nve-layout"?: string;
3284
+ /** @deprecated - not supported on custom element tags */
3285
+ "nve-text"?: string;
3286
+
3287
+ /** Dispatched when the selected tab value changes after an invoker `--toggle` updates selection */
3288
+ onselect?: (e: CustomEvent<CustomEvent>) => void;
3289
+ };
3290
+
3263
3291
  export type TabsItemProps = {
3264
3292
  /** Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)
3265
3293
  - `true` The element holds selection and represents the user's current choice within the group.
@@ -3888,27 +3916,6 @@ export type CustomElements = {
3888
3916
  */
3889
3917
  "nve-accordion-group": Partial<AccordionGroupProps & BaseProps & BaseEvents>;
3890
3918
 
3891
- /**
3892
- * @deprecated true
3893
- *
3894
- * An alert banner is an element that displays a brief, important message outside the context of the current page.
3895
- * ---
3896
- *
3897
- *
3898
- * ### **Slots:**
3899
- * - _default_ - default slot for nve-alert
3900
- *
3901
- * ### **CSS Properties:**
3902
- * - **--gap** - undefined _(default: undefined)_
3903
- * - **--color** - undefined _(default: undefined)_
3904
- * - **--padding** - undefined _(default: undefined)_
3905
- * - **--font-size** - undefined _(default: undefined)_
3906
- * - **--background** - undefined _(default: undefined)_
3907
- * - **--border-radius** - undefined _(default: undefined)_
3908
- * - **--border** - undefined _(default: undefined)_
3909
- */
3910
- "nve-alert-banner": Partial<AlertBannerProps & BaseProps & BaseEvents>;
3911
-
3912
3919
  /**
3913
3920
  * 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.
3914
3921
  * ---
@@ -4262,7 +4269,8 @@ export type CustomElements = {
4262
4269
  *
4263
4270
  *
4264
4271
  * ### **Events:**
4265
- * - **scroll** - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
4272
+ * - **create** - Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`.
4273
+ * - **scroll** - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
4266
4274
  * - **reset**
4267
4275
  *
4268
4276
  * ### **Methods:**
@@ -4305,6 +4313,7 @@ export type CustomElements = {
4305
4313
  * - **menu-item** - The menu item elements
4306
4314
  * - **checkbox** - The checkbox element
4307
4315
  * - **icon** - The icon element
4316
+ * - **create-option** - The menu item element for creating new options
4308
4317
  */
4309
4318
  "nve-combobox": Partial<ComboboxProps & BaseProps & BaseEvents>;
4310
4319
 
@@ -4743,6 +4752,28 @@ export type CustomElements = {
4743
4752
  */
4744
4753
  "nve-file": Partial<FileProps & BaseProps & BaseEvents>;
4745
4754
 
4755
+ /**
4756
+ * Formats a date/time value as localized text using the Intl.DateTimeFormat API. Renders inside a semantic time element.
4757
+ * Granular options (weekday, year, month, day, hour, minute, second) mirror the Intl.DateTimeFormat API. 'numeric' omits zero-padding, '2-digit' zero-pads.
4758
+ * ---
4759
+ *
4760
+ *
4761
+ * ### **Slots:**
4762
+ * - _default_ - Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.
4763
+ */
4764
+ "nve-format-datetime": Partial<FormatDatetimeProps & BaseProps & BaseEvents>;
4765
+
4766
+ /**
4767
+ * Formats a date/time value as localized relative text using the Intl.RelativeTimeFormat API. Renders inside a semantic time element.
4768
+ * Options mirror the Intl.RelativeTimeFormat API. When unit is 'auto', the component selects the best unit based on the time difference.
4769
+ * ---
4770
+ *
4771
+ *
4772
+ * ### **Slots:**
4773
+ * - _default_ - Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.
4774
+ */
4775
+ "nve-format-relative-time": Partial<FormatRelativeTimeProps & BaseProps & BaseEvents>;
4776
+
4746
4777
  /**
4747
4778
  * Groups many related form controls under a shared label and validation context for semantically linked inputs.
4748
4779
  * ---
@@ -5962,6 +5993,23 @@ export type CustomElements = {
5962
5993
  */
5963
5994
  "nve-switch": Partial<SwitchProps & BaseProps & BaseEvents>;
5964
5995
 
5996
+ /**
5997
+ * Coordinates tabs with matching panel content using Invoker Commands and slot-matched panels.
5998
+ * ---
5999
+ *
6000
+ *
6001
+ * ### **Events:**
6002
+ * - **select** - Dispatched when the selected tab value changes after an invoker `--toggle` updates selection
6003
+ *
6004
+ * ### **Slots:**
6005
+ * - _default_ - Default slot for a single nve-tabs element. Do not use behavior-select on nve-tabs when using this group.
6006
+ * - **value** - Named panel content where the slot name matches a nve-tabs-item value.
6007
+ *
6008
+ * ### **CSS Properties:**
6009
+ * - **--padding** - undefined _(default: undefined)_
6010
+ */
6011
+ "nve-tabs-group": Partial<TabsGroupProps & BaseProps & BaseEvents>;
6012
+
5965
6013
  /**
5966
6014
  * Represents an individual tab within a tablist, providing a selectable button for switching between content views.
5967
6015
  * ---
@@ -6276,7 +6324,7 @@ export type CustomElements = {
6276
6324
  *
6277
6325
  * ### **Slots:**
6278
6326
  * - _default_ - Use default slot for basic text content or nested <nve-tree-node> elements.
6279
- * - **content** - Use for extended long form content containing interactive elements or form inputs.
6327
+ * - **content** - Use only for extended long form content containing interactive elements or form inputs.
6280
6328
  *
6281
6329
  * ### **CSS Properties:**
6282
6330
  * - **--color** - undefined _(default: undefined)_
@@ -58,52 +58,6 @@ type AccordionGroupProps = {
58
58
  "nve-text"?: string;
59
59
  };
60
60
 
61
- type AlertBannerProps = {
62
- /** @deprecated - not supported on custom element tags */
63
- "nve-layout"?: string;
64
- /** @deprecated - not supported on custom element tags */
65
- "nve-text"?: string;
66
- /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
67
- - `accent` Highlights important actions or draws attention to primary interactive elements.
68
-
69
- - `warning` Indicates cautionary actions that require careful consideration before proceeding.
70
-
71
- - `success` Represents positive outcomes, confirmations, or constructive actions.
72
-
73
- - `danger` Signals destructive or irreversible actions that need extra attention and confirmation. */
74
- status?: "accent" | "warning" | "success" | "danger" | "default";
75
- /** Controls the visual prominence to establish hierarchy and guide user attention.
76
- - `emphasis` Increases visual weight to draw attention and highlight important elements. */
77
- prominence?: "emphasis" | "default";
78
- /** Defines a base color from the theme color palette */
79
- color?:
80
- | "red-cardinal"
81
- | "gray-slate"
82
- | "gray-denim"
83
- | "blue-indigo"
84
- | "blue-cobalt"
85
- | "blue-sky"
86
- | "teal-cyan"
87
- | "green-mint"
88
- | "teal-seafoam"
89
- | "green-grass"
90
- | "yellow-amber"
91
- | "orange-pumpkin"
92
- | "red-tomato"
93
- | "pink-magenta"
94
- | "purple-plum"
95
- | "purple-violet"
96
- | "purple-lavender"
97
- | "pink-rose"
98
- | "green-jade"
99
- | "lime-pear"
100
- | "yellow-nova"
101
- | "brand-green";
102
- /** Demonstrates different container styles to accommodate visual weight and context.
103
- - `full` Element container optimizes for filling its container bounds. */
104
- container?: "full" | "default";
105
- };
106
-
107
61
  type AlertGroupProps = {
108
62
  /** Communicates the intent and semantic meaning of an element to help users understand the outcome of their actions.
109
63
  - `accent` Highlights important actions or draws attention to primary interactive elements.
@@ -637,6 +591,8 @@ type ComboboxProps = {
637
591
  container?: "flat";
638
592
  /** Disable rendering of inline tags for many-item select */
639
593
  notags?: boolean;
594
+ /** Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail. */
595
+ "behavior-create"?: boolean;
640
596
  /** @deprecated - not supported on custom element tags */
641
597
  "nve-layout"?: string;
642
598
  /** @deprecated - not supported on custom element tags */
@@ -665,6 +621,8 @@ type ComboboxProps = {
665
621
  - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. */
666
622
  prominence?: "muted";
667
623
 
624
+ /** Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`. */
625
+ oncreate?: (e: CustomEvent<CustomEvent>) => void;
668
626
  /** Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. */
669
627
  onscroll?: (e: CustomEvent<never>) => void;
670
628
  /** */
@@ -1181,6 +1139,64 @@ type FileProps = {
1181
1139
  onreset?: (e: CustomEvent<CustomEvent>) => void;
1182
1140
  };
1183
1141
 
1142
+ type FormatDatetimeProps = {
1143
+ /** Optional date string for values supplied by JavaScript or bound data.
1144
+ By default, the component formats the element's text content, which also serves as the SSR fallback.
1145
+ When both are present, this property takes precedence. */
1146
+ date?: string | "default";
1147
+ /** Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. */
1148
+ locale?: string | "default";
1149
+ /** Weekday representation: 'long' | 'short' | 'narrow'. */
1150
+ weekday?: "long" | "short" | "narrow" | "default";
1151
+ /** Year representation: 'numeric' | '2-digit'. */
1152
+ year?: "numeric" | "2-digit" | "default";
1153
+ /** Month representation: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow'. */
1154
+ month?: "numeric" | "2-digit" | "long" | "short" | "narrow" | "default";
1155
+ /** Day representation: 'numeric' | '2-digit'. */
1156
+ day?: "numeric" | "2-digit" | "default";
1157
+ /** Hour representation: 'numeric' | '2-digit'. */
1158
+ hour?: "numeric" | "2-digit" | "default";
1159
+ /** Minute representation: 'numeric' | '2-digit'. */
1160
+ minute?: "numeric" | "2-digit" | "default";
1161
+ /** Second representation: 'numeric' | '2-digit'. */
1162
+ second?: "numeric" | "2-digit" | "default";
1163
+ /** Preset date formatting style: 'full' | 'long' | 'medium' | 'short'.
1164
+ Preset styles take precedence over granular date and time part options. */
1165
+ "date-style"?: "full" | "long" | "medium" | "short" | "default";
1166
+ /** Preset time formatting style: 'full' | 'long' | 'medium' | 'short'.
1167
+ Preset styles take precedence over granular date and time part options. */
1168
+ "time-style"?: "full" | "long" | "medium" | "short" | "default";
1169
+ /** Time zone name display: 'long' | 'short'. Use it with granular options only; preset styles ignore it. */
1170
+ "time-zone-name"?: "long" | "short" | "default";
1171
+ /** IANA time zone identifier (such as 'America/New_York', 'UTC'). */
1172
+ "time-zone"?: string | "default";
1173
+ /** @deprecated - not supported on custom element tags */
1174
+ "nve-layout"?: string;
1175
+ /** @deprecated - not supported on custom element tags */
1176
+ "nve-text"?: string;
1177
+ };
1178
+
1179
+ type FormatRelativeTimeProps = {
1180
+ /** Optional date string for values supplied by JavaScript or bound data.
1181
+ By default, the component formats the element's text content, which also serves as the SSR fallback.
1182
+ When both are present, this property takes precedence. */
1183
+ date?: string | "default";
1184
+ /** Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. */
1185
+ locale?: string | "default";
1186
+ /** Numeric formatting: 'always' | 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'. */
1187
+ numeric?: "always" | "auto";
1188
+ /** Formatting length: 'long' | 'short' | 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option. */
1189
+ "format-style"?: "long" | "short" | "narrow";
1190
+ /** 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. */
1191
+ unit?: "second" | "minute" | "hour" | "day" | "week" | "month" | "year" | "auto";
1192
+ /** When present, auto-updates the displayed relative time at appropriate intervals. */
1193
+ sync?: boolean;
1194
+ /** @deprecated - not supported on custom element tags */
1195
+ "nve-layout"?: string;
1196
+ /** @deprecated - not supported on custom element tags */
1197
+ "nve-text"?: string;
1198
+ };
1199
+
1184
1200
  type ControlGroupProps = {
1185
1201
  /** Controls the directional arrangement and spacing behavior of the element's content.
1186
1202
  - `vertical` Arranges content in a vertical stack with block-level spacing.
@@ -3187,6 +3203,18 @@ type SwitchProps = {
3187
3203
  onreset?: (e: CustomEvent<CustomEvent>) => void;
3188
3204
  };
3189
3205
 
3206
+ type TabsGroupProps = {
3207
+ /** Determines the alignment of the popover relative to the provided anchor element. */
3208
+ alignment?: "top" | "start" | "end";
3209
+ /** @deprecated - not supported on custom element tags */
3210
+ "nve-layout"?: string;
3211
+ /** @deprecated - not supported on custom element tags */
3212
+ "nve-text"?: string;
3213
+
3214
+ /** Dispatched when the selected tab value changes after an invoker `--toggle` updates selection */
3215
+ onselect?: (e: CustomEvent<CustomEvent>) => void;
3216
+ };
3217
+
3190
3218
  type TabsItemProps = {
3191
3219
  /** Indicates whether an element currently holds selection within a multi-option selection group. [MDN](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes/aria-selected)
3192
3220
  - `true` The element holds selection and represents the user's current choice within the group.
@@ -3815,27 +3843,6 @@ export type CustomElements = {
3815
3843
  */
3816
3844
  "nve-accordion-group": DefineComponent<AccordionGroupProps>;
3817
3845
 
3818
- /**
3819
- * @deprecated true
3820
- *
3821
- * An alert banner is an element that displays a brief, important message outside the context of the current page.
3822
- * ---
3823
- *
3824
- *
3825
- * ### **Slots:**
3826
- * - _default_ - default slot for nve-alert
3827
- *
3828
- * ### **CSS Properties:**
3829
- * - **--gap** - undefined _(default: undefined)_
3830
- * - **--color** - undefined _(default: undefined)_
3831
- * - **--padding** - undefined _(default: undefined)_
3832
- * - **--font-size** - undefined _(default: undefined)_
3833
- * - **--background** - undefined _(default: undefined)_
3834
- * - **--border-radius** - undefined _(default: undefined)_
3835
- * - **--border** - undefined _(default: undefined)_
3836
- */
3837
- "nve-alert-banner": DefineComponent<AlertBannerProps>;
3838
-
3839
3846
  /**
3840
3847
  * 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.
3841
3848
  * ---
@@ -4189,7 +4196,8 @@ export type CustomElements = {
4189
4196
  *
4190
4197
  *
4191
4198
  * ### **Events:**
4192
- * - **scroll** - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
4199
+ * - **create** - Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`.
4200
+ * - **scroll** - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
4193
4201
  * - **reset**
4194
4202
  *
4195
4203
  * ### **Methods:**
@@ -4232,6 +4240,7 @@ export type CustomElements = {
4232
4240
  * - **menu-item** - The menu item elements
4233
4241
  * - **checkbox** - The checkbox element
4234
4242
  * - **icon** - The icon element
4243
+ * - **create-option** - The menu item element for creating new options
4235
4244
  */
4236
4245
  "nve-combobox": DefineComponent<ComboboxProps>;
4237
4246
 
@@ -4670,6 +4679,28 @@ export type CustomElements = {
4670
4679
  */
4671
4680
  "nve-file": DefineComponent<FileProps>;
4672
4681
 
4682
+ /**
4683
+ * Formats a date/time value as localized text using the Intl.DateTimeFormat API. Renders inside a semantic time element.
4684
+ * Granular options (weekday, year, month, day, hour, minute, second) mirror the Intl.DateTimeFormat API. 'numeric' omits zero-padding, '2-digit' zero-pads.
4685
+ * ---
4686
+ *
4687
+ *
4688
+ * ### **Slots:**
4689
+ * - _default_ - Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.
4690
+ */
4691
+ "nve-format-datetime": DefineComponent<FormatDatetimeProps>;
4692
+
4693
+ /**
4694
+ * Formats a date/time value as localized relative text using the Intl.RelativeTimeFormat API. Renders inside a semantic time element.
4695
+ * Options mirror the Intl.RelativeTimeFormat API. When unit is 'auto', the component selects the best unit based on the time difference.
4696
+ * ---
4697
+ *
4698
+ *
4699
+ * ### **Slots:**
4700
+ * - _default_ - Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.
4701
+ */
4702
+ "nve-format-relative-time": DefineComponent<FormatRelativeTimeProps>;
4703
+
4673
4704
  /**
4674
4705
  * Groups many related form controls under a shared label and validation context for semantically linked inputs.
4675
4706
  * ---
@@ -5889,6 +5920,23 @@ export type CustomElements = {
5889
5920
  */
5890
5921
  "nve-switch": DefineComponent<SwitchProps>;
5891
5922
 
5923
+ /**
5924
+ * Coordinates tabs with matching panel content using Invoker Commands and slot-matched panels.
5925
+ * ---
5926
+ *
5927
+ *
5928
+ * ### **Events:**
5929
+ * - **select** - Dispatched when the selected tab value changes after an invoker `--toggle` updates selection
5930
+ *
5931
+ * ### **Slots:**
5932
+ * - _default_ - Default slot for a single nve-tabs element. Do not use behavior-select on nve-tabs when using this group.
5933
+ * - **value** - Named panel content where the slot name matches a nve-tabs-item value.
5934
+ *
5935
+ * ### **CSS Properties:**
5936
+ * - **--padding** - undefined _(default: undefined)_
5937
+ */
5938
+ "nve-tabs-group": DefineComponent<TabsGroupProps>;
5939
+
5892
5940
  /**
5893
5941
  * Represents an individual tab within a tablist, providing a selectable button for switching between content views.
5894
5942
  * ---
@@ -6203,7 +6251,7 @@ export type CustomElements = {
6203
6251
  *
6204
6252
  * ### **Slots:**
6205
6253
  * - _default_ - Use default slot for basic text content or nested <nve-tree-node> elements.
6206
- * - **content** - Use for extended long form content containing interactive elements or form inputs.
6254
+ * - **content** - Use only for extended long form content containing interactive elements or form inputs.
6207
6255
  *
6208
6256
  * ### **CSS Properties:**
6209
6257
  * - **--color** - undefined _(default: undefined)_