@nova-design-system/nova-webcomponents 3.1.0 → 3.2.0

package/dist/types/components.d.ts

@@ -372,30 +372,12 @@ export namespace Components {
           * @default []
          */
         "columns": Column[];
-        /**
-          * The columns to display in the data grid. It can be passed directly as an array of objects or as a JSON string. If both `columns` and `columnsJson` are provided, `columns` takes precedence.
-          * @example `[{"header":"Name","accessor":"name"},{"header":"Age","accessor":"age"},{"header":"Email","accessor":"email"}]`
-         */
-        "columnsJson"?: string;
-        /**
-         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
-         */
-        "columns-json"?: string;
         /**
           * The data to display in the data grid.
           * @example [{ "name": "Alice", "age": 25 }, { "name": "Bob", "age": 30 }]
           * @default []
          */
         "data": any[];
-        /**
-          * The data to display in the data grid. It can be passed directly as an array of objects or as a JSON string. If both `data` and `dataJson` are provided, `data` takes precedence.
-          * @example `[{ "name": "Alice", "age": 25 }, { "name": "Bob", "age": 30 }]`
-         */
-        "dataJson"?: string;
-        /**
-         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
-         */
-        "data-json"?: string;
         /**
           * Whether to enable global filtering for the data grid. This allows users to search across all columns for a specific value. The search is case-insensitive and supports partial matches. It use string.includes() to match the search term.
           * @default false
@@ -486,6 +468,10 @@ export namespace Components {
           * Defines the accessor of the column.
          */
         "accessor": string;
+        /**
+          * Defines the group header of the column.
+         */
+        "group"?: string;
         /**
           * Defines the header of the column.
          */
@@ -1027,6 +1013,15 @@ export namespace Components {
           * Applies focus to the input field as soon as the component is mounted. This is equivalent to setting the native autofocus attribute on an <input> element.
          */
         "autofocus": boolean;
+        /**
+          * Delay in milliseconds before the search is triggered when typing in the filter input.
+          * @default 300
+         */
+        "debounceDelay": number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "debounce-delay"?: number;
         /**
           * Add helpful hints or extra information under the text input field. This is where you can clarify what users should enter or provide additional instructions, making the form easier to fill out correctly.
          */
@@ -1082,6 +1077,14 @@ export namespace Components {
           * Lets you define the text that explains what users should enter in the text input field. It's a crucial element for making forms clear and user-friendly.
          */
         "label": string;
+        /**
+          * Defines the maximum height of the multiselect list when open.
+         */
+        "maxHeight": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "max-height"?: string;
         /**
           * Defines the name attribute of the input field, which is crucial for form submission. This value is used as the key in the key-value pair sent to the server, representing the input's data in form submissions. It should be unique within the form to avoid conflicts.
          */
@@ -1167,7 +1170,7 @@ export namespace Components {
     }
     interface NvFieldmultiselect {
         /**
-          * The autocomplete prop for faster input filling.
+          * The autocomplete prop helps users fill out the input field faster by suggesting entries they've used before, like their email or address. You can turn it on to make forms more convenient or off to ensure users always type in fresh data.
          */
         "autocomplete": `${TextInputAutocomplete}`;
         /**
@@ -1665,6 +1668,159 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvFieldslider {
+        /**
+          * Add helpful hints or extra information under the slider. This is where you can clarify what users should enter or provide additional instructions, making the form easier to fill out correctly.
+         */
+        "description": string;
+        /**
+          * Disables user interaction with the slider and its associated input fields.
+         */
+        "disabled": boolean;
+        /**
+          * Sets the ID for the end input element and the for attribute of the associated label. If no ID is provided, a random one will be automatically generated.
+         */
+        "endInputId": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "end-input-id"?: string;
+        /**
+          * Name attribute for the end value input when using range mode. If not provided, the name attribute will be used with '-end' appended.
+         */
+        "endName": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "end-name"?: string;
+        /**
+          * Alters the slider's appearance to indicate an error, helping users identify fields that need correction.
+          * @validator error
+         */
+        "error": boolean;
+        /**
+          * A description that appears when there is an error related to the slider.
+          * @validator message
+         */
+        "errorDescription": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "error-description"?: string;
+        /**
+          * Allows the field to stretch and fill the entire width of its container.
+         */
+        "fluid": boolean;
+        /**
+          * Enables an optional numeric input field alongside the slider, allowing users to type a value directly instead of—or in addition to—using the slider handle.
+         */
+        "hasField": boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "has-field"?: boolean;
+        /**
+          * Keeps the interface clean by removing visible labels, but still announces the label to screen readers so users relying on assistive tech aren't left guessing.
+         */
+        "hideLabel": boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "hide-label"?: boolean;
+        /**
+          * Provides a textual description of the slider's function, helping users understand what the control adjusts. It also supports accessibility by serving as the accessible name for the component.
+         */
+        "label": string;
+        /**
+          * Use this to automatically show a label, like “$” or “kg,” after the value on the slider’s tooltip or input, helping users better understand the number.
+         */
+        "labelAfterValue": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "label-after-value"?: string;
+        /**
+          * Use this to automatically show a label, like “~” for approximate values, before the slider’s value in the tooltip or input, giving users quick context about the number.
+         */
+        "labelBeforeValue": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "label-before-value"?: string;
+        /**
+          * Defines the maximum allowed value for the slider. The thumb cannot move above this value, and manual input is also constrained accordingly.
+         */
+        "max": number;
+        /**
+          * Defines the minimum allowed value for the slider. The thumb cannot move below this value, and manual input is also constrained accordingly.
+         */
+        "min": number;
+        /**
+          * Name attribute for the form input element. Required for form submission. For range sliders, this will be used for the start value input and add -end to the end input name.
+         */
+        "name": string;
+        /**
+          * Allows the slider to display two thumbs, enabling users to select a continuous range between a minimum and maximum value. Ideal for use cases like filtering by price or time.
+         */
+        "range": boolean;
+        /**
+          * Makes the slider and input non-editable while keeping them focusable and included in form submissions.
+         */
+        "readonly": boolean;
+        /**
+          * Controls the visibility of tick marks on the slider. When enabled, all visual ticks that indicate step points along the track are shown. If custom ticks are provided, they are always shown regardless of this setting.
+         */
+        "showTicks": boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "show-ticks"?: boolean;
+        /**
+          * Controls whether the slider handle should visually snap to step values during dragging. When false, the handle can be positioned at any point along the track while dragging, but the actual value will still snap to the nearest step value. When true, the handle will visually snap to the nearest step value during dragging.
+         */
+        "snap": boolean;
+        /**
+          * When true and custom ticks are provided, the slider will snap to the nearest tick value during dragging, instead of using the step value. This is useful when you have custom ticks at specific values that don't align with regular step intervals.
+         */
+        "snapTicks": boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "snap-ticks"?: boolean;
+        /**
+          * Sets the ID for the start input element and the for attribute of the associated label. If no ID is provided, a random one will be automatically generated.
+         */
+        "startInputId": string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "start-input-id"?: string;
+        /**
+          * Defines the interval between selectable values on the slider. Controls how much the value increases or decreases with each keyboard interaction, drag movement, or direct input.
+         */
+        "step": number;
+        /**
+          * Changes the slider's appearance to indicate successful input or validation.
+         */
+        "success": boolean;
+        /**
+          * Allows you to specify custom tick marks at specific values along the slider. Each tick can optionally display a label to provide additional context or guidance for users.
+         */
+        "ticks": {
+    /** The numeric value of the tick */
+    value: number;
+    /** The label of the tick */
+    label?: string;
+  }[];
+        /**
+          * Numeric value of the slider as a string, if range mode is on, the values will be a comma-separated string.
+         */
+        "value": string;
+    }
     interface NvFieldtext {
         /**
           * The autocomplete prop helps users fill out the input field faster by suggesting entries they’ve used before, like their email or address. You can turn it on to make forms more convenient or off to ensure users always type in fresh data.
@@ -2449,6 +2605,10 @@ export interface NvFieldselectCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLNvFieldselectElement;
 }
+export interface NvFieldsliderCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLNvFieldsliderElement;
+}
 export interface NvFieldtextCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLNvFieldtextElement;
@@ -2858,6 +3018,27 @@ declare global {
         prototype: HTMLNvFieldselectElement;
         new (): HTMLNvFieldselectElement;
     };
+    interface HTMLNvFieldsliderElementEventMap {
+        "valueChanged": string;
+    }
+    /**
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface HTMLNvFieldsliderElement extends Components.NvFieldslider, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLNvFieldsliderElementEventMap>(type: K, listener: (this: HTMLNvFieldsliderElement, ev: NvFieldsliderCustomEvent<HTMLNvFieldsliderElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLNvFieldsliderElementEventMap>(type: K, listener: (this: HTMLNvFieldsliderElement, ev: NvFieldsliderCustomEvent<HTMLNvFieldsliderElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    }
+    var HTMLNvFieldsliderElement: {
+        prototype: HTMLNvFieldsliderElement;
+        new (): HTMLNvFieldsliderElement;
+    };
     interface HTMLNvFieldtextElementEventMap {
         "valueChanged": string;
     }
@@ -3091,6 +3272,7 @@ declare global {
         "nv-fieldpassword": HTMLNvFieldpasswordElement;
         "nv-fieldradio": HTMLNvFieldradioElement;
         "nv-fieldselect": HTMLNvFieldselectElement;
+        "nv-fieldslider": HTMLNvFieldsliderElement;
         "nv-fieldtext": HTMLNvFieldtextElement;
         "nv-fieldtextarea": HTMLNvFieldtextareaElement;
         "nv-fieldtime": HTMLNvFieldtimeElement;
@@ -3496,30 +3678,12 @@ declare namespace LocalJSX {
           * @default []
          */
         "columns"?: Column[];
-        /**
-          * The columns to display in the data grid. It can be passed directly as an array of objects or as a JSON string. If both `columns` and `columnsJson` are provided, `columns` takes precedence.
-          * @example `[{"header":"Name","accessor":"name"},{"header":"Age","accessor":"age"},{"header":"Email","accessor":"email"}]`
-         */
-        "columnsJson"?: string;
-        /**
-         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
-         */
-        "columns-json"?: string;
         /**
           * The data to display in the data grid.
           * @example [{ "name": "Alice", "age": 25 }, { "name": "Bob", "age": 30 }]
           * @default []
          */
         "data"?: any[];
-        /**
-          * The data to display in the data grid. It can be passed directly as an array of objects or as a JSON string. If both `data` and `dataJson` are provided, `data` takes precedence.
-          * @example `[{ "name": "Alice", "age": 25 }, { "name": "Bob", "age": 30 }]`
-         */
-        "dataJson"?: string;
-        /**
-         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
-         */
-        "data-json"?: string;
         /**
           * Whether to enable global filtering for the data grid. This allows users to search across all columns for a specific value. The search is case-insensitive and supports partial matches. It use string.includes() to match the search term.
           * @default false
@@ -3628,6 +3792,10 @@ declare namespace LocalJSX {
           * Defines the accessor of the column.
          */
         "accessor": string;
+        /**
+          * Defines the group header of the column.
+         */
+        "group"?: string;
         /**
           * Defines the header of the column.
          */
@@ -4189,6 +4357,15 @@ declare namespace LocalJSX {
           * Applies focus to the input field as soon as the component is mounted. This is equivalent to setting the native autofocus attribute on an <input> element.
          */
         "autofocus"?: boolean;
+        /**
+          * Delay in milliseconds before the search is triggered when typing in the filter input.
+          * @default 300
+         */
+        "debounceDelay"?: number;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "debounce-delay"?: number;
         /**
           * Add helpful hints or extra information under the text input field. This is where you can clarify what users should enter or provide additional instructions, making the form easier to fill out correctly.
          */
@@ -4239,6 +4416,14 @@ declare namespace LocalJSX {
           * Lets you define the text that explains what users should enter in the text input field. It's a crucial element for making forms clear and user-friendly.
          */
         "label"?: string;
+        /**
+          * Defines the maximum height of the multiselect list when open.
+         */
+        "maxHeight"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "max-height"?: string;
         /**
           * Defines the name attribute of the input field, which is crucial for form submission. This value is used as the key in the key-value pair sent to the server, representing the input's data in form submissions. It should be unique within the form to avoid conflicts.
          */
@@ -4359,7 +4544,7 @@ declare namespace LocalJSX {
     }
     interface NvFieldmultiselect {
         /**
-          * The autocomplete prop for faster input filling.
+          * The autocomplete prop helps users fill out the input field faster by suggesting entries they've used before, like their email or address. You can turn it on to make forms more convenient or off to ensure users always type in fresh data.
          */
         "autocomplete"?: `${TextInputAutocomplete}`;
         /**
@@ -4872,6 +5057,164 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * @deprecated [EXPERIMENTAL]
+     * @experimental This component is still in development and subject to change in future releases.
+     */
+    interface NvFieldslider {
+        /**
+          * Add helpful hints or extra information under the slider. This is where you can clarify what users should enter or provide additional instructions, making the form easier to fill out correctly.
+         */
+        "description"?: string;
+        /**
+          * Disables user interaction with the slider and its associated input fields.
+         */
+        "disabled"?: boolean;
+        /**
+          * Sets the ID for the end input element and the for attribute of the associated label. If no ID is provided, a random one will be automatically generated.
+         */
+        "endInputId"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "end-input-id"?: string;
+        /**
+          * Name attribute for the end value input when using range mode. If not provided, the name attribute will be used with '-end' appended.
+         */
+        "endName"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "end-name"?: string;
+        /**
+          * Alters the slider's appearance to indicate an error, helping users identify fields that need correction.
+          * @validator error
+         */
+        "error"?: boolean;
+        /**
+          * A description that appears when there is an error related to the slider.
+          * @validator message
+         */
+        "errorDescription"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "error-description"?: string;
+        /**
+          * Allows the field to stretch and fill the entire width of its container.
+         */
+        "fluid"?: boolean;
+        /**
+          * Enables an optional numeric input field alongside the slider, allowing users to type a value directly instead of—or in addition to—using the slider handle.
+         */
+        "hasField"?: boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "has-field"?: boolean;
+        /**
+          * Keeps the interface clean by removing visible labels, but still announces the label to screen readers so users relying on assistive tech aren't left guessing.
+         */
+        "hideLabel"?: boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "hide-label"?: boolean;
+        /**
+          * Provides a textual description of the slider's function, helping users understand what the control adjusts. It also supports accessibility by serving as the accessible name for the component.
+         */
+        "label"?: string;
+        /**
+          * Use this to automatically show a label, like “$” or “kg,” after the value on the slider’s tooltip or input, helping users better understand the number.
+         */
+        "labelAfterValue"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "label-after-value"?: string;
+        /**
+          * Use this to automatically show a label, like “~” for approximate values, before the slider’s value in the tooltip or input, giving users quick context about the number.
+         */
+        "labelBeforeValue"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "label-before-value"?: string;
+        /**
+          * Defines the maximum allowed value for the slider. The thumb cannot move above this value, and manual input is also constrained accordingly.
+         */
+        "max"?: number;
+        /**
+          * Defines the minimum allowed value for the slider. The thumb cannot move below this value, and manual input is also constrained accordingly.
+         */
+        "min"?: number;
+        /**
+          * Name attribute for the form input element. Required for form submission. For range sliders, this will be used for the start value input and add -end to the end input name.
+         */
+        "name"?: string;
+        /**
+          * Emitted when the slider values change.
+          * @bind value
+         */
+        "onValueChanged"?: (event: NvFieldsliderCustomEvent<string>) => void;
+        /**
+          * Allows the slider to display two thumbs, enabling users to select a continuous range between a minimum and maximum value. Ideal for use cases like filtering by price or time.
+         */
+        "range"?: boolean;
+        /**
+          * Makes the slider and input non-editable while keeping them focusable and included in form submissions.
+         */
+        "readonly"?: boolean;
+        /**
+          * Controls the visibility of tick marks on the slider. When enabled, all visual ticks that indicate step points along the track are shown. If custom ticks are provided, they are always shown regardless of this setting.
+         */
+        "showTicks"?: boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "show-ticks"?: boolean;
+        /**
+          * Controls whether the slider handle should visually snap to step values during dragging. When false, the handle can be positioned at any point along the track while dragging, but the actual value will still snap to the nearest step value. When true, the handle will visually snap to the nearest step value during dragging.
+         */
+        "snap"?: boolean;
+        /**
+          * When true and custom ticks are provided, the slider will snap to the nearest tick value during dragging, instead of using the step value. This is useful when you have custom ticks at specific values that don't align with regular step intervals.
+         */
+        "snapTicks"?: boolean;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "snap-ticks"?: boolean;
+        /**
+          * Sets the ID for the start input element and the for attribute of the associated label. If no ID is provided, a random one will be automatically generated.
+         */
+        "startInputId"?: string;
+        /**
+         * @deprecated use camelCase instead. Support for dash-casing will be removed in Stencil v5.
+         */
+        "start-input-id"?: string;
+        /**
+          * Defines the interval between selectable values on the slider. Controls how much the value increases or decreases with each keyboard interaction, drag movement, or direct input.
+         */
+        "step"?: number;
+        /**
+          * Changes the slider's appearance to indicate successful input or validation.
+         */
+        "success"?: boolean;
+        /**
+          * Allows you to specify custom tick marks at specific values along the slider. Each tick can optionally display a label to provide additional context or guidance for users.
+         */
+        "ticks"?: {
+    /** The numeric value of the tick */
+    value: number;
+    /** The label of the tick */
+    label?: string;
+  }[];
+        /**
+          * Numeric value of the slider as a string, if range mode is on, the values will be a comma-separated string.
+         */
+        "value"?: string;
+    }
     interface NvFieldtext {
         /**
           * The autocomplete prop helps users fill out the input field faster by suggesting entries they’ve used before, like their email or address. You can turn it on to make forms more convenient or off to ensure users always type in fresh data.
@@ -5649,6 +5992,7 @@ declare namespace LocalJSX {
         "nv-fieldpassword": NvFieldpassword;
         "nv-fieldradio": NvFieldradio;
         "nv-fieldselect": NvFieldselect;
+        "nv-fieldslider": NvFieldslider;
         "nv-fieldtext": NvFieldtext;
         "nv-fieldtextarea": NvFieldtextarea;
         "nv-fieldtime": NvFieldtime;
@@ -5697,6 +6041,11 @@ declare module "@stencil/core" {
             "nv-fieldpassword": LocalJSX.NvFieldpassword & JSXBase.HTMLAttributes<HTMLNvFieldpasswordElement>;
             "nv-fieldradio": LocalJSX.NvFieldradio & JSXBase.HTMLAttributes<HTMLNvFieldradioElement>;
             "nv-fieldselect": LocalJSX.NvFieldselect & JSXBase.HTMLAttributes<HTMLNvFieldselectElement>;
+            /**
+             * @deprecated [EXPERIMENTAL]
+             * @experimental This component is still in development and subject to change in future releases.
+             */
+            "nv-fieldslider": LocalJSX.NvFieldslider & JSXBase.HTMLAttributes<HTMLNvFieldsliderElement>;
             "nv-fieldtext": LocalJSX.NvFieldtext & JSXBase.HTMLAttributes<HTMLNvFieldtextElement>;
             "nv-fieldtextarea": LocalJSX.NvFieldtextarea & JSXBase.HTMLAttributes<HTMLNvFieldtextareaElement>;
             "nv-fieldtime": LocalJSX.NvFieldtime & JSXBase.HTMLAttributes<HTMLNvFieldtimeElement>;

package/dist/types/interfaces/Column.d.ts

@@ -5,9 +5,13 @@ export interface Column {
     /**
      * Display name of the column
      */
-    header: string;
+    header?: string;
     /**
      * Data accessor for the column
      */
     accessor: string;
+    /**
+     * Group name for the column
+     */
+    group?: string;
 }