@telesign/boreal-web-components 0.1.0-alpha.4 → 0.1.0-alpha.5

package/dist/types/components.d.ts

@@ -9,18 +9,26 @@ import { IAvatar } from "./components/images-icons/bds-avatar/types";
 import { IBadge } from "./components/feedback/bds-badge/types/IBadge";
 import { IBanner } from "./components/feedback/bds-banner/types/IBanner";
 import { IButton } from "./components/actions/bds-button/types/IButton";
+import { IButtonGroup } from "./components/actions/bds-button-group/types/IButtonGroup";
 import { CheckboxChangeDetail } from "./components/forms/bds-checkbox/types/ICheckbox";
+import { ICheckboxCard } from "./components/forms/bds-checkbox-card/types/ICheckboxCard";
 import { IDialog } from "./components/overlays/bds-dialog/types";
-import { IDivider } from "./components/helpers/types/IDivider";
+import { IDivider } from "./components/helpers/bds-divider/types/IDivider";
 import { IFlag } from "./components/forms/bds-flag/interfaces/IFlag";
 import { IGrid } from "./components/layouts/bds-grid/grid/types";
 import { IGridItem } from "./components/layouts/bds-grid/grid-item/types";
+import { IListMenu, ListMenuChangeDetail } from "./components/actions/bds-list-menu/bds-list-menu/types/IListMenu";
 import { IListMenuItem, IListMenuItemEvent } from "./components/actions/bds-list-menu/bds-list-menu-item/types/IListMenuItem";
 import { IPopover } from "./components/overlays/bds-popover/types/IPopover";
+import { RadioChangeDetail } from "./components/forms/bds-radio/types/IRadio";
+import { RadioButtonChangeDetail } from "./components/forms/bds-radio-button/types/IRadioButton";
+import { IRadioCard, RadioCardChangeDetail } from "./components/forms/bds-radio-card/types/IRadioCard";
+import { IFormValidator, Orientation } from "./types/index";
+import { RadioGroupType } from "./components/forms/bds-radio-group/types/types";
+import { RadioGroupChangeDetail } from "./components/forms/bds-radio-group/types/IRadioGroup";
 import { ISpinner } from "./components/feedback/bds-spinner/types/ISpinner";
 import { IStatus } from "./components/feedback/bds-status/types/IStatus";
 import { ITag, TagEventPayload } from "./components/feedback/bds-tag/types";
-import { IFormValidator } from "./types/index";
 import { TextFieldType, TextFieldValidationTiming, TextFieldVariant } from "./components/forms/bds-text-field/types";
 import { Event } from "./stencil-public-runtime";
 import { IToggle } from "./components/actions/bds-toggle/types";
@@ -32,18 +40,26 @@ export { IAvatar } from "./components/images-icons/bds-avatar/types";
 export { IBadge } from "./components/feedback/bds-badge/types/IBadge";
 export { IBanner } from "./components/feedback/bds-banner/types/IBanner";
 export { IButton } from "./components/actions/bds-button/types/IButton";
+export { IButtonGroup } from "./components/actions/bds-button-group/types/IButtonGroup";
 export { CheckboxChangeDetail } from "./components/forms/bds-checkbox/types/ICheckbox";
+export { ICheckboxCard } from "./components/forms/bds-checkbox-card/types/ICheckboxCard";
 export { IDialog } from "./components/overlays/bds-dialog/types";
-export { IDivider } from "./components/helpers/types/IDivider";
+export { IDivider } from "./components/helpers/bds-divider/types/IDivider";
 export { IFlag } from "./components/forms/bds-flag/interfaces/IFlag";
 export { IGrid } from "./components/layouts/bds-grid/grid/types";
 export { IGridItem } from "./components/layouts/bds-grid/grid-item/types";
+export { IListMenu, ListMenuChangeDetail } from "./components/actions/bds-list-menu/bds-list-menu/types/IListMenu";
 export { IListMenuItem, IListMenuItemEvent } from "./components/actions/bds-list-menu/bds-list-menu-item/types/IListMenuItem";
 export { IPopover } from "./components/overlays/bds-popover/types/IPopover";
+export { RadioChangeDetail } from "./components/forms/bds-radio/types/IRadio";
+export { RadioButtonChangeDetail } from "./components/forms/bds-radio-button/types/IRadioButton";
+export { IRadioCard, RadioCardChangeDetail } from "./components/forms/bds-radio-card/types/IRadioCard";
+export { IFormValidator, Orientation } from "./types/index";
+export { RadioGroupType } from "./components/forms/bds-radio-group/types/types";
+export { RadioGroupChangeDetail } from "./components/forms/bds-radio-group/types/IRadioGroup";
 export { ISpinner } from "./components/feedback/bds-spinner/types/ISpinner";
 export { IStatus } from "./components/feedback/bds-status/types/IStatus";
 export { ITag, TagEventPayload } from "./components/feedback/bds-tag/types";
-export { IFormValidator } from "./types/index";
 export { TextFieldType, TextFieldValidationTiming, TextFieldVariant } from "./components/forms/bds-text-field/types";
 export { Event } from "./stencil-public-runtime";
 export { IToggle } from "./components/actions/bds-toggle/types";
