@nvidia-elements/core 0.0.3 → 0.0.4

package/dist/custom-elements-vue.d.ts

@@ -637,6 +637,8 @@ type ComboboxProps = {
   container?: "flat";
   /** Disable rendering of inline tags for many-item select */
   notags?: boolean;
+  /** Enable creation of new options when the input value doesn't match any existing option. Dispatches a `create` event with `{ value }` detail. */
+  "behavior-create"?: boolean;
   /** @deprecated - not supported on custom element tags */
   "nve-layout"?: string;
   /** @deprecated - not supported on custom element tags */
@@ -665,6 +667,8 @@ type ComboboxProps = {
 - `muted` Reduces visual weight for supporting content that should remain subtle and unobtrusive. */
   prominence?: "muted";
 
+  /** Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`. */
+  oncreate?: (e: CustomEvent<CustomEvent>) => void;
   /** Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`. */
   onscroll?: (e: CustomEvent<never>) => void;
   /**  */
@@ -1181,6 +1185,64 @@ type FileProps = {
   onreset?: (e: CustomEvent<CustomEvent>) => void;
 };
 
+type FormatDatetimeProps = {
+  /** 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. */
+  date?: string | "default";
+  /** Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. */
+  locale?: string | "default";
+  /** Weekday representation: 'long' | 'short' | 'narrow'. */
+  weekday?: "long" | "short" | "narrow" | "default";
+  /** Year representation: 'numeric' | '2-digit'. */
+  year?: "numeric" | "2-digit" | "default";
+  /** Month representation: 'numeric' | '2-digit' | 'long' | 'short' | 'narrow'. */
+  month?: "numeric" | "2-digit" | "long" | "short" | "narrow" | "default";
+  /** Day representation: 'numeric' | '2-digit'. */
+  day?: "numeric" | "2-digit" | "default";
+  /** Hour representation: 'numeric' | '2-digit'. */
+  hour?: "numeric" | "2-digit" | "default";
+  /** Minute representation: 'numeric' | '2-digit'. */
+  minute?: "numeric" | "2-digit" | "default";
+  /** Second representation: 'numeric' | '2-digit'. */
+  second?: "numeric" | "2-digit" | "default";
+  /** Preset date formatting style: 'full' | 'long' | 'medium' | 'short'.
+Preset styles take precedence over granular date and time part options. */
+  "date-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. */
+  "time-style"?: "full" | "long" | "medium" | "short" | "default";
+  /** Time zone name display: 'long' | 'short'. Use it with granular options only; preset styles ignore it. */
+  "time-zone-name"?: "long" | "short" | "default";
+  /** IANA time zone identifier (such as 'America/New_York', 'UTC'). */
+  "time-zone"?: string | "default";
+  /** @deprecated - not supported on custom element tags */
+  "nve-layout"?: string;
+  /** @deprecated - not supported on custom element tags */
+  "nve-text"?: string;
+};
+
+type FormatRelativeTimeProps = {
+  /** 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. */
+  date?: string | "default";
+  /** Language tag (such as en-US, de-DE). Defaults to document.documentElement.lang or browser default. */
+  locale?: string | "default";
+  /** Numeric formatting: 'always' | 'auto'. When 'auto', enables natural language forms such as 'yesterday' instead of '1 day ago'. */
+  numeric?: "always" | "auto";
+  /** Formatting length: 'long' | 'short' | 'narrow'. Controls verbosity (such as '3 days ago' vs '3d ago'). Maps to Intl.RelativeTimeFormat style option. */
+  "format-style"?: "long" | "short" | "narrow";
+  /** 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. */
+  unit?: "second" | "minute" | "hour" | "day" | "week" | "month" | "year" | "auto";
+  /** When present, auto-updates the displayed relative time at appropriate intervals. */
+  sync?: boolean;
+  /** @deprecated - not supported on custom element tags */
+  "nve-layout"?: string;
+  /** @deprecated - not supported on custom element tags */
+  "nve-text"?: string;
+};
+
 type ControlGroupProps = {
   /** Controls the directional arrangement and spacing behavior of the element's content.
 - `vertical` Arranges content in a vertical stack with block-level spacing.
@@ -3187,6 +3249,18 @@ type SwitchProps = {
   onreset?: (e: CustomEvent<CustomEvent>) => void;
 };
 
+type TabsGroupProps = {
+  /** Determines the alignment of the popover relative to the provided anchor element. */
+  alignment?: "top" | "start" | "end";
+  /** @deprecated - not supported on custom element tags */
+  "nve-layout"?: string;
+  /** @deprecated - not supported on custom element tags */
+  "nve-text"?: string;
+
+  /** Dispatched when the selected tab value changes after an invoker `--toggle` updates selection */
+  onselect?: (e: CustomEvent<CustomEvent>) => void;
+};
+
 type TabsItemProps = {
   /** 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)
 - `true` The element holds selection and represents the user's current choice within the group.
@@ -4189,7 +4263,8 @@ export type CustomElements = {
    *
    *
    * ### **Events:**
-   *  - **scroll** - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
+   *  - **create** - Fires when the user confirms a value that doesn't match any existing option and the `behavior-create` attribute exists. `detail: { value }`.
+   * - **scroll** - Fires when the user scrolls the dropdown option list. Throttled to one dispatch per animation frame. `detail: { scrollTop, scrollHeight, clientHeight }`.
    * - **reset**
    *
    * ### **Methods:**
@@ -4232,6 +4307,7 @@ export type CustomElements = {
    * - **menu-item** - The menu item elements
    * - **checkbox** - The checkbox element
    * - **icon** - The icon element
+   * - **create-option** - The menu item element for creating new options
    */
   "nve-combobox": DefineComponent<ComboboxProps>;
 
@@ -4670,6 +4746,28 @@ export type CustomElements = {
    */
   "nve-file": DefineComponent<FileProps>;
 
+  /**
+   * Formats a date/time value as localized text using the Intl.DateTimeFormat API. Renders inside a semantic time element.
+   * Granular options (weekday, year, month, day, hour, minute, second) mirror the Intl.DateTimeFormat API. 'numeric' omits zero-padding, '2-digit' zero-pads.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.
+   */
+  "nve-format-datetime": DefineComponent<FormatDatetimeProps>;
+
+  /**
+   * Formats a date/time value as localized relative text using the Intl.RelativeTimeFormat API. Renders inside a semantic time element.
+   * Options mirror the Intl.RelativeTimeFormat API. When unit is 'auto', the component selects the best unit based on the time difference.
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - Date string to format (such as 2023-07-28T04:20:17.434Z). Serves as fallback before hydration.
+   */
+  "nve-format-relative-time": DefineComponent<FormatRelativeTimeProps>;
+
   /**
    * Groups many related form controls under a shared label and validation context for semantically linked inputs.
    * ---
@@ -5889,6 +5987,23 @@ export type CustomElements = {
    */
   "nve-switch": DefineComponent<SwitchProps>;
 
+  /**
+   * Coordinates tabs with matching panel content using Invoker Commands and slot-matched panels.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **select** - Dispatched when the selected tab value changes after an invoker `--toggle` updates selection
+   *
+   * ### **Slots:**
+   *  - _default_ - Default slot for a single nve-tabs element. Do not use behavior-select on nve-tabs when using this group.
+   * - **value** - Named panel content where the slot name matches a nve-tabs-item value.
+   *
+   * ### **CSS Properties:**
+   *  - **--padding** - undefined _(default: undefined)_
+   */
+  "nve-tabs-group": DefineComponent<TabsGroupProps>;
+
   /**
    * Represents an individual tab within a tablist, providing a selectable button for switching between content views.
    * ---
@@ -6203,7 +6318,7 @@ export type CustomElements = {
    *
    * ### **Slots:**
    *  - _default_ - Use default slot for basic text content or nested <nve-tree-node> elements.
-   * - **content** - Use for extended long form content containing interactive elements or form inputs.
+   * - **content** - Use only for extended long form content containing interactive elements or form inputs.
    *
    * ### **CSS Properties:**
    *  - **--color** - undefined _(default: undefined)_