@kdcloudjs/shoelace 1.0.29 → 1.0.30

package/dist/vscode.html-custom-data.json

@@ -2,6 +2,49 @@
   "$schema": "https://raw.githubusercontent.com/microsoft/vscode-html-languageservice/main/docs/customData.schema.json",
   "version": 1.1,
   "tags": [
+    {
+      "name": "sl-alert",
+      "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the alert opens.\n- **sl-after-show** - Emitted after the alert opens and all animations are complete.\n- **sl-hide** - Emitted when the alert closes.\n- **sl-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's main content.\n- **icon** - An icon to show in the alert. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **message** - The container that wraps the alert's main content.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.",
+      "attributes": [
+        {
+          "name": "open",
+          "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+          "values": []
+        },
+        {
+          "name": "closable",
+          "description": "Enables a close button that allows the user to dismiss the alert.",
+          "values": []
+        },
+        {
+          "name": "variant",
+          "description": "The alert's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" }
+          ]
+        },
+        {
+          "name": "duration",
+          "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
+          "values": []
+        },
+        {
+          "name": "countdown",
+          "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
+          "values": [{ "name": "rtl" }, { "name": "ltr" }]
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/alert"
+        }
+      ]
+    },
     {
       "name": "sl-animated-image",
       "description": "A component for displaying animated GIFs and WEBPs that play and pause on interaction.\n---\n\n\n### **Events:**\n - **sl-load** - Emitted when the image loads successfully.\n- **sl-error** - Emitted when the image fails to load.\n\n### **Slots:**\n - **play-icon** - Optional play icon to use instead of the default. Works best with `<sl-icon>`.\n- **pause-icon** - Optional pause icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--control-box-size** - The size of the icon box. _(default: undefined)_\n- **--icon-size** - The size of the play/pause icons. _(default: undefined)_\n\n### **CSS Parts:**\n - **control-box** - The container that surrounds the pause/play icons and provides their background.",
@@ -30,45 +73,43 @@
       ]
     },
     {
-      "name": "sl-alert",
-      "description": "Alerts are used to display important messages inline or as toast notifications.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the alert opens.\n- **sl-after-show** - Emitted after the alert opens and all animations are complete.\n- **sl-hide** - Emitted when the alert closes.\n- **sl-after-hide** - Emitted after the alert closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the alert.\n- **hide()** - Hides the alert\n- **toast()** - Displays the alert as a toast notification. This will move the alert out of its position in the DOM and, when\ndismissed, it will be removed from the DOM completely. By storing a reference to the alert, you can reuse it by\ncalling this method again. The returned promise will resolve after the alert is hidden.\n\n### **Slots:**\n - _default_ - The alert's main content.\n- **icon** - An icon to show in the alert. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the optional icon.\n- **message** - The container that wraps the alert's main content.\n- **close-button** - The close button, an `<sl-icon-button>`.\n- **close-button__base** - The close button's exported `base` part.",
+      "name": "sl-avatar",
+      "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
       "attributes": [
         {
-          "name": "open",
-          "description": "Indicates whether or not the alert is open. You can toggle this attribute to show and hide the alert, or you can\nuse the `show()` and `hide()` methods and this attribute will reflect the alert's open state.",
+          "name": "image",
+          "description": "The image source to use for the avatar.",
           "values": []
         },
         {
-          "name": "closable",
-          "description": "Enables a close button that allows the user to dismiss the alert.",
+          "name": "label",
+          "description": "A label to use to describe the avatar to assistive devices.",
           "values": []
         },
         {
-          "name": "variant",
-          "description": "The alert's theme variant.",
-          "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" }
-          ]
+          "name": "initials",
+          "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
+          "values": []
         },
         {
-          "name": "duration",
-          "description": "The length of time, in milliseconds, the alert will show before closing itself. If the user interacts with\nthe alert before it closes (e.g. moves the mouse over it), the timer will restart. Defaults to `Infinity`, meaning\nthe alert will not close on its own.",
-          "values": []
+          "name": "loading",
+          "description": "Indicates how the browser should load the image.",
+          "values": [{ "name": "eager" }, { "name": "lazy" }]
         },
         {
-          "name": "countdown",
-          "description": "Enables a countdown that indicates the remaining time the alert will be displayed.\nTypically used to indicate the remaining time before a whole app refresh.",
-          "values": [{ "name": "rtl" }, { "name": "ltr" }]
+          "name": "shape",
+          "description": "The shape of the avatar.",
+          "values": [
+            { "name": "circle" },
+            { "name": "square" },
+            { "name": "rounded" }
+          ]
         }
       ],
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/alert"
+          "url": "https://shoelace.style/components/avatar"
         }
       ]
     },