@@ -154,7 +170,7 @@ export namespace Components {
      * @attr {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
      * @attr {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
      * @attr {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-     * @attr {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+     * @attr {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
      * @attr {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
      * @attr {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
      * @property {string} label - The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.
@@ -163,13 +179,13 @@ export namespace Components {
      * @property {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
      * @property {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
      * @property {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-     * @property {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+     * @property {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
      * @property {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
      * @property {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
      * @default 'button' - Default type value
      * @default 'default' - Default color value
      * @default 'default' - Default variant value
-     * @default 'medium' - Default size value
+     * @default 'md' - Default size value
      * @default 'default' - Default status value
      * @default false - Default disabled value
      * @default '' - Default label value
@@ -209,7 +225,7 @@ export namespace Components {
          */
         "name": IButton['name'];
         /**
-          * size is a string attribute. The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+          * size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
           * @default BUTTON_SIZES.MEDIUM
          */
         "size": IButton['size'];
@@ -224,6 +240,36 @@ export namespace Components {
          */
         "variant": IButton['variant'];
     }
+    /**
+     * Button group component for grouping related buttons together in a unified visual unit.
+     */
+    interface BdsButtonGroup {
+        /**
+          * Controls the color applied to all child `<bds-button>` elements. Accepted values: see `CoreColors`. Default is `default`.
+          * @default CORE_COLORS.DEFAULT
+         */
+        "color": IButtonGroup['color'];
+        /**
+          * Provides an accessible label for the button group.
+          * @default 'Button group'
+         */
+        "label": IButtonGroup['label'];
+        /**
+          * Controls the layout direction of the grouped buttons. Accepted values: `'horizontal'`, `'vertical'`. Default is `'horizontal'`.
+          * @default ORIENTATIONS.HORIZONTAL
+         */
+        "orientation": IButtonGroup['orientation'];
+        /**
+          * Controls the size applied to all child `<bds-button>` elements. Accepted values: `'sm'`, `'md'`, `'lg'`. Default is `'md'`.
+          * @default BUTTON_SIZES.MEDIUM
+         */
+        "size": IButtonGroup['size'];
+        /**
+          * Controls the variant applied to all child `<bds-button>` elements. Accepted values: `'default'`, `'outline'`, `'plain'`. Default is `'default'`.
+          * @default BUTTON_VARIANTS.DEFAULT
+         */
+        "variant": IButtonGroup['variant'];
+    }
     /**
      * Checkbox component for boolean selection with three visual states.
      * @summary A checkbox form control with default, selected, and indeterminate states.
@@ -276,6 +322,63 @@ export namespace Components {
          */
         "value": string;
     }
+    /**
+     * Checkbox card component is a selectable card-based checkbox option.
+     * It presents a non-exclusive choice with optional descriptive text and icon,
+     * supporting checked, indeterminate, disabled, and error states.
+     * Can be used standalone or within a checkbox group for orchestration.
+     * @property {string}  name          - Name of the form control, submitted as a key in the form data.
+     * @property {boolean} disabled      - Disables the control. Defaults to `false`.
+     * @property {boolean} required      - Marks the control as required for form submission. Defaults to `false`.
+     * @property {string}  value         - Value submitted with the form data when checked. Defaults to `"on"`.
+     * @property {string}  label         - Label displayed next to the checkbox. If not provided, the default slot is used.
+     * @property {boolean} checked       - Whether the checkbox card is selected. Defaults to `false`.
+     * @property {boolean} indeterminate - Whether the checkbox card shows an indeterminate ("mixed") visual state. Defaults to `false`.
+     * @property {boolean} error         - Whether the checkbox card is in an error state. Defaults to `false`.
+     * @fires valueChange - Emitted when the checked state changes (for 2-way binding / v-model). Payload: `boolean`.
+     * @fires bdsChange   - Emitted when the user toggles the checkbox card. Payload: `{ checked: boolean, value: string }`.
+     */
+    interface BdsCheckboxCard {
+        /**
+          * Whether this checkbox card is selected.
+          * @default false
+         */
+        "checked": ICheckboxCard['checked'];
+        /**
+          * Disables the control.
+          * @default false
+         */
+        "disabled": ICheckboxCard['disabled'];
+        /**
+          * Whether the checkbox card is in an error state.
+          * @default false
+         */
+        "error": ICheckboxCard['error'];
+        /**
+          * Whether the checkbox card shows an indeterminate visual state.
+          * @default false
+         */
+        "indeterminate": ICheckboxCard['indeterminate'];
+        /**
+          * Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label": ICheckboxCard['label'];
+        /**
+          * Name of the form control, submitted as a key in the form data.
+         */
+        "name": ICheckboxCard['name'];
+        /**
+          * Marks the control as required for form submission.
+          * @default false
+         */
+        "required": ICheckboxCard['required'];
+        /**
+          * Value submitted with the form when this checkbox is selected.
+          * @default 'on'
+         */
+        "value": ICheckboxCard['value'];
+    }
     /**
      * Modal dialog component for displaying content in an overlay.
      * @summary Modal overlay for alerts, forms, and confirmations with customizable layout and behavior.
@@ -522,15 +625,10 @@ export namespace Components {
      * Container component that manages a list of menu items.
      * It handles selection logic (single/multiple) and maintains the data state.
      * @summary A list menu component that can contain multiple menu items and manage their selection state.
-     * @attr {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-     * @attr {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-     * @property {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-     * @property {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-     * @event bdsChange - Emitted when the selection changes, providing the current selected value(s).
+     * @fires bdsChange - Emitted when the selection changes, providing the current selected value(s).
+     * @fires bdsSelect - Emmited when item is selected in menu-role="menu" is clicked
      * @method getSelectedValues - Returns the currently selected value(s). If multiple is true, returns an array of strings; otherwise, returns a single string or undefined.
      * @method setSelectedValues - Sets the selected value(s). Accepts a string for single selection or an array of strings for multiple selection.
-     * @default false - By default, the menu does not allow multiple selections (single selection mode).
-     * @default 'menu' - The default ARIA role for the menu is 'menu'.
      */
     interface BdsListMenu {
         /**
@@ -541,14 +639,19 @@ export namespace Components {
         "getSelectedValues": () => Promise<string | string[]>;
         /**
           * Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-          * @default 'menu'
+          * @default MENU_ROLES.MENU
          */
-        "menuRole": 'menu' | 'listbox';
+        "menuRole": IListMenu['menuRole'];
         /**
-          * If true, allows multiple items to be selected. Default is false (single selection).
+          * Determines if the menu items have selectall/deselectall controls
           * @default false
          */
-        "multiple": boolean;
+        "selectControls": IListMenu['selectControls'];
+        /**
+          * The selection mode of the menu. Can be 'SINGLE' or 'MULTIPLE'. Default is 'SINGLE'.
+          * @default LIST_MENU_SELECTION_MODE.SINGLE
+         */
+        "selectionMode": IListMenu['selectionMode'];
         /**
           * Sets the selected values programmatically. Useful for initializing the menu from an external data source or form reset.
           * @method setSelectedValues
@@ -596,6 +699,11 @@ export namespace Components {
           * @default false
          */
         "activeItem": IListMenuItem['activeItem'];
+        /**
+          * Checkable state item, if is activated should be visible a checkbox
+          * @default false
+         */
+        "checkable": IListMenuItem['checkable'];
         /**
           * Disabled state item
           * @default false
@@ -682,6 +790,202 @@ export namespace Components {
          */
         "width"?: IPopover['width'];
     }
+    /**
+     * Radio button component for single-selection within a group.
+     * Use inside `bds-radio-group` for managed selection and form binding.
+     * Can also be used standalone with the `name`, `value`, and `checked` props.
+     */
+    interface BdsRadio {
+        /**
+          * Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.
+          * @default false
+         */
+        "checked": boolean;
+        /**
+          * Disables the radio, preventing interaction and selection.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Shows error styling on the radio indicator. Propagated by bds-radio-group.
+          * @default false
+         */
+        "error": boolean;
+        /**
+          * Tooltip text shown on an info icon next to the label.
+          * @default ''
+         */
+        "info": string;
+        /**
+          * Label text displayed next to the radio indicator. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label": string;
+        /**
+          * Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.
+          * @default ''
+         */
+        "name": string;
+        /**
+          * Value submitted with the form when this radio is selected.
+          * @default 'on'
+         */
+        "value": string;
+    }
+    /**
+     * Button-shaped radio option for use inside `bds-radio-group[type="radiobutton"]`.
+     * Creates a segmented control appearance when grouped. Not form-associated — the parent
+     * `bds-radio-group` owns form state and single-selection enforcement.
+     */
+    interface BdsRadioButton {
+        /**
+          * Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.
+          * @default false
+         */
+        "checked": boolean;
+        /**
+          * Disables the button, preventing interaction and selection.
+          * @default false
+         */
+        "disabled": boolean;
+        /**
+          * Shows error styling on the button. Propagated by bds-radio-group.
+          * @default false
+         */
+        "error": boolean;
+        /**
+          * Tooltip text shown on an info icon next to the label.
+          * @default ''
+         */
+        "info": string;
+        /**
+          * Label text displayed inside the button. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label": string;
+        /**
+          * Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.
+          * @default ''
+         */
+        "name": string;
+        /**
+          * Value submitted with the form when this button is selected.
+          * @default 'on'
+         */
+        "value": string;
+    }
+    /**
+     * Radio card component is a selectable card-based radio option.
+     * It presents a mutually exclusive choice with optional descriptive text and icon,
+     * designed for integration with bds-radio-group for orchestration.
+     * Can also be used standalone with the `name`, `value`, and `checked` props.
+     * @fires bdsChange - Emitted when the user selects this radio card. Listened to by the parent bds-radio-group to enforce single selection.
+     */
+    interface BdsRadioCard {
+        /**
+          * Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.
+          * @default false
+         */
+        "checked": IRadioCard['checked'];
+        /**
+          * Disables the radio card, preventing it from being selected and interacted with.
+          * @default false
+         */
+        "disabled": IRadioCard['disabled'];
+        /**
+          * Whether the radio card is in an error state.
+          * @default false
+         */
+        "error": IRadioCard['error'];
+        /**
+          * Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.
+          * @default ''
+         */
+        "info": IRadioCard['info'];
+        /**
+          * Label text displayed next to the radio indicator. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label": IRadioCard['label'];
+        /**
+          * Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.
+          * @default ''
+         */
+        "name": IRadioCard['name'];
+        /**
+          * Value submitted with the form when this radio is selected.
+          * @default 'on'
+         */
+        "value": IRadioCard['value'];
+    }
+    /**
+     * Radio group component that orchestrates single-selection across a set of `bds-radio` children.
+     */
+    interface BdsRadioGroup {
+        /**
+          * Returns whether the group's current value satisfies the browser's built-in constraint validation.
+         */
+        "checkValidity": () => Promise<boolean>;
+        /**
+          * Disables all child radios and prevents selection. Also mirrored to isDisabled
+          * @State for form-level disable support.
+          * @default false
+         */
+        "disabled": false;
+        /**
+          * Shows error styling on the group helper text. Propagated to all child radios.
+          * @default false
+         */
+        "error": false;
+        /**
+          * Error message rendered below the radio options when error is true. Replaces helperText.
+          * @default ''
+         */
+        "errorMessage": "";
+        /**
+          * Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.
+          * @default ''
+         */
+        "helperText": "";
+        /**
+          * Tooltip text shown on the group label info icon.
+          * @default ''
+         */
+        "info": "";
+        /**
+          * Group label rendered above the radio options.
+          * @default ''
+         */
+        "label": "";
+        /**
+          * Name of the form control; submitted as the field key in FormData.
+         */
+        "name": string;
+        /**
+          * Layout direction of the radio options.
+          * @default ORIENTATIONS.VERTICAL
+         */
+        "orientation": Orientation;
+        /**
+          * Reports the group's validity state to the user, showing native validation UI if invalid.
+         */
+        "reportValidity": () => Promise<boolean>;
+        /**
+          * Marks the group as required for form submission. Triggers validity error when no radio is selected.
+          * @default false
+         */
+        "required": false;
+        /**
+          * Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element.
+          * @default RADIO_GROUP_TYPES.RADIO
+         */
+        "type": RadioGroupType;
+        /**
+          * Currently selected radio value. Synced to children on change.
+          * @default ''
+         */
+        "value": string;
+    }
     /**
      * Spinner component used to indicate a loading or processing state.
      * @summary Displays an animated circular spinner to communicate that content is loading.
@@ -1172,6 +1476,10 @@ export interface BdsCheckboxCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBdsCheckboxElement;
 }
+export interface BdsCheckboxCardCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBdsCheckboxCardElement;
+}
 export interface BdsDialogCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBdsDialogElement;
@@ -1184,6 +1492,22 @@ export interface BdsListMenuItemCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBdsListMenuItemElement;
 }
+export interface BdsRadioCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBdsRadioElement;
+}
+export interface BdsRadioButtonCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBdsRadioButtonElement;
+}
+export interface BdsRadioCardCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBdsRadioCardElement;
+}
+export interface BdsRadioGroupCustomEvent<T> extends CustomEvent<T> {
+    detail: T;
+    target: HTMLBdsRadioGroupElement;
+}
 export interface BdsTagCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLBdsTagElement;
@@ -1272,7 +1596,7 @@ declare global {
      * @attr {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
      * @attr {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
      * @attr {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-     * @attr {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+     * @attr {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
      * @attr {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
      * @attr {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
      * @property {string} label - The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.
@@ -1281,13 +1605,13 @@ declare global {
      * @property {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
      * @property {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
      * @property {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-     * @property {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+     * @property {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
      * @property {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
      * @property {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
      * @default 'button' - Default type value
      * @default 'default' - Default color value
      * @default 'default' - Default variant value
-     * @default 'medium' - Default size value
+     * @default 'md' - Default size value
      * @default 'default' - Default status value
      * @default false - Default disabled value
      * @default '' - Default label value
@@ -1309,6 +1633,15 @@ declare global {
         prototype: HTMLBdsButtonElement;
         new (): HTMLBdsButtonElement;
     };
+    /**
+     * Button group component for grouping related buttons together in a unified visual unit.
+     */
+    interface HTMLBdsButtonGroupElement extends Components.BdsButtonGroup, HTMLStencilElement {
+    }
+    var HTMLBdsButtonGroupElement: {
+        prototype: HTMLBdsButtonGroupElement;
+        new (): HTMLBdsButtonGroupElement;
+    };
     interface HTMLBdsCheckboxElementEventMap {
         "valueChange": boolean;
         "bdsChange": CheckboxChangeDetail;
@@ -1338,6 +1671,40 @@ declare global {
         prototype: HTMLBdsCheckboxElement;
         new (): HTMLBdsCheckboxElement;
     };
+    interface HTMLBdsCheckboxCardElementEventMap {
+        "valueChange": any;
+        "bdsChange": any;
+    }
+    /**
+     * Checkbox card component is a selectable card-based checkbox option.
+     * It presents a non-exclusive choice with optional descriptive text and icon,
+     * supporting checked, indeterminate, disabled, and error states.
+     * Can be used standalone or within a checkbox group for orchestration.
+     * @property {string}  name          - Name of the form control, submitted as a key in the form data.
+     * @property {boolean} disabled      - Disables the control. Defaults to `false`.
+     * @property {boolean} required      - Marks the control as required for form submission. Defaults to `false`.
+     * @property {string}  value         - Value submitted with the form data when checked. Defaults to `"on"`.
+     * @property {string}  label         - Label displayed next to the checkbox. If not provided, the default slot is used.
+     * @property {boolean} checked       - Whether the checkbox card is selected. Defaults to `false`.
+     * @property {boolean} indeterminate - Whether the checkbox card shows an indeterminate ("mixed") visual state. Defaults to `false`.
+     * @property {boolean} error         - Whether the checkbox card is in an error state. Defaults to `false`.
+     * @fires valueChange - Emitted when the checked state changes (for 2-way binding / v-model). Payload: `boolean`.
+     * @fires bdsChange   - Emitted when the user toggles the checkbox card. Payload: `{ checked: boolean, value: string }`.
+     */
+    interface HTMLBdsCheckboxCardElement extends Components.BdsCheckboxCard, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBdsCheckboxCardElementEventMap>(type: K, listener: (this: HTMLBdsCheckboxCardElement, ev: BdsCheckboxCardCustomEvent<HTMLBdsCheckboxCardElementEventMap[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 HTMLBdsCheckboxCardElementEventMap>(type: K, listener: (this: HTMLBdsCheckboxCardElement, ev: BdsCheckboxCardCustomEvent<HTMLBdsCheckboxCardElementEventMap[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 HTMLBdsCheckboxCardElement: {
+        prototype: HTMLBdsCheckboxCardElement;
+        new (): HTMLBdsCheckboxCardElement;
+    };
     interface HTMLBdsDialogElementEventMap {
         "bdsOpen": void;
         "bdsClose": void;
@@ -1454,21 +1821,16 @@ declare global {
     };
     interface HTMLBdsListMenuElementEventMap {
         "bdsChange": string | string[];
-        "bdsClicked": HTMLElement;
+        "bdsSelect": ListMenuChangeDetail;
     }
     /**
      * Container component that manages a list of menu items.
      * It handles selection logic (single/multiple) and maintains the data state.
      * @summary A list menu component that can contain multiple menu items and manage their selection state.
-     * @attr {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-     * @attr {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-     * @property {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-     * @property {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-     * @event bdsChange - Emitted when the selection changes, providing the current selected value(s).
+     * @fires bdsChange - Emitted when the selection changes, providing the current selected value(s).
+     * @fires bdsSelect - Emmited when item is selected in menu-role="menu" is clicked
      * @method getSelectedValues - Returns the currently selected value(s). If multiple is true, returns an array of strings; otherwise, returns a single string or undefined.
      * @method setSelectedValues - Sets the selected value(s). Accepts a string for single selection or an array of strings for multiple selection.
-     * @default false - By default, the menu does not allow multiple selections (single selection mode).
-     * @default 'menu' - The default ARIA role for the menu is 'menu'.
      */
     interface HTMLBdsListMenuElement extends Components.BdsListMenu, HTMLStencilElement {
         addEventListener<K extends keyof HTMLBdsListMenuElementEventMap>(type: K, listener: (this: HTMLBdsListMenuElement, ev: BdsListMenuCustomEvent<HTMLBdsListMenuElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
@@ -1485,7 +1847,7 @@ declare global {
         new (): HTMLBdsListMenuElement;
     };
     interface HTMLBdsListMenuItemElementEventMap {
-        "bdsSelect": IListMenuItemEvent;
+        "bdsSelectItem": IListMenuItemEvent;
     }
     /**
      * Component representing an individual item within a list menu for navigations and selection.
@@ -1554,6 +1916,95 @@ declare global {
         prototype: HTMLBdsPopoverElement;
         new (): HTMLBdsPopoverElement;
     };
+    interface HTMLBdsRadioElementEventMap {
+        "bdsChange": RadioChangeDetail;
+    }
+    /**
+     * Radio button component for single-selection within a group.
+     * Use inside `bds-radio-group` for managed selection and form binding.
+     * Can also be used standalone with the `name`, `value`, and `checked` props.
+     */
+    interface HTMLBdsRadioElement extends Components.BdsRadio, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBdsRadioElementEventMap>(type: K, listener: (this: HTMLBdsRadioElement, ev: BdsRadioCustomEvent<HTMLBdsRadioElementEventMap[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 HTMLBdsRadioElementEventMap>(type: K, listener: (this: HTMLBdsRadioElement, ev: BdsRadioCustomEvent<HTMLBdsRadioElementEventMap[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 HTMLBdsRadioElement: {
+        prototype: HTMLBdsRadioElement;
+        new (): HTMLBdsRadioElement;
+    };
+    interface HTMLBdsRadioButtonElementEventMap {
+        "bdsChange": RadioButtonChangeDetail;
+    }
+    /**
+     * Button-shaped radio option for use inside `bds-radio-group[type="radiobutton"]`.
+     * Creates a segmented control appearance when grouped. Not form-associated — the parent
+     * `bds-radio-group` owns form state and single-selection enforcement.
+     */
+    interface HTMLBdsRadioButtonElement extends Components.BdsRadioButton, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBdsRadioButtonElementEventMap>(type: K, listener: (this: HTMLBdsRadioButtonElement, ev: BdsRadioButtonCustomEvent<HTMLBdsRadioButtonElementEventMap[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 HTMLBdsRadioButtonElementEventMap>(type: K, listener: (this: HTMLBdsRadioButtonElement, ev: BdsRadioButtonCustomEvent<HTMLBdsRadioButtonElementEventMap[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 HTMLBdsRadioButtonElement: {
+        prototype: HTMLBdsRadioButtonElement;
+        new (): HTMLBdsRadioButtonElement;
+    };
+    interface HTMLBdsRadioCardElementEventMap {
+        "bdsChange": RadioCardChangeDetail;
+    }
+    /**
+     * Radio card component is a selectable card-based radio option.
+     * It presents a mutually exclusive choice with optional descriptive text and icon,
+     * designed for integration with bds-radio-group for orchestration.
+     * Can also be used standalone with the `name`, `value`, and `checked` props.
+     * @fires bdsChange - Emitted when the user selects this radio card. Listened to by the parent bds-radio-group to enforce single selection.
+     */
+    interface HTMLBdsRadioCardElement extends Components.BdsRadioCard, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBdsRadioCardElementEventMap>(type: K, listener: (this: HTMLBdsRadioCardElement, ev: BdsRadioCardCustomEvent<HTMLBdsRadioCardElementEventMap[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 HTMLBdsRadioCardElementEventMap>(type: K, listener: (this: HTMLBdsRadioCardElement, ev: BdsRadioCardCustomEvent<HTMLBdsRadioCardElementEventMap[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 HTMLBdsRadioCardElement: {
+        prototype: HTMLBdsRadioCardElement;
+        new (): HTMLBdsRadioCardElement;
+    };
+    interface HTMLBdsRadioGroupElementEventMap {
+        "bdsChange": RadioGroupChangeDetail;
+        "valueChange": string;
+    }
+    /**
+     * Radio group component that orchestrates single-selection across a set of `bds-radio` children.
+     */
+    interface HTMLBdsRadioGroupElement extends Components.BdsRadioGroup, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLBdsRadioGroupElementEventMap>(type: K, listener: (this: HTMLBdsRadioGroupElement, ev: BdsRadioGroupCustomEvent<HTMLBdsRadioGroupElementEventMap[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 HTMLBdsRadioGroupElementEventMap>(type: K, listener: (this: HTMLBdsRadioGroupElement, ev: BdsRadioGroupCustomEvent<HTMLBdsRadioGroupElementEventMap[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 HTMLBdsRadioGroupElement: {
+        prototype: HTMLBdsRadioGroupElement;
+        new (): HTMLBdsRadioGroupElement;
+    };
     /**
      * Spinner component used to indicate a loading or processing state.
      * @summary Displays an animated circular spinner to communicate that content is loading.
@@ -1779,7 +2230,9 @@ declare global {
         "bds-badge": HTMLBdsBadgeElement;
         "bds-banner": HTMLBdsBannerElement;
         "bds-button": HTMLBdsButtonElement;
+        "bds-button-group": HTMLBdsButtonGroupElement;
         "bds-checkbox": HTMLBdsCheckboxElement;
+        "bds-checkbox-card": HTMLBdsCheckboxCardElement;
         "bds-dialog": HTMLBdsDialogElement;
         "bds-divider": HTMLBdsDividerElement;
         "bds-flag": HTMLBdsFlagElement;
@@ -1788,6 +2241,10 @@ declare global {
         "bds-list-menu": HTMLBdsListMenuElement;
         "bds-list-menu-item": HTMLBdsListMenuItemElement;
         "bds-popover": HTMLBdsPopoverElement;
+        "bds-radio": HTMLBdsRadioElement;
+        "bds-radio-button": HTMLBdsRadioButtonElement;
+        "bds-radio-card": HTMLBdsRadioCardElement;
+        "bds-radio-group": HTMLBdsRadioGroupElement;
         "bds-spinner": HTMLBdsSpinnerElement;
         "bds-status": HTMLBdsStatusElement;
         "bds-tag": HTMLBdsTagElement;
@@ -1898,7 +2355,7 @@ declare namespace LocalJSX {
      * @attr {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
      * @attr {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
      * @attr {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-     * @attr {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+     * @attr {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
      * @attr {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
      * @attr {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
      * @property {string} label - The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.
@@ -1907,13 +2364,13 @@ declare namespace LocalJSX {
      * @property {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
      * @property {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
      * @property {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-     * @property {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+     * @property {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
      * @property {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
      * @property {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
      * @default 'button' - Default type value
      * @default 'default' - Default color value
      * @default 'default' - Default variant value
-     * @default 'medium' - Default size value
+     * @default 'md' - Default size value
      * @default 'default' - Default status value
      * @default false - Default disabled value
      * @default '' - Default label value
@@ -1961,7 +2418,7 @@ declare namespace LocalJSX {
          */
         "onBdsClick"?: (event: BdsButtonCustomEvent<UIEvent>) => void;
         /**
-          * size is a string attribute. The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+          * size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
           * @default BUTTON_SIZES.MEDIUM
          */
         "size"?: IButton['size'];
@@ -1976,6 +2433,36 @@ declare namespace LocalJSX {
          */
         "variant"?: IButton['variant'];
     }
+    /**
+     * Button group component for grouping related buttons together in a unified visual unit.
+     */
+    interface BdsButtonGroup {
+        /**
+          * Controls the color applied to all child `<bds-button>` elements. Accepted values: see `CoreColors`. Default is `default`.
+          * @default CORE_COLORS.DEFAULT
+         */
+        "color"?: IButtonGroup['color'];
+        /**
+          * Provides an accessible label for the button group.
+          * @default 'Button group'
+         */
+        "label"?: IButtonGroup['label'];
+        /**
+          * Controls the layout direction of the grouped buttons. Accepted values: `'horizontal'`, `'vertical'`. Default is `'horizontal'`.
+          * @default ORIENTATIONS.HORIZONTAL
+         */
+        "orientation"?: IButtonGroup['orientation'];
+        /**
+          * Controls the size applied to all child `<bds-button>` elements. Accepted values: `'sm'`, `'md'`, `'lg'`. Default is `'md'`.
+          * @default BUTTON_SIZES.MEDIUM
+         */
+        "size"?: IButtonGroup['size'];
+        /**
+          * Controls the variant applied to all child `<bds-button>` elements. Accepted values: `'default'`, `'outline'`, `'plain'`. Default is `'default'`.
+          * @default BUTTON_VARIANTS.DEFAULT
+         */
+        "variant"?: IButtonGroup['variant'];
+    }
     /**
      * Checkbox component for boolean selection with three visual states.
      * @summary A checkbox form control with default, selected, and indeterminate states.
@@ -2040,6 +2527,75 @@ declare namespace LocalJSX {
          */
         "value"?: string;
     }
+    /**
+     * Checkbox card component is a selectable card-based checkbox option.
+     * It presents a non-exclusive choice with optional descriptive text and icon,
+     * supporting checked, indeterminate, disabled, and error states.
+     * Can be used standalone or within a checkbox group for orchestration.
+     * @property {string}  name          - Name of the form control, submitted as a key in the form data.
+     * @property {boolean} disabled      - Disables the control. Defaults to `false`.
+     * @property {boolean} required      - Marks the control as required for form submission. Defaults to `false`.
+     * @property {string}  value         - Value submitted with the form data when checked. Defaults to `"on"`.
+     * @property {string}  label         - Label displayed next to the checkbox. If not provided, the default slot is used.
+     * @property {boolean} checked       - Whether the checkbox card is selected. Defaults to `false`.
+     * @property {boolean} indeterminate - Whether the checkbox card shows an indeterminate ("mixed") visual state. Defaults to `false`.
+     * @property {boolean} error         - Whether the checkbox card is in an error state. Defaults to `false`.
+     * @fires valueChange - Emitted when the checked state changes (for 2-way binding / v-model). Payload: `boolean`.
+     * @fires bdsChange   - Emitted when the user toggles the checkbox card. Payload: `{ checked: boolean, value: string }`.
+     */
+    interface BdsCheckboxCard {
+        /**
+          * Whether this checkbox card is selected.
+          * @default false
+         */
+        "checked"?: ICheckboxCard['checked'];
+        /**
+          * Disables the control.
+          * @default false
+         */
+        "disabled"?: ICheckboxCard['disabled'];
+        /**
+          * Whether the checkbox card is in an error state.
+          * @default false
+         */
+        "error"?: ICheckboxCard['error'];
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * Whether the checkbox card shows an indeterminate visual state.
+          * @default false
+         */
+        "indeterminate"?: ICheckboxCard['indeterminate'];
+        /**
+          * Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label"?: ICheckboxCard['label'];
+        /**
+          * Name of the form control, submitted as a key in the form data.
+         */
+        "name": ICheckboxCard['name'];
+        /**
+          * Emitted when the user toggles this checkbox card.
+         */
+        "onBdsChange"?: (event: BdsCheckboxCardCustomEvent<any>) => void;
+        /**
+          * Emitted when the checked state changes. Useful for 2-way binding / v-model.
+         */
+        "onValueChange"?: (event: BdsCheckboxCardCustomEvent<any>) => void;
+        /**
+          * Marks the control as required for form submission.
+          * @default false
+         */
+        "required"?: ICheckboxCard['required'];
+        /**
+          * Value submitted with the form when this checkbox is selected.
+          * @default 'on'
+         */
+        "value"?: ICheckboxCard['value'];
+    }
     /**
      * Modal dialog component for displaying content in an overlay.
      * @summary Modal overlay for alerts, forms, and confirmations with customizable layout and behavior.
@@ -2290,27 +2846,17 @@ declare namespace LocalJSX {
      * Container component that manages a list of menu items.
      * It handles selection logic (single/multiple) and maintains the data state.
      * @summary A list menu component that can contain multiple menu items and manage their selection state.
-     * @attr {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-     * @attr {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-     * @property {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-     * @property {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-     * @event bdsChange - Emitted when the selection changes, providing the current selected value(s).
+     * @fires bdsChange - Emitted when the selection changes, providing the current selected value(s).
+     * @fires bdsSelect - Emmited when item is selected in menu-role="menu" is clicked
      * @method getSelectedValues - Returns the currently selected value(s). If multiple is true, returns an array of strings; otherwise, returns a single string or undefined.
      * @method setSelectedValues - Sets the selected value(s). Accepts a string for single selection or an array of strings for multiple selection.
-     * @default false - By default, the menu does not allow multiple selections (single selection mode).
-     * @default 'menu' - The default ARIA role for the menu is 'menu'.
      */
     interface BdsListMenu {
         /**
           * Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-          * @default 'menu'
-         */
-        "menuRole"?: 'menu' | 'listbox';
-        /**
-          * If true, allows multiple items to be selected. Default is false (single selection).
-          * @default false
+          * @default MENU_ROLES.MENU
          */
-        "multiple"?: boolean;
+        "menuRole"?: IListMenu['menuRole'];
         /**
           * Emitted when the selection changes, providing the current selected value(s).
          */
@@ -2318,7 +2864,17 @@ declare namespace LocalJSX {
         /**
           * Emitted when the selection changes, providing the current selected value(s).
          */
-        "onBdsClicked"?: (event: BdsListMenuCustomEvent<HTMLElement>) => void;
+        "onBdsSelect"?: (event: BdsListMenuCustomEvent<ListMenuChangeDetail>) => void;
+        /**
+          * Determines if the menu items have selectall/deselectall controls
+          * @default false
+         */
+        "selectControls"?: IListMenu['selectControls'];
+        /**
+          * The selection mode of the menu. Can be 'SINGLE' or 'MULTIPLE'. Default is 'SINGLE'.
+          * @default LIST_MENU_SELECTION_MODE.SINGLE
+         */
+        "selectionMode"?: IListMenu['selectionMode'];
     }
     /**
      * Component representing an individual item within a list menu for navigations and selection.
@@ -2360,6 +2916,11 @@ declare namespace LocalJSX {
           * @default false
          */
         "activeItem"?: IListMenuItem['activeItem'];
+        /**
+          * Checkable state item, if is activated should be visible a checkbox
+          * @default false
+         */
+        "checkable"?: IListMenuItem['checkable'];
         /**
           * Disabled state item
           * @default false
@@ -2388,7 +2949,7 @@ declare namespace LocalJSX {
         /**
           * Event handler for activation
          */
-        "onBdsSelect"?: (event: BdsListMenuItemCustomEvent<IListMenuItemEvent>) => void;
+        "onBdsSelectItem"?: (event: BdsListMenuItemCustomEvent<IListMenuItemEvent>) => void;
         /**
           * Selected item state
           * @default false
@@ -2450,6 +3011,218 @@ declare namespace LocalJSX {
          */
         "width"?: IPopover['width'];
     }
+    /**
+     * Radio button component for single-selection within a group.
+     * Use inside `bds-radio-group` for managed selection and form binding.
+     * Can also be used standalone with the `name`, `value`, and `checked` props.
+     */
+    interface BdsRadio {
+        /**
+          * Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.
+          * @default false
+         */
+        "checked"?: boolean;
+        /**
+          * Disables the radio, preventing interaction and selection.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Shows error styling on the radio indicator. Propagated by bds-radio-group.
+          * @default false
+         */
+        "error"?: boolean;
+        /**
+          * Tooltip text shown on an info icon next to the label.
+          * @default ''
+         */
+        "info"?: string;
+        /**
+          * Label text displayed next to the radio indicator. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label"?: string;
+        /**
+          * Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.
+          * @default ''
+         */
+        "name"?: string;
+        /**
+          * Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.
+         */
+        "onBdsChange"?: (event: BdsRadioCustomEvent<RadioChangeDetail>) => void;
+        /**
+          * Value submitted with the form when this radio is selected.
+          * @default 'on'
+         */
+        "value"?: string;
+    }
+    /**
+     * Button-shaped radio option for use inside `bds-radio-group[type="radiobutton"]`.
+     * Creates a segmented control appearance when grouped. Not form-associated — the parent
+     * `bds-radio-group` owns form state and single-selection enforcement.
+     */
+    interface BdsRadioButton {
+        /**
+          * Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.
+          * @default false
+         */
+        "checked"?: boolean;
+        /**
+          * Disables the button, preventing interaction and selection.
+          * @default false
+         */
+        "disabled"?: boolean;
+        /**
+          * Shows error styling on the button. Propagated by bds-radio-group.
+          * @default false
+         */
+        "error"?: boolean;
+        /**
+          * Tooltip text shown on an info icon next to the label.
+          * @default ''
+         */
+        "info"?: string;
+        /**
+          * Label text displayed inside the button. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label"?: string;
+        /**
+          * Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.
+          * @default ''
+         */
+        "name"?: string;
+        /**
+          * Emitted when the user selects this button. Listened to by the parent bds-radio-group to enforce single selection.
+         */
+        "onBdsChange"?: (event: BdsRadioButtonCustomEvent<RadioButtonChangeDetail>) => void;
+        /**
+          * Value submitted with the form when this button is selected.
+          * @default 'on'
+         */
+        "value"?: string;
+    }
+    /**
+     * Radio card component is a selectable card-based radio option.
+     * It presents a mutually exclusive choice with optional descriptive text and icon,
+     * designed for integration with bds-radio-group for orchestration.
+     * Can also be used standalone with the `name`, `value`, and `checked` props.
+     * @fires bdsChange - Emitted when the user selects this radio card. Listened to by the parent bds-radio-group to enforce single selection.
+     */
+    interface BdsRadioCard {
+        /**
+          * Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.
+          * @default false
+         */
+        "checked"?: IRadioCard['checked'];
+        /**
+          * Disables the radio card, preventing it from being selected and interacted with.
+          * @default false
+         */
+        "disabled"?: IRadioCard['disabled'];
+        /**
+          * Whether the radio card is in an error state.
+          * @default false
+         */
+        "error"?: IRadioCard['error'];
+        /**
+          * Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.
+          * @default ''
+         */
+        "info"?: IRadioCard['info'];
+        /**
+          * Label text displayed next to the radio indicator. Falls back to the default slot when empty.
+          * @default ''
+         */
+        "label"?: IRadioCard['label'];
+        /**
+          * Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.
+          * @default ''
+         */
+        "name"?: IRadioCard['name'];
+        /**
+          * Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.
+         */
+        "onBdsChange"?: (event: BdsRadioCardCustomEvent<RadioCardChangeDetail>) => void;
+        /**
+          * Value submitted with the form when this radio is selected.
+          * @default 'on'
+         */
+        "value"?: IRadioCard['value'];
+    }
+    /**
+     * Radio group component that orchestrates single-selection across a set of `bds-radio` children.
+     */
+    interface BdsRadioGroup {
+        /**
+          * Disables all child radios and prevents selection. Also mirrored to isDisabled
+          * @State for form-level disable support.
+          * @default false
+         */
+        "disabled"?: false;
+        /**
+          * Shows error styling on the group helper text. Propagated to all child radios.
+          * @default false
+         */
+        "error"?: false;
+        /**
+          * Error message rendered below the radio options when error is true. Replaces helperText.
+          * @default ''
+         */
+        "errorMessage"?: "";
+        /**
+          * The `id` of a `<form>` element to associate this element with.
+         */
+        "form"?: string;
+        /**
+          * Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.
+          * @default ''
+         */
+        "helperText"?: "";
+        /**
+          * Tooltip text shown on the group label info icon.
+          * @default ''
+         */
+        "info"?: "";
+        /**
+          * Group label rendered above the radio options.
+          * @default ''
+         */
+        "label"?: "";
+        /**
+          * Name of the form control; submitted as the field key in FormData.
+         */
+        "name": string;
+        /**
+          * Emitted when the selected radio changes. Payload includes the new value.
+         */
+        "onBdsChange"?: (event: BdsRadioGroupCustomEvent<RadioGroupChangeDetail>) => void;
+        /**
+          * Emitted when the selected radio changes. Used for v-model two-way binding in Vue.
+         */
+        "onValueChange"?: (event: BdsRadioGroupCustomEvent<string>) => void;
+        /**
+          * Layout direction of the radio options.
+          * @default ORIENTATIONS.VERTICAL
+         */
+        "orientation"?: Orientation;
+        /**
+          * Marks the group as required for form submission. Triggers validity error when no radio is selected.
+          * @default false
+         */
+        "required"?: false;
+        /**
+          * Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element.
+          * @default RADIO_GROUP_TYPES.RADIO
+         */
+        "type"?: RadioGroupType;
+        /**
+          * Currently selected radio value. Synced to children on change.
+          * @default ''
+         */
+        "value"?: string;
+    }
     /**
      * Spinner component used to indicate a loading or processing state.
      * @summary Displays an animated circular spinner to communicate that content is loading.
@@ -3004,6 +3777,13 @@ declare namespace LocalJSX {
         "loading": IButton['loading'];
         "disclosure": IButton['disclosure'];
     }
+    interface BdsButtonGroupAttributes {
+        "size": IButtonGroup['size'];
+        "orientation": IButtonGroup['orientation'];
+        "label": IButtonGroup['label'];
+        "color": IButtonGroup['color'];
+        "variant": IButtonGroup['variant'];
+    }
     interface BdsCheckboxAttributes {
         "name": string;
         "disabled": boolean;
@@ -3014,6 +3794,16 @@ declare namespace LocalJSX {
         "value": string;
         "label": string;
     }
+    interface BdsCheckboxCardAttributes {
+        "name": ICheckboxCard['name'];
+        "disabled": ICheckboxCard['disabled'];
+        "required": ICheckboxCard['required'];
+        "value": ICheckboxCard['value'];
+        "label": ICheckboxCard['label'];
+        "checked": ICheckboxCard['checked'];
+        "indeterminate": ICheckboxCard['indeterminate'];
+        "error": ICheckboxCard['error'];
+    }
     interface BdsDialogAttributes {
         "active": IDialog['active'];
         "preventClose": IDialog['preventClose'];
@@ -3056,8 +3846,9 @@ declare namespace LocalJSX {
         "offset": IGridItem['offset'];
     }
     interface BdsListMenuAttributes {
-        "multiple": boolean;
-        "menuRole": 'menu' | 'listbox';
+        "selectionMode": IListMenu['selectionMode'];
+        "menuRole": IListMenu['menuRole'];
+        "selectControls": IListMenu['selectControls'];
     }
     interface BdsListMenuItemAttributes {
         "variant": IListMenuItem['variant'];
@@ -3065,6 +3856,7 @@ declare namespace LocalJSX {
         "disabled": IListMenuItem['disabled'];
         "selected": IListMenuItem['selected'];
         "value": IListMenuItem['value'];
+        "checkable": IListMenuItem['checkable'];
         "activeItem": IListMenuItem['activeItem'];
         "href": IListMenuItem['href'];
         "newTab": IListMenuItem['newTab'];
@@ -3077,6 +3869,46 @@ declare namespace LocalJSX {
         "footer": boolean;
         "closable": boolean;
     }
+    interface BdsRadioAttributes {
+        "checked": boolean;
+        "disabled": boolean;
+        "value": string;
+        "name": string;
+        "label": string;
+        "error": boolean;
+        "info": string;
+    }
+    interface BdsRadioButtonAttributes {
+        "checked": boolean;
+        "disabled": boolean;
+        "error": boolean;
+        "value": string;
+        "name": string;
+        "label": string;
+        "info": string;
+    }
+    interface BdsRadioCardAttributes {
+        "value": IRadioCard['value'];
+        "info": IRadioCard['info'];
+        "name": IRadioCard['name'];
+        "label": IRadioCard['label'];
+        "checked": IRadioCard['checked'];
+        "disabled": IRadioCard['disabled'];
+        "error": IRadioCard['error'];
+    }
+    interface BdsRadioGroupAttributes {
+        "disabled": false;
+        "error": false;
+        "errorMessage": "";
+        "helperText": "";
+        "info": "";
+        "label": "";
+        "name": string;
+        "orientation": Orientation;
+        "required": false;
+        "type": RadioGroupType;
+        "value": string;
+    }
     interface BdsSpinnerAttributes {
         "size": ISpinner['size'];
         "label": ISpinner['label'];
@@ -3160,7 +3992,9 @@ declare namespace LocalJSX {
         "bds-badge": Omit<BdsBadge, keyof BdsBadgeAttributes> & { [K in keyof BdsBadge & keyof BdsBadgeAttributes]?: BdsBadge[K] } & { [K in keyof BdsBadge & keyof BdsBadgeAttributes as `attr:${K}`]?: BdsBadgeAttributes[K] } & { [K in keyof BdsBadge & keyof BdsBadgeAttributes as `prop:${K}`]?: BdsBadge[K] };
         "bds-banner": Omit<BdsBanner, keyof BdsBannerAttributes> & { [K in keyof BdsBanner & keyof BdsBannerAttributes]?: BdsBanner[K] } & { [K in keyof BdsBanner & keyof BdsBannerAttributes as `attr:${K}`]?: BdsBannerAttributes[K] } & { [K in keyof BdsBanner & keyof BdsBannerAttributes as `prop:${K}`]?: BdsBanner[K] };
         "bds-button": Omit<BdsButton, keyof BdsButtonAttributes> & { [K in keyof BdsButton & keyof BdsButtonAttributes]?: BdsButton[K] } & { [K in keyof BdsButton & keyof BdsButtonAttributes as `attr:${K}`]?: BdsButtonAttributes[K] } & { [K in keyof BdsButton & keyof BdsButtonAttributes as `prop:${K}`]?: BdsButton[K] };
+        "bds-button-group": Omit<BdsButtonGroup, keyof BdsButtonGroupAttributes> & { [K in keyof BdsButtonGroup & keyof BdsButtonGroupAttributes]?: BdsButtonGroup[K] } & { [K in keyof BdsButtonGroup & keyof BdsButtonGroupAttributes as `attr:${K}`]?: BdsButtonGroupAttributes[K] } & { [K in keyof BdsButtonGroup & keyof BdsButtonGroupAttributes as `prop:${K}`]?: BdsButtonGroup[K] };
         "bds-checkbox": Omit<BdsCheckbox, keyof BdsCheckboxAttributes> & { [K in keyof BdsCheckbox & keyof BdsCheckboxAttributes]?: BdsCheckbox[K] } & { [K in keyof BdsCheckbox & keyof BdsCheckboxAttributes as `attr:${K}`]?: BdsCheckboxAttributes[K] } & { [K in keyof BdsCheckbox & keyof BdsCheckboxAttributes as `prop:${K}`]?: BdsCheckbox[K] } & OneOf<"name", BdsCheckbox["name"], BdsCheckboxAttributes["name"]>;
+        "bds-checkbox-card": Omit<BdsCheckboxCard, keyof BdsCheckboxCardAttributes> & { [K in keyof BdsCheckboxCard & keyof BdsCheckboxCardAttributes]?: BdsCheckboxCard[K] } & { [K in keyof BdsCheckboxCard & keyof BdsCheckboxCardAttributes as `attr:${K}`]?: BdsCheckboxCardAttributes[K] } & { [K in keyof BdsCheckboxCard & keyof BdsCheckboxCardAttributes as `prop:${K}`]?: BdsCheckboxCard[K] } & OneOf<"name", BdsCheckboxCard["name"], BdsCheckboxCardAttributes["name"]>;
         "bds-dialog": Omit<BdsDialog, keyof BdsDialogAttributes> & { [K in keyof BdsDialog & keyof BdsDialogAttributes]?: BdsDialog[K] } & { [K in keyof BdsDialog & keyof BdsDialogAttributes as `attr:${K}`]?: BdsDialogAttributes[K] } & { [K in keyof BdsDialog & keyof BdsDialogAttributes as `prop:${K}`]?: BdsDialog[K] };
         "bds-divider": Omit<BdsDivider, keyof BdsDividerAttributes> & { [K in keyof BdsDivider & keyof BdsDividerAttributes]?: BdsDivider[K] } & { [K in keyof BdsDivider & keyof BdsDividerAttributes as `attr:${K}`]?: BdsDividerAttributes[K] } & { [K in keyof BdsDivider & keyof BdsDividerAttributes as `prop:${K}`]?: BdsDivider[K] };
         "bds-flag": Omit<BdsFlag, keyof BdsFlagAttributes> & { [K in keyof BdsFlag & keyof BdsFlagAttributes]?: BdsFlag[K] } & { [K in keyof BdsFlag & keyof BdsFlagAttributes as `attr:${K}`]?: BdsFlagAttributes[K] } & { [K in keyof BdsFlag & keyof BdsFlagAttributes as `prop:${K}`]?: BdsFlag[K] };
@@ -3169,6 +4003,10 @@ declare namespace LocalJSX {
         "bds-list-menu": Omit<BdsListMenu, keyof BdsListMenuAttributes> & { [K in keyof BdsListMenu & keyof BdsListMenuAttributes]?: BdsListMenu[K] } & { [K in keyof BdsListMenu & keyof BdsListMenuAttributes as `attr:${K}`]?: BdsListMenuAttributes[K] } & { [K in keyof BdsListMenu & keyof BdsListMenuAttributes as `prop:${K}`]?: BdsListMenu[K] };
         "bds-list-menu-item": Omit<BdsListMenuItem, keyof BdsListMenuItemAttributes> & { [K in keyof BdsListMenuItem & keyof BdsListMenuItemAttributes]?: BdsListMenuItem[K] } & { [K in keyof BdsListMenuItem & keyof BdsListMenuItemAttributes as `attr:${K}`]?: BdsListMenuItemAttributes[K] } & { [K in keyof BdsListMenuItem & keyof BdsListMenuItemAttributes as `prop:${K}`]?: BdsListMenuItem[K] };
         "bds-popover": Omit<BdsPopover, keyof BdsPopoverAttributes> & { [K in keyof BdsPopover & keyof BdsPopoverAttributes]?: BdsPopover[K] } & { [K in keyof BdsPopover & keyof BdsPopoverAttributes as `attr:${K}`]?: BdsPopoverAttributes[K] } & { [K in keyof BdsPopover & keyof BdsPopoverAttributes as `prop:${K}`]?: BdsPopover[K] };
+        "bds-radio": Omit<BdsRadio, keyof BdsRadioAttributes> & { [K in keyof BdsRadio & keyof BdsRadioAttributes]?: BdsRadio[K] } & { [K in keyof BdsRadio & keyof BdsRadioAttributes as `attr:${K}`]?: BdsRadioAttributes[K] } & { [K in keyof BdsRadio & keyof BdsRadioAttributes as `prop:${K}`]?: BdsRadio[K] };
+        "bds-radio-button": Omit<BdsRadioButton, keyof BdsRadioButtonAttributes> & { [K in keyof BdsRadioButton & keyof BdsRadioButtonAttributes]?: BdsRadioButton[K] } & { [K in keyof BdsRadioButton & keyof BdsRadioButtonAttributes as `attr:${K}`]?: BdsRadioButtonAttributes[K] } & { [K in keyof BdsRadioButton & keyof BdsRadioButtonAttributes as `prop:${K}`]?: BdsRadioButton[K] };
+        "bds-radio-card": Omit<BdsRadioCard, keyof BdsRadioCardAttributes> & { [K in keyof BdsRadioCard & keyof BdsRadioCardAttributes]?: BdsRadioCard[K] } & { [K in keyof BdsRadioCard & keyof BdsRadioCardAttributes as `attr:${K}`]?: BdsRadioCardAttributes[K] } & { [K in keyof BdsRadioCard & keyof BdsRadioCardAttributes as `prop:${K}`]?: BdsRadioCard[K] };
+        "bds-radio-group": Omit<BdsRadioGroup, keyof BdsRadioGroupAttributes> & { [K in keyof BdsRadioGroup & keyof BdsRadioGroupAttributes]?: BdsRadioGroup[K] } & { [K in keyof BdsRadioGroup & keyof BdsRadioGroupAttributes as `attr:${K}`]?: BdsRadioGroupAttributes[K] } & { [K in keyof BdsRadioGroup & keyof BdsRadioGroupAttributes as `prop:${K}`]?: BdsRadioGroup[K] } & OneOf<"name", BdsRadioGroup["name"], BdsRadioGroupAttributes["name"]>;
         "bds-spinner": Omit<BdsSpinner, keyof BdsSpinnerAttributes> & { [K in keyof BdsSpinner & keyof BdsSpinnerAttributes]?: BdsSpinner[K] } & { [K in keyof BdsSpinner & keyof BdsSpinnerAttributes as `attr:${K}`]?: BdsSpinnerAttributes[K] } & { [K in keyof BdsSpinner & keyof BdsSpinnerAttributes as `prop:${K}`]?: BdsSpinner[K] };
         "bds-status": Omit<BdsStatus, keyof BdsStatusAttributes> & { [K in keyof BdsStatus & keyof BdsStatusAttributes]?: BdsStatus[K] } & { [K in keyof BdsStatus & keyof BdsStatusAttributes as `attr:${K}`]?: BdsStatusAttributes[K] } & { [K in keyof BdsStatus & keyof BdsStatusAttributes as `prop:${K}`]?: BdsStatus[K] };
         "bds-tag": Omit<BdsTag, keyof BdsTagAttributes> & { [K in keyof BdsTag & keyof BdsTagAttributes]?: BdsTag[K] } & { [K in keyof BdsTag & keyof BdsTagAttributes as `attr:${K}`]?: BdsTagAttributes[K] } & { [K in keyof BdsTag & keyof BdsTagAttributes as `prop:${K}`]?: BdsTag[K] };
@@ -3228,7 +4066,7 @@ declare module "@stencil/core" {
              * @attr {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
              * @attr {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
              * @attr {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-             * @attr {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+             * @attr {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
              * @attr {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
              * @attr {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
              * @property {string} label - The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.
@@ -3237,13 +4075,13 @@ declare module "@stencil/core" {
              * @property {string} type - The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.
              * @property {string} color - The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.
              * @property {string} variant - The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.
-             * @property {string} size - The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.
+             * @property {string} size - The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.
              * @property {boolean} loading - Indicates whether the button is in a loading state, which can be used to show a loading spinner and disable the button. Default is false.
              * @property {boolean} disclosure - Indicates if the button should show a chevron down at the end of the content.
              * @default 'button' - Default type value
              * @default 'default' - Default color value
              * @default 'default' - Default variant value
-             * @default 'medium' - Default size value
+             * @default 'md' - Default size value
              * @default 'default' - Default status value
              * @default false - Default disabled value
              * @default '' - Default label value
@@ -3252,6 +4090,10 @@ declare module "@stencil/core" {
              * @default false - Default disclosure value
              */
             "bds-button": LocalJSX.IntrinsicElements["bds-button"] & JSXBase.HTMLAttributes<HTMLBdsButtonElement>;
+            /**
+             * Button group component for grouping related buttons together in a unified visual unit.
+             */
+            "bds-button-group": LocalJSX.IntrinsicElements["bds-button-group"] & JSXBase.HTMLAttributes<HTMLBdsButtonGroupElement>;
             /**
              * Checkbox component for boolean selection with three visual states.
              * @summary A checkbox form control with default, selected, and indeterminate states.
@@ -3264,6 +4106,23 @@ declare module "@stencil/core" {
              * @fires bdsChange - Emitted when the user toggles the checkbox. Payload: `{ checked: boolean, value: string }`.
              */
             "bds-checkbox": LocalJSX.IntrinsicElements["bds-checkbox"] & JSXBase.HTMLAttributes<HTMLBdsCheckboxElement>;
+            /**
+             * Checkbox card component is a selectable card-based checkbox option.
+             * It presents a non-exclusive choice with optional descriptive text and icon,
+             * supporting checked, indeterminate, disabled, and error states.
+             * Can be used standalone or within a checkbox group for orchestration.
+             * @property {string}  name          - Name of the form control, submitted as a key in the form data.
+             * @property {boolean} disabled      - Disables the control. Defaults to `false`.
+             * @property {boolean} required      - Marks the control as required for form submission. Defaults to `false`.
+             * @property {string}  value         - Value submitted with the form data when checked. Defaults to `"on"`.
+             * @property {string}  label         - Label displayed next to the checkbox. If not provided, the default slot is used.
+             * @property {boolean} checked       - Whether the checkbox card is selected. Defaults to `false`.
+             * @property {boolean} indeterminate - Whether the checkbox card shows an indeterminate ("mixed") visual state. Defaults to `false`.
+             * @property {boolean} error         - Whether the checkbox card is in an error state. Defaults to `false`.
+             * @fires valueChange - Emitted when the checked state changes (for 2-way binding / v-model). Payload: `boolean`.
+             * @fires bdsChange   - Emitted when the user toggles the checkbox card. Payload: `{ checked: boolean, value: string }`.
+             */
+            "bds-checkbox-card": LocalJSX.IntrinsicElements["bds-checkbox-card"] & JSXBase.HTMLAttributes<HTMLBdsCheckboxCardElement>;
             /**
              * Modal dialog component for displaying content in an overlay.
              * @summary Modal overlay for alerts, forms, and confirmations with customizable layout and behavior.
@@ -3344,15 +4203,10 @@ declare module "@stencil/core" {
              * Container component that manages a list of menu items.
              * It handles selection logic (single/multiple) and maintains the data state.
              * @summary A list menu component that can contain multiple menu items and manage their selection state.
-             * @attr {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-             * @attr {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-             * @property {boolean} multiple - If true, allows multiple items to be selected. Default is false (single selection).
-             * @property {string} menuRole - Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.
-             * @event bdsChange - Emitted when the selection changes, providing the current selected value(s).
+             * @fires bdsChange - Emitted when the selection changes, providing the current selected value(s).
+             * @fires bdsSelect - Emmited when item is selected in menu-role="menu" is clicked
              * @method getSelectedValues - Returns the currently selected value(s). If multiple is true, returns an array of strings; otherwise, returns a single string or undefined.
              * @method setSelectedValues - Sets the selected value(s). Accepts a string for single selection or an array of strings for multiple selection.
-             * @default false - By default, the menu does not allow multiple selections (single selection mode).
-             * @default 'menu' - The default ARIA role for the menu is 'menu'.
              */
             "bds-list-menu": LocalJSX.IntrinsicElements["bds-list-menu"] & JSXBase.HTMLAttributes<HTMLBdsListMenuElement>;
             /**
@@ -3404,6 +4258,30 @@ declare module "@stencil/core" {
              * @cssprop data-hidearrow - Reflects the hideArrow option.
              */
             "bds-popover": LocalJSX.IntrinsicElements["bds-popover"] & JSXBase.HTMLAttributes<HTMLBdsPopoverElement>;
+            /**
+             * Radio button component for single-selection within a group.
+             * Use inside `bds-radio-group` for managed selection and form binding.
+             * Can also be used standalone with the `name`, `value`, and `checked` props.
+             */
+            "bds-radio": LocalJSX.IntrinsicElements["bds-radio"] & JSXBase.HTMLAttributes<HTMLBdsRadioElement>;
+            /**
+             * Button-shaped radio option for use inside `bds-radio-group[type="radiobutton"]`.
+             * Creates a segmented control appearance when grouped. Not form-associated — the parent
+             * `bds-radio-group` owns form state and single-selection enforcement.
+             */
+            "bds-radio-button": LocalJSX.IntrinsicElements["bds-radio-button"] & JSXBase.HTMLAttributes<HTMLBdsRadioButtonElement>;
+            /**
+             * Radio card component is a selectable card-based radio option.
+             * It presents a mutually exclusive choice with optional descriptive text and icon,
+             * designed for integration with bds-radio-group for orchestration.
+             * Can also be used standalone with the `name`, `value`, and `checked` props.
+             * @fires bdsChange - Emitted when the user selects this radio card. Listened to by the parent bds-radio-group to enforce single selection.
+             */
+            "bds-radio-card": LocalJSX.IntrinsicElements["bds-radio-card"] & JSXBase.HTMLAttributes<HTMLBdsRadioCardElement>;
+            /**
+             * Radio group component that orchestrates single-selection across a set of `bds-radio` children.
+             */
+            "bds-radio-group": LocalJSX.IntrinsicElements["bds-radio-group"] & JSXBase.HTMLAttributes<HTMLBdsRadioGroupElement>;
             /**
              * Spinner component used to indicate a loading or processing state.
              * @summary Displays an animated circular spinner to communicate that content is loading.