@uh-design-system/component-library 1.1.0 → 1.2.0-rc.0

package/dist/types/components.d.ts

@@ -13,7 +13,7 @@ import { DsCheckboxGroupChangeEvent, DsCheckboxGroupIndeterminateChildChangeEven
 import { DsChipClickEvent, DsChipValue } from "./components/01-base-components/ds-chip/ds-chip";
 import { DsChipClickEvent as DsChipClickEvent1 } from "./components/01-base-components/ds-chip/ds-chip";
 import { DsSubmitInvalidEvent as DsSubmitInvalidEvent1, DsValidityEvent as DsValidityEvent1 } from ".";
-import { DsComboboxBlurEvent, DsComboboxChangeEvent, DsComboboxFilterChangeEvent, DsComboboxFocusEvent, DsComboboxSelectedOptionRemovedEvent, DsComboboxSelectedOptionValueChangeEvent } from "./components/01-base-components/ds-combobox/ds-combobox";
+import { DsComboboxBlurEvent, DsComboboxChangeEvent, DsComboboxFilterChangeEvent, DsComboboxFocusEvent, DsComboboxMultipleChangeEvent, DsComboboxSelectedOptionRemovedEvent, DsComboboxSelectedOptionValueChangeEvent } from "./components/01-base-components/ds-combobox/ds-combobox";
 import { LinkTarget as LinkTarget1 } from "./utils/link/linkUtils";
 import { DsMediaErrorEvent, DsMediaLoadEvent, MediaType } from "./components/01-base-components/ds-media/ds-media";
 import { DsOptionClickEvent, DsOptionLabelChangeEvent, DsOptionMountedEvent, DsOptionValueChangeEvent } from "./components/01-base-components/ds-option/ds-option";
@@ -21,7 +21,7 @@ import { DsOptionsActiveIndexChangeEvent, DsOptionsEscEvent } from "./components
 import { DsRadioButtonBlurEvent, DsRadioButtonChangeEvent, DsRadioButtonCheckEvent, DsRadioButtonFocusEvent } from "./components/01-base-components/ds-radio-button/ds-radio-button";
 import { DsRadioButtonGroupChangeEvent, DsRadioButtonGroupInvalidStateChangeEvent, DsRadioButtonGroupValueChangeEvent } from "./components/01-base-components/ds-radio-button-group/ds-radio-button-group";
 import { RibbonLink } from "./data";
-import { DsSelectBlurEvent, DsSelectChangeEvent, DsSelectFocusEvent } from "./components/01-base-components/ds-select/ds-select";
+import { DsSelectBlurEvent, DsSelectChangeEvent, DsSelectFocusEvent, DsSelectMultipleChangeEvent } from "./components/01-base-components/ds-select/ds-select";
 import { Language } from "./store";
 import { DsTextAreaEvent } from "./components/01-base-components/ds-text-area/ds-text-area";
 import { DsTextInputType } from "./components/01-base-components/ds-text-input/utils";
@@ -35,7 +35,7 @@ export { DsCheckboxGroupChangeEvent, DsCheckboxGroupIndeterminateChildChangeEven
 export { DsChipClickEvent, DsChipValue } from "./components/01-base-components/ds-chip/ds-chip";
 export { DsChipClickEvent as DsChipClickEvent1 } from "./components/01-base-components/ds-chip/ds-chip";
 export { DsSubmitInvalidEvent as DsSubmitInvalidEvent1, DsValidityEvent as DsValidityEvent1 } from ".";
-export { DsComboboxBlurEvent, DsComboboxChangeEvent, DsComboboxFilterChangeEvent, DsComboboxFocusEvent, DsComboboxSelectedOptionRemovedEvent, DsComboboxSelectedOptionValueChangeEvent } from "./components/01-base-components/ds-combobox/ds-combobox";
+export { DsComboboxBlurEvent, DsComboboxChangeEvent, DsComboboxFilterChangeEvent, DsComboboxFocusEvent, DsComboboxMultipleChangeEvent, DsComboboxSelectedOptionRemovedEvent, DsComboboxSelectedOptionValueChangeEvent } from "./components/01-base-components/ds-combobox/ds-combobox";
 export { LinkTarget as LinkTarget1 } from "./utils/link/linkUtils";
 export { DsMediaErrorEvent, DsMediaLoadEvent, MediaType } from "./components/01-base-components/ds-media/ds-media";
 export { DsOptionClickEvent, DsOptionLabelChangeEvent, DsOptionMountedEvent, DsOptionValueChangeEvent } from "./components/01-base-components/ds-option/ds-option";
@@ -43,7 +43,7 @@ export { DsOptionsActiveIndexChangeEvent, DsOptionsEscEvent } from "./components
 export { DsRadioButtonBlurEvent, DsRadioButtonChangeEvent, DsRadioButtonCheckEvent, DsRadioButtonFocusEvent } from "./components/01-base-components/ds-radio-button/ds-radio-button";
 export { DsRadioButtonGroupChangeEvent, DsRadioButtonGroupInvalidStateChangeEvent, DsRadioButtonGroupValueChangeEvent } from "./components/01-base-components/ds-radio-button-group/ds-radio-button-group";
 export { RibbonLink } from "./data";
-export { DsSelectBlurEvent, DsSelectChangeEvent, DsSelectFocusEvent } from "./components/01-base-components/ds-select/ds-select";
+export { DsSelectBlurEvent, DsSelectChangeEvent, DsSelectFocusEvent, DsSelectMultipleChangeEvent } from "./components/01-base-components/ds-select/ds-select";
 export { Language } from "./store";
 export { DsTextAreaEvent } from "./components/01-base-components/ds-text-area/ds-text-area";
 export { DsTextInputType } from "./components/01-base-components/ds-text-input/utils";
@@ -52,47 +52,74 @@ export { Event } from "./stencil-public-runtime";
 export namespace Components {
     interface DsAccordion {
         /**
-          * Aligns the border to the position where accordion content starts
+          * Passed to the `aria-describedby` attribute of the heading `button` element.
+         */
+        "dsAriaDescribedBy"?: string;
+        /**
+          * Passed to the `aria-labelledby` attribute of the heading `button` element. Should be set when `dsHeadingVariant` is `icon-button`.
+         */
+        "dsAriaLabelledBy"?: string;
+        /**
+          * If true, aligns the border to the position where accordion content starts. Use cases include side panels or sidebars to achieve better text alignment with other content.
           * @default false
          */
         "dsBorderAligned": boolean;
         /**
           * Text of the close button
-          * @default 'Close'
          */
-        "dsCloseButtonLabel": string;
+        "dsCloseButtonLabel"?: string;
+        /**
+          * If true, adds a background color to the accordion content area
+          * @default true
+         */
+        "dsContentHasBackground": boolean;
         /**
           * Heading level to be used for the accordion
           * @default 2
          */
         "dsHeadingLevel": number;
         /**
-          * Removes the bottom border
+          * Heading variant of the accordion: - `button`: Heading button takes the full width of the header. The header content is inside the button. - `icon-button`: Heading button is styled as an icon button. The header content is separate from the button.
+          * @default 'button'
+         */
+        "dsHeadingVariant": 'button' | 'icon-button';
+        /**
+          * If true, removes the bottom border
           * @default false
          */
         "dsHideBottomBorder": boolean;
         /**
-          * Removes the top border
+          * If true, removes the left border
+          * @default true
+         */
+        "dsHideLeftBorder": boolean;
+        /**
+          * If true, removes the right border
+          * @default true
+         */
+        "dsHideRightBorder": boolean;
+        /**
+          * If true, removes the top border
           * @default false
          */
         "dsHideTopBorder": boolean;
         /**
           * Id of the accordion button
-          * @default 'dsaccordion'
+          * @default dsAccordionIdGenerator.next().value as string
          */
         "dsId": string;
         /**
-          * Displays the accordion as opened when loaded
+          * If true, displays the accordion as opened when loaded
           * @default false
          */
         "dsOpenByDefault": boolean;
         /**
-          * Displays a close button at the end of an opened accordion
+          * If true, displays a close button at the end of an opened accordion. Use cases include accordions with long content where scrolling back to the header to close the accordion would be inconvenient.
           * @default false
          */
         "dsUseCloseButton": boolean;
         /**
-          * Variant of the accordion
+          * Variant of the accordion: - `default`: Standard spacing and font sizes. - `compact`: Reduced spacing and font sizes, for denser display of content.
           * @default 'default'
          */
         "dsVariant": 'default' | 'compact';
@@ -131,7 +158,7 @@ export namespace Components {
           * The variant style of the badge
           * @default 'default'
          */
-        "dsVariant": 'default' | 'success' | 'attention' | 'danger' | 'info' | 'notification' | 'primary';
+        "dsVariant": 'default' | 'success' | 'attention' | 'danger' | 'info' | 'notification' | 'primary' | 'disabled';
     }
     interface DsBreadcrumb {
         /**
@@ -737,12 +764,18 @@ export namespace Components {
          */
         "dsRequired": boolean;
         /**
-          * The value of the selected option.  Set this property to programmatically select an option by its `dsValue`. Listen to the `dsChange` event to keep this property synchronized when users make selections.
+          * The value of the selected option.  Set this property to programmatically select an option by its `dsValue`. Listen to the `dsChange` or `dsMultipleChange` event (depending on the variant) to keep this property synchronized when users make selections.
           * @default null
          */
-        "dsValue": string | null;
+        "dsValue": string | string[] | null;
+        /**
+          * Defines the variant of the combobox: - "default": allows selection of a single option - "multiple": allows selection of multiple options
+          * @default 'default'
+         */
+        "dsVariant"?: 'default' | 'multiple';
         "getOptions": () => Promise<HTMLDsOptionElement[]>;
         "getSelectedOption": () => Promise<{ value: string; label: string; description: string; }>;
+        "getSelectedOptions": () => Promise<{ value: string; label: string; description: string; }[]>;
         "setFocus": () => Promise<void>;
     }
     interface DsControlLabel {
@@ -922,10 +955,10 @@ export namespace Components {
          */
         "dsRole": string;
         /**
-          * Size of the icon
-          * @default '1.5rem'
+          * Icon size in positive REM units (e.g., '1rem', '1.5rem')
+          * @default this.defaultSize
          */
-        "dsSize": Size;
+        "dsSize": string;
         /**
           * Tooltip text for the icon. Should match the `dsAriaLabel`.
          */
@@ -4573,7 +4606,11 @@ export namespace Components {
          */
         "dsColour"?: 'black' | 'white';
         /**
-          * URL where the logo link should navigate
+          * Passed to the `download` attribute of the `a` element
+         */
+        "dsDownload"?: boolean;
+        /**
+          * Passed to the `href` attribute of the `a` element
          */
         "dsHref": string;
         /**
@@ -4620,6 +4657,10 @@ export namespace Components {
           * Passed to the `aria-label` attribute of the `a` element.
          */
         "dsAriaLabel": string;
+        /**
+          * Passed to the `download` attribute of the `a` element
+         */
+        "dsDownload"?: boolean;
         /**
           * If true, the link takes the full width of its container.
           * @default false
@@ -4740,7 +4781,7 @@ export namespace Components {
           * Variant of the notification
           * @default 'neutral'
          */
-        "dsVariant": "success" | "info" | "attention" | "danger" | "neutral" | "neutralWhite";
+        "dsVariant": "success" | "attention" | "danger" | "info" | "neutral" | "neutralWhite";
     }
     interface DsOption {
         /**
@@ -4790,6 +4831,11 @@ export namespace Components {
           * Value of the option.
          */
         "dsValue": string;
+        /**
+          * Defines the appearance of the select component. Should match the `ds-variant` of the parent (`ds-select`, `ds-combobox`) component: - "default": Single selection appearance. - "multiple": Multiple selection appearance, resembling a combobox.
+          * @default 'default'
+         */
+        "dsVariant"?: 'default' | 'multiple';
         /**
           * Get the group of the option.
          */
@@ -4826,8 +4872,13 @@ export namespace Components {
           * @default 0
          */
         "dsActiveIndex": number;
+        /**
+          * Passed to the `aria-multiselectable` attribute of the `div` (listbox) element.
+         */
+        "dsAriaMultiselectable"?: boolean;
         /**
           * Unique `id` attribute of the options element.
+          * @default optionsIdGenerator.next().value as string
          */
         "dsId"?: string;
         /**
@@ -5132,13 +5183,14 @@ export namespace Components {
           * The value of the selected option.
           * @default null
          */
-        "dsValue": string | null;
+        "dsValue": string | string[] | null;
         /**
-          * Defines the variant of the select component: - "default" uses a custom implementation - "native" uses the browser’s default select
+          * Defines the variant of the select component: - "default" uses a custom implementation that allows selection of a single option - "multiple" uses a custom implementation that allows selection of multiple options - "native" uses the browser’s default select
           * @default 'default'
          */
-        "dsVariant": 'default' | 'native';
+        "dsVariant": 'default' | 'multiple' | 'native';
         "getSelectedOption": () => Promise<{ value: string; label: string; description: string; }>;
+        "getSelectedOptions": () => Promise<{ value: string; label: string; description: string; }[]>;
     }
     interface DsSelectNative {
         /**
@@ -5544,6 +5596,22 @@ export interface DsComboboxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLDsComboboxElement;
 }
+export interface DsLinkCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLDsLinkElement;
+}
+export interface DsLinkCtaCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLDsLinkCtaElement;
+}
+export interface DsLinkLogoCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLDsLinkLogoElement;
+}
+export interface DsLinkWithArrowCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLDsLinkWithArrowElement;
+}
 export interface DsMediaCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLDsMediaElement;
@@ -5619,6 +5687,7 @@ declare global {
         new (): HTMLDsBadgeElement;
     };
     interface HTMLDsBreadcrumbElementEventMap {
+        "dsClick": MouseEvent;
         "dsIsHiddenChange": boolean;
     }
     interface HTMLDsBreadcrumbElement extends Components.DsBreadcrumb, HTMLStencilElement {
@@ -5784,6 +5853,7 @@ declare global {
     };
     interface HTMLDsComboboxElementEventMap {
         "dsFilterChange": DsComboboxFilterChangeEvent;
+        "dsMultipleChange": DsComboboxMultipleChangeEvent;
         "dsChange": DsComboboxChangeEvent;
         "dsSelectedOptionValueChange": DsComboboxSelectedOptionValueChangeEvent;
         "dsSelectedOptionRemoved": DsComboboxSelectedOptionRemovedEvent;
@@ -7444,29 +7514,73 @@ declare global {
         prototype: HTMLDsInputValidityElement;
         new (): HTMLDsInputValidityElement;
     };
+    interface HTMLDsLinkElementEventMap {
+        "dsClick": MouseEvent;
+    }
     interface HTMLDsLinkElement extends Components.DsLink, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLDsLinkElementEventMap>(type: K, listener: (this: HTMLDsLinkElement, ev: DsLinkCustomEvent<HTMLDsLinkElementEventMap[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 HTMLDsLinkElementEventMap>(type: K, listener: (this: HTMLDsLinkElement, ev: DsLinkCustomEvent<HTMLDsLinkElementEventMap[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 HTMLDsLinkElement: {
         prototype: HTMLDsLinkElement;
         new (): HTMLDsLinkElement;
     };
+    interface HTMLDsLinkCtaElementEventMap {
+        "dsClick": MouseEvent;
+    }
     interface HTMLDsLinkCtaElement extends Components.DsLinkCta, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLDsLinkCtaElementEventMap>(type: K, listener: (this: HTMLDsLinkCtaElement, ev: DsLinkCtaCustomEvent<HTMLDsLinkCtaElementEventMap[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 HTMLDsLinkCtaElementEventMap>(type: K, listener: (this: HTMLDsLinkCtaElement, ev: DsLinkCtaCustomEvent<HTMLDsLinkCtaElementEventMap[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 HTMLDsLinkCtaElement: {
         prototype: HTMLDsLinkCtaElement;
         new (): HTMLDsLinkCtaElement;
     };
+    interface HTMLDsLinkLogoElementEventMap {
+        "dsClick": MouseEvent;
+    }
     /**
      * Logo link component for displaying site logo and name.
      * Used primarily in navigation ribbons and headers.
      */
     interface HTMLDsLinkLogoElement extends Components.DsLinkLogo, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLDsLinkLogoElementEventMap>(type: K, listener: (this: HTMLDsLinkLogoElement, ev: DsLinkLogoCustomEvent<HTMLDsLinkLogoElementEventMap[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 HTMLDsLinkLogoElementEventMap>(type: K, listener: (this: HTMLDsLinkLogoElement, ev: DsLinkLogoCustomEvent<HTMLDsLinkLogoElementEventMap[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 HTMLDsLinkLogoElement: {
         prototype: HTMLDsLinkLogoElement;
         new (): HTMLDsLinkLogoElement;
     };
+    interface HTMLDsLinkWithArrowElementEventMap {
+        "dsClick": MouseEvent;
+    }
     interface HTMLDsLinkWithArrowElement extends Components.DsLinkWithArrow, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLDsLinkWithArrowElementEventMap>(type: K, listener: (this: HTMLDsLinkWithArrowElement, ev: DsLinkWithArrowCustomEvent<HTMLDsLinkWithArrowElementEventMap[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 HTMLDsLinkWithArrowElementEventMap>(type: K, listener: (this: HTMLDsLinkWithArrowElement, ev: DsLinkWithArrowCustomEvent<HTMLDsLinkWithArrowElementEventMap[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 HTMLDsLinkWithArrowElement: {
         prototype: HTMLDsLinkWithArrowElement;
@@ -7621,6 +7735,7 @@ declare global {
         new (): HTMLDsRibbonElement;
     };
     interface HTMLDsSelectElementEventMap {
+        "dsMultipleChange": DsSelectMultipleChangeEvent;
         "dsChange": DsSelectChangeEvent;
         "dsSubmitInvalid": DsSubmitInvalidEvent;
         "dsValidity": DsValidityEvent;
@@ -8052,47 +8167,74 @@ declare global {
 declare namespace LocalJSX {
     interface DsAccordion {
         /**
-          * Aligns the border to the position where accordion content starts
+          * Passed to the `aria-describedby` attribute of the heading `button` element.
+         */
+        "dsAriaDescribedBy"?: string;
+        /**
+          * Passed to the `aria-labelledby` attribute of the heading `button` element. Should be set when `dsHeadingVariant` is `icon-button`.
+         */
+        "dsAriaLabelledBy"?: string;
+        /**
+          * If true, aligns the border to the position where accordion content starts. Use cases include side panels or sidebars to achieve better text alignment with other content.
           * @default false
          */
         "dsBorderAligned"?: boolean;
         /**
           * Text of the close button
-          * @default 'Close'
          */
         "dsCloseButtonLabel"?: string;
+        /**
+          * If true, adds a background color to the accordion content area
+          * @default true
+         */
+        "dsContentHasBackground"?: boolean;
         /**
           * Heading level to be used for the accordion
           * @default 2
          */
         "dsHeadingLevel"?: number;
         /**
-          * Removes the bottom border
+          * Heading variant of the accordion: - `button`: Heading button takes the full width of the header. The header content is inside the button. - `icon-button`: Heading button is styled as an icon button. The header content is separate from the button.
+          * @default 'button'
+         */
+        "dsHeadingVariant"?: 'button' | 'icon-button';
+        /**
+          * If true, removes the bottom border
           * @default false
          */
         "dsHideBottomBorder"?: boolean;
         /**
-          * Removes the top border
+          * If true, removes the left border
+          * @default true
+         */
+        "dsHideLeftBorder"?: boolean;
+        /**
+          * If true, removes the right border
+          * @default true
+         */
+        "dsHideRightBorder"?: boolean;
+        /**
+          * If true, removes the top border
           * @default false
          */
         "dsHideTopBorder"?: boolean;
         /**
           * Id of the accordion button
-          * @default 'dsaccordion'
+          * @default dsAccordionIdGenerator.next().value as string
          */
         "dsId"?: string;
         /**
-          * Displays the accordion as opened when loaded
+          * If true, displays the accordion as opened when loaded
           * @default false
          */
         "dsOpenByDefault"?: boolean;
         /**
-          * Displays a close button at the end of an opened accordion
+          * If true, displays a close button at the end of an opened accordion. Use cases include accordions with long content where scrolling back to the header to close the accordion would be inconvenient.
           * @default false
          */
         "dsUseCloseButton"?: boolean;
         /**
-          * Variant of the accordion
+          * Variant of the accordion: - `default`: Standard spacing and font sizes. - `compact`: Reduced spacing and font sizes, for denser display of content.
           * @default 'default'
          */
         "dsVariant"?: 'default' | 'compact';
@@ -8135,7 +8277,7 @@ declare namespace LocalJSX {
           * The variant style of the badge
           * @default 'default'
          */
-        "dsVariant"?: 'default' | 'success' | 'attention' | 'danger' | 'info' | 'notification' | 'primary';
+        "dsVariant"?: 'default' | 'success' | 'attention' | 'danger' | 'info' | 'notification' | 'primary' | 'disabled';
     }
     interface DsBreadcrumb {
         /**
@@ -8182,6 +8324,10 @@ declare namespace LocalJSX {
           * @default ''
          */
         "dsText"?: string;
+        /**
+          * Emitted when the link is clicked
+         */
+        "onDsClick"?: (event: DsBreadcrumbCustomEvent<MouseEvent>) => void;
         /**
           * Emitted when the `dsIsHidden` property changes
          */
@@ -8655,7 +8801,7 @@ declare namespace LocalJSX {
          */
         "dsName"?: string;
         /**
-          * Emitted when a chip in the group is clicked. Returns the index of the clicked chip.
+          * Emitted when a chip in the group is clicked. Returns the `dsValue` of the clicked chip.
          */
         "onDsChipClick"?: (event: DsChipGroupCustomEvent<DsChipClickEvent1>) => void;
         /**
@@ -8766,16 +8912,21 @@ declare namespace LocalJSX {
          */
         "dsRequired"?: boolean;
         /**
-          * The value of the selected option.  Set this property to programmatically select an option by its `dsValue`. Listen to the `dsChange` event to keep this property synchronized when users make selections.
+          * The value of the selected option.  Set this property to programmatically select an option by its `dsValue`. Listen to the `dsChange` or `dsMultipleChange` event (depending on the variant) to keep this property synchronized when users make selections.
           * @default null
          */
-        "dsValue"?: string | null;
+        "dsValue"?: string | string[] | null;
+        /**
+          * Defines the variant of the combobox: - "default": allows selection of a single option - "multiple": allows selection of multiple options
+          * @default 'default'
+         */
+        "dsVariant"?: 'default' | 'multiple';
         /**
           * Event emitted when the combobox loses focus.
          */
         "onDsBlur"?: (event: DsComboboxCustomEvent<DsComboboxBlurEvent>) => void;
         /**
-          * Event emitted when user selects an option.
+          * Event emitted when user selects an option. For "default" `dsVariant`.
          */
         "onDsChange"?: (event: DsComboboxCustomEvent<DsComboboxChangeEvent>) => void;
         /**
@@ -8786,6 +8937,10 @@ declare namespace LocalJSX {
           * Event emitted when the combobox gains focus.
          */
         "onDsFocus"?: (event: DsComboboxCustomEvent<DsComboboxFocusEvent>) => void;
+        /**
+          * Event emitted when user selects an option. For "multiple" `dsVariant`.
+         */
+        "onDsMultipleChange"?: (event: DsComboboxCustomEvent<DsComboboxMultipleChangeEvent>) => void;
         /**
           * Event emitted when selected option is removed.
          */
@@ -8980,10 +9135,10 @@ declare namespace LocalJSX {
          */
         "dsRole"?: string;
         /**
-          * Size of the icon
-          * @default '1.5rem'
+          * Icon size in positive REM units (e.g., '1rem', '1.5rem')
+          * @default this.defaultSize
          */
-        "dsSize"?: Size;
+        "dsSize"?: string;
         /**
           * Tooltip text for the icon. Should match the `dsAriaLabel`.
          */
@@ -12565,6 +12720,10 @@ declare namespace LocalJSX {
           * @default 'regular'
          */
         "dsWeight"?: LinkWeight;
+        /**
+          * Emitted when the link is clicked
+         */
+        "onDsClick"?: (event: DsLinkCustomEvent<MouseEvent>) => void;
     }
     interface DsLinkCta {
         /**
@@ -12611,6 +12770,10 @@ declare namespace LocalJSX {
           * @default 'primary'
          */
         "dsVariant"?: 'primary' | 'secondary';
+        /**
+          * Emitted when the link is clicked
+         */
+        "onDsClick"?: (event: DsLinkCtaCustomEvent<MouseEvent>) => void;
     }
     /**
      * Logo link component for displaying site logo and name.
@@ -12622,9 +12785,13 @@ declare namespace LocalJSX {
          */
         "dsColour"?: 'black' | 'white';
         /**
-          * URL where the logo link should navigate
+          * Passed to the `download` attribute of the `a` element
          */
-        "dsHref": string;
+        "dsDownload"?: boolean;
+        /**
+          * Passed to the `href` attribute of the `a` element
+         */
+        "dsHref"?: string;
         /**
           * Passed to the `hreflang` attribute of the `a` element
          */
@@ -12663,12 +12830,20 @@ declare namespace LocalJSX {
           * Site or application name text
          */
         "dsText"?: string;
+        /**
+          * Emitted when the link is clicked
+         */
+        "onDsClick"?: (event: DsLinkLogoCustomEvent<MouseEvent>) => void;
     }
     interface DsLinkWithArrow {
         /**
           * Passed to the `aria-label` attribute of the `a` element.
          */
         "dsAriaLabel"?: string;
+        /**
+          * Passed to the `download` attribute of the `a` element
+         */
+        "dsDownload"?: boolean;
         /**
           * If true, the link takes the full width of its container.
           * @default false
@@ -12709,6 +12884,10 @@ declare namespace LocalJSX {
           * Text content of the link
          */
         "dsText"?: string;
+        /**
+          * Emitted when the link is clicked
+         */
+        "onDsClick"?: (event: DsLinkWithArrowCustomEvent<MouseEvent>) => void;
     }
     interface DsMedia {
         /**
@@ -12797,7 +12976,7 @@ declare namespace LocalJSX {
           * Variant of the notification
           * @default 'neutral'
          */
-        "dsVariant"?: "success" | "info" | "attention" | "danger" | "neutral" | "neutralWhite";
+        "dsVariant"?: "success" | "attention" | "danger" | "info" | "neutral" | "neutralWhite";
         /**
           * Event emitted when user clicks the dismiss button.
          */
@@ -12851,6 +13030,11 @@ declare namespace LocalJSX {
           * Value of the option.
          */
         "dsValue": string;
+        /**
+          * Defines the appearance of the select component. Should match the `ds-variant` of the parent (`ds-select`, `ds-combobox`) component: - "default": Single selection appearance. - "multiple": Multiple selection appearance, resembling a combobox.
+          * @default 'default'
+         */
+        "dsVariant"?: 'default' | 'multiple';
         /**
           * `dsClick` event is emitted when the option is clicked.
          */
@@ -12890,8 +13074,13 @@ declare namespace LocalJSX {
           * @default 0
          */
         "dsActiveIndex"?: number;
+        /**
+          * Passed to the `aria-multiselectable` attribute of the `div` (listbox) element.
+         */
+        "dsAriaMultiselectable"?: boolean;
         /**
           * Unique `id` attribute of the options element.
+          * @default optionsIdGenerator.next().value as string
          */
         "dsId"?: string;
         /**
@@ -13230,24 +13419,28 @@ declare namespace LocalJSX {
           * The value of the selected option.
           * @default null
          */
-        "dsValue"?: string | null;
+        "dsValue"?: string | string[] | null;
         /**
-          * Defines the variant of the select component: - "default" uses a custom implementation - "native" uses the browser’s default select
+          * Defines the variant of the select component: - "default" uses a custom implementation that allows selection of a single option - "multiple" uses a custom implementation that allows selection of multiple options - "native" uses the browser’s default select
           * @default 'default'
          */
-        "dsVariant"?: 'default' | 'native';
+        "dsVariant"?: 'default' | 'multiple' | 'native';
         /**
           * Event emitted when the select loses focus.
          */
         "onDsBlur"?: (event: DsSelectCustomEvent<DsSelectBlurEvent>) => void;
         /**
-          * Event emitted when user selects an option.
+          * Event emitted when user selects an option. For "default" `dsVariant`.
          */
         "onDsChange"?: (event: DsSelectCustomEvent<DsSelectChangeEvent>) => void;
         /**
           * Event emitted when the select gains focus.
          */
         "onDsFocus"?: (event: DsSelectCustomEvent<DsSelectFocusEvent>) => void;
+        /**
+          * Event emitted when user selects an option. For "multiple" `dsVariant`.
+         */
+        "onDsMultipleChange"?: (event: DsSelectCustomEvent<DsSelectMultipleChangeEvent>) => void;
         /**
           * The `dsSubmitInvalid` event is emitted when the select is invalid when attempting to submit a form. Calling `checkValidity()` method will also emit this event if the select is invalid.
          */

package/dist/types/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const FEEDBACK_RESET_TIMEOUT = 3000;
 export declare const FEEDBACK_SET_TIMEOUT = 350;
+export declare const SCRIM_HEIGHT = 44;