@@ -139,47 +180,6 @@
         }
       ]
     },
-    {
-      "name": "sl-avatar",
-      "description": "Avatars are used to represent a person or object.\n---\n\n\n### **Events:**\n - **sl-error** - The image could not be loaded. This may because of an invalid URL, a temporary network condition, or some unknown cause.\n\n### **Slots:**\n - **icon** - The default icon to use when no image or initials are present. Works best with `<sl-icon>`.\n\n### **CSS Properties:**\n - **--size** - The size of the avatar. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon** - The container that wraps the avatar's icon.\n- **initials** - The container that wraps the avatar's initials.\n- **image** - The avatar image. Only shown when the `image` attribute is set.",
-      "attributes": [
-        {
-          "name": "image",
-          "description": "The image source to use for the avatar.",
-          "values": []
-        },
-        {
-          "name": "label",
-          "description": "A label to use to describe the avatar to assistive devices.",
-          "values": []
-        },
-        {
-          "name": "initials",
-          "description": "Initials to use as a fallback when no image is available (1-2 characters max recommended).",
-          "values": []
-        },
-        {
-          "name": "loading",
-          "description": "Indicates how the browser should load the image.",
-          "values": [{ "name": "eager" }, { "name": "lazy" }]
-        },
-        {
-          "name": "shape",
-          "description": "The shape of the avatar.",
-          "values": [
-            { "name": "circle" },
-            { "name": "square" },
-            { "name": "rounded" }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/avatar"
-        }
-      ]
-    },
     {
       "name": "sl-badge",
       "description": "Badges are used to draw attention and display statuses or counts.\n---\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
@@ -1858,12 +1858,12 @@
       ]
     },
     {
-      "name": "sl-nav-submenu",
-      "description": "Nav submenus are used to group related nav items in a hierarchical structure.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the submenu opens.\n- **sl-after-show** - Emitted after the submenu opens and all animations are complete.\n- **sl-hide** - Emitted when the submenu closes.\n- **sl-after-hide** - Emitted after the submenu closes and all animations are complete.\n\n### **Methods:**\n - **show(source: _'api' | 'nav' | 'user'_)** - Shows the submenu.\n- **hide(source: _'api' | 'nav' | 'user'_)** - Hides the submenu.\n\n### **Slots:**\n - _default_ - The nav items within the submenu.\n- **title** - The nav submenu's title.\n- **prefix** - Used to prepend an icon or similar element to the nav submenu.\n- **suffix** - Used to append an icon or similar element to the nav submenu.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sl-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps the title, prefix, suffix and expand/collapse icon.\n- **prefix** - The prefix container.\n- **label** - The nav submenu label.\n- **suffix** - The suffix container.\n- **expand-icon** - The container that wraps the expand/collapse icons.\n- **content** - The nav submenu content.\n- **popup** - The popup that wraps the content in horizontal mode.",
+      "name": "sl-nav-item",
+      "description": "Nav items are the individual links or buttons within a navigation menu.\n---\n\n\n### **Events:**\n - **sl-nav-select** - Emitted when a nav item is selected.\n\n### **Slots:**\n - _default_ - The nav item's label.\n- **prefix** - Used to prepend an icon or similar element to the nav item.\n- **suffix** - Used to append an icon or similar element to the nav item.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The prefix container.\n- **label** - The nav item label.\n- **suffix** - The suffix container.",
       "attributes": [
         {
           "name": "key",
-          "description": "A stable key used by `sl-nav` to track open state.",
+          "description": "A stable key used by `sl-nav` to track selection.",
           "values": []
         },
         {
@@ -1872,38 +1872,48 @@
           "values": []
         },
         {
-          "name": "open",
-          "description": "Indicates whether or not the submenu is open.",
+          "name": "danger",
+          "description": "Matches Antd's `danger` item flag.",
           "values": []
         },
         {
-          "name": "nested",
-          "description": "Indicates if this submenu is nested within another submenu.",
+          "name": "title",
+          "description": "Tooltip text, primarily used when the menu is collapsed.",
           "values": []
         },
         {
-          "name": "title",
-          "description": "The summary to show in the header. If you need to display HTML, use the `title` slot instead.",
+          "name": "disabled",
+          "description": "Draws the nav item in a disabled state.",
           "values": []
         },
         {
-          "name": "theme",
-          "description": "Matches Antd's `theme` field.",
-          "values": [{ "name": "light" }, { "name": "dark" }]
+          "name": "active",
+          "description": "Draws the nav item in an active (selected) state.",
+          "values": []
         },
         {
-          "name": "popup-class-name",
-          "description": "Matches Antd's `popupClassName` field.",
+          "name": "href",
+          "description": "The URL to link to. If set, the nav item will render as an anchor tag.",
           "values": []
         },
         {
-          "name": "disabled",
-          "description": "Draws the submenu in a disabled state.",
+          "name": "target",
+          "description": "The target attribute for the anchor tag.",
+          "values": [
+            { "name": "_blank" },
+            { "name": "_parent" },
+            { "name": "_self" },
+            { "name": "_top" }
+          ]
+        },
+        {
+          "name": "download",
+          "description": "The download attribute for the anchor tag.",
           "values": []
         },
         {
-          "name": "active",
-          "description": "Draws the submenu in an active (selected) state.",
+          "name": "rel",
+          "description": "The rel attribute for the anchor tag.",
           "values": []
         },
         {
@@ -1924,17 +1934,17 @@
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav-submenu"
+          "url": "https://shoelace.style/components/nav-item"
         }
       ]
     },
     {
-      "name": "sl-nav-item",
-      "description": "Nav items are the individual links or buttons within a navigation menu.\n---\n\n\n### **Events:**\n - **sl-nav-select** - Emitted when a nav item is selected.\n\n### **Slots:**\n - _default_ - The nav item's label.\n- **prefix** - Used to prepend an icon or similar element to the nav item.\n- **suffix** - Used to append an icon or similar element to the nav item.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **prefix** - The prefix container.\n- **label** - The nav item label.\n- **suffix** - The suffix container.",
+      "name": "sl-nav-submenu",
+      "description": "Nav submenus are used to group related nav items in a hierarchical structure.\n---\n\n\n### **Events:**\n - **sl-show** - Emitted when the submenu opens.\n- **sl-after-show** - Emitted after the submenu opens and all animations are complete.\n- **sl-hide** - Emitted when the submenu closes.\n- **sl-after-hide** - Emitted after the submenu closes and all animations are complete.\n\n### **Methods:**\n - **show(source: _'api' | 'nav' | 'user'_)** - Shows the submenu.\n- **hide(source: _'api' | 'nav' | 'user'_)** - Hides the submenu.\n\n### **Slots:**\n - _default_ - The nav items within the submenu.\n- **title** - The nav submenu's title.\n- **prefix** - Used to prepend an icon or similar element to the nav submenu.\n- **suffix** - Used to append an icon or similar element to the nav submenu.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sl-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sl-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps the title, prefix, suffix and expand/collapse icon.\n- **prefix** - The prefix container.\n- **label** - The nav submenu label.\n- **suffix** - The suffix container.\n- **expand-icon** - The container that wraps the expand/collapse icons.\n- **content** - The nav submenu content.\n- **popup** - The popup that wraps the content in horizontal mode.",
       "attributes": [
         {
           "name": "key",
-          "description": "A stable key used by `sl-nav` to track selection.",
+          "description": "A stable key used by `sl-nav` to track open state.",
           "values": []
         },
         {
@@ -1943,48 +1953,38 @@
           "values": []
         },
         {
-          "name": "danger",
-          "description": "Matches Antd's `danger` item flag.",
+          "name": "open",
+          "description": "Indicates whether or not the submenu is open.",
           "values": []
         },
         {
-          "name": "title",
-          "description": "Tooltip text, primarily used when the menu is collapsed.",
+          "name": "nested",
+          "description": "Indicates if this submenu is nested within another submenu.",
           "values": []
         },
         {
-          "name": "disabled",
-          "description": "Draws the nav item in a disabled state.",
+          "name": "title",
+          "description": "The summary to show in the header. If you need to display HTML, use the `title` slot instead.",
           "values": []
         },
         {
-          "name": "active",
-          "description": "Draws the nav item in an active (selected) state.",
-          "values": []
+          "name": "theme",
+          "description": "Matches Antd's `theme` field.",
+          "values": [{ "name": "light" }, { "name": "dark" }]
         },
         {
-          "name": "href",
-          "description": "The URL to link to. If set, the nav item will render as an anchor tag.",
+          "name": "popup-class-name",
+          "description": "Matches Antd's `popupClassName` field.",
           "values": []
         },
         {
-          "name": "target",
-          "description": "The target attribute for the anchor tag.",
-          "values": [
-            { "name": "_blank" },
-            { "name": "_parent" },
-            { "name": "_self" },
-            { "name": "_top" }
-          ]
-        },
-        {
-          "name": "download",
-          "description": "The download attribute for the anchor tag.",
+          "name": "disabled",
+          "description": "Draws the submenu in a disabled state.",
           "values": []
         },
         {
-          "name": "rel",
-          "description": "The rel attribute for the anchor tag.",
+          "name": "active",
+          "description": "Draws the submenu in an active (selected) state.",
           "values": []
         },
         {
@@ -2005,7 +2005,7 @@
       "references": [
         {
           "name": "Documentation",
-          "url": "https://shoelace.style/components/nav-item"
+          "url": "https://shoelace.style/components/nav-submenu"
         }
       ]
     },
@@ -2991,6 +2991,49 @@
         }
       ]
     },
