@nova-design-system/nova-webcomponents 3.0.0-beta.38 → 3.0.0-beta.39

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

@@ -0,0 +1,9 @@
+/**
+ * Interface for week abbreviations by locale
+ */
+export interface WeekAbbreviations {
+    /**
+     * Abbreviation for "week" in a specific locale
+     */
+    [key: string]: string;
+}

package/dist/types/utils/constants.d.ts

@@ -1,3 +1,4 @@
+import { WeekAbbreviations } from '../interfaces/localization';
 export declare enum FeedbackColors {
     Information = "information",
     Warning = "warning",
@@ -119,3 +120,4 @@ export declare enum TimeType {
     Minutes = "minutes",
     Seconds = "seconds"
 }
+export declare const WEEK_ABBREVIATIONS: WeekAbbreviations;

package/dist/types/utils/uri.utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a Data URI to a string.
+ * @param {string} dataURI - The data URI (base64-encoded string) representing data.
+ * @returns {string} - The original string representation of the data.
+ */
+export declare function dataURIToString(dataURI: string): string;

package/dist/vscode-data.json

@@ -328,6 +328,90 @@
         }
       ]
     },
+    {
+      "name": "nv-calendar",
+      "description": {
+        "kind": "markdown",
+        "value": "The `<nv-calendar>` component supports a wide range of date formats to accommodate various use cases, including international standards, regional conventions, and platform-specific formats."
+      },
+      "attributes": [
+        {
+          "name": "date-format",
+          "description": "Date format (ex: 'YYYY-MM-DD', 'DD-MM-YYYY', etc.)"
+        },
+        {
+          "name": "disabled-dates",
+          "description": "Disabled dates (ISO string array)"
+        },
+        {
+          "name": "first-day-of-week",
+          "description": "First day of the week (0 = Sunday, 1 = Monday, etc.)"
+        },
+        {
+          "name": "locale",
+          "description": "Locale for date formatting"
+        },
+        {
+          "name": "max",
+          "description": "Maximum date for selection (ISO string format, ex: \"2025-12-31\")"
+        },
+        {
+          "name": "min",
+          "description": "Minimum date for selection (ISO string format, ex: \"2025-01-01\")"
+        },
+        {
+          "name": "number-of-calendars",
+          "description": "Number of calendars to display"
+        },
+        {
+          "name": "range-value",
+          "description": "Selected date range\nformat: { start: ISO string, end: ISO string }\nex: { start: \"2025-03-15\", end: \"2025-03-20\" }"
+        },
+        {
+          "name": "selection-type",
+          "description": "Selection type (single date or date range)",
+          "values": [
+            {
+              "name": "range"
+            },
+            {
+              "name": "single"
+            }
+          ]
+        },
+        {
+          "name": "shortcuts",
+          "description": "Custom actions to display in the footer\nJSON array of objects with the following properties:\n- label: string\n- onClick: function"
+        },
+        {
+          "name": "shortcuts-placement",
+          "description": "Footer placement",
+          "values": [
+            {
+              "name": "bottom"
+            },
+            {
+              "name": "left"
+            },
+            {
+              "name": "right"
+            }
+          ]
+        },
+        {
+          "name": "show-actions",
+          "description": "Show action buttons"
+        },
+        {
+          "name": "show-week-numbers",
+          "description": "Show week numbers"
+        },
+        {
+          "name": "single-value",
+          "description": "Selected date (ISO string format)\nex: \"2025-03-15\""
+        }
+      ]
+    },
     {
       "name": "nv-col",
       "description": {
@@ -514,6 +598,10 @@
         "value": "The checkbox component is a simple and essential element of user interfaces. It allows users to select one or more options from a list. Each checkbox can be activated or deactivated with a single click, changing its appearance from empty to checked, and vice versa. This clear visual system helps users easily understand which options are selected. Checkboxes are often used in forms to enable users to personalize their choices in an intuitive and flexible way."
       },
       "attributes": [
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "checked",
           "description": "Indicates whether the checkbox is checked or not."
@@ -609,9 +697,6 @@
             {
               "name": "off"
             },
-            {
-              "name": "home"
-            },
             {
               "name": "section-*"
             },
@@ -621,6 +706,9 @@
             {
               "name": "billing"
             },
+            {
+              "name": "home"
+            },
             {
               "name": "work"
             },
@@ -797,6 +885,10 @@
             }
           ]
         },
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "description",
           "description": "Add helpful hints or extra information under the text input field. This is\nwhere you can clarify what users should enter or provide additional\ninstructions, making the form easier to fill out correctly."
