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

package/custom-elements.json

@@ -441,6 +441,398 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/navigation/bds-breadcrumb/bds-breadcrumb.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-breadcrumb",
+          "name": "BdsBreadcrumb",
+          "attributes": [
+            {
+              "name": "items-after-collapse",
+              "description": "Number of items visible at the end after collapse occurs.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "fieldName": "itemsAfterCollapse"
+            },
+            {
+              "name": "items-before-collapse",
+              "description": "Number of items visible at the start before collapse occurs.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "fieldName": "itemsBeforeCollapse"
+            },
+            {
+              "name": "max-items",
+              "description": "Maximum number of breadcrumb items visible before collapsing.\nIf set to 0 or undefined, no collapsing is applied.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "maxItems"
+            },
+            {
+              "name": "separator",
+              "description": "Separator rendered between breadcrumb items.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'/'",
+              "fieldName": "separator"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "itemsAfterCollapse",
+              "description": "Number of items visible at the end after collapse occurs.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "readonly": true,
+              "attribute": "items-after-collapse"
+            },
+            {
+              "kind": "field",
+              "name": "itemsBeforeCollapse",
+              "description": "Number of items visible at the start before collapse occurs.",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "readonly": true,
+              "attribute": "items-before-collapse"
+            },
+            {
+              "kind": "field",
+              "name": "maxItems",
+              "description": "Maximum number of breadcrumb items visible before collapsing.\nIf set to 0 or undefined, no collapsing is applied.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "readonly": true,
+              "attribute": "max-items"
+            },
+            {
+              "kind": "field",
+              "name": "separator",
+              "description": "Separator rendered between breadcrumb items.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'/'",
+              "readonly": true,
+              "attribute": "separator"
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsClickBreadcrumb",
+              "description": "Emitted when a breadcrumb item is clicked.",
+              "type": {
+                "text": "CustomEvent<{ element: HTMLElement; index?: number; href?: string; router?: boolean; }>",
+                "references": [
+                  {
+                    "name": "BdsClickBreadcrumbEvent",
+                    "module": "./types/IBreadcrumb"
+                  }
+                ]
+              }
+            },
+            {
+              "name": "bdsClickCollapsed",
+              "description": "Emitted when the collapse indicator (\"...\") is clicked.\nReturns a reference to the clicked element and the list of collapsed breadcrumb items.",
+              "type": {
+                "text": "CustomEvent<{ element: HTMLElement; collapsedBreadcrumbs: HTMLBdsBreadcrumbItemElement[]; }>",
+                "references": [
+                  {
+                    "name": "BdsClickCollapsedEvent",
+                    "module": "./types/IBreadcrumb"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The content of the bds-breadcrumb group. It's meant for multiple `<bds-breadcrumb-item>` elements."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsBreadcrumb",
+          "declaration": {
+            "name": "BdsBreadcrumb"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-breadcrumb",
+          "declaration": {
+            "name": "BdsBreadcrumb"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/navigation/bds-breadcrumb-item/bds-breadcrumb-item.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-breadcrumb-item",
+          "name": "BdsBreadcrumbItem",
+          "attributes": [
+            {
+              "name": "active",
+              "description": "Marks this breadcrumb item as the current page.\n\nWhen true, the item is non-interactive and has aria-current=\"page\".",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "active"
+            },
+            {
+              "name": "collapsed",
+              "description": "Internal prop controlled by the parent breadcrumb.\nIndicates that this item is part of a collapsed range.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "collapsed"
+            },
+            {
+              "name": "downloadable",
+              "description": "Enables download behavior for the link.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "downloadable"
+            },
+            {
+              "name": "filename",
+              "description": "Suggested filename for the downloaded file.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'filename'",
+              "fieldName": "filename"
+            },
+            {
+              "name": "href",
+              "description": "URL for the breadcrumb link.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "href"
+            },
+            {
+              "name": "rel",
+              "description": "Relationship between the current document and the linked resource.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "rel"
+            },
+            {
+              "name": "router",
+              "description": "Enables router-based navigation instead of native link navigation.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "router"
+            },
+            {
+              "name": "show-collapse",
+              "description": "Internal prop controlled by the parent breadcrumb.\nRenders the collapse indicator (\"...\") for hidden items.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "showCollapse"
+            },
+            {
+              "name": "target",
+              "description": "Specifies where to open the linked document.",
+              "type": {
+                "text": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\""
+              },
+              "default": "'_self'",
+              "fieldName": "target"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "active",
+              "description": "Marks this breadcrumb item as the current page.\n\nWhen true, the item is non-interactive and has aria-current=\"page\".",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "active"
+            },
+            {
+              "kind": "field",
+              "name": "collapsed",
+              "description": "Internal prop controlled by the parent breadcrumb.\nIndicates that this item is part of a collapsed range.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "collapsed"
+            },
+            {
+              "kind": "field",
+              "name": "downloadable",
+              "description": "Enables download behavior for the link.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "downloadable"
+            },
+            {
+              "kind": "field",
+              "name": "filename",
+              "description": "Suggested filename for the downloaded file.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'filename'",
+              "readonly": true,
+              "attribute": "filename"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "description": "URL for the breadcrumb link.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "rel",
+              "description": "Relationship between the current document and the linked resource.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "rel"
+            },
+            {
+              "kind": "field",
+              "name": "router",
+              "description": "Enables router-based navigation instead of native link navigation.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "router"
+            },
+            {
+              "kind": "field",
+              "name": "showCollapse",
+              "description": "Internal prop controlled by the parent breadcrumb.\nRenders the collapse indicator (\"...\") for hidden items.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "show-collapse"
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "description": "Specifies where to open the linked document.",
+              "type": {
+                "text": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\""
+              },
+              "default": "'_self'",
+              "readonly": true,
+              "attribute": "target"
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsClick",
+              "description": "Emitted when a breadcrumb item is clicked.",
+              "type": {
+                "text": "CustomEvent<{ element: HTMLBdsBreadcrumbItemElement; href?: string; router: boolean; }>",
+                "references": [
+                  {
+                    "name": "BdsClickItemEvent",
+                    "module": "./types/IBreadcrumbItem"
+                  }
+                ]
+              }
+            },
+            {
+              "name": "bdsClickCollapse",
+              "description": "Emitted when the collapse indicator (\"...\") is activated.",
+              "type": {
+                "text": "CustomEvent<{ element: HTMLElement; }>",
+                "references": [
+                  {
+                    "name": "BdsClickCollapseEvent",
+                    "module": "./types/IBreadcrumbItem"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The text content of the breadcrumb item, can include simple text or text with icons."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsBreadcrumbItem",
+          "declaration": {
+            "name": "BdsBreadcrumbItem"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-breadcrumb-item",
+          "declaration": {
+            "name": "BdsBreadcrumbItem"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/actions/bds-button/bds-button.tsx",
@@ -465,9 +857,149 @@
                 ]
               },
               "default": "CORE_COLORS.DEFAULT",
-              "fieldName": "color"
+              "fieldName": "color"
+            },
+            {
+              "name": "disabled",
+              "description": "disabled is a boolean attribute. Disables the button when true, preventing user interaction and applying disabled styles.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "disclosure",
+              "description": "disclosure is a boolean attribute. Used to show a chevron down at the of the content",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disclosure"
+            },
+            {
+              "name": "label",
+              "description": "The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "loading",
+              "description": "loading is a boolean attribute. 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.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "loading"
+            },
+            {
+              "name": "name",
+              "description": "name is a string attribute. The name attribute for the button, useful for form submissions.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "name"
+            },
+            {
+              "name": "size",
+              "description": "size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "BUTTON_SIZES.MEDIUM",
+              "fieldName": "size"
+            },
+            {
+              "name": "type",
+              "description": "type is a string attribute. The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.",
+              "type": {
+                "text": "\"button\" | \"reset\" | \"submit\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "BUTTON_TYPES.BUTTON",
+              "fieldName": "type"
+            },
+            {
+              "name": "variant",
+              "description": "variant is a string attribute. The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.",
+              "type": {
+                "text": "\"default\" | \"outline\" | \"plain\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "BUTTON_VARIANTS.DEFAULT",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "color",
+              "description": "color is a string attribute. The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.",
+              "type": {
+                "text": "\"default\" | \"error\" | \"primary\" | \"success\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "CORE_COLORS.DEFAULT",
+              "readonly": true,
+              "attribute": "color"
             },
             {
+              "kind": "field",
               "name": "disabled",
               "description": "disabled is a boolean attribute. Disables the button when true, preventing user interaction and applying disabled styles.",
               "type": {
@@ -480,9 +1012,11 @@
                 ]
               },
               "default": "false",
-              "fieldName": "disabled"
+              "readonly": true,
+              "attribute": "disabled"
             },
             {
+              "kind": "field",
               "name": "disclosure",
               "description": "disclosure is a boolean attribute. Used to show a chevron down at the of the content",
               "type": {
@@ -495,9 +1029,11 @@
                 ]
               },
               "default": "false",
-              "fieldName": "disclosure"
+              "readonly": true,
+              "attribute": "disclosure"
             },
             {
+              "kind": "field",
               "name": "label",
               "description": "The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.",
               "type": {
@@ -510,9 +1046,11 @@
                 ]
               },
               "default": "''",
-              "fieldName": "label"
+              "readonly": true,
+              "attribute": "label"
             },
             {
+              "kind": "field",
               "name": "loading",
               "description": "loading is a boolean attribute. 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.",
               "type": {
@@ -525,9 +1063,11 @@
                 ]
               },
               "default": "false",
-              "fieldName": "loading"
+              "readonly": true,
+              "attribute": "loading"
             },
             {
+              "kind": "field",
               "name": "name",
               "description": "name is a string attribute. The name attribute for the button, useful for form submissions.",
               "type": {
@@ -539,48 +1079,190 @@
                   }
                 ]
               },
-              "default": "''",
-              "fieldName": "name"
+              "default": "''",
+              "readonly": true,
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "BUTTON_SIZES.MEDIUM",
+              "readonly": true,
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "description": "type is a string attribute. The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.",
+              "type": {
+                "text": "\"button\" | \"reset\" | \"submit\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "BUTTON_TYPES.BUTTON",
+              "readonly": true,
+              "attribute": "type"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "variant is a string attribute. The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.",
+              "type": {
+                "text": "\"default\" | \"outline\" | \"plain\"",
+                "references": [
+                  {
+                    "name": "IButton",
+                    "module": "./types/IButton"
+                  }
+                ]
+              },
+              "default": "BUTTON_VARIANTS.DEFAULT",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsClick",
+              "description": "emit event to click",
+              "type": {
+                "text": "CustomEvent<UIEvent>",
+                "references": [
+                  {
+                    "name": "UIEvent",
+                    "package": "global:"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The content of the button, typically text or an icon."
+            },
+            {
+              "name": "badge",
+              "description": "Slot to place a badge component"
+            },
+            {
+              "name": "icon",
+              "description": "Content to show an icon at the begining of the button"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsButton",
+          "declaration": {
+            "name": "BdsButton"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-button",
+          "declaration": {
+            "name": "BdsButton"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/actions/bds-button-group/bds-button-group.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-button-group",
+          "name": "BdsButtonGroup",
+          "description": "Button group component for grouping related buttons together in a unified visual unit.",
+          "attributes": [
+            {
+              "name": "color",
+              "description": "Controls the color applied to all child `<bds-button>` elements. Accepted values: see `CoreColors`. Default is `default`.",
+              "type": {
+                "text": "\"default\" | \"error\" | \"primary\" | \"success\"",
+                "references": [
+                  {
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "CORE_COLORS.DEFAULT",
+              "fieldName": "color"
+            },
+            {
+              "name": "label",
+              "description": "Provides an accessible label for the button group.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "'Button group'",
+              "fieldName": "label"
+            },
+            {
+              "name": "orientation",
+              "description": "Controls the layout direction of the grouped buttons. Accepted values: `'horizontal'`, `'vertical'`. Default is `'horizontal'`.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "ORIENTATIONS.HORIZONTAL",
+              "fieldName": "orientation"
             },
             {
               "name": "size",
-              "description": "size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.",
+              "description": "Controls the size applied to all child `<bds-button>` elements. Accepted values: `'sm'`, `'md'`, `'lg'`. Default is `'md'`.",
               "type": {
                 "text": "\"lg\" | \"md\" | \"sm\"",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
               "default": "BUTTON_SIZES.MEDIUM",
               "fieldName": "size"
             },
-            {
-              "name": "type",
-              "description": "type is a string attribute. The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.",
-              "type": {
-                "text": "\"button\" | \"reset\" | \"submit\"",
-                "references": [
-                  {
-                    "name": "IButton",
-                    "module": "./types/IButton"
-                  }
-                ]
-              },
-              "default": "BUTTON_TYPES.BUTTON",
-              "fieldName": "type"
-            },
             {
               "name": "variant",
-              "description": "variant is a string attribute. The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.",
+              "description": "Controls the variant applied to all child `<bds-button>` elements. Accepted values: `'default'`, `'outline'`, `'plain'`. Default is `'default'`.",
               "type": {
                 "text": "\"default\" | \"outline\" | \"plain\"",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
@@ -592,13 +1274,13 @@
             {
               "kind": "field",
               "name": "color",
-              "description": "color is a string attribute. The color theme of the button, which can be 'default', 'primary', 'success', or 'error'. Default is 'default'.",
+              "description": "Controls the color applied to all child `<bds-button>` elements. Accepted values: see `CoreColors`. Default is `default`.",
               "type": {
                 "text": "\"default\" | \"error\" | \"primary\" | \"success\"",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
@@ -608,168 +1290,355 @@
             },
             {
               "kind": "field",
-              "name": "disabled",
-              "description": "disabled is a boolean attribute. Disables the button when true, preventing user interaction and applying disabled styles.",
+              "name": "label",
+              "description": "Provides an accessible label for the button group.",
               "type": {
-                "text": "boolean",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
-              "default": "false",
+              "default": "'Button group'",
               "readonly": true,
-              "attribute": "disabled"
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "disclosure",
-              "description": "disclosure is a boolean attribute. Used to show a chevron down at the of the content",
+              "name": "orientation",
+              "description": "Controls the layout direction of the grouped buttons. Accepted values: `'horizontal'`, `'vertical'`. Default is `'horizontal'`.",
               "type": {
-                "text": "boolean",
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
-              "default": "false",
+              "default": "ORIENTATIONS.HORIZONTAL",
               "readonly": true,
-              "attribute": "disclosure"
+              "attribute": "orientation"
             },
             {
               "kind": "field",
-              "name": "label",
-              "description": "The accessible name for the button, used for screen readers. It should be provided by the user for accessibility purposes.",
+              "name": "size",
+              "description": "Controls the size applied to all child `<bds-button>` elements. Accepted values: `'sm'`, `'md'`, `'lg'`. Default is `'md'`.",
               "type": {
-                "text": "string",
+                "text": "\"lg\" | \"md\" | \"sm\"",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
-              "default": "''",
+              "default": "BUTTON_SIZES.MEDIUM",
               "readonly": true,
-              "attribute": "label"
+              "attribute": "size"
             },
             {
               "kind": "field",
-              "name": "loading",
-              "description": "loading is a boolean attribute. 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.",
+              "name": "variant",
+              "description": "Controls the variant applied to all child `<bds-button>` elements. Accepted values: `'default'`, `'outline'`, `'plain'`. Default is `'default'`.",
               "type": {
-                "text": "boolean",
+                "text": "\"default\" | \"outline\" | \"plain\"",
                 "references": [
                   {
-                    "name": "IButton",
-                    "module": "./types/IButton"
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
                   }
                 ]
               },
-              "default": "false",
+              "default": "BUTTON_VARIANTS.DEFAULT",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The content of the button group, typically multiple `<bds-button>` elements."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsButtonGroup",
+          "declaration": {
+            "name": "BdsButtonGroup"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-button-group",
+          "declaration": {
+            "name": "BdsButtonGroup"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/forms/bds-checkbox/bds-checkbox/bds-checkbox.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-checkbox",
+          "name": "BdsCheckbox",
+          "description": "Checkbox component for boolean selection with three visual states.",
+          "attributes": [
+            {
+              "name": "checked",
+              "description": "Whether the checkbox is selected.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the checkbox.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "description": "Shows error styling on the checkbox.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "error"
+            },
+            {
+              "name": "indeterminate",
+              "description": "Whether the checkbox shows an indeterminate (\"mixed\") visual state.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "indeterminate"
+            },
+            {
+              "name": "info",
+              "description": "Tooltip text for the checkbox.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "info"
+            },
+            {
+              "name": "label",
+              "description": "Label displayed next to the checkbox. If not provided, the default slot is used.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "name"
+            },
+            {
+              "name": "required",
+              "description": "Marks the checkbox as required for form submission.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "value",
+              "description": "Value submitted with the form data when checked.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether the checkbox is selected.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the checkbox.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "description": "Shows error styling on the checkbox.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "indeterminate",
+              "description": "Whether the checkbox shows an indeterminate (\"mixed\") visual state.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "indeterminate",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "info",
+              "description": "Tooltip text for the checkbox.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
               "readonly": true,
-              "attribute": "loading"
+              "attribute": "info",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "name",
-              "description": "name is a string attribute. The name attribute for the button, useful for form submissions.",
+              "name": "label",
+              "description": "Label displayed next to the checkbox. If not provided, the default slot is used.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IButton",
-                    "module": "./types/IButton"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
               "readonly": true,
-              "attribute": "name"
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "size",
-              "description": "size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
-                "references": [
-                  {
-                    "name": "IButton",
-                    "module": "./types/IButton"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "BUTTON_SIZES.MEDIUM",
+              "default": "''",
               "readonly": true,
-              "attribute": "size"
+              "attribute": "name",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "type",
-              "description": "type is a string attribute. The type of the button, which can be 'button', 'submit', or 'reset'. Default is 'button'.",
+              "name": "required",
+              "description": "Marks the checkbox as required for form submission.",
               "type": {
-                "text": "\"button\" | \"reset\" | \"submit\"",
-                "references": [
-                  {
-                    "name": "IButton",
-                    "module": "./types/IButton"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "BUTTON_TYPES.BUTTON",
+              "default": "false",
               "readonly": true,
-              "attribute": "type"
+              "attribute": "required",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "variant",
-              "description": "variant is a string attribute. The visual style of the button, which can be 'default', 'outline', or 'plain'. Default is 'default'.",
+              "name": "value",
+              "description": "Value submitted with the form data when checked.",
               "type": {
-                "text": "\"default\" | \"outline\" | \"plain\"",
-                "references": [
-                  {
-                    "name": "IButton",
-                    "module": "./types/IButton"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "BUTTON_VARIANTS.DEFAULT",
+              "default": "'on'",
               "readonly": true,
-              "attribute": "variant"
+              "attribute": "value"
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
             }
           ],
           "events": [
             {
-              "name": "bdsClick",
-              "description": "emit event to click",
+              "name": "bdsChange",
+              "description": "Emitted when the user toggles the checkbox.",
               "type": {
-                "text": "CustomEvent<UIEvent>",
+                "text": "CustomEvent<CheckboxChangeDetail>",
                 "references": [
                   {
-                    "name": "UIEvent",
-                    "package": "global:"
+                    "name": "CheckboxChangeDetail",
+                    "module": "../types/ICheckbox"
                   }
                 ]
               }
+            },
+            {
+              "name": "valueChange",
+              "description": "Emitted when the checked state changes (for 2-way binding / v-model).",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "The content of the button, typically text or an icon."
-            },
-            {
-              "name": "badge",
-              "description": "Slot to place a badge component"
-            },
-            {
-              "name": "icon",
-              "description": "Content to show an icon at the begining of the button"
+              "description": "Default slot for label content when no `label` prop is provided."
             }
           ]
         }
@@ -777,198 +1646,260 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsButton",
+          "name": "BdsCheckbox",
           "declaration": {
-            "name": "BdsButton"
+            "name": "BdsCheckbox"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-button",
+          "name": "bds-checkbox",
           "declaration": {
-            "name": "BdsButton"
+            "name": "BdsCheckbox"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/actions/bds-button-group/bds-button-group.tsx",
+      "path": "src/components/forms/bds-checkbox/bds-checkbox-button/bds-checkbox-button.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-button-group",
-          "name": "BdsButtonGroup",
-          "description": "Button group component for grouping related buttons together in a unified visual unit.",
+          "tagName": "bds-checkbox-button",
+          "name": "BdsCheckboxButton",
+          "description": "Button-shaped checkbox option that toggles independently on each interaction.\nRenders as a pill-button with the same visual language as `bds-radio-button`, but uses\n`role=\"checkbox\"` and multi-select semantics — toggling one button has no effect on others.\n\nCan be used standalone (with `name` and optional `required`) or inside a `bds-checkbox-group`,\nwhich is the recommended approach for coordinated form state and group-level validation.",
           "attributes": [
             {
-              "name": "color",
-              "description": "Controls the color applied to all child `<bds-button>` elements. Accepted values: see `CoreColors`. Default is `default`.",
+              "name": "checked",
+              "description": "Toggle state of this button. Flips on every interaction when not disabled.",
               "type": {
-                "text": "\"default\" | \"error\" | \"primary\" | \"success\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "CORE_COLORS.DEFAULT",
-              "fieldName": "color"
+              "default": "false",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the button, preventing interaction. Propagated by `bds-checkbox-group` when the group is disabled.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "description": "Shows error styling on the button.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "error"
+            },
+            {
+              "name": "info",
+              "description": "Tooltip text shown on an info icon next to the label.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "info"
             },
             {
               "name": "label",
-              "description": "Provides an accessible label for the button group.",
+              "description": "Label text displayed inside the button. Falls back to the default slot when empty.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'Button group'",
+              "default": "''",
               "fieldName": "label"
             },
             {
-              "name": "orientation",
-              "description": "Controls the layout direction of the grouped buttons. Accepted values: `'horizontal'`, `'vertical'`. Default is `'horizontal'`.",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "\"horizontal\" | \"vertical\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "ORIENTATIONS.HORIZONTAL",
-              "fieldName": "orientation"
+              "default": "''",
+              "fieldName": "name"
             },
             {
-              "name": "size",
-              "description": "Controls the size applied to all child `<bds-button>` elements. Accepted values: `'sm'`, `'md'`, `'lg'`. Default is `'md'`.",
+              "name": "required",
+              "description": "Marks this button as required for form submission. Has no effect when used inside `bds-checkbox-group`.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "BUTTON_SIZES.MEDIUM",
-              "fieldName": "size"
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "value",
+              "description": "Value associated with this button; submitted with form data when checked.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "checked",
+              "description": "Toggle state of this button. Flips on every interaction when not disabled.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the button, preventing interaction. Propagated by `bds-checkbox-group` when the group is disabled.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
             },
             {
-              "name": "variant",
-              "description": "Controls the variant applied to all child `<bds-button>` elements. Accepted values: `'default'`, `'outline'`, `'plain'`. Default is `'default'`.",
+              "kind": "field",
+              "name": "error",
+              "description": "Shows error styling on the button.",
               "type": {
-                "text": "\"default\" | \"outline\" | \"plain\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "BUTTON_VARIANTS.DEFAULT",
-              "fieldName": "variant"
-            }
-          ],
-          "members": [
+              "default": "false",
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
+            },
             {
               "kind": "field",
-              "name": "color",
-              "description": "Controls the color applied to all child `<bds-button>` elements. Accepted values: see `CoreColors`. Default is `default`.",
+              "name": "info",
+              "description": "Tooltip text shown on an info icon next to the label.",
               "type": {
-                "text": "\"default\" | \"error\" | \"primary\" | \"success\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "CORE_COLORS.DEFAULT",
+              "default": "''",
               "readonly": true,
-              "attribute": "color"
+              "attribute": "info"
             },
             {
               "kind": "field",
               "name": "label",
-              "description": "Provides an accessible label for the button group.",
+              "description": "Label text displayed inside the button. Falls back to the default slot when empty.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "'Button group'",
+              "default": "''",
               "readonly": true,
               "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "orientation",
-              "description": "Controls the layout direction of the grouped buttons. Accepted values: `'horizontal'`, `'vertical'`. Default is `'horizontal'`.",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "\"horizontal\" | \"vertical\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "ORIENTATIONS.HORIZONTAL",
+              "default": "''",
               "readonly": true,
-              "attribute": "orientation"
+              "attribute": "name",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "size",
-              "description": "Controls the size applied to all child `<bds-button>` elements. Accepted values: `'sm'`, `'md'`, `'lg'`. Default is `'md'`.",
+              "name": "required",
+              "description": "Marks this button as required for form submission. Has no effect when used inside `bds-checkbox-group`.",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
-                "references": [
-                  {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "BUTTON_SIZES.MEDIUM",
+              "default": "false",
               "readonly": true,
-              "attribute": "size"
+              "attribute": "required",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "variant",
-              "description": "Controls the variant applied to all child `<bds-button>` elements. Accepted values: `'default'`, `'outline'`, `'plain'`. Default is `'default'`.",
+              "name": "value",
+              "description": "Value associated with this button; submitted with form data when checked.",
               "type": {
-                "text": "\"default\" | \"outline\" | \"plain\"",
+                "text": "string"
+              },
+              "default": "'on'",
+              "readonly": true,
+              "attribute": "value"
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "description": "Returns whether this button satisfies its validation constraints.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "description": "Reports validity to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsChange",
+              "description": "Emitted on every toggle — both when the button becomes checked and when it becomes unchecked.\nPayload: `{ checked: boolean, value: string }`.",
+              "type": {
+                "text": "CustomEvent<CheckboxButtonChangeDetail>",
                 "references": [
                   {
-                    "name": "IButtonGroup",
-                    "module": "./types/IButtonGroup"
+                    "name": "CheckboxButtonChangeDetail",
+                    "module": "./types/ICheckboxButton"
                   }
                 ]
-              },
-              "default": "BUTTON_VARIANTS.DEFAULT",
-              "readonly": true,
-              "attribute": "variant"
+              }
+            },
+            {
+              "name": "valueChange",
+              "description": "Emitted when the checked state changes. Used for `v-model` two-way binding in Vue. Payload: `boolean`.",
+              "type": {
+                "text": "CustomEvent<boolean>"
+              }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "The content of the button group, typically multiple `<bds-button>` elements."
+              "description": "Label content rendered when no `label` prop is provided."
+            },
+            {
+              "name": "icon",
+              "description": "Optional icon displayed to the left of the label."
             }
           ]
         }
@@ -976,36 +1907,41 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsButtonGroup",
+          "name": "BdsCheckboxButton",
           "declaration": {
-            "name": "BdsButtonGroup"
+            "name": "BdsCheckboxButton"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-button-group",
+          "name": "bds-checkbox-button",
           "declaration": {
-            "name": "BdsButtonGroup"
+            "name": "BdsCheckboxButton"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-checkbox/bds-checkbox.tsx",
+      "path": "src/components/forms/bds-checkbox/bds-checkbox-card/bds-checkbox-card.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-checkbox",
-          "name": "BdsCheckbox",
-          "description": "Checkbox component for boolean selection with three visual states.",
+          "tagName": "bds-checkbox-card",
+          "name": "BdsCheckboxCard",
           "attributes": [
             {
               "name": "checked",
-              "description": "Whether the checkbox is selected.",
+              "description": "Whether this checkbox card is selected.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "checked"
@@ -1014,34 +1950,58 @@
               "name": "disabled",
               "description": "Disables the control.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "disabled"
             },
             {
               "name": "error",
-              "description": "Shows error styling on the checkbox.",
+              "description": "Whether the checkbox card is in an error state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "error"
             },
             {
               "name": "indeterminate",
-              "description": "Whether the checkbox shows an indeterminate (\"mixed\") visual state.",
+              "description": "Whether the checkbox card shows an indeterminate visual state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "indeterminate"
             },
             {
               "name": "label",
-              "description": "Label displayed next to the checkbox. If not provided, the default slot is used.",
+              "description": "Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "''",
               "fieldName": "label"
@@ -1050,7 +2010,13 @@
               "name": "name",
               "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "fieldName": "name"
             },
@@ -1058,16 +2024,28 @@
               "name": "required",
               "description": "Marks the control as required for form submission.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "required"
             },
             {
               "name": "value",
-              "description": "Value submitted with the form data when checked.",
+              "description": "Value submitted with the form when this checkbox is selected.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "'on'",
               "fieldName": "value"
@@ -1077,9 +2055,15 @@
             {
               "kind": "field",
               "name": "checked",
-              "description": "Whether the checkbox is selected.",
+              "description": "Whether this checkbox card is selected.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "attribute": "checked",
@@ -1090,7 +2074,13 @@
               "name": "disabled",
               "description": "Disables the control.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
@@ -1100,9 +2090,15 @@
             {
               "kind": "field",
               "name": "error",
-              "description": "Shows error styling on the checkbox.",
+              "description": "Whether the checkbox card is in an error state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
@@ -1112,20 +2108,33 @@
             {
               "kind": "field",
               "name": "indeterminate",
-              "description": "Whether the checkbox shows an indeterminate (\"mixed\") visual state.",
+              "description": "Whether the checkbox card shows an indeterminate visual state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
+              "readonly": true,
               "attribute": "indeterminate",
               "reflects": true
             },
             {
               "kind": "field",
               "name": "label",
-              "description": "Label displayed next to the checkbox. If not provided, the default slot is used.",
+              "description": "Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "''",
               "readonly": true,
@@ -1136,7 +2145,13 @@
               "name": "name",
               "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "readonly": true,
               "attribute": "name",
@@ -1147,7 +2162,13 @@
               "name": "required",
               "description": "Marks the control as required for form submission.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
@@ -1157,41 +2178,82 @@
             {
               "kind": "field",
               "name": "value",
-              "description": "Value submitted with the form data when checked.",
+              "description": "Value submitted with the form when this checkbox is selected.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
               },
               "default": "'on'",
               "readonly": true,
-              "attribute": "value"
+              "attribute": "value",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
             }
           ],
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the user toggles the checkbox.",
+              "description": "Emitted when the user toggles this checkbox card.",
               "type": {
-                "text": "CustomEvent<CheckboxChangeDetail>",
-                "references": [
-                  {
-                    "name": "CheckboxChangeDetail",
-                    "module": "./types/ICheckbox"
-                  }
-                ]
+                "text": "CustomEvent<any>"
               }
             },
             {
               "name": "valueChange",
-              "description": "Emitted when the checked state changes (for 2-way binding / v-model).",
+              "description": "Emitted when the checked state changes. Useful for 2-way binding / v-model.",
               "type": {
-                "text": "CustomEvent<boolean>"
+                "text": "CustomEvent<any>"
               }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Default slot for label content when no `label` prop is provided."
+              "description": "Label content when no `label` prop is provided."
+            },
+            {
+              "name": "description",
+              "description": "Optional descriptive text rendered below the label."
+            },
+            {
+              "name": "icon",
+              "description": "Optional icon rendered to the left of the label."
             }
           ]
         }
@@ -1199,181 +2261,149 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsCheckbox",
+          "name": "BdsCheckboxCard",
           "declaration": {
-            "name": "BdsCheckbox"
+            "name": "BdsCheckboxCard"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-checkbox",
+          "name": "bds-checkbox-card",
           "declaration": {
-            "name": "BdsCheckbox"
+            "name": "BdsCheckboxCard"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-checkbox-card/bds-checkbox-card.tsx",
+      "path": "src/components/forms/bds-checkbox/bds-checkbox-group/bds-checkbox-group.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-checkbox-card",
-          "name": "BdsCheckboxCard",
-          "description": "Checkbox card component is a selectable card-based checkbox option.\nIt presents a non-exclusive choice with optional descriptive text and icon,\nsupporting checked, indeterminate, disabled, and error states.\nCan be used standalone or within a checkbox group for orchestration.",
+          "tagName": "bds-checkbox-group",
+          "name": "BdsCheckboxGroup",
+          "description": "Checkbox group component that orchestrates multi-selection across a set of `bds-checkbox`, `bds-checkbox-button`, `bds-checkbox-card` children.",
           "attributes": [
-            {
-              "name": "checked",
-              "description": "Whether this checkbox card is selected.",
-              "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
-              },
-              "default": "false",
-              "fieldName": "checked"
-            },
             {
               "name": "disabled",
-              "description": "Disables the control.",
+              "description": "Disables all child checkboxes and prevents selection. Also mirrored to isDisabled",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "boolean"
               },
               "default": "false",
               "fieldName": "disabled"
             },
             {
               "name": "error",
-              "description": "Whether the checkbox card is in an error state.",
+              "description": "Shows error styling on the group helper text. Propagated to all child checkboxes.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "boolean"
               },
               "default": "false",
               "fieldName": "error"
             },
             {
-              "name": "indeterminate",
-              "description": "Whether the checkbox card shows an indeterminate visual state.",
+              "name": "error-message",
+              "description": "Error message rendered below the checkbox options when error is true. Replaces helperText.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "errorMessage"
+            },
+            {
+              "name": "helper-text",
+              "description": "Helper text rendered below the checkbox options. Shown in default state; replaced by errorMessage in error state.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "helperText"
+            },
+            {
+              "name": "info",
+              "description": "Tooltip text shown on the group label info icon.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "info"
+            },
+            {
+              "name": "joined",
+              "description": "Hides the divider between checkbox buttons when type is 'checkboxbutton'.",
+              "type": {
+                "text": "boolean"
               },
               "default": "false",
-              "fieldName": "indeterminate"
+              "fieldName": "joined"
             },
             {
               "name": "label",
-              "description": "Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.",
+              "description": "Group label rendered above the checkbox options.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
               "fieldName": "label"
             },
             {
               "name": "name",
-              "description": "Name of the form control, submitted as a key in the form data.",
+              "description": "Name of the form control; submitted as the field key in FormData.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "string"
               },
               "fieldName": "name"
             },
             {
-              "name": "required",
-              "description": "Marks the control as required for form submission.",
+              "name": "orientation",
+              "description": "Layout direction of the checkbox options.",
               "type": {
-                "text": "boolean",
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
+                    "name": "Orientation",
+                    "module": "@/types"
                   }
                 ]
               },
+              "default": "'horizontal'",
+              "fieldName": "orientation"
+            },
+            {
+              "name": "required",
+              "description": "Marks the group as required for form submission. Triggers validity error when no checkboxes are selected.",
+              "type": {
+                "text": "boolean"
+              },
               "default": "false",
               "fieldName": "required"
             },
             {
-              "name": "value",
-              "description": "Value submitted with the form when this checkbox is selected.",
+              "name": "type",
+              "description": "Identifies this group variant. 'checkbox' renders bds-checkbox children; 'checkboxbutton' renders bds-checkbox-button segmented control; 'checkboxcard' renders bds-checkbox-card element.",
               "type": {
-                "text": "string",
+                "text": "\"checkbox\" | \"checkboxbutton\" | \"checkboxcard\"",
                 "references": [
                   {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
+                    "name": "CheckboxGroupType",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "'on'",
-              "fieldName": "value"
+              "default": "'checkbox'",
+              "fieldName": "type"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "checked",
-              "description": "Whether this checkbox card is selected.",
-              "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
-              },
-              "default": "false",
-              "attribute": "checked",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "disabled",
-              "description": "Disables the control.",
-              "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+              "name": "disabled",
+              "description": "Disables all child checkboxes and prevents selection. Also mirrored to isDisabled",
+              "type": {
+                "text": "boolean"
               },
               "default": "false",
               "readonly": true,
@@ -1383,15 +2413,9 @@
             {
               "kind": "field",
               "name": "error",
-              "description": "Whether the checkbox card is in an error state.",
+              "description": "Shows error styling on the group helper text. Propagated to all child checkboxes.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "boolean"
               },
               "default": "false",
               "readonly": true,
@@ -1400,33 +2424,55 @@
             },
             {
               "kind": "field",
-              "name": "indeterminate",
-              "description": "Whether the checkbox card shows an indeterminate visual state.",
+              "name": "errorMessage",
+              "description": "Error message rendered below the checkbox options when error is true. Replaces helperText.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "error-message"
+            },
+            {
+              "kind": "field",
+              "name": "helperText",
+              "description": "Helper text rendered below the checkbox options. Shown in default state; replaced by errorMessage in error state.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "helper-text"
+            },
+            {
+              "kind": "field",
+              "name": "info",
+              "description": "Tooltip text shown on the group label info icon.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "info"
+            },
+            {
+              "kind": "field",
+              "name": "joined",
+              "description": "Hides the divider between checkbox buttons when type is 'checkboxbutton'.",
+              "type": {
+                "text": "boolean"
               },
               "default": "false",
-              "attribute": "indeterminate",
+              "readonly": true,
+              "attribute": "joined",
               "reflects": true
             },
             {
               "kind": "field",
               "name": "label",
-              "description": "Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.",
+              "description": "Group label rendered above the checkbox options.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
               "readonly": true,
@@ -1435,15 +2481,9 @@
             {
               "kind": "field",
               "name": "name",
-              "description": "Name of the form control, submitted as a key in the form data.",
+              "description": "Name of the form control; submitted as the field key in FormData.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
-                  }
-                ]
+                "text": "string"
               },
               "readonly": true,
               "attribute": "name",
@@ -1451,17 +2491,29 @@
             },
             {
               "kind": "field",
-              "name": "required",
-              "description": "Marks the control as required for form submission.",
+              "name": "orientation",
+              "description": "Layout direction of the checkbox options.",
               "type": {
-                "text": "boolean",
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
+                    "name": "Orientation",
+                    "module": "@/types"
                   }
                 ]
               },
+              "default": "'horizontal'",
+              "readonly": true,
+              "attribute": "orientation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "description": "Marks the group as required for form submission. Triggers validity error when no checkboxes are selected.",
+              "type": {
+                "text": "boolean"
+              },
               "default": "false",
               "readonly": true,
               "attribute": "required",
@@ -1469,51 +2521,96 @@
             },
             {
               "kind": "field",
-              "name": "value",
-              "description": "Value submitted with the form when this checkbox is selected.",
+              "name": "type",
+              "description": "Identifies this group variant. 'checkbox' renders bds-checkbox children; 'checkboxbutton' renders bds-checkbox-button segmented control; 'checkboxcard' renders bds-checkbox-card element.",
               "type": {
-                "text": "string",
+                "text": "\"checkbox\" | \"checkboxbutton\" | \"checkboxcard\"",
                 "references": [
                   {
-                    "name": "ICheckboxCard",
-                    "module": "./types/ICheckboxCard"
+                    "name": "CheckboxGroupType",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "'on'",
+              "default": "'checkbox'",
               "readonly": true,
-              "attribute": "value",
+              "attribute": "type",
               "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Currently selected checkbox values. Synced to children on change.",
+              "type": {
+                "text": "string[]"
+              },
+              "default": "[]"
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "description": "Returns whether the group's current value satisfies the browser's built-in constraint validation.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
             }
           ],
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the user toggles this checkbox card.",
+              "description": "Emitted when any checkbox is toggled. Payload includes the complete updated values array.",
               "type": {
-                "text": "CustomEvent<any>"
+                "text": "CustomEvent<CheckboxGroupChangeDetail>",
+                "references": [
+                  {
+                    "name": "CheckboxGroupChangeDetail",
+                    "module": "./types"
+                  }
+                ]
               }
             },
             {
               "name": "valueChange",
-              "description": "Emitted when the checked state changes. Useful for 2-way binding / v-model.",
+              "description": "Emitted when any checkbox is toggled. Used for v-model two-way binding in Vue.",
               "type": {
-                "text": "CustomEvent<any>"
+                "text": "CustomEvent<string[]>"
               }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Label content when no `label` prop is provided."
-            },
-            {
-              "name": "description",
-              "description": "Optional descriptive text rendered below the label."
-            },
+              "description": "Default slot for `bds-checkbox`, `bds-checkbox-button`, `bds-checkbox-card` child elements."
+            }
+          ],
+          "cssProperties": [
             {
-              "name": "icon",
-              "description": "Optional icon rendered to the left of the label."
+              "name": "--layout-count",
+              "description": "Defines the number of columns for horizontal orientation. Default is 1."
             }
           ]
         }
@@ -1521,16 +2618,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsCheckboxCard",
+          "name": "BdsCheckboxGroup",
           "declaration": {
-            "name": "BdsCheckboxCard"
+            "name": "BdsCheckboxGroup"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-checkbox-card",
+          "name": "bds-checkbox-group",
           "declaration": {
-            "name": "BdsCheckboxCard"
+            "name": "BdsCheckboxGroup"
           }
         }
       ]
@@ -2405,7 +3502,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/layouts/bds-grid/grid/bds-grid.tsx",
+      "path": "src/components/layouts/bds-grid/bds-grid/bds-grid.tsx",
       "declarations": [
         {
           "kind": "class",
@@ -2512,7 +3609,7 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/layouts/bds-grid/grid-item/bds-grid-item.tsx",
+      "path": "src/components/layouts/bds-grid/bds-grid-item/bds-grid-item.tsx",
       "declarations": [
         {
           "kind": "class",
@@ -2812,6 +3909,51 @@
           "name": "BdsListMenu",
           "description": "Container component that manages a list of menu items.\nIt handles selection logic (single/multiple) and maintains the data state.",
           "attributes": [
+            {
+              "name": "checkable",
+              "description": "Prop to show in all items a checkbox",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "checkable"
+            },
+            {
+              "name": "empty",
+              "description": "is empty state item",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "empty"
+            },
+            {
+              "name": "empty-text",
+              "description": "Prop to show empty text",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "'No options available'",
+              "fieldName": "emptyText"
+            },
             {
               "name": "menu-role",
               "description": "Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.",
@@ -2859,6 +4001,58 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "checkable",
+              "description": "Prop to show in all items a checkbox",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "checkable"
+            },
+            {
+              "kind": "field",
+              "name": "empty",
+              "description": "is empty state item",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "empty",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "emptyText",
+              "description": "Prop to show empty text",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "'No options available'",
+              "readonly": true,
+              "attribute": "empty-text"
+            },
             {
               "kind": "field",
               "name": "menuRole",
@@ -2874,7 +4068,8 @@
               },
               "default": "MENU_ROLES.MENU",
               "readonly": true,
-              "attribute": "menu-role"
+              "attribute": "menu-role",
+              "reflects": true
             },
             {
               "kind": "field",
@@ -2910,6 +4105,26 @@
               "readonly": true,
               "attribute": "selection-mode"
             },
+            {
+              "kind": "method",
+              "name": "getAllItems",
+              "description": "Retrieves all child menu items.",
+              "return": {
+                "type": {
+                  "text": "Promise<HTMLBdsListMenuItemElement[]>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    },
+                    {
+                      "name": "HTMLBdsListMenuItemElement",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
             {
               "kind": "method",
               "name": "getSelectedValues",
@@ -3313,6 +4528,7 @@
                 ]
               },
               "default": "false",
+              "readonly": true,
               "attribute": "selected",
               "reflects": true
             },
@@ -3513,67 +4729,300 @@
               "type": {
                 "text": "boolean"
               },
-              "default": "false",
+              "default": "false",
+              "readonly": true,
+              "attribute": "footer"
+            },
+            {
+              "kind": "field",
+              "name": "header",
+              "description": "If true, displays the header section with icon and title slots.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "header"
+            },
+            {
+              "kind": "field",
+              "name": "width",
+              "description": "Width of the popover content.\n- number: width in pixels (e.g. 320 → \"320px\")\n- 'full': 100% of the trigger/parent width\n- 'auto': fits the content",
+              "type": {
+                "text": "\"auto\" | \"full\" | number",
+                "references": [
+                  {
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
+                  }
+                ]
+              },
+              "default": "320",
+              "readonly": true,
+              "attribute": "width"
+            },
+            {
+              "kind": "method",
+              "name": "closePopover",
+              "description": "Programmatically closes the popover, running the full hide lifecycle.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "openPopover",
+              "description": "Programmatically opens the popover, running the full show lifecycle.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot for the popover body content."
+            },
+            {
+              "name": "footer-button",
+              "description": "Slot for footer actions."
+            },
+            {
+              "name": "footer-helper",
+              "description": "Slot for footer helper content."
+            },
+            {
+              "name": "header-icon",
+              "description": "Slot for header icon."
+            },
+            {
+              "name": "header-title",
+              "description": "Slot for header title."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "arrow"
+            },
+            {
+              "name": "popover-content"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsPopover",
+          "declaration": {
+            "name": "BdsPopover"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-popover",
+          "declaration": {
+            "name": "BdsPopover"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/forms/bds-radio/bds-radio/bds-radio.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-radio",
+          "name": "BdsRadio",
+          "description": "Radio button component for single-selection within a group.\nUse inside `bds-radio-group` for managed selection and form binding.\nCan also be used standalone with the `name`, `value`, and `checked` props.",
+          "attributes": [
+            {
+              "name": "checked",
+              "description": "Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the radio, preventing interaction and selection.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "description": "Shows error styling on the radio indicator. Propagated by bds-radio-group.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "error"
+            },
+            {
+              "name": "info",
+              "description": "Tooltip text shown on an info icon next to the label.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "info"
+            },
+            {
+              "name": "label",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "name",
+              "description": "Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "name"
+            },
+            {
+              "name": "value",
+              "description": "Value submitted with the form when this radio is selected.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the radio, preventing interaction and selection.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "description": "Shows error styling on the radio indicator. Propagated by bds-radio-group.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "info",
+              "description": "Tooltip text shown on an info icon next to the label.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "info"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "description": "Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
               "readonly": true,
-              "attribute": "footer"
+              "attribute": "name",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "header",
-              "description": "If true, displays the header section with icon and title slots.",
+              "name": "value",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
+              "default": "'on'",
               "readonly": true,
-              "attribute": "header"
-            },
+              "attribute": "value"
+            }
+          ],
+          "events": [
             {
-              "kind": "field",
-              "name": "width",
-              "description": "Width of the popover content.\n- number: width in pixels (e.g. 320 → \"320px\")\n- 'full': 100% of the trigger/parent width\n- 'auto': fits the content",
+              "name": "bdsChange",
+              "description": "Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.",
               "type": {
-                "text": "\"auto\" | \"full\" | number",
+                "text": "CustomEvent<RadioChangeDetail>",
                 "references": [
                   {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "RadioChangeDetail",
+                    "module": "./types/IRadio"
                   }
                 ]
-              },
-              "default": "320",
-              "readonly": true,
-              "attribute": "width"
+              }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Default slot for the popover body content."
-            },
-            {
-              "name": "footer-button",
-              "description": "Slot for footer actions."
-            },
-            {
-              "name": "footer-helper",
-              "description": "Slot for footer helper content."
-            },
-            {
-              "name": "header-icon",
-              "description": "Slot for header icon."
-            },
-            {
-              "name": "header-title",
-              "description": "Slot for header title."
-            }
-          ],
-          "cssParts": [
-            {
-              "name": "arrow"
+              "description": "Label content when no `label` prop is provided."
             },
             {
-              "name": "popover-content"
+              "name": "icon",
+              "description": "Optional icon rendered to the left of the label."
             }
           ]
         }
@@ -3581,34 +5030,34 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsPopover",
+          "name": "BdsRadio",
           "declaration": {
-            "name": "BdsPopover"
+            "name": "BdsRadio"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-popover",
+          "name": "bds-radio",
           "declaration": {
-            "name": "BdsPopover"
+            "name": "BdsRadio"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-radio/bds-radio.tsx",
+      "path": "src/components/forms/bds-radio/bds-radio-button/bds-radio-button.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-radio",
-          "name": "BdsRadio",
-          "description": "Radio button component for single-selection within a group.\nUse inside `bds-radio-group` for managed selection and form binding.\nCan also be used standalone with the `name`, `value`, and `checked` props.",
+          "tagName": "bds-radio-button",
+          "name": "BdsRadioButton",
+          "description": "Button-shaped radio option for use inside `bds-radio-group[type=\"radiobutton\"]`.\nCreates a segmented control appearance when grouped. Not form-associated — the parent\n`bds-radio-group` owns form state and single-selection enforcement.",
           "attributes": [
             {
               "name": "checked",
-              "description": "Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "description": "Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
                 "text": "boolean"
               },
@@ -3617,7 +5066,7 @@
             },
             {
               "name": "disabled",
-              "description": "Disables the radio, preventing interaction and selection.",
+              "description": "Disables the button, preventing interaction and selection.",
               "type": {
                 "text": "boolean"
               },
@@ -3626,7 +5075,7 @@
             },
             {
               "name": "error",
-              "description": "Shows error styling on the radio indicator. Propagated by bds-radio-group.",
+              "description": "Shows error styling on the button. Propagated by bds-radio-group.",
               "type": {
                 "text": "boolean"
               },
@@ -3644,7 +5093,7 @@
             },
             {
               "name": "label",
-              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
+              "description": "Label text displayed inside the button. Falls back to the default slot when empty.",
               "type": {
                 "text": "string"
               },
@@ -3662,7 +5111,7 @@
             },
             {
               "name": "value",
-              "description": "Value submitted with the form when this radio is selected.",
+              "description": "Value submitted with the form when this button is selected.",
               "type": {
                 "text": "string"
               },
@@ -3674,7 +5123,7 @@
             {
               "kind": "field",
               "name": "checked",
-              "description": "Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "description": "Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
                 "text": "boolean"
               },
@@ -3685,7 +5134,7 @@
             {
               "kind": "field",
               "name": "disabled",
-              "description": "Disables the radio, preventing interaction and selection.",
+              "description": "Disables the button, preventing interaction and selection.",
               "type": {
                 "text": "boolean"
               },
@@ -3697,7 +5146,7 @@
             {
               "kind": "field",
               "name": "error",
-              "description": "Shows error styling on the radio indicator. Propagated by bds-radio-group.",
+              "description": "Shows error styling on the button. Propagated by bds-radio-group.",
               "type": {
                 "text": "boolean"
               },
@@ -3720,7 +5169,7 @@
             {
               "kind": "field",
               "name": "label",
-              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
+              "description": "Label text displayed inside the button. Falls back to the default slot when empty.",
               "type": {
                 "text": "string"
               },
@@ -3743,7 +5192,7 @@
             {
               "kind": "field",
               "name": "value",
-              "description": "Value submitted with the form when this radio is selected.",
+              "description": "Value submitted with the form when this button is selected.",
               "type": {
                 "text": "string"
               },
@@ -3755,13 +5204,13 @@
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.",
+              "description": "Emitted when the user selects this button. Listened to by the parent bds-radio-group to enforce single selection.",
               "type": {
-                "text": "CustomEvent<RadioChangeDetail>",
+                "text": "CustomEvent<RadioButtonChangeDetail>",
                 "references": [
                   {
-                    "name": "RadioChangeDetail",
-                    "module": "./types/IRadio"
+                    "name": "RadioButtonChangeDetail",
+                    "module": "./types/IRadioButton"
                   }
                 ]
               }
@@ -3782,90 +5231,132 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsRadio",
+          "name": "BdsRadioButton",
           "declaration": {
-            "name": "BdsRadio"
+            "name": "BdsRadioButton"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-radio",
+          "name": "bds-radio-button",
           "declaration": {
-            "name": "BdsRadio"
+            "name": "BdsRadioButton"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-radio-button/bds-radio-button.tsx",
+      "path": "src/components/forms/bds-radio/bds-radio-card/bds-radio-card.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-radio-button",
-          "name": "BdsRadioButton",
-          "description": "Button-shaped radio option for use inside `bds-radio-group[type=\"radiobutton\"]`.\nCreates a segmented control appearance when grouped. Not form-associated — the parent\n`bds-radio-group` owns form state and single-selection enforcement.",
+          "tagName": "bds-radio-card",
+          "name": "BdsRadioCard",
+          "description": "Radio card component is a selectable card-based radio option.\nIt presents a mutually exclusive choice with optional descriptive text and icon,\ndesigned for integration with bds-radio-group for orchestration.\nCan also be used standalone with the `name`, `value`, and `checked` props.",
           "attributes": [
             {
               "name": "checked",
-              "description": "Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "description": "Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "checked"
             },
             {
               "name": "disabled",
-              "description": "Disables the button, preventing interaction and selection.",
+              "description": "Disables the radio card, preventing it from being selected and interacted with.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "disabled"
             },
             {
               "name": "error",
-              "description": "Shows error styling on the button. Propagated by bds-radio-group.",
+              "description": "Whether the radio card is in an error state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "false",
               "fieldName": "error"
             },
             {
               "name": "info",
-              "description": "Tooltip text shown on an info icon next to the label.",
+              "description": "Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "''",
               "fieldName": "info"
             },
             {
               "name": "label",
-              "description": "Label text displayed inside the button. Falls back to the default slot when empty.",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "''",
               "fieldName": "label"
             },
             {
               "name": "name",
-              "description": "Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.",
+              "description": "Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "''",
               "fieldName": "name"
             },
             {
               "name": "value",
-              "description": "Value submitted with the form when this button is selected.",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "'on'",
               "fieldName": "value"
@@ -3875,9 +5366,15 @@
             {
               "kind": "field",
               "name": "checked",
-              "description": "Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "description": "Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "false",
               "attribute": "checked",
@@ -3886,9 +5383,15 @@
             {
               "kind": "field",
               "name": "disabled",
-              "description": "Disables the button, preventing interaction and selection.",
+              "description": "Disables the radio card, preventing it from being selected and interacted with.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
@@ -3898,9 +5401,15 @@
             {
               "kind": "field",
               "name": "error",
-              "description": "Shows error styling on the button. Propagated by bds-radio-group.",
+              "description": "Whether the radio card is in an error state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
@@ -3910,9 +5419,15 @@
             {
               "kind": "field",
               "name": "info",
-              "description": "Tooltip text shown on an info icon next to the label.",
+              "description": "Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "''",
               "readonly": true,
@@ -3921,9 +5436,15 @@
             {
               "kind": "field",
               "name": "label",
-              "description": "Label text displayed inside the button. Falls back to the default slot when empty.",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "''",
               "readonly": true,
@@ -3932,37 +5453,49 @@
             {
               "kind": "field",
               "name": "name",
-              "description": "Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.",
+              "description": "Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "''",
               "readonly": true,
-              "attribute": "name",
-              "reflects": true
+              "attribute": "name"
             },
             {
               "kind": "field",
               "name": "value",
-              "description": "Value submitted with the form when this button is selected.",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
+                  }
+                ]
               },
               "default": "'on'",
               "readonly": true,
-              "attribute": "value"
+              "attribute": "value",
+              "reflects": true
             }
           ],
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the user selects this button. Listened to by the parent bds-radio-group to enforce single selection.",
+              "description": "Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.",
               "type": {
-                "text": "CustomEvent<RadioButtonChangeDetail>",
+                "text": "CustomEvent<RadioCardChangeDetail>",
                 "references": [
                   {
-                    "name": "RadioButtonChangeDetail",
-                    "module": "./types/IRadioButton"
+                    "name": "RadioCardChangeDetail",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               }
@@ -3973,247 +5506,455 @@
               "name": "",
               "description": "Label content when no `label` prop is provided."
             },
+            {
+              "name": "description",
+              "description": "Optional descriptive text rendered below the label."
+            },
             {
               "name": "icon",
               "description": "Optional icon rendered to the left of the label."
             }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bds-radio-button-size - The size of the radio button. Default is 18px."
+            },
+            {
+              "name": "--bds-radio-dot-size - The size of the dot inside the radio button. Default is 10px."
+            }
           ]
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "BdsRadioButton",
+          "name": "BdsRadioCard",
           "declaration": {
-            "name": "BdsRadioButton"
+            "name": "BdsRadioCard"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-radio-button",
+          "name": "bds-radio-card",
           "declaration": {
-            "name": "BdsRadioButton"
+            "name": "BdsRadioCard"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-radio-card/bds-radio-card.tsx",
+      "path": "src/components/forms/bds-radio/bds-radio-group/bds-radio-group.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-radio-card",
-          "name": "BdsRadioCard",
-          "description": "Radio card component is a selectable card-based radio option.\nIt presents a mutually exclusive choice with optional descriptive text and icon,\ndesigned for integration with bds-radio-group for orchestration.\nCan also be used standalone with the `name`, `value`, and `checked` props.",
+          "tagName": "bds-radio-group",
+          "name": "BdsRadioGroup",
+          "description": "Radio group component that orchestrates single-selection across a set of `bds-radio` children.",
           "attributes": [
-            {
-              "name": "checked",
-              "description": "Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.",
-              "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
-              },
-              "default": "false",
-              "fieldName": "checked"
-            },
             {
               "name": "disabled",
-              "description": "Disables the radio card, preventing it from being selected and interacted with.",
+              "description": "Disables all child radios and prevents selection. Also mirrored to isDisabled",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "boolean"
               },
               "default": "false",
               "fieldName": "disabled"
             },
             {
               "name": "error",
-              "description": "Whether the radio card is in an error state.",
+              "description": "Shows error styling on the group helper text. Propagated to all child radios.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "boolean"
               },
               "default": "false",
               "fieldName": "error"
             },
+            {
+              "name": "error-message",
+              "description": "Error message rendered below the radio options when error is true. Replaces helperText.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "errorMessage"
+            },
+            {
+              "name": "helper-text",
+              "description": "Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "helperText"
+            },
             {
               "name": "info",
-              "description": "Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.",
+              "description": "Tooltip text shown on the group label info icon.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
               "fieldName": "info"
             },
+            {
+              "name": "joined",
+              "description": "Hides the divider between radio buttons when type is 'radiobutton'.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "joined"
+            },
             {
               "name": "label",
-              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
+              "description": "Group label rendered above the radio options.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
               "fieldName": "label"
             },
             {
               "name": "name",
-              "description": "Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.",
+              "description": "Name of the form control; submitted as the field key in FormData.",
               "type": {
-                "text": "string",
+                "text": "string"
+              },
+              "fieldName": "name"
+            },
+            {
+              "name": "orientation",
+              "description": "Layout direction of the radio options.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
+                    "name": "Orientation",
+                    "module": "@/types"
                   }
                 ]
               },
-              "default": "''",
-              "fieldName": "name"
+              "default": "'vertical'",
+              "fieldName": "orientation"
             },
             {
-              "name": "value",
-              "description": "Value submitted with the form when this radio is selected.",
+              "name": "required",
+              "description": "Marks the group as required for form submission. Triggers validity error when no radio is selected.",
               "type": {
-                "text": "string",
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "type",
+              "description": "Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element.",
+              "type": {
+                "text": "\"radio\" | \"radiobutton\" | \"radiocard\"",
                 "references": [
                   {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
+                    "name": "RadioGroupType",
+                    "module": "./types/types"
                   }
                 ]
               },
-              "default": "'on'",
+              "default": "'radio'",
+              "fieldName": "type"
+            },
+            {
+              "name": "value",
+              "description": "Currently selected radio value. Synced to children on change.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
               "fieldName": "value"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "checked",
-              "description": "Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.",
+              "name": "disabled",
+              "description": "Disables all child radios and prevents selection. Also mirrored to isDisabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "description": "Shows error styling on the group helper text. Propagated to all child radios.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "errorMessage",
+              "description": "Error message rendered below the radio options when error is true. Replaces helperText.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "error-message"
+            },
+            {
+              "kind": "field",
+              "name": "helperText",
+              "description": "Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "helper-text"
+            },
+            {
+              "kind": "field",
+              "name": "info",
+              "description": "Tooltip text shown on the group label info icon.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "info"
+            },
+            {
+              "kind": "field",
+              "name": "joined",
+              "description": "Hides the divider between radio buttons when type is 'radiobutton'.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "joined",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Group label rendered above the radio options.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "description": "Name of the form control; submitted as the field key in FormData.",
+              "type": {
+                "text": "string"
+              },
+              "readonly": true,
+              "attribute": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "orientation",
+              "description": "Layout direction of the radio options.",
               "type": {
-                "text": "boolean",
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
+                    "name": "Orientation",
+                    "module": "@/types"
                   }
                 ]
               },
-              "default": "false",
-              "attribute": "checked",
+              "default": "'vertical'",
+              "readonly": true,
+              "attribute": "orientation",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "disabled",
-              "description": "Disables the radio card, preventing it from being selected and interacted with.",
+              "name": "required",
+              "description": "Marks the group as required for form submission. Triggers validity error when no radio is selected.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "boolean"
               },
               "default": "false",
               "readonly": true,
-              "attribute": "disabled",
+              "attribute": "required",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "error",
-              "description": "Whether the radio card is in an error state.",
+              "name": "type",
+              "description": "Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element.",
               "type": {
-                "text": "boolean",
+                "text": "\"radio\" | \"radiobutton\" | \"radiocard\"",
                 "references": [
                   {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
+                    "name": "RadioGroupType",
+                    "module": "./types/types"
                   }
                 ]
               },
-              "default": "false",
+              "default": "'radio'",
               "readonly": true,
-              "attribute": "error",
+              "attribute": "type",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "info",
-              "description": "Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.",
+              "name": "value",
+              "description": "Currently selected radio value. Synced to children on change.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "info"
+              "attribute": "value"
             },
             {
-              "kind": "field",
-              "name": "label",
-              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
+              "kind": "method",
+              "name": "checkValidity",
+              "description": "Returns whether the group's current value satisfies the browser's built-in constraint validation.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsChange",
+              "description": "Emitted when the selected radio changes. Payload includes the new value.",
               "type": {
-                "text": "string",
+                "text": "CustomEvent<RadioGroupChangeDetail>",
                 "references": [
                   {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
+                    "name": "RadioGroupChangeDetail",
+                    "module": "./types/IRadioGroup"
                   }
                 ]
+              }
+            },
+            {
+              "name": "valueChange",
+              "description": "Emitted when the selected radio changes. Used for v-model two-way binding in Vue.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot for `bds-radio` child elements."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--layout-count",
+              "description": "Defines the number of columns for horizontal orientation. Default is 1."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsRadioGroup",
+          "declaration": {
+            "name": "BdsRadioGroup"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-radio-group",
+          "declaration": {
+            "name": "BdsRadioGroup"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/forms/bds-select/bds-select.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-select",
+          "name": "BdsSelect",
+          "description": "Component representing a select dropdown, allowing users to choose an option from a list.\nIt consists of a text field that triggers the dropdown and a list menu that contains the options.\nThe component supports both single selection and searchable functionality.",
+          "attributes": [
+            {
+              "name": "name",
+              "description": "Name to assign in form",
+              "type": {
+                "text": "string"
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "label"
+              "fieldName": "name"
+            },
+            {
+              "name": "searchable",
+              "description": "Prop to define if its searchable. It allows to write and filter the options",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "searchable"
             },
+            {
+              "name": "value",
+              "description": "The value of the select component.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
               "name": "name",
-              "description": "Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.",
+              "description": "Name to assign in form",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "string"
               },
               "default": "''",
               "readonly": true,
@@ -4221,19 +5962,23 @@
             },
             {
               "kind": "field",
-              "name": "value",
-              "description": "Value submitted with the form when this radio is selected.",
+              "name": "searchable",
+              "description": "Prop to define if its searchable. It allows to write and filter the options",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IRadioCard",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "'on'",
+              "default": "false",
               "readonly": true,
+              "attribute": "searchable"
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "The value of the select component.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
               "attribute": "value",
               "reflects": true
             }
@@ -4241,38 +5986,27 @@
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.",
+              "description": "Emitted when the selection change the value",
               "type": {
-                "text": "CustomEvent<RadioCardChangeDetail>",
-                "references": [
-                  {
-                    "name": "RadioCardChangeDetail",
-                    "module": "./types/IRadioCard"
-                  }
-                ]
+                "text": "CustomEvent<string>"
               }
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Label content when no `label` prop is provided."
-            },
-            {
-              "name": "description",
-              "description": "Optional descriptive text rendered below the label."
             },
             {
-              "name": "icon",
-              "description": "Optional icon rendered to the left of the label."
+              "name": "valueChange",
+              "description": "Emit value Change for vue implementation",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
             }
           ],
-          "cssProperties": [
+          "slots": [
             {
-              "name": "--bds-radio-button-size - The size of the radio button. Default is 18px."
+              "name": "field",
+              "description": "The text field element that triggers the select dropdown. It should be a `bds-text-field` component."
             },
             {
-              "name": "--bds-radio-dot-size - The size of the dot inside the radio button. Default is 10px."
+              "name": "list",
+              "description": "The list menu element that contains the options for the select dropdown. It should be a `bds-list-menu` component."
             }
           ]
         }
@@ -4280,34 +6014,34 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsRadioCard",
+          "name": "BdsSelect",
           "declaration": {
-            "name": "BdsRadioCard"
+            "name": "BdsSelect"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-radio-card",
+          "name": "bds-select",
           "declaration": {
-            "name": "BdsRadioCard"
+            "name": "BdsSelect"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-radio-group/bds-radio-group.tsx",
+      "path": "src/components/forms/bds-slider/bds-slider.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-radio-group",
-          "name": "BdsRadioGroup",
-          "description": "Radio group component that orchestrates single-selection across a set of `bds-radio` children.",
+          "tagName": "bds-slider",
+          "name": "BdsSlider",
+          "description": "Slider component for selecting a numeric value or a range of values.",
           "attributes": [
             {
               "name": "disabled",
-              "description": "Disables all child radios and prevents selection. Also mirrored to isDisabled",
+              "description": "Disables the slider, preventing all user interaction. Defaults to `false`.",
               "type": {
                 "text": "boolean"
               },
@@ -4315,104 +6049,126 @@
               "fieldName": "disabled"
             },
             {
-              "name": "error",
-              "description": "Shows error styling on the group helper text. Propagated to all child radios.",
+              "name": "disabled-handlers",
+              "description": "JSON string array of handle values that should be individually disabled.\nEach number must match a value present in the `value` prop.\nAccepts `number`, `number[]`, or JSON string: `\"[5, 30]\"`.\nDefaults to `\"[]\"`.",
+              "type": {
+                "text": "number[] | string",
+                "references": [
+                  {
+                    "name": "SliderRawValue",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "'[]'",
+              "fieldName": "disabledHandlers"
+            },
+            {
+              "name": "discrete",
+              "description": "When `true`, renders discrete tick marks along the track\nat every step position between `min` and `max`.\nDefaults to `false`.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "error"
+              "fieldName": "discrete"
+            },
+            {
+              "name": "label",
+              "description": "Label for the slider. Defaults to `\"\"`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "label"
             },
             {
-              "name": "error-message",
-              "description": "Error message rendered below the radio options when error is true. Replaces helperText.",
+              "name": "max",
+              "description": "Maximum selectable value. Defaults to `100`.",
               "type": {
-                "text": "\"\""
+                "text": "number"
               },
-              "default": "''",
-              "fieldName": "errorMessage"
+              "default": "100",
+              "fieldName": "max"
             },
             {
-              "name": "helper-text",
-              "description": "Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.",
+              "name": "min",
+              "description": "Minimum selectable value. Defaults to `0`.",
               "type": {
-                "text": "\"\""
+                "text": "number"
               },
-              "default": "''",
-              "fieldName": "helperText"
+              "default": "0",
+              "fieldName": "min"
             },
             {
-              "name": "info",
-              "description": "Tooltip text shown on the group label info icon.",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "\"\""
+                "text": "string"
               },
               "default": "''",
-              "fieldName": "info"
+              "fieldName": "name"
             },
             {
-              "name": "label",
-              "description": "Group label rendered above the radio options.",
+              "name": "show-limits",
+              "description": "Shows the min and max values of the slider.\nDefaults to `false`.",
               "type": {
-                "text": "\"\""
+                "text": "boolean"
               },
-              "default": "''",
-              "fieldName": "label"
+              "default": "false",
+              "fieldName": "showLimits"
             },
             {
-              "name": "name",
-              "description": "Name of the form control; submitted as the field key in FormData.",
+              "name": "step",
+              "description": "Step size for each increment/decrement.\nMust be a positive number. Defaults to `1`.",
               "type": {
-                "text": "string"
+                "text": "number"
               },
-              "fieldName": "name"
+              "default": "1",
+              "fieldName": "step"
             },
             {
-              "name": "orientation",
-              "description": "Layout direction of the radio options.",
+              "name": "tooltip",
+              "description": "Controls tooltip visibility on each handle.\n- `\"never\"`  — tooltip is hidden.\n- `\"focus\"`  — tooltip appears only when the handle is active/focused.\nDefa ults to `\"focus\"`.",
               "type": {
-                "text": "\"horizontal\" | \"vertical\"",
+                "text": "\"focus\" | \"never\"",
                 "references": [
                   {
-                    "name": "Orientation",
-                    "module": "@/types"
+                    "name": "SliderTooltipType",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "ORIENTATIONS.VERTICAL",
-              "fieldName": "orientation"
-            },
-            {
-              "name": "required",
-              "description": "Marks the group as required for form submission. Triggers validity error when no radio is selected.",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "required"
+              "default": "SLIDER_TOOLTIP.FOCUS",
+              "fieldName": "tooltip"
             },
             {
               "name": "type",
-              "description": "Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element.",
+              "description": "Slider type that defines the slider behavior. Defaults to `single`.",
               "type": {
-                "text": "\"radio\" | \"radiobutton\" | \"radiocard\"",
+                "text": "\"range\" | \"single\"",
                 "references": [
                   {
-                    "name": "RadioGroupType",
-                    "module": "./types/types"
+                    "name": "SliderType",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "RADIO_GROUP_TYPES.RADIO",
+              "default": "SLIDER_TYPE.SINGLE",
               "fieldName": "type"
             },
             {
               "name": "value",
-              "description": "Currently selected radio value. Synced to children on change.",
+              "description": "Current value(s) of the slider.\nAccepts `number`, `number[]`, or a JSON string for HTML vanilla usage.\n- Single handle: `50` or `\"50\"`\n- Multi-handle:  `[10, 50, 80]` or `\"[10, 50, 80]\"`\n- Defaults to `0`.",
               "type": {
-                "text": "string"
+                "text": "number[] | string",
+                "references": [
+                  {
+                    "name": "SliderRawValue",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "''",
+              "default": "[0]",
               "fieldName": "value"
             }
           ],
@@ -4420,7 +6176,7 @@
             {
               "kind": "field",
               "name": "disabled",
-              "description": "Disables all child radios and prevents selection. Also mirrored to isDisabled",
+              "description": "Disables the slider, preventing all user interaction. Defaults to `false`.",
               "type": {
                 "text": "boolean"
               },
@@ -4431,115 +6187,138 @@
             },
             {
               "kind": "field",
-              "name": "error",
-              "description": "Shows error styling on the group helper text. Propagated to all child radios.",
+              "name": "disabledHandlers",
+              "description": "JSON string array of handle values that should be individually disabled.\nEach number must match a value present in the `value` prop.\nAccepts `number`, `number[]`, or JSON string: `\"[5, 30]\"`.\nDefaults to `\"[]\"`.",
               "type": {
-                "text": "boolean"
+                "text": "number[] | string",
+                "references": [
+                  {
+                    "name": "SliderRawValue",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "false",
+              "default": "'[]'",
               "readonly": true,
-              "attribute": "error",
+              "attribute": "disabled-handlers",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "errorMessage",
-              "description": "Error message rendered below the radio options when error is true. Replaces helperText.",
+              "name": "discrete",
+              "description": "When `true`, renders discrete tick marks along the track\nat every step position between `min` and `max`.\nDefaults to `false`.",
               "type": {
-                "text": "\"\""
+                "text": "boolean"
               },
-              "default": "''",
+              "default": "false",
               "readonly": true,
-              "attribute": "error-message"
+              "attribute": "discrete",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "helperText",
-              "description": "Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.",
+              "name": "label",
+              "description": "Label for the slider. Defaults to `\"\"`.",
               "type": {
-                "text": "\"\""
+                "text": "string"
               },
               "default": "''",
               "readonly": true,
-              "attribute": "helper-text"
+              "attribute": "label",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "info",
-              "description": "Tooltip text shown on the group label info icon.",
+              "name": "max",
+              "description": "Maximum selectable value. Defaults to `100`.",
               "type": {
-                "text": "\"\""
+                "text": "number"
               },
-              "default": "''",
+              "default": "100",
               "readonly": true,
-              "attribute": "info"
+              "attribute": "max",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "label",
-              "description": "Group label rendered above the radio options.",
+              "name": "min",
+              "description": "Minimum selectable value. Defaults to `0`.",
               "type": {
-                "text": "\"\""
+                "text": "number"
               },
-              "default": "''",
+              "default": "0",
               "readonly": true,
-              "attribute": "label"
+              "attribute": "min",
+              "reflects": true
             },
             {
               "kind": "field",
               "name": "name",
-              "description": "Name of the form control; submitted as the field key in FormData.",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
                 "text": "string"
               },
+              "default": "''",
               "readonly": true,
               "attribute": "name",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "orientation",
-              "description": "Layout direction of the radio options.",
+              "name": "showLimits",
+              "description": "Shows the min and max values of the slider.\nDefaults to `false`.",
               "type": {
-                "text": "\"horizontal\" | \"vertical\"",
-                "references": [
-                  {
-                    "name": "Orientation",
-                    "module": "@/types"
-                  }
-                ]
+                "text": "boolean"
               },
-              "default": "ORIENTATIONS.VERTICAL",
+              "default": "false",
               "readonly": true,
-              "attribute": "orientation",
+              "attribute": "show-limits",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "required",
-              "description": "Marks the group as required for form submission. Triggers validity error when no radio is selected.",
+              "name": "step",
+              "description": "Step size for each increment/decrement.\nMust be a positive number. Defaults to `1`.",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
+              "default": "1",
               "readonly": true,
-              "attribute": "required",
+              "attribute": "step",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "tooltip",
+              "description": "Controls tooltip visibility on each handle.\n- `\"never\"`  — tooltip is hidden.\n- `\"focus\"`  — tooltip appears only when the handle is active/focused.\nDefa ults to `\"focus\"`.",
+              "type": {
+                "text": "\"focus\" | \"never\"",
+                "references": [
+                  {
+                    "name": "SliderTooltipType",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "SLIDER_TOOLTIP.FOCUS",
+              "readonly": true,
+              "attribute": "tooltip",
               "reflects": true
             },
             {
               "kind": "field",
               "name": "type",
-              "description": "Identifies this group variant. 'radio' renders circular bds-radio children; 'radiobutton' renders bds-radio-button segmented control; 'radiocard' renders bds-radio-card element.",
+              "description": "Slider type that defines the slider behavior. Defaults to `single`.",
               "type": {
-                "text": "\"radio\" | \"radiobutton\" | \"radiocard\"",
+                "text": "\"range\" | \"single\"",
                 "references": [
                   {
-                    "name": "RadioGroupType",
-                    "module": "./types/types"
+                    "name": "SliderType",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "RADIO_GROUP_TYPES.RADIO",
+              "default": "SLIDER_TYPE.SINGLE",
               "readonly": true,
               "attribute": "type",
               "reflects": true
@@ -4547,20 +6326,27 @@
             {
               "kind": "field",
               "name": "value",
-              "description": "Currently selected radio value. Synced to children on change.",
+              "description": "Current value(s) of the slider.\nAccepts `number`, `number[]`, or a JSON string for HTML vanilla usage.\n- Single handle: `50` or `\"50\"`\n- Multi-handle:  `[10, 50, 80]` or `\"[10, 50, 80]\"`\n- Defaults to `0`.",
               "type": {
-                "text": "string"
+                "text": "number[] | string",
+                "references": [
+                  {
+                    "name": "SliderRawValue",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "''",
+              "default": "[0]",
+              "readonly": true,
               "attribute": "value"
             },
             {
               "kind": "method",
-              "name": "checkValidity",
-              "description": "Returns whether the group's current value satisfies the browser's built-in constraint validation.",
+              "name": "getValues",
+              "description": "Returns the current value(s) of the slider.\n- Single-handle → `number`\n- Multi-handle  → `number[]`",
               "return": {
                 "type": {
-                  "text": "Promise<boolean>",
+                  "text": "Promise<number[]>",
                   "references": [
                     {
                       "name": "Promise",
@@ -4572,15 +6358,38 @@
             },
             {
               "kind": "method",
-              "name": "reportValidity",
-              "description": "Reports the group's validity state to the user, showing native validation UI if invalid.",
+              "name": "setValues",
+              "description": "Programmatically sets the slider value(s).",
+              "parameters": [
+                {
+                  "name": "next",
+                  "description": "- A single `number` or an array of `number[]` matching the number of handles.",
+                  "type": {
+                    "text": "string | number[]",
+                    "references": [
+                      {
+                        "name": "Promise",
+                        "package": "global:"
+                      },
+                      {
+                        "name": "SliderRawValue",
+                        "module": "./types"
+                      }
+                    ]
+                  }
+                }
+              ],
               "return": {
                 "type": {
-                  "text": "Promise<boolean>",
+                  "text": "Promise<void>",
                   "references": [
                     {
                       "name": "Promise",
                       "package": "global:"
+                    },
+                    {
+                      "name": "SliderRawValue",
+                      "module": "./types"
                     }
                   ]
                 }
@@ -4590,35 +6399,36 @@
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the selected radio changes. Payload includes the new value.",
+              "description": "Emitted whenever the slider value(s) change due to user interaction.\nPayload: `{ value: number }` for single handle, `{ value: number[] }` for multi-handle.",
               "type": {
-                "text": "CustomEvent<RadioGroupChangeDetail>",
+                "text": "CustomEvent<SliderChangeDetail>",
                 "references": [
                   {
-                    "name": "RadioGroupChangeDetail",
-                    "module": "./types/IRadioGroup"
+                    "name": "SliderChangeDetail",
+                    "module": "./types"
                   }
                 ]
               }
             },
             {
-              "name": "valueChange",
-              "description": "Emitted when the selected radio changes. Used for v-model two-way binding in Vue.",
+              "name": "bdsClick",
+              "description": "Emitted when the user clicks on the slider.\nPayload: `{ target: HTMLElement }` and `{ value: number[] }` for multi-handle.",
               "type": {
-                "text": "CustomEvent<string>"
+                "text": "CustomEvent<{ target: HTMLElement; value: number[]; }>",
+                "references": [
+                  {
+                    "name": "HTMLElement",
+                    "package": "global:"
+                  }
+                ]
               }
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Default slot for `bds-radio` child elements."
-            }
-          ],
-          "cssProperties": [
+            },
             {
-              "name": "--layout-count",
-              "description": "Defines the number of columns for horizontal orientation. Default is 1."
+              "name": "valueChange",
+              "description": "Native-style alias of `bdsChange`. Emitted simultaneously.\nPayload: `{ value: number[] }` for multi-handle.",
+              "type": {
+                "text": "CustomEvent<number[]>"
+              }
             }
           ]
         }
@@ -4626,16 +6436,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsRadioGroup",
+          "name": "BdsSlider",
           "declaration": {
-            "name": "BdsRadioGroup"
+            "name": "BdsSlider"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-radio-group",
+          "name": "bds-slider",
           "declaration": {
-            "name": "BdsRadioGroup"
+            "name": "BdsSlider"
           }
         }
       ]
@@ -5217,6 +7027,15 @@
               "default": "''",
               "fieldName": "icon"
             },
+            {
+              "name": "icon-right",
+              "description": "Icon rendered on the right side of the input, on the actions containers. (e.g., 'bds-icon-settings')",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "iconRight"
+            },
             {
               "name": "info",
               "description": "Tooltip content attached to the label. Rendered via `bds-typography` `tooltipText` prop.",
@@ -5298,6 +7117,15 @@
               "default": "false",
               "fieldName": "required"
             },
+            {
+              "name": "selectable",
+              "description": "Set mode readonly to use in selects",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "selectable"
+            },
             {
               "name": "sublabel",
               "description": "Sublabel rendered inside the input container, before the text area.",
@@ -5502,6 +7330,17 @@
               "readonly": true,
               "attribute": "icon"
             },
+            {
+              "kind": "field",
+              "name": "iconRight",
+              "description": "Icon rendered on the right side of the input, on the actions containers. (e.g., 'bds-icon-settings')",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "icon-right"
+            },
             {
               "kind": "field",
               "name": "info",
@@ -5603,6 +7442,17 @@
               "attribute": "required",
               "reflects": true
             },
+            {
+              "kind": "field",
+              "name": "selectable",
+              "description": "Set mode readonly to use in selects",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "selectable"
+            },
             {
               "kind": "field",
               "name": "sublabel",
@@ -6517,6 +8367,21 @@
               "default": "1",
               "fieldName": "maxLines"
             },
+            {
+              "name": "rel",
+              "description": "Relationship between the current document and the linked resource.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ITypography",
+                    "module": "./types/ITypography"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "rel"
+            },
             {
               "name": "required",
               "description": "Marks the field as required.",
@@ -6756,6 +8621,23 @@
               "readonly": true,
               "attribute": "max-lines"
             },
+            {
+              "kind": "field",
+              "name": "rel",
+              "description": "Relationship between the current document and the linked resource.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ITypography",
+                    "module": "./types/ITypography"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "rel"
+            },
             {
               "kind": "field",
               "name": "required",