+    {
+      "name": "sl-tag",
+      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
+      "attributes": [
+        {
+          "name": "variant",
+          "description": "The tag's theme variant.",
+          "values": [
+            { "name": "primary" },
+            { "name": "success" },
+            { "name": "neutral" },
+            { "name": "warning" },
+            { "name": "danger" },
+            { "name": "text" }
+          ]
+        },
+        {
+          "name": "size",
+          "description": "The tag's size.",
+          "values": [
+            { "name": "small" },
+            { "name": "medium" },
+            { "name": "large" }
+          ]
+        },
+        {
+          "name": "pill",
+          "description": "Draws a pill-style tag with rounded edges.",
+          "values": []
+        },
+        {
+          "name": "removable",
+          "description": "Makes the tag removable and shows a remove button.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://shoelace.style/components/tag"
+        }
+      ]
+    },
     {
       "name": "sl-table",
       "description": "\n---\n\n\n### **Events:**\n - **change**",
@@ -3078,49 +3121,6 @@
         }
       ]
     },
-    {
-      "name": "sl-tag",
-      "description": "Tags are used as labels to organize things or to indicate a selection.\n---\n\n\n### **Events:**\n - **sl-remove** - Emitted when the remove button is activated.\n\n### **Slots:**\n - _default_ - The tag's content.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - The tag's content.\n- **remove-button** - The tag's remove button, an `<sl-icon-button>`.\n- **remove-button__base** - The remove button's exported `base` part.",
-      "attributes": [
-        {
-          "name": "variant",
-          "description": "The tag's theme variant.",
-          "values": [
-            { "name": "primary" },
-            { "name": "success" },
-            { "name": "neutral" },
-            { "name": "warning" },
-            { "name": "danger" },
-            { "name": "text" }
-          ]
-        },
-        {
-          "name": "size",
-          "description": "The tag's size.",
-          "values": [
-            { "name": "small" },
-            { "name": "medium" },
-            { "name": "large" }
-          ]
-        },
-        {
-          "name": "pill",
-          "description": "Draws a pill-style tag with rounded edges.",
-          "values": []
-        },
-        {
-          "name": "removable",
-          "description": "Makes the tag removable and shows a remove button.",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Documentation",
-          "url": "https://shoelace.style/components/tag"
-        }
-      ]
-    },
     {
       "name": "sl-textarea",
       "description": "Textareas collect data from the user and allow multiple lines of text.\n---\n\n\n### **Events:**\n - **sl-blur** - Emitted when the control loses focus.\n- **sl-change** - Emitted when an alteration to the control's value is committed by the user.\n- **sl-focus** - Emitted when the control gains focus.\n- **sl-input** - Emitted when the control receives input.\n- **sl-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the textarea.\n- **blur()** - Removes focus from the textarea.\n- **select()** - Selects all the text in the textarea.\n- **scrollPosition(position: _{ top?: number; left?: number }_): _{ top: number; left: number } | undefined_** - Gets or sets the textarea's scroll position.\n- **setSelectionRange(selectionStart: _number_, selectionEnd: _number_, selectionDirection: _'forward' | 'backward' | 'none'_)** - Sets the start and end positions of the text selection (0-based).\n- **setRangeText(replacement: _string_, start: _number_, end: _number_, selectMode: _'select' | 'start' | 'end' | 'preserve'_)** - Replaces a range of text with a new string.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - **label** - The textarea's label. Alternatively, you can use the `label` attribute.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The input's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **base** - The component's base wrapper.\n- **textarea** - The internal `<textarea>` control.",