@@ -806,7 +898,7 @@
           "description": "The disabled prop lets you turn off the input field so that users can't\ntype in it. When disabled, the field is grayed out and won't respond to\nclicks or touches."
         },
         {
-          "name": "emptyresult",
+          "name": "empty-result",
           "description": "The text to display when no items match the filter."
         },
         {
@@ -839,7 +931,7 @@
         },
         {
           "name": "options",
-          "description": "List of options available in the dropdown."
+          "description": "List of options available in the dropdown. The options are passed as a JSON\nstring."
         },
         {
           "name": "placeholder",
@@ -872,7 +964,7 @@
         },
         {
           "name": "label",
-          "description": "Label used as the value for the default layout."
+          "description": "Specifies the text label for the dropdown item.\n\nWhen no default slot is provided, this label is rendered as the item's\nvisible text. If the default slot is supplied, the label isn’t directly\ndisplayed but is used as the selected text (on the dropdown trigger). If\nno label is explicitly set, the component will automatically derive the\nlabel from the text content of the default slot."
         },
         {
           "name": "selected",
@@ -880,7 +972,7 @@
         },
         {
           "name": "value",
-          "description": "Value associated with the item."
+          "description": "Value associated with the item. This is recommended and required for proper\nform management."
         }
       ]
     },
@@ -934,9 +1026,6 @@
             {
               "name": "off"
             },
-            {
-              "name": "home"
-            },
             {
               "name": "section-*"
             },
@@ -946,6 +1035,9 @@
             {
               "name": "billing"
             },
+            {
+              "name": "home"
+            },
             {
               "name": "work"
             },
@@ -1122,6 +1214,10 @@
             }
           ]
         },
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "badge-label",
           "description": "Text for the badge showing the number of selected items."
@@ -1139,7 +1235,7 @@
           "description": "Disables the input field."
         },
         {
-          "name": "emptyresult",
+          "name": "empty-result",
           "description": "The text to display when no items match the filter."
         },
         {
@@ -1215,6 +1311,10 @@
         "value": "NvFieldnumber is a custom web component that provides a styled number input field with various properties and methods to enhance its functionality. It includes features such as labels, descriptions, placeholders, validation messages, and stepper buttons for incrementing and decrementing the value."
       },
       "attributes": [
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "description",
           "description": "Add helpful hints or extra information under the text input field. This is\nwhere you can clarify what users should enter or provide additional\ninstructions, making the form easier to fill out correctly."
@@ -1302,9 +1402,6 @@
             {
               "name": "off"
             },
-            {
-              "name": "home"
-            },
             {
               "name": "section-*"
             },
@@ -1314,6 +1411,9 @@
             {
               "name": "billing"
             },
+            {
+              "name": "home"
+            },
             {
               "name": "work"
             },
@@ -1490,6 +1590,10 @@
             }
           ]
         },
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "description",
           "description": "Add helpful hints or extra information under the text input field. This is\nwhere you can clarify what users should enter or provide additional\ninstructions, making the form easier to fill out correctly."
@@ -1579,6 +1683,10 @@
         "value": "Use radio buttons when you have a group of mutually exclusive choices and only one selection from the group is allowed."
       },
       "attributes": [
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "checked",
           "description": "Controls whether the radio button is selected."
@@ -1644,6 +1752,10 @@
         "value": "A custom field select component that renders a dropdown (select) element with various slots for customization."
       },
       "attributes": [
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on a <select>\nelement."
+        },
         {
           "name": "description",
           "description": "Add helpful hints or extra information under the select field. This is\nwhere you can clarify what users should choose or provide additional\ninstructions, making the form easier to fill out correctly."
@@ -1727,9 +1839,6 @@
             {
               "name": "off"
             },
-            {
-              "name": "home"
-            },
             {
               "name": "section-*"
             },
@@ -1739,6 +1848,9 @@
             {
               "name": "billing"
             },
+            {
+              "name": "home"
+            },
             {
               "name": "work"
             },
@@ -1915,6 +2027,10 @@
             }
           ]
         },
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "description",
           "description": "Add helpful hints or extra information under the text input field. This is\nwhere you can clarify what users should enter or provide additional\ninstructions, making the form easier to fill out correctly."
