@uh-design-system/component-library 0.7.1 → 0.7.2-rc.1

package/dist/docs.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-06-25T09:20:06",
+  "timestamp": "2025-08-06T16:47:46",
   "compiler": {
     "name": "@stencil/core",
-    "version": "4.35.1",
+    "version": "4.36.2",
     "typescriptVersion": "5.5.4"
   },
   "components": [
@@ -839,6 +839,7 @@
       "parts": [],
       "dependents": [
         "ds-accordion",
+        "ds-combobox",
         "ds-select",
         "ds-text-input"
       ],
@@ -859,6 +860,9 @@
         "ds-accordion": [
           "ds-button"
         ],
+        "ds-combobox": [
+          "ds-button"
+        ],
         "ds-select": [
           "ds-button"
         ],
@@ -2610,6 +2614,463 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/01-base-components/ds-combobox/ds-combobox.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-combobox",
+      "readme": "# ds-combobox\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "dsAriaLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-aria-label",
+          "reflectToAttr": false,
+          "docs": "Passed to the `aria-label` attribute of the `input` element of the rendered combobox.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsAssistiveText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-assistive-text",
+          "reflectToAttr": false,
+          "docs": "Text for additional information shown below label.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsClearable",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-clearable",
+          "reflectToAttr": false,
+          "docs": "If true, allows the user to clear the selected option.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsDisabled",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-disabled",
+          "reflectToAttr": false,
+          "docs": "Passed to the `disabled` attribute of the `input` element of the rendered combobox.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsErrorText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-error-text",
+          "reflectToAttr": false,
+          "docs": "Error message shown below the combobox.\nIf set, the combobox is shown in an invalid state.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsFilteringStrategy",
+          "type": "\"dynamic\" | \"static\"",
+          "complexType": {
+            "original": "'dynamic' | 'static'",
+            "resolved": "\"dynamic\" | \"static\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-filtering-strategy",
+          "reflectToAttr": false,
+          "docs": "Defines combobox's filtering stategy:\n- \"dynamic\" options are filtered\n- \"static\" options are not filtered\n\nBoth options emit the `dsFilterChange` event on user input.\nUse this event to filter options using \"static\" strategy.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "'dynamic'"
+            }
+          ],
+          "default": "'dynamic'",
+          "values": [
+            {
+              "value": "dynamic",
+              "type": "string"
+            },
+            {
+              "value": "static",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsIcon",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-icon",
+          "reflectToAttr": false,
+          "docs": "Icon to display at the start of the combobox.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsId",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-id",
+          "reflectToAttr": false,
+          "docs": "Unique `id` attribute of the combobox element.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "comboboxIdGenerator.next().value as string"
+            }
+          ],
+          "default": "comboboxIdGenerator.next().value as string",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsLabel",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-label",
+          "reflectToAttr": false,
+          "docs": "Label of the combobox.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsLoading",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-loading",
+          "reflectToAttr": false,
+          "docs": "If true, shows a loading spinner and text.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsNoResults",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-no-results",
+          "reflectToAttr": false,
+          "docs": "When using \"static\" filtering strategy use this property to indicate\nthat there are no results for the current search.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsOptionsError",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-options-error",
+          "reflectToAttr": false,
+          "docs": "If true, shows an options error.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsPlaceholder",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-placeholder",
+          "reflectToAttr": false,
+          "docs": "Passed to the `placeholder` attribute of the `input` element of the rendered combobox.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsPlaceholderHidden",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-placeholder-hidden",
+          "reflectToAttr": false,
+          "docs": "If true, hides the placeholder text.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [
+        {
+          "event": "dsChange",
+          "detail": "string",
+          "bubbles": true,
+          "complexType": {
+            "original": "string | null",
+            "resolved": "string",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Event emitted when user selects an option.",
+          "docsTags": []
+        },
+        {
+          "event": "dsFilterChange",
+          "detail": "string",
+          "bubbles": true,
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "Event emitted when user interacts with the search input.",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "dsOptionClick",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "focusout",
+          "capture": false,
+          "passive": false
+        }
+      ],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [
+        "ds-icon",
+        "ds-button",
+        "ds-options-message",
+        "ds-input-validity"
+      ],
+      "dependencyGraph": {
+        "ds-combobox": [
+          "ds-icon",
+          "ds-button",
+          "ds-options-message",
+          "ds-input-validity"
+        ],
+        "ds-button": [
+          "ds-icon",
+          "ds-spinner",
+          "ds-visually-hidden"
+        ],
+        "ds-spinner": [
+          "ds-visually-hidden"
+        ],
+        "ds-options-message": [
+          "ds-icon",
+          "ds-spinner",
+          "ds-visually-hidden"
+        ],
+        "ds-input-validity": [
+          "ds-icon"
+        ]
+      }
+    },
     {
       "filePath": "src/components/01-base-components/ds-grid/ds-grid.tsx",
       "encapsulation": "none",
@@ -3269,11 +3730,13 @@
         "ds-button",
         "ds-card",
         "ds-chip",
+        "ds-combobox",
         "ds-input-validity",
         "ds-link",
         "ds-link-with-arrow",
         "ds-option",
         "ds-options",
+        "ds-options-message",
         "ds-select",
         "ds-tag",
         "ds-text-input"
@@ -3292,6 +3755,9 @@
         "ds-chip": [
           "ds-icon"
         ],
+        "ds-combobox": [
+          "ds-icon"
+        ],
         "ds-input-validity": [
           "ds-icon"
         ],
@@ -3307,6 +3773,9 @@
         "ds-options": [
           "ds-icon"
         ],
+        "ds-options-message": [
+          "ds-icon"
+        ],
         "ds-select": [
           "ds-icon"
         ],
@@ -36586,6 +37055,7 @@
       "dependents": [
         "ds-checkbox",
         "ds-checkbox-group",
+        "ds-combobox",
         "ds-radio-button",
         "ds-radio-button-group",
         "ds-select",
@@ -36604,6 +37074,9 @@
         "ds-checkbox-group": [
           "ds-input-validity"
         ],
+        "ds-combobox": [
+          "ds-input-validity"
+        ],
         "ds-radio-button": [
           "ds-input-validity"
         ],
@@ -37160,6 +37633,35 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dsFullWidth",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-full-width",
+          "reflectToAttr": false,
+          "docs": "Whether the element should take up the full width of its container.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dsHref",
           "type": "string",
@@ -37183,6 +37685,45 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dsIcon",
+          "type": "\"arrow_back\" | \"arrow_forward\"",
+          "complexType": {
+            "original": "LinkIcon",
+            "resolved": "\"arrow_back\" | \"arrow_forward\"",
+            "references": {
+              "LinkIcon": {
+                "location": "global",
+                "id": "global::LinkIcon"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "ds-icon",
+          "reflectToAttr": false,
+          "docs": "",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "this.defaultIcon"
+            }
+          ],
+          "default": "this.defaultIcon",
+          "values": [
+            {
+              "value": "arrow_back",
+              "type": "string"
+            },
+            {
+              "value": "arrow_forward",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dsIconPosition",
           "type": "\"end\" | \"start\"",
@@ -37379,7 +37920,7 @@
           "mutable": false,
           "attr": "ds-active",
           "reflectToAttr": true,
-          "docs": "Whether the option is currently active (focused).",
+          "docs": "If true, the option is currently active (focused).",
           "docsTags": [
             {
               "name": "default",
@@ -37431,7 +37972,123 @@
           "mutable": false,
           "attr": "ds-disabled",
           "reflectToAttr": false,
-          "docs": "Whether the option is disabled.",
+          "docs": "If true, the option is disabled.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsFocusOnActiveChange",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-focus-on-active-change",
+          "reflectToAttr": false,
+          "docs": "Used internally in select and combobox to control focus when the option becomes active.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "true"
+            }
+          ],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsHidden",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-hidden",
+          "reflectToAttr": false,
+          "docs": "If true, the option will be hidden.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsId",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-id",
+          "reflectToAttr": false,
+          "docs": "Unique `id` attribute of the option element.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "optionIdGenerator.next().value as string"
+            }
+          ],
+          "default": "optionIdGenerator.next().value as string",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsMouseDownPreventDefault",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-mouse-down-prevent-default",
+          "reflectToAttr": false,
+          "docs": "Used internally in combobox to prevent default behavior on mousedown.",
           "docsTags": [
             {
               "name": "default",
@@ -37460,7 +38117,7 @@
           "mutable": false,
           "attr": "ds-selected",
           "reflectToAttr": true,
-          "docs": "Whether the option is currently selected.",
+          "docs": "If true, the option is currently selected.",
           "docsTags": [
             {
               "name": "default",
@@ -37524,10 +38181,89 @@
           "parameters": [],
           "docs": "Sets focus to the option element.",
           "docsTags": []
+        },
+        {
+          "name": "dsGetGroup",
+          "returns": {
+            "type": "Promise<HTMLDsOptionGroupElement>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<HTMLDsOptionGroupElement>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              },
+              "HTMLDsOptionGroupElement": {
+                "location": "global",
+                "id": "global::HTMLDsOptionGroupElement"
+              }
+            },
+            "return": "Promise<HTMLDsOptionGroupElement>"
+          },
+          "signature": "dsGetGroup() => Promise<HTMLDsOptionGroupElement>",
+          "parameters": [],
+          "docs": "Get the group of the option.",
+          "docsTags": []
+        },
+        {
+          "name": "dsGetLabel",
+          "returns": {
+            "type": "Promise<string>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<string>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              }
+            },
+            "return": "Promise<string>"
+          },
+          "signature": "dsGetLabel() => Promise<string>",
+          "parameters": [],
+          "docs": "Get label text of the option.",
+          "docsTags": []
+        }
+      ],
+      "events": [
+        {
+          "event": "dsOptionClick",
+          "detail": "HTMLDsOptionElement",
+          "bubbles": true,
+          "complexType": {
+            "original": "HTMLDsOptionElement",
+            "resolved": "HTMLDsOptionElement",
+            "references": {
+              "HTMLDsOptionElement": {
+                "location": "global",
+                "id": "global::HTMLDsOptionElement"
+              }
+            }
+          },
+          "cancelable": true,
+          "composed": true,
+          "docs": "",
+          "docsTags": []
+        }
+      ],
+      "listeners": [
+        {
+          "event": "mousedown",
+          "capture": false,
+          "passive": false
+        },
+        {
+          "event": "click",
+          "capture": false,
+          "passive": false
         }
       ],
-      "events": [],
-      "listeners": [],
       "styles": [],
       "slots": [],
       "parts": [],
@@ -37550,6 +38286,35 @@
       "docsTags": [],
       "usage": {},
       "props": [
+        {
+          "name": "dsHidden",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-hidden",
+          "reflectToAttr": false,
+          "docs": "If true, the group will be hidden.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dsLabel",
           "type": "string",
@@ -37572,11 +38337,73 @@
           "required": true,
           "getter": false,
           "setter": false
+        },
+        {
+          "name": "dsMouseDownPreventDefault",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-mouse-down-prevent-default",
+          "reflectToAttr": false,
+          "docs": "Used internally in combobox to prevent default behavior on mousedown.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [
+        {
+          "name": "dsHasVisibleOptions",
+          "returns": {
+            "type": "Promise<boolean>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "() => Promise<boolean>",
+            "parameters": [],
+            "references": {
+              "Promise": {
+                "location": "global",
+                "id": "global::Promise"
+              },
+              "HTMLDsOptionElement": {
+                "location": "global",
+                "id": "global::HTMLDsOptionElement"
+              }
+            },
+            "return": "Promise<boolean>"
+          },
+          "signature": "dsHasVisibleOptions() => Promise<boolean>",
+          "parameters": [],
+          "docs": "",
+          "docsTags": []
         }
       ],
-      "methods": [],
       "events": [],
-      "listeners": [],
+      "listeners": [
+        {
+          "event": "mousedown",
+          "capture": false,
+          "passive": false
+        }
+      ],
       "styles": [],
       "slots": [],
       "parts": [],
@@ -37622,6 +38449,29 @@
           "getter": false,
           "setter": false
         },
+        {
+          "name": "dsId",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-id",
+          "reflectToAttr": false,
+          "docs": "Unique `id` attribute of the options element.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": true,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
         {
           "name": "dsLabelId",
           "type": "string",
@@ -37781,10 +38631,10 @@
           "docsTags": [
             {
               "name": "default",
-              "text": "\"Try again or if the problem persists contact support.\""
+              "text": "'Try again or if the problem persists contact support.'"
             }
           ],
-          "default": "\"Try again or if the problem persists contact support.\"",
+          "default": "'Try again or if the problem persists contact support.'",
           "values": [
             {
               "type": "string"
@@ -37810,10 +38660,10 @@
           "docsTags": [
             {
               "name": "default",
-              "text": "\"We couldn’t load the options\""
+              "text": "'We couldn’t load the options'"
             }
           ],
-          "default": "\"We couldn’t load the options\"",
+          "default": "'We couldn’t load the options'",
           "values": [
             {
               "type": "string"
@@ -37917,6 +38767,276 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/01-base-components/ds-options-message/ds-options-message.tsx",
+      "encapsulation": "scoped",
+      "tag": "ds-options-message",
+      "readme": "# ds-options-status\n\n\n",
+      "docs": "",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "dsError",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-error",
+          "reflectToAttr": false,
+          "docs": "If true, shows an error state.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsErrorText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-error-text",
+          "reflectToAttr": false,
+          "docs": "Text to display when there is an error loading options (default: \"Try again or if the problem persists, contact support.\").",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "tryAgainOrIfTheProblemPersists()"
+            }
+          ],
+          "default": "tryAgainOrIfTheProblemPersists()",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsErrorTitle",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-error-title",
+          "reflectToAttr": false,
+          "docs": "Title to display when there is an error loading options (default: \"We could not load options.\").",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "weCouldNotLoadOptions()"
+            }
+          ],
+          "default": "weCouldNotLoadOptions()",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsLoading",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-loading",
+          "reflectToAttr": false,
+          "docs": "If true, shows a loading state.",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsLoadingText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-loading-text",
+          "reflectToAttr": false,
+          "docs": "Text to display when options are loading (default: \"Loading options...\").",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "loadingOptions()"
+            }
+          ],
+          "default": "loadingOptions()",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsNoResults",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-no-results",
+          "reflectToAttr": false,
+          "docs": "If true, shows a no results state",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "false"
+            }
+          ],
+          "default": "false",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsNoResultsText",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-no-results-text",
+          "reflectToAttr": false,
+          "docs": "Text to display when there are no results (default: \"Try a different search term.\").",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "tryADifferentSearchTerm()"
+            }
+          ],
+          "default": "tryADifferentSearchTerm()",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        },
+        {
+          "name": "dsNoResultsTitle",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "ds-no-results-title",
+          "reflectToAttr": false,
+          "docs": "Title to display when there are no results (default: \"No results found\").",
+          "docsTags": [
+            {
+              "name": "default",
+              "text": "noResultsFound()"
+            }
+          ],
+          "default": "noResultsFound()",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false,
+          "getter": false,
+          "setter": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "ds-combobox"
+      ],
+      "dependencies": [
+        "ds-icon",
+        "ds-spinner",
+        "ds-visually-hidden"
+      ],
+      "dependencyGraph": {
+        "ds-options-message": [
+          "ds-icon",
+          "ds-spinner",
+          "ds-visually-hidden"
+        ],
+        "ds-spinner": [
+          "ds-visually-hidden"
+        ],
+        "ds-combobox": [
+          "ds-options-message"
+        ]
+      }
+    },
     {
       "filePath": "src/components/01-base-components/ds-radio-button/ds-radio-button.tsx",
       "encapsulation": "scoped",
@@ -39142,7 +40262,7 @@
           "mutable": false,
           "attr": "ds-options-error",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "If true, shows an options error.",
           "docsTags": [
             {
               "name": "default",
@@ -39171,7 +40291,7 @@
           "mutable": false,
           "attr": "ds-options-error-text",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Text to display when there is an error loading options.",
           "docsTags": [
             {
               "name": "default",
@@ -39200,7 +40320,7 @@
           "mutable": false,
           "attr": "ds-options-error-title",
           "reflectToAttr": false,
-          "docs": "",
+          "docs": "Title to display when there is an error loading options.",
           "docsTags": [
             {
               "name": "default",
@@ -39309,14 +40429,14 @@
           "name": "dsVariant",
           "type": "\"default\" | \"native\"",
           "complexType": {
-            "original": "'native' | 'default'",
+            "original": "'default' | 'native'",
             "resolved": "\"default\" | \"native\"",
             "references": {}
           },
           "mutable": false,
           "attr": "ds-variant",
           "reflectToAttr": false,
-          "docs": "Defines the variant of the select component. \"native\" uses the browser’s default select, while \"default\" uses a custom implementation.",
+          "docs": "Defines the variant of the select component:\n- \"default\" uses a custom implementation\n- \"native\" uses the browser’s default select",
           "docsTags": [
             {
               "name": "default",
@@ -39647,7 +40767,8 @@
       "parts": [],
       "dependents": [
         "ds-button",
-        "ds-options"
+        "ds-options",
+        "ds-options-message"
       ],
       "dependencies": [
         "ds-visually-hidden"
@@ -39661,6 +40782,9 @@
         ],
         "ds-options": [
           "ds-spinner"
+        ],
+        "ds-options-message": [
+          "ds-spinner"
         ]
       }
     },
@@ -41086,6 +42210,7 @@
         "ds-chip",
         "ds-link",
         "ds-link-with-arrow",
+        "ds-options-message",
         "ds-radio-button",
         "ds-spinner",
         "ds-text-input"
@@ -41104,6 +42229,9 @@
         "ds-link-with-arrow": [
           "ds-visually-hidden"
         ],
+        "ds-options-message": [
+          "ds-visually-hidden"
+        ],
         "ds-radio-button": [
           "ds-visually-hidden"
         ],