@@ -2026,6 +2142,10 @@
         "value": "The `nv-fieldtextarea` component is a text textarea field that can be used in forms. It includes a label, message, and validation state. The value of the textarea can be controlled by the parent component. It can also display an error state, a hint message, or a validation message."
       },
       "attributes": [
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on a <textarea>\nelement."
+        },
         {
           "name": "autosize",
           "description": "Enable this to make the textarea automatically resize as the user types,\nadjusting the height to fit the content. For the best experience, avoid\nvertical resizing, as it’s controlled by this feature. Horizontal resizing\ncan still be allowed if desired."
@@ -2125,6 +2245,10 @@
         "value": "A versatile and user-friendly input field designed to handle time values with precision and flexibility. The `nv-fieldtime` component allows users to input, select, and adjust time in various formats, making it suitable for a wide range of applications, from scheduling tools to time trackers. With customizable options and built-in accessibility features, it ensures a seamless and intuitive experience for all users."
       },
       "attributes": [
+        {
+          "name": "autofocus",
+          "description": "Applies focus to the input field as soon as the component is mounted. This\nis equivalent to setting the native autofocus attribute on an <input>\nelement."
+        },
         {
           "name": "description",
           "description": "Add helpful hints or extra information under the time input field. This is\nwhere you can clarify what users should enter or provide additional\ninstructions."
@@ -2503,61 +2627,34 @@
           "description": "Choose the icon you want to display. This also sets the aria-label for\nimproved accessibility, helping users who rely on screen readers.\nThe icon is not displayed when the button is loading.",
           "values": [
             {
-              "name": "link"
+              "name": "home"
             },
             {
-              "name": "map"
+              "name": "photo"
             },
             {
-              "name": "menu"
+              "name": "copy"
             },
             {
-              "name": "search"
+              "name": "cut"
             },
             {
               "name": "select"
             },
             {
-              "name": "table"
-            },
-            {
-              "name": "template"
-            },
-            {
-              "name": "video"
-            },
-            {
-              "name": "frame"
-            },
-            {
-              "name": "user"
-            },
-            {
-              "name": "chart-bubble"
-            },
-            {
-              "name": "checkbox"
-            },
-            {
-              "name": "home"
-            },
-            {
-              "name": "bulb"
-            },
-            {
-              "name": "photo"
+              "name": "message"
             },
             {
-              "name": "copy"
+              "name": "replace"
             },
             {
-              "name": "cut"
+              "name": "search"
             },
             {
-              "name": "replace"
+              "name": "repeat"
             },
             {
-              "name": "repeat"
+              "name": "link"
             },
             {
               "name": "power"
@@ -2781,6 +2878,9 @@
             {
               "name": "bulb-off"
             },
+            {
+              "name": "bulb"
+            },
             {
               "name": "cake"
             },
@@ -2838,6 +2938,9 @@
             {
               "name": "chart-bar"
             },
+            {
+              "name": "chart-bubble"
+            },
             {
               "name": "chart-circles"
             },
@@ -2859,6 +2962,9 @@
             {
               "name": "check"
             },
+            {
+              "name": "checkbox"
+            },
             {
               "name": "checklist"
             },
@@ -3222,6 +3328,9 @@
             {
               "name": "folders"
             },
+            {
+              "name": "frame"
+            },
             {
               "name": "gas-station"
             },
@@ -3379,13 +3488,16 @@
               "name": "map-pin"
             },
             {
-              "name": "message-dots"
+              "name": "map"
             },
             {
-              "name": "message-off"
+              "name": "menu"
             },
             {
-              "name": "message"
+              "name": "message-dots"
+            },
+            {
+              "name": "message-off"
             },
             {
               "name": "messages"
@@ -3747,6 +3859,9 @@
             {
               "name": "switch-vertical"
             },
+            {
+              "name": "table"
+            },
             {
               "name": "tag"
             },
@@ -3765,6 +3880,9 @@
             {
               "name": "temperature"
             },
+            {
+              "name": "template"
+            },
             {
               "name": "terminal"
             },
@@ -3837,6 +3955,9 @@
             {
               "name": "user-worker"
             },
+            {
+              "name": "user"
+            },
             {
               "name": "users"
             },
@@ -3852,6 +3973,9 @@
             {
               "name": "video-plus"
             },
+            {
+              "name": "video"
+            },
             {
               "name": "volume-2"
             },