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

package/custom-elements.json

@@ -544,9 +544,9 @@
             },
             {
               "name": "size",
-              "description": "size is a string attribute. The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.",
+              "description": "size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.",
               "type": {
-                "text": "\"large\" | \"medium\" | \"small\"",
+                "text": "\"lg\" | \"md\" | \"sm\"",
                 "references": [
                   {
                     "name": "IButton",
@@ -694,9 +694,9 @@
             {
               "kind": "field",
               "name": "size",
-              "description": "size is a string attribute. The size of the button, which can be 'small', 'medium', or 'large'. Default is 'medium'.",
+              "description": "size is a string attribute. The size of the button, which can be 'sm', 'md', or 'lg'. Default is 'md'.",
               "type": {
-                "text": "\"large\" | \"medium\" | \"small\"",
+                "text": "\"lg\" | \"md\" | \"sm\"",
                 "references": [
                   {
                     "name": "IButton",
@@ -791,6 +791,205 @@
         }
       ]
     },
+    {
+      "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": "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": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "BUTTON_SIZES.MEDIUM",
+              "fieldName": "size"
+            },
+            {
+              "name": "variant",
+              "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": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "BUTTON_VARIANTS.DEFAULT",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "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",
+              "readonly": true,
+              "attribute": "color"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Provides an accessible label for the button group.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "'Button group'",
+              "readonly": true,
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "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",
+              "readonly": true,
+              "attribute": "orientation"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "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": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "default": "BUTTON_SIZES.MEDIUM",
+              "readonly": true,
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "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": "IButtonGroup",
+                    "module": "./types/IButtonGroup"
+                  }
+                ]
+              },
+              "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.tsx",
@@ -1016,214 +1215,338 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/overlays/bds-dialog/bds-dialog.tsx",
+      "path": "src/components/forms/bds-checkbox-card/bds-checkbox-card.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-dialog",
-          "name": "BdsDialog",
-          "description": "Modal dialog component for displaying content in an overlay.",
+          "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.",
           "attributes": [
             {
-              "name": "active",
-              "description": "Controls whether the dialog is open.",
+              "name": "checked",
+              "description": "Whether this checkbox card is selected.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "active"
+              "fieldName": "checked"
             },
             {
-              "name": "backdrop-close",
-              "description": "Close dialog when clicking the backdrop.",
+              "name": "disabled",
+              "description": "Disables the control.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "backdropClose"
+              "fieldName": "disabled"
             },
             {
-              "name": "closable",
-              "description": "Hide the close button in the header.",
+              "name": "error",
+              "description": "Whether the checkbox card is in an error state.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "closable"
-            },
-            {
-              "name": "content-padding",
-              "description": "Content padding: 'default' or 'none'.",
-              "type": {
-                "text": "\"default\" | \"none\"",
-                "references": [
-                  {
-                    "name": "IDialog",
-                    "module": "./types"
-                  }
-                ]
-              },
-              "default": "DIALOG_CONTENT_PADDING.DEFAULT",
-              "fieldName": "contentPadding"
+              "fieldName": "error"
             },
             {
-              "name": "escape-close",
-              "description": "Close dialog when pressing Escape.",
+              "name": "indeterminate",
+              "description": "Whether the checkbox card shows an indeterminate visual state.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "escapeClose"
+              "fieldName": "indeterminate"
             },
             {
-              "name": "height",
-              "description": "Dialog custom height",
+              "name": "label",
+              "description": "Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "''",
-              "fieldName": "height"
+              "fieldName": "label"
             },
             {
-              "name": "layout",
-              "description": "Layout type: 'default', 'headerless', or 'footerless'.",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "\"default\" | \"footerless\" | \"headerless\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
-              "default": "DIALOG_LAYOUT.DEFAULT",
-              "fieldName": "layout"
+              "fieldName": "name"
             },
             {
-              "name": "maximizable",
-              "description": "Show maximize button to toggle full-screen.",
+              "name": "required",
+              "description": "Marks the control as required for form submission.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "maximizable"
+              "fieldName": "required"
             },
             {
-              "name": "prevent-close",
-              "description": "Controls whether the dialog is closable.",
+              "name": "value",
+              "description": "Value submitted with the form when this checkbox is selected.",
               "type": {
-                "text": "boolean",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "preventClose"
-            },
+              "default": "'on'",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
             {
-              "name": "size",
-              "description": "Dialog size: 'small', 'medium', 'large', or 'full'.",
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether this checkbox card is selected.",
               "type": {
-                "text": "\"full\" | \"lg\" | \"md\" | \"sm\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
-              "default": "DIALOG_SIZES.MEDIUM",
-              "fieldName": "size"
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
             },
             {
-              "name": "title-dialog",
-              "description": "Title text displayed in the header.",
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the control.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "error",
+              "description": "Whether the checkbox card is in an error state.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "indeterminate",
+              "description": "Whether the checkbox card shows an indeterminate visual state.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
+              },
+              "default": "false",
+              "attribute": "indeterminate",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Label text displayed next to the checkbox indicator. Falls back to the default slot when empty.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
               "default": "''",
-              "fieldName": "titleDialog"
+              "readonly": true,
+              "attribute": "label"
             },
             {
-              "name": "variant",
-              "description": "Visual variant: 'default', 'info', 'success', 'warning', or 'danger'.",
+              "kind": "field",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "\"danger\" | \"default\" | \"info\" | \"success\" | \"warning\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
-              "default": "DIALOG_VARIANT.DEFAULT",
-              "fieldName": "variant"
+              "readonly": true,
+              "attribute": "name",
+              "reflects": true
             },
             {
-              "name": "width",
-              "description": "Dialog custom width",
+              "kind": "field",
+              "name": "required",
+              "description": "Marks the control as required for form submission.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "required",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Value submitted with the form when this checkbox is selected.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IDialog",
-                    "module": "./types"
+                    "name": "ICheckboxCard",
+                    "module": "./types/ICheckboxCard"
                   }
                 ]
               },
-              "default": "''",
-              "fieldName": "width"
+              "default": "'on'",
+              "readonly": true,
+              "attribute": "value",
+              "reflects": true
             }
           ],
-          "members": [
+          "events": [
+            {
+              "name": "bdsChange",
+              "description": "Emitted when the user toggles this checkbox card.",
+              "type": {
+                "text": "CustomEvent<any>"
+              }
+            },
+            {
+              "name": "valueChange",
+              "description": "Emitted when the checked state changes. Useful for 2-way binding / v-model.",
+              "type": {
+                "text": "CustomEvent<any>"
+              }
+            }
+          ],
+          "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."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsCheckboxCard",
+          "declaration": {
+            "name": "BdsCheckboxCard"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-checkbox-card",
+          "declaration": {
+            "name": "BdsCheckboxCard"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/overlays/bds-dialog/bds-dialog.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-dialog",
+          "name": "BdsDialog",
+          "description": "Modal dialog component for displaying content in an overlay.",
+          "attributes": [
             {
-              "kind": "field",
               "name": "active",
               "description": "Controls whether the dialog is open.",
               "type": {
@@ -1236,12 +1559,10 @@
                 ]
               },
               "default": "false",
-              "attribute": "active",
-              "reflects": true
+              "fieldName": "active"
             },
             {
-              "kind": "field",
-              "name": "backdropClose",
+              "name": "backdrop-close",
               "description": "Close dialog when clicking the backdrop.",
               "type": {
                 "text": "boolean",
@@ -1253,11 +1574,9 @@
                 ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "backdrop-close"
+              "fieldName": "backdropClose"
             },
             {
-              "kind": "field",
               "name": "closable",
               "description": "Hide the close button in the header.",
               "type": {
@@ -1270,12 +1589,10 @@
                 ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "closable"
+              "fieldName": "closable"
             },
             {
-              "kind": "field",
-              "name": "contentPadding",
+              "name": "content-padding",
               "description": "Content padding: 'default' or 'none'.",
               "type": {
                 "text": "\"default\" | \"none\"",
@@ -1287,12 +1604,10 @@
                 ]
               },
               "default": "DIALOG_CONTENT_PADDING.DEFAULT",
-              "readonly": true,
-              "attribute": "content-padding"
+              "fieldName": "contentPadding"
             },
             {
-              "kind": "field",
-              "name": "escapeClose",
+              "name": "escape-close",
               "description": "Close dialog when pressing Escape.",
               "type": {
                 "text": "boolean",
@@ -1304,11 +1619,9 @@
                 ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "escape-close"
+              "fieldName": "escapeClose"
             },
             {
-              "kind": "field",
               "name": "height",
               "description": "Dialog custom height",
               "type": {
@@ -1321,11 +1634,9 @@
                 ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "height"
+              "fieldName": "height"
             },
             {
-              "kind": "field",
               "name": "layout",
               "description": "Layout type: 'default', 'headerless', or 'footerless'.",
               "type": {
@@ -1338,11 +1649,9 @@
                 ]
               },
               "default": "DIALOG_LAYOUT.DEFAULT",
-              "readonly": true,
-              "attribute": "layout"
+              "fieldName": "layout"
             },
             {
-              "kind": "field",
               "name": "maximizable",
               "description": "Show maximize button to toggle full-screen.",
               "type": {
@@ -1355,12 +1664,10 @@
                 ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "maximizable"
+              "fieldName": "maximizable"
             },
             {
-              "kind": "field",
-              "name": "preventClose",
+              "name": "prevent-close",
               "description": "Controls whether the dialog is closable.",
               "type": {
                 "text": "boolean",
@@ -1372,11 +1679,9 @@
                 ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "prevent-close"
+              "fieldName": "preventClose"
             },
             {
-              "kind": "field",
               "name": "size",
               "description": "Dialog size: 'small', 'medium', 'large', or 'full'.",
               "type": {
@@ -1389,12 +1694,10 @@
                 ]
               },
               "default": "DIALOG_SIZES.MEDIUM",
-              "readonly": true,
-              "attribute": "size"
+              "fieldName": "size"
             },
             {
-              "kind": "field",
-              "name": "titleDialog",
+              "name": "title-dialog",
               "description": "Title text displayed in the header.",
               "type": {
                 "text": "string",
@@ -1406,11 +1709,9 @@
                 ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "title-dialog"
+              "fieldName": "titleDialog"
             },
             {
-              "kind": "field",
               "name": "variant",
               "description": "Visual variant: 'default', 'info', 'success', 'warning', or 'danger'.",
               "type": {
@@ -1423,11 +1724,9 @@
                 ]
               },
               "default": "DIALOG_VARIANT.DEFAULT",
-              "readonly": true,
-              "attribute": "variant"
+              "fieldName": "variant"
             },
             {
-              "kind": "field",
               "name": "width",
               "description": "Dialog custom width",
               "type": {
@@ -1440,73 +1739,1260 @@
                 ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "width"
-            },
-            {
-              "kind": "method",
-              "name": "close",
-              "description": "Closes the dialog programmatically.\nThis method triggers the close functionality to hide the dialog.",
-              "return": {
-                "type": {
-                  "text": "Promise<void>",
-                  "references": [
-                    {
-                      "name": "Promise",
-                      "package": "global:"
-                    }
-                  ]
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "open",
-              "description": "Opens the dialog programmatically.\nThis method triggers the show functionality to display the dialog.",
-              "return": {
-                "type": {
-                  "text": "Promise<void>",
-                  "references": [
-                    {
-                      "name": "Promise",
-                      "package": "global:"
-                    }
-                  ]
-                }
-              }
+              "fieldName": "width"
             }
           ],
-          "events": [
-            {
-              "name": "bdsClose",
-              "description": "Emitted when the dialog closes.",
-              "type": {
-                "text": "CustomEvent<void>"
-              }
-            },
+          "members": [
             {
-              "name": "bdsMaximize",
-              "description": "Emitted when the dialog maximize button is clicked.",
+              "kind": "field",
+              "name": "active",
+              "description": "Controls whether the dialog is open.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "attribute": "active",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "backdropClose",
+              "description": "Close dialog when clicking the backdrop.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "backdrop-close"
+            },
+            {
+              "kind": "field",
+              "name": "closable",
+              "description": "Hide the close button in the header.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "closable"
+            },
+            {
+              "kind": "field",
+              "name": "contentPadding",
+              "description": "Content padding: 'default' or 'none'.",
+              "type": {
+                "text": "\"default\" | \"none\"",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "DIALOG_CONTENT_PADDING.DEFAULT",
+              "readonly": true,
+              "attribute": "content-padding"
+            },
+            {
+              "kind": "field",
+              "name": "escapeClose",
+              "description": "Close dialog when pressing Escape.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "escape-close"
+            },
+            {
+              "kind": "field",
+              "name": "height",
+              "description": "Dialog custom height",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "height"
+            },
+            {
+              "kind": "field",
+              "name": "layout",
+              "description": "Layout type: 'default', 'headerless', or 'footerless'.",
+              "type": {
+                "text": "\"default\" | \"footerless\" | \"headerless\"",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "DIALOG_LAYOUT.DEFAULT",
+              "readonly": true,
+              "attribute": "layout"
+            },
+            {
+              "kind": "field",
+              "name": "maximizable",
+              "description": "Show maximize button to toggle full-screen.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "maximizable"
+            },
+            {
+              "kind": "field",
+              "name": "preventClose",
+              "description": "Controls whether the dialog is closable.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "prevent-close"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "Dialog size: 'small', 'medium', 'large', or 'full'.",
+              "type": {
+                "text": "\"full\" | \"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "DIALOG_SIZES.MEDIUM",
+              "readonly": true,
+              "attribute": "size"
+            },
+            {
+              "kind": "field",
+              "name": "titleDialog",
+              "description": "Title text displayed in the header.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "title-dialog"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Visual variant: 'default', 'info', 'success', 'warning', or 'danger'.",
+              "type": {
+                "text": "\"danger\" | \"default\" | \"info\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "DIALOG_VARIANT.DEFAULT",
+              "readonly": true,
+              "attribute": "variant"
+            },
+            {
+              "kind": "field",
+              "name": "width",
+              "description": "Dialog custom width",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IDialog",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "width"
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "description": "Closes the dialog programmatically.\nThis method triggers the close functionality to hide the dialog.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "open",
+              "description": "Opens the dialog programmatically.\nThis method triggers the show functionality to display the dialog.",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsClose",
+              "description": "Emitted when the dialog closes.",
               "type": {
                 "text": "CustomEvent<void>"
               }
             },
             {
-              "name": "bdsOpen",
-              "description": "Emitted when the dialog opens.",
+              "name": "bdsMaximize",
+              "description": "Emitted when the dialog maximize button is clicked.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            },
+            {
+              "name": "bdsOpen",
+              "description": "Emitted when the dialog opens.",
+              "type": {
+                "text": "CustomEvent<void>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Main content of the dialog body."
+            },
+            {
+              "name": "footer",
+              "description": "Content for the dialog footer (e.g. action buttons)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsDialog",
+          "declaration": {
+            "name": "BdsDialog"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-dialog",
+          "declaration": {
+            "name": "BdsDialog"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/helpers/bds-divider/bds-divider.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-divider",
+          "name": "BdsDivider",
+          "description": "Divider component for creating visual separators between content sections.",
+          "attributes": [
+            {
+              "name": "orientation",
+              "description": "The orientation of the divider.\nAllowed values: horizontal | vertical",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "IDivider",
+                    "module": "./types/IDivider"
+                  }
+                ]
+              },
+              "default": "DIVIDER_ORIENTATIONS.HORIZONTAL",
+              "fieldName": "orientation"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "orientation",
+              "description": "The orientation of the divider.\nAllowed values: horizontal | vertical",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "IDivider",
+                    "module": "./types/IDivider"
+                  }
+                ]
+              },
+              "default": "DIVIDER_ORIENTATIONS.HORIZONTAL",
+              "readonly": true,
+              "attribute": "orientation",
+              "reflects": true
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "divider"
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bds-divider-color",
+              "description": "Custom color for the divider. Default is $boreal-ui-default-lighter."
+            },
+            {
+              "name": "--bds-divider-gap",
+              "description": "Custom gap between dividers. Default is $boreal-spacing-3xs."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsDivider",
+          "declaration": {
+            "name": "BdsDivider"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-divider",
+          "declaration": {
+            "name": "BdsDivider"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/forms/bds-flag/bds-flag.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-flag",
+          "name": "BdsFlag",
+          "description": "Flag component used to display a country flag together with its corresponding label.",
+          "attributes": [
+            {
+              "name": "align-flag",
+              "description": "Determines whether the flag is displayed on the left or right side of the label.",
+              "type": {
+                "text": "\"left\" | \"right\"",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "AlignFlag.LEFT",
+              "fieldName": "alignFlag"
+            },
+            {
+              "name": "call-sign",
+              "description": "Whether the country calling code should be displayed next to the label.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "callSign"
+            },
+            {
+              "name": "country",
+              "description": "Country value used to resolve the matching flag entry.\n\nThe expected value depends on the configured `identifier`.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "country"
+            },
+            {
+              "name": "identifier",
+              "description": "Defines which field should be used to identify the country.\nFor example, code, iso2, or iso3.",
+              "type": {
+                "text": "\"code\" | \"iso2\" | \"iso3\"",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "FlagIdentifier.CODE",
+              "fieldName": "identifier"
+            },
+            {
+              "name": "label",
+              "description": "Whether the country name label should be displayed next to the flag.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "label"
+            },
+            {
+              "name": "shape",
+              "description": "Visual shape used to render the flag.",
+              "type": {
+                "text": "\"circle\" | \"rectangle\" | \"square\"",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "Shape.RECTANGLE",
+              "fieldName": "shape"
+            },
+            {
+              "name": "short-name",
+              "description": "Whether the abbreviated country name (ISO2/ISO3) should be displayed instead of the full name.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "shortName"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "alignFlag",
+              "description": "Determines whether the flag is displayed on the left or right side of the label.",
+              "type": {
+                "text": "\"left\" | \"right\"",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "AlignFlag.LEFT",
+              "readonly": true,
+              "attribute": "align-flag"
+            },
+            {
+              "kind": "field",
+              "name": "callSign",
+              "description": "Whether the country calling code should be displayed next to the label.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "call-sign"
+            },
+            {
+              "kind": "field",
+              "name": "country",
+              "description": "Country value used to resolve the matching flag entry.\n\nThe expected value depends on the configured `identifier`.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "country"
+            },
+            {
+              "kind": "field",
+              "name": "customFlags",
+              "description": "Custom flag definitions merged with the default country catalog.\n\nCustom entries can override default asset sources when the same `iso2` is used.",
+              "type": {
+                "text": "ICountry[]",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "[]",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "identifier",
+              "description": "Defines which field should be used to identify the country.\nFor example, code, iso2, or iso3.",
+              "type": {
+                "text": "\"code\" | \"iso2\" | \"iso3\"",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "FlagIdentifier.CODE",
+              "readonly": true,
+              "attribute": "identifier"
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Whether the country name label should be displayed next to the flag.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "shape",
+              "description": "Visual shape used to render the flag.",
+              "type": {
+                "text": "\"circle\" | \"rectangle\" | \"square\"",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "Shape.RECTANGLE",
+              "readonly": true,
+              "attribute": "shape"
+            },
+            {
+              "kind": "field",
+              "name": "shortName",
+              "description": "Whether the abbreviated country name (ISO2/ISO3) should be displayed instead of the full name.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IFlag",
+                    "module": "./interfaces/IFlag"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "short-name"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsFlag",
+          "declaration": {
+            "name": "BdsFlag"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-flag",
+          "declaration": {
+            "name": "BdsFlag"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/layouts/bds-grid/grid/bds-grid.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-grid",
+          "name": "BdsGrid",
+          "description": "12-column CSS Grid layout container with 5 responsive breakpoints.\n\nMinimum browser support: Chrome/Edge (last 2), Firefox (last 2), Safari (last 2).",
+          "attributes": [
+            {
+              "name": "layout",
+              "description": "`'fluid'` fills full width; `'fixed'` caps the column area at 960px and centres the container.",
+              "type": {
+                "text": "\"fixed\" | \"fluid\"",
+                "references": [
+                  {
+                    "name": "IGrid",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "GRID_LAYOUT.FLUID",
+              "fieldName": "layout"
+            },
+            {
+              "name": "row-gap",
+              "description": "Overrides the row gap independently of the column gutter.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IGrid",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "rowGap"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "layout",
+              "description": "`'fluid'` fills full width; `'fixed'` caps the column area at 960px and centres the container.",
+              "type": {
+                "text": "\"fixed\" | \"fluid\"",
+                "references": [
+                  {
+                    "name": "IGrid",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "GRID_LAYOUT.FLUID",
+              "readonly": true,
+              "attribute": "layout"
+            },
+            {
+              "kind": "field",
+              "name": "rowGap",
+              "description": "Overrides the row gap independently of the column gutter.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IGrid",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "row-gap"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Direct `bds-grid-item` children."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bds-grid-nav-offset",
+              "description": "Left offset reserved for navigation. Set to `64px` (global nav only) or `294px` (global + container nav)."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsGrid",
+          "declaration": {
+            "name": "BdsGrid"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-grid",
+          "declaration": {
+            "name": "BdsGrid"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/layouts/bds-grid/grid-item/bds-grid-item.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-grid-item",
+          "name": "BdsGridItem",
+          "description": "Grid item child of `bds-grid`. Must be a direct child of `bds-grid`.",
+          "attributes": [
+            {
+              "name": "col-span",
+              "description": "Column span at all breakpoints (fallback). `'full'` spans all columns (`grid-column: 1 / -1`).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "GRID_ITEM_COL_SPAN.DEFAULT",
+              "fieldName": "colSpan"
+            },
+            {
+              "name": "col-span-2xl",
+              "description": "Override col-span at the `2xl` breakpoint (≥1344px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "colSpan2xl"
+            },
+            {
+              "name": "col-span-lg",
+              "description": "Override col-span at the `lg` breakpoint (≥960px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "colSpanLg"
+            },
+            {
+              "name": "col-span-md",
+              "description": "Override col-span at the `md` breakpoint (≥769px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "colSpanMd"
+            },
+            {
+              "name": "col-span-sm",
+              "description": "Override col-span at the `sm` breakpoint (≥320px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "colSpanSm"
+            },
+            {
+              "name": "col-span-xl",
+              "description": "Override col-span at the `xl` breakpoint (≥1152px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "colSpanXl"
+            },
+            {
+              "name": "offset",
+              "description": "Column offset: shifts the item right by N columns (0–11).",
+              "type": {
+                "text": "number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "0",
+              "fieldName": "offset"
+            },
+            {
+              "name": "row-span",
+              "description": "Row span. `'full'` maps to `grid-row: 1 / -1`.",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "fieldName": "rowSpan"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "colSpan",
+              "description": "Column span at all breakpoints (fallback). `'full'` spans all columns (`grid-column: 1 / -1`).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "GRID_ITEM_COL_SPAN.DEFAULT",
+              "readonly": true,
+              "attribute": "col-span",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "colSpan2xl",
+              "description": "Override col-span at the `2xl` breakpoint (≥1344px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "col-span-2xl",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "colSpanLg",
+              "description": "Override col-span at the `lg` breakpoint (≥960px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "col-span-lg",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "colSpanMd",
+              "description": "Override col-span at the `md` breakpoint (≥769px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "col-span-md",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "colSpanSm",
+              "description": "Override col-span at the `sm` breakpoint (≥320px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "col-span-sm",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "colSpanXl",
+              "description": "Override col-span at the `xl` breakpoint (≥1152px).",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "col-span-xl",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "offset",
+              "description": "Column offset: shifts the item right by N columns (0–11).",
+              "type": {
+                "text": "number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "0",
+              "readonly": true,
+              "attribute": "offset",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rowSpan",
+              "description": "Row span. `'full'` maps to `grid-row: 1 / -1`.",
+              "type": {
+                "text": "\"full\" | number",
+                "references": [
+                  {
+                    "name": "IGridItem",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "readonly": true,
+              "attribute": "row-span",
+              "reflects": true
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Item content. The grid item manages position only — content styling is\nthe responsibility of the slotted element."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsGridItem",
+          "declaration": {
+            "name": "BdsGridItem"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-grid-item",
+          "declaration": {
+            "name": "BdsGridItem"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/actions/bds-list-menu/bds-list-menu/bds-list-menu.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-list-menu",
+          "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": "menu-role",
+              "description": "Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.",
+              "type": {
+                "text": "\"listbox\" | \"menu\"",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "MENU_ROLES.MENU",
+              "fieldName": "menuRole"
+            },
+            {
+              "name": "select-controls",
+              "description": "Determines if the menu items have selectall/deselectall controls",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "selectControls"
+            },
+            {
+              "name": "selection-mode",
+              "description": "The selection mode of the menu. Can be 'SINGLE' or 'MULTIPLE'. Default is 'SINGLE'.",
+              "type": {
+                "text": "\"multiple\" | \"single\"",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "LIST_MENU_SELECTION_MODE.SINGLE",
+              "fieldName": "selectionMode"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "menuRole",
+              "description": "Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.",
+              "type": {
+                "text": "\"listbox\" | \"menu\"",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "MENU_ROLES.MENU",
+              "readonly": true,
+              "attribute": "menu-role"
+            },
+            {
+              "kind": "field",
+              "name": "selectControls",
+              "description": "Determines if the menu items have selectall/deselectall controls",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "select-controls"
+            },
+            {
+              "kind": "field",
+              "name": "selectionMode",
+              "description": "The selection mode of the menu. Can be 'SINGLE' or 'MULTIPLE'. Default is 'SINGLE'.",
+              "type": {
+                "text": "\"multiple\" | \"single\"",
+                "references": [
+                  {
+                    "name": "IListMenu",
+                    "module": "./types/IListMenu"
+                  }
+                ]
+              },
+              "default": "LIST_MENU_SELECTION_MODE.SINGLE",
+              "readonly": true,
+              "attribute": "selection-mode"
+            },
+            {
+              "kind": "method",
+              "name": "getSelectedValues",
+              "description": "Retrieves the currently selected value(s) programmatically.",
+              "return": {
+                "type": {
+                  "text": "Promise<string | string[]>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                },
+                "description": "The selected value(s) based on the 'multiple' prop."
+              }
+            },
+            {
+              "kind": "method",
+              "name": "setSelectedValues",
+              "description": "Sets the selected values programmatically.\nUseful for initializing the menu from an external data source or form reset.",
+              "parameters": [
+                {
+                  "name": "values",
+                  "description": "- The value or values to be marked as selected.",
+                  "type": {
+                    "text": "string | string[]",
+                    "references": [
+                      {
+                        "name": "Promise",
+                        "package": "global:"
+                      }
+                    ]
+                  }
+                }
+              ],
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsChange",
+              "description": "Emitted when the selection changes, providing the current selected value(s).",
               "type": {
-                "text": "CustomEvent<void>"
+                "text": "CustomEvent<string | string[]>"
+              }
+            },
+            {
+              "name": "bdsSelect",
+              "description": "Emitted when the selection changes, providing the current selected value(s).",
+              "type": {
+                "text": "CustomEvent<ListMenuChangeDetail>",
+                "references": [
+                  {
+                    "name": "ListMenuChangeDetail",
+                    "module": "./types/IListMenu"
+                  }
+                ]
               }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Main content of the dialog body."
+              "description": "Default slot for bds-list-menu-item elements."
+            }
+          ],
+          "cssProperties": [
+            {
+              "name": "--bds-list-menu-max-height - The maximum height of the list menu content. Default is 240px."
             },
             {
-              "name": "footer",
-              "description": "Content for the dialog footer (e.g. action buttons)."
+              "name": "--bds-list-menu-max-width - The maximum width of the list menu. Default is 350px."
             }
           ]
         }
@@ -1514,343 +3000,378 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsDialog",
+          "name": "BdsListMenu",
           "declaration": {
-            "name": "BdsDialog"
+            "name": "BdsListMenu"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-dialog",
+          "name": "bds-list-menu",
           "declaration": {
-            "name": "BdsDialog"
+            "name": "BdsListMenu"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/helpers/bds-divider.tsx",
+      "path": "src/components/actions/bds-list-menu/bds-list-menu-item/bds-list-menu-item.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-divider",
-          "name": "BdsDivider",
-          "description": "Divider component for creating visual separators between content sections.",
+          "tagName": "bds-list-menu-item",
+          "name": "BdsListMenuItem",
+          "description": "Component representing an individual item within a list menu for navigations and selection.",
           "attributes": [
             {
-              "name": "orientation",
-              "description": "The orientation of the divider.\nAllowed values: horizontal | vertical",
+              "name": "active-item",
+              "description": "Active state item",
               "type": {
-                "text": "\"horizontal\" | \"vertical\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IDivider",
-                    "module": "./types/IDivider"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "DIVIDER_ORIENTATIONS.HORIZONTAL",
-              "fieldName": "orientation"
-            }
-          ],
-          "members": [
+              "default": "false",
+              "fieldName": "activeItem"
+            },
             {
-              "kind": "field",
-              "name": "orientation",
-              "description": "The orientation of the divider.\nAllowed values: horizontal | vertical",
+              "name": "checkable",
+              "description": "Checkable state item, if is activated should be visible a checkbox",
               "type": {
-                "text": "\"horizontal\" | \"vertical\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IDivider",
-                    "module": "./types/IDivider"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "DIVIDER_ORIENTATIONS.HORIZONTAL",
-              "readonly": true,
-              "attribute": "orientation",
-              "reflects": true
-            }
-          ],
-          "cssParts": [
+              "default": "false",
+              "fieldName": "checkable"
+            },
             {
-              "name": "divider"
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "BdsDivider",
-          "declaration": {
-            "name": "BdsDivider"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "bds-divider",
-          "declaration": {
-            "name": "BdsDivider"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/forms/bds-flag/bds-flag.tsx",
-      "declarations": [
-        {
-          "kind": "class",
-          "customElement": true,
-          "tagName": "bds-flag",
-          "name": "BdsFlag",
-          "description": "Flag component used to display a country flag together with its corresponding label.",
-          "attributes": [
+              "name": "disabled",
+              "description": "Disabled state item",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
             {
-              "name": "align-flag",
-              "description": "Determines whether the flag is displayed on the left or right side of the label.",
+              "name": "download",
+              "description": "Makes the link downloadable if true",
               "type": {
-                "text": "\"left\" | \"right\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "AlignFlag.LEFT",
-              "fieldName": "alignFlag"
+              "default": "''",
+              "fieldName": "download"
             },
             {
-              "name": "call-sign",
-              "description": "Whether the country calling code should be displayed next to the label.",
+              "name": "href",
+              "description": "Link behavior props",
               "type": {
-                "text": "boolean",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "callSign"
+              "default": "''",
+              "fieldName": "href"
             },
             {
-              "name": "country",
-              "description": "Country value used to resolve the matching flag entry.\n\nThe expected value depends on the configured `identifier`.",
+              "name": "name",
+              "description": "The name of the list menu item",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
               "default": "''",
-              "fieldName": "country"
+              "fieldName": "name"
             },
             {
-              "name": "identifier",
-              "description": "Defines which field should be used to identify the country.\nFor example, code, iso2, or iso3.",
+              "name": "new-tab",
+              "description": "Opens the link in a new tab if true",
               "type": {
-                "text": "\"code\" | \"iso2\" | \"iso3\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "FlagIdentifier.CODE",
-              "fieldName": "identifier"
+              "default": "false",
+              "fieldName": "newTab"
             },
             {
-              "name": "label",
-              "description": "Whether the country name label should be displayed next to the flag.",
+              "name": "selected",
+              "description": "Selected item state",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "label"
+              "fieldName": "selected"
             },
             {
-              "name": "shape",
-              "description": "Visual shape used to render the flag.",
+              "name": "value",
+              "description": "Value associated with the menu item",
               "type": {
-                "text": "\"circle\" | \"rectangle\" | \"square\"",
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "value"
+            },
+            {
+              "name": "variant",
+              "description": "Defines the visual style of the list menu item.\n- 'button': A standard clickable item.\n- 'label': A non-interactive label, typically used for grouping items.",
+              "type": {
+                "text": "\"button\" | \"label\"",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "LIST_MENU_ITEM_VARIANTS.BUTTON",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "activeItem",
+              "description": "Active state item",
+              "type": {
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "Shape.RECTANGLE",
-              "fieldName": "shape"
+              "default": "false",
+              "readonly": true,
+              "attribute": "active-item",
+              "reflects": true
             },
             {
-              "name": "short-name",
-              "description": "Whether the abbreviated country name (ISO2/ISO3) should be displayed instead of the full name.",
+              "kind": "field",
+              "name": "checkable",
+              "description": "Checkable state item, if is activated should be visible a checkbox",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "shortName"
-            }
-          ],
-          "members": [
+              "readonly": true,
+              "attribute": "checkable",
+              "reflects": true
+            },
             {
               "kind": "field",
-              "name": "alignFlag",
-              "description": "Determines whether the flag is displayed on the left or right side of the label.",
+              "name": "disabled",
+              "description": "Disabled state item",
               "type": {
-                "text": "\"left\" | \"right\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "AlignFlag.LEFT",
+              "default": "false",
               "readonly": true,
-              "attribute": "align-flag"
+              "attribute": "disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "callSign",
-              "description": "Whether the country calling code should be displayed next to the label.",
+              "name": "download",
+              "description": "Makes the link downloadable if true",
               "type": {
-                "text": "boolean",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "false",
+              "default": "''",
               "readonly": true,
-              "attribute": "call-sign"
+              "attribute": "download"
             },
             {
               "kind": "field",
-              "name": "country",
-              "description": "Country value used to resolve the matching flag entry.\n\nThe expected value depends on the configured `identifier`.",
+              "name": "href",
+              "description": "Link behavior props",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
               "default": "''",
               "readonly": true,
-              "attribute": "country"
+              "attribute": "href"
             },
             {
               "kind": "field",
-              "name": "customFlags",
-              "description": "Custom flag definitions merged with the default country catalog.\n\nCustom entries can override default asset sources when the same `iso2` is used.",
+              "name": "name",
+              "description": "The name of the list menu item",
               "type": {
-                "text": "ICountry[]",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "[]",
-              "readonly": true
+              "default": "''",
+              "readonly": true,
+              "attribute": "name"
             },
             {
               "kind": "field",
-              "name": "identifier",
-              "description": "Defines which field should be used to identify the country.\nFor example, code, iso2, or iso3.",
+              "name": "newTab",
+              "description": "Opens the link in a new tab if true",
               "type": {
-                "text": "\"code\" | \"iso2\" | \"iso3\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "FlagIdentifier.CODE",
+              "default": "false",
               "readonly": true,
-              "attribute": "identifier"
+              "attribute": "new-tab"
             },
             {
               "kind": "field",
-              "name": "label",
-              "description": "Whether the country name label should be displayed next to the flag.",
+              "name": "selected",
+              "description": "Selected item state",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "label"
+              "attribute": "selected",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "shape",
-              "description": "Visual shape used to render the flag.",
+              "name": "value",
+              "description": "Value associated with the menu item",
               "type": {
-                "text": "\"circle\" | \"rectangle\" | \"square\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "Shape.RECTANGLE",
+              "default": "''",
               "readonly": true,
-              "attribute": "shape"
+              "attribute": "value",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "shortName",
-              "description": "Whether the abbreviated country name (ISO2/ISO3) should be displayed instead of the full name.",
+              "name": "variant",
+              "description": "Defines the visual style of the list menu item.\n- 'button': A standard clickable item.\n- 'label': A non-interactive label, typically used for grouping items.",
               "type": {
-                "text": "boolean",
+                "text": "\"button\" | \"label\"",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
                   }
                 ]
               },
-              "default": "false",
+              "default": "LIST_MENU_ITEM_VARIANTS.BUTTON",
               "readonly": true,
-              "attribute": "short-name"
+              "attribute": "variant",
+              "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsSelectItem",
+              "description": "Event handler for activation",
+              "type": {
+                "text": "CustomEvent<IListMenuItemEvent>",
+                "references": [
+                  {
+                    "name": "IListMenuItemEvent",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot for the content of the menu item."
             }
           ]
         }
@@ -1858,106 +3379,201 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsFlag",
+          "name": "BdsListMenuItem",
           "declaration": {
-            "name": "BdsFlag"
+            "name": "BdsListMenuItem"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-flag",
+          "name": "bds-list-menu-item",
           "declaration": {
-            "name": "BdsFlag"
+            "name": "BdsListMenuItem"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/layouts/bds-grid/grid/bds-grid.tsx",
+      "path": "src/components/overlays/bds-popover/bds-popover.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-grid",
-          "name": "BdsGrid",
-          "description": "12-column CSS Grid layout container with 5 responsive breakpoints.\n\nMinimum browser support: Chrome/Edge (last 2), Firefox (last 2), Safari (last 2).",
+          "tagName": "bds-popover",
+          "name": "BdsPopover",
           "attributes": [
             {
-              "name": "layout",
-              "description": "`'fluid'` fills full width; `'fixed'` caps the column area at 960px and centres the container.",
+              "name": "closable",
+              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
               "type": {
-                "text": "\"fixed\" | \"fluid\"",
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "closable"
+            },
+            {
+              "name": "disabled",
+              "description": "If true, disables the popover.",
+              "type": {
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IGrid",
-                    "module": "./types"
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
                   }
                 ]
               },
-              "default": "GRID_LAYOUT.FLUID",
-              "fieldName": "layout"
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "row-gap",
-              "description": "Overrides the row gap independently of the column gutter.",
+              "name": "footer",
+              "description": "If true, displays the footer section with helper and button slots.",
               "type": {
-                "text": "string",
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "footer"
+            },
+            {
+              "name": "header",
+              "description": "If true, displays the header section with icon and title slots.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "header"
+            },
+            {
+              "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": "IGrid",
-                    "module": "./types"
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
                   }
                 ]
               },
-              "fieldName": "rowGap"
+              "default": "320",
+              "fieldName": "width"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "layout",
-              "description": "`'fluid'` fills full width; `'fixed'` caps the column area at 960px and centres the container.",
+              "name": "closable",
+              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
               "type": {
-                "text": "\"fixed\" | \"fluid\"",
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "closable"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "If true, disables the popover.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "floatingOptions",
+              "description": "Override default options for the floating mixin.\nThis can be overridden by passing a different object to the `floatingOptions` prop.",
+              "type": {
+                "text": "FloatingPopoverProp",
                 "references": [
                   {
-                    "name": "IGrid",
-                    "module": "./types"
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
                   }
                 ]
               },
-              "default": "GRID_LAYOUT.FLUID",
+              "default": "{}",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "footer",
+              "description": "If true, displays the footer section with helper and button slots.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
               "readonly": true,
-              "attribute": "layout"
+              "attribute": "footer"
             },
             {
               "kind": "field",
-              "name": "rowGap",
-              "description": "Overrides the row gap independently of the column gutter.",
+              "name": "header",
+              "description": "If true, displays the header section with icon and title slots.",
               "type": {
-                "text": "string",
+                "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": "IGrid",
-                    "module": "./types"
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
                   }
                 ]
               },
+              "default": "320",
               "readonly": true,
-              "attribute": "row-gap"
+              "attribute": "width"
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Direct `bds-grid-item` children."
+              "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."
             }
           ],
-          "cssProperties": [
+          "cssParts": [
             {
-              "name": "--bds-grid-nav-offset",
-              "description": "Left offset reserved for navigation. Set to `64px` (global nav only) or `294px` (global + container nav)."
+              "name": "arrow"
+            },
+            {
+              "name": "popover-content"
             }
           ]
         }
@@ -1965,290 +3581,200 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsGrid",
+          "name": "BdsPopover",
           "declaration": {
-            "name": "BdsGrid"
+            "name": "BdsPopover"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-grid",
+          "name": "bds-popover",
           "declaration": {
-            "name": "BdsGrid"
+            "name": "BdsPopover"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/layouts/bds-grid/grid-item/bds-grid-item.tsx",
+      "path": "src/components/forms/bds-radio/bds-radio.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-grid-item",
-          "name": "BdsGridItem",
-          "description": "Grid item child of `bds-grid`. Must be a direct child of `bds-grid`.",
+          "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": "col-span",
-              "description": "Column span at all breakpoints (fallback). `'full'` spans all columns (`grid-column: 1 / -1`).",
-              "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
-              },
-              "default": "GRID_ITEM_COL_SPAN.DEFAULT",
-              "fieldName": "colSpan"
-            },
-            {
-              "name": "col-span-2xl",
-              "description": "Override col-span at the `2xl` breakpoint (≥1344px).",
+              "name": "checked",
+              "description": "Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "boolean"
               },
-              "fieldName": "colSpan2xl"
+              "default": "false",
+              "fieldName": "checked"
             },
             {
-              "name": "col-span-lg",
-              "description": "Override col-span at the `lg` breakpoint (≥960px).",
+              "name": "disabled",
+              "description": "Disables the radio, preventing interaction and selection.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "boolean"
               },
-              "fieldName": "colSpanLg"
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "col-span-md",
-              "description": "Override col-span at the `md` breakpoint (≥769px).",
+              "name": "error",
+              "description": "Shows error styling on the radio indicator. Propagated by bds-radio-group.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "boolean"
               },
-              "fieldName": "colSpanMd"
+              "default": "false",
+              "fieldName": "error"
             },
             {
-              "name": "col-span-sm",
-              "description": "Override col-span at the `sm` breakpoint (≥320px).",
+              "name": "info",
+              "description": "Tooltip text shown on an info icon next to the label.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
-              "fieldName": "colSpanSm"
+              "default": "''",
+              "fieldName": "info"
             },
             {
-              "name": "col-span-xl",
-              "description": "Override col-span at the `xl` breakpoint (≥1152px).",
+              "name": "label",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
-              "fieldName": "colSpanXl"
+              "default": "''",
+              "fieldName": "label"
             },
             {
-              "name": "offset",
-              "description": "Column offset: shifts the item right by N columns (0–11).",
+              "name": "name",
+              "description": "Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.",
               "type": {
-                "text": "number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "0",
-              "fieldName": "offset"
+              "default": "''",
+              "fieldName": "name"
             },
             {
-              "name": "row-span",
-              "description": "Row span. `'full'` maps to `grid-row: 1 / -1`.",
+              "name": "value",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
-              "fieldName": "rowSpan"
+              "default": "'on'",
+              "fieldName": "value"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "colSpan",
-              "description": "Column span at all breakpoints (fallback). `'full'` spans all columns (`grid-column: 1 / -1`).",
-              "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
-              },
-              "default": "GRID_ITEM_COL_SPAN.DEFAULT",
-              "readonly": true,
-              "attribute": "col-span",
-              "reflects": true
-            },
-            {
-              "kind": "field",
-              "name": "colSpan2xl",
-              "description": "Override col-span at the `2xl` breakpoint (≥1344px).",
+              "name": "checked",
+              "description": "Whether this radio is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "boolean"
               },
-              "readonly": true,
-              "attribute": "col-span-2xl",
+              "default": "false",
+              "attribute": "checked",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "colSpanLg",
-              "description": "Override col-span at the `lg` breakpoint (≥960px).",
+              "name": "disabled",
+              "description": "Disables the radio, preventing interaction and selection.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "boolean"
               },
+              "default": "false",
               "readonly": true,
-              "attribute": "col-span-lg",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "colSpanMd",
-              "description": "Override col-span at the `md` breakpoint (≥769px).",
+              "name": "error",
+              "description": "Shows error styling on the radio indicator. Propagated by bds-radio-group.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "boolean"
               },
+              "default": "false",
               "readonly": true,
-              "attribute": "col-span-md",
+              "attribute": "error",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "colSpanSm",
-              "description": "Override col-span at the `sm` breakpoint (≥320px).",
+              "name": "info",
+              "description": "Tooltip text shown on an info icon next to the label.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
+              "default": "''",
               "readonly": true,
-              "attribute": "col-span-sm",
-              "reflects": true
+              "attribute": "info"
             },
             {
               "kind": "field",
-              "name": "colSpanXl",
-              "description": "Override col-span at the `xl` breakpoint (≥1152px).",
+              "name": "label",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
               "type": {
-                "text": "\"full\" | number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
+              "default": "''",
               "readonly": true,
-              "attribute": "col-span-xl",
-              "reflects": true
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "offset",
-              "description": "Column offset: shifts the item right by N columns (0–11).",
+              "name": "name",
+              "description": "Name attribute stamped by the parent bds-radio-group via setAttribute. Set directly when used standalone.",
               "type": {
-                "text": "number",
-                "references": [
-                  {
-                    "name": "IGridItem",
-                    "module": "./types"
-                  }
-                ]
+                "text": "string"
               },
-              "default": "0",
+              "default": "''",
               "readonly": true,
-              "attribute": "offset",
+              "attribute": "name",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "rowSpan",
-              "description": "Row span. `'full'` maps to `grid-row: 1 / -1`.",
+              "name": "value",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
-                "text": "\"full\" | number",
+                "text": "string"
+              },
+              "default": "'on'",
+              "readonly": true,
+              "attribute": "value"
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsChange",
+              "description": "Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.",
+              "type": {
+                "text": "CustomEvent<RadioChangeDetail>",
                 "references": [
                   {
-                    "name": "IGridItem",
-                    "module": "./types"
+                    "name": "RadioChangeDetail",
+                    "module": "./types/IRadio"
                   }
                 ]
-              },
-              "readonly": true,
-              "attribute": "row-span",
-              "reflects": true
+              }
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Item content. The grid item manages position only — content styling is\nthe responsibility of the slotted element."
+              "description": "Label content when no `label` prop is provided."
+            },
+            {
+              "name": "icon",
+              "description": "Optional icon rendered to the left of the label."
             }
           ]
         }
@@ -2256,139 +3782,187 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsGridItem",
+          "name": "BdsRadio",
           "declaration": {
-            "name": "BdsGridItem"
+            "name": "BdsRadio"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-grid-item",
+          "name": "bds-radio",
           "declaration": {
-            "name": "BdsGridItem"
+            "name": "BdsRadio"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/actions/bds-list-menu/bds-list-menu/bds-list-menu.tsx",
+      "path": "src/components/forms/bds-radio-button/bds-radio-button.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-list-menu",
-          "name": "BdsListMenu",
-          "description": "Container component that manages a list of menu items.\nIt handles selection logic (single/multiple) and maintains the data state.",
+          "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": "menu-role",
-              "description": "Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.",
+              "name": "checked",
+              "description": "Whether this button is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
-                "text": "\"listbox\" | \"menu\""
+                "text": "boolean"
               },
-              "default": "'menu'",
-              "fieldName": "menuRole"
+              "default": "false",
+              "fieldName": "checked"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the button, preventing interaction and selection.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
             },
             {
-              "name": "multiple",
-              "description": "If true, allows multiple items to be selected. Default is false (single selection).",
+              "name": "error",
+              "description": "Shows error styling on the button. Propagated by bds-radio-group.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "multiple"
+              "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 inside the button. 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 button is selected.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "fieldName": "value"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "menuRole",
-              "description": "Defines the ARIA role of the menu. Can be 'menu' or 'listbox'. Default is 'menu'.",
+              "name": "checked",
+              "description": "Whether this button 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 button, preventing interaction and selection.",
               "type": {
-                "text": "\"listbox\" | \"menu\""
+                "text": "boolean"
               },
-              "default": "'menu'",
+              "default": "false",
               "readonly": true,
-              "attribute": "menu-role"
+              "attribute": "disabled",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "multiple",
-              "description": "If true, allows multiple items to be selected. Default is false (single selection).",
+              "name": "error",
+              "description": "Shows error styling on the button. Propagated by bds-radio-group.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "readonly": true,
-              "attribute": "multiple"
+              "attribute": "error",
+              "reflects": true
             },
             {
-              "kind": "method",
-              "name": "getSelectedValues",
-              "description": "Retrieves the currently selected value(s) programmatically.",
-              "return": {
-                "type": {
-                  "text": "Promise<string | string[]>",
-                  "references": [
-                    {
-                      "name": "Promise",
-                      "package": "global:"
-                    }
-                  ]
-                },
-                "description": "The selected value(s) based on the 'multiple' prop."
-              }
+              "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": "method",
-              "name": "setSelectedValues",
-              "description": "Sets the selected values programmatically.\nUseful for initializing the menu from an external data source or form reset.",
-              "parameters": [
-                {
-                  "name": "values",
-                  "description": "- The value or values to be marked as selected.",
-                  "type": {
-                    "text": "string | string[]",
-                    "references": [
-                      {
-                        "name": "Promise",
-                        "package": "global:"
-                      }
-                    ]
-                  }
-                }
-              ],
-              "return": {
-                "type": {
-                  "text": "Promise<void>",
-                  "references": [
-                    {
-                      "name": "Promise",
-                      "package": "global:"
-                    }
-                  ]
-                }
-              }
+              "kind": "field",
+              "name": "label",
+              "description": "Label text displayed inside the button. 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": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Value submitted with the form when this button is selected.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'on'",
+              "readonly": true,
+              "attribute": "value"
             }
           ],
           "events": [
             {
               "name": "bdsChange",
-              "description": "Emitted when the selection changes, providing the current selected value(s).",
-              "type": {
-                "text": "CustomEvent<string | string[]>"
-              }
-            },
-            {
-              "name": "bdsClicked",
-              "description": "Emitted when the selection changes, providing the current selected value(s).",
+              "description": "Emitted when the user selects this button. Listened to by the parent bds-radio-group to enforce single selection.",
               "type": {
-                "text": "CustomEvent<HTMLElement>",
+                "text": "CustomEvent<RadioButtonChangeDetail>",
                 "references": [
                   {
-                    "name": "HTMLElement",
-                    "package": "global:"
+                    "name": "RadioButtonChangeDetail",
+                    "module": "./types/IRadioButton"
                   }
                 ]
               }
@@ -2397,7 +3971,11 @@
           "slots": [
             {
               "name": "",
-              "description": "Default slot for bds-list-menu-item elements."
+              "description": "Label content when no `label` prop is provided."
+            },
+            {
+              "name": "icon",
+              "description": "Optional icon rendered to the left of the label."
             }
           ]
         }
@@ -2405,55 +3983,55 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsListMenu",
+          "name": "BdsRadioButton",
           "declaration": {
-            "name": "BdsListMenu"
+            "name": "BdsRadioButton"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-list-menu",
+          "name": "bds-radio-button",
           "declaration": {
-            "name": "BdsListMenu"
+            "name": "BdsRadioButton"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/actions/bds-list-menu/bds-list-menu-item/bds-list-menu-item.tsx",
+      "path": "src/components/forms/bds-radio-card/bds-radio-card.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-list-menu-item",
-          "name": "BdsListMenuItem",
-          "description": "Component representing an individual item within a list menu for navigations and selection.",
+          "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": "active-item",
-              "description": "Active state item",
+              "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": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                  {
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "false",
-              "fieldName": "activeItem"
+              "fieldName": "checked"
             },
             {
               "name": "disabled",
-              "description": "Disabled state item",
+              "description": "Disables the radio card, preventing it from being selected and interacted with.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
@@ -2461,192 +4039,179 @@
               "fieldName": "disabled"
             },
             {
-              "name": "download",
-              "description": "Makes the link downloadable if true",
+              "name": "error",
+              "description": "Whether the radio card is in an error state.",
               "type": {
-                "text": "string",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
-              "default": "''",
-              "fieldName": "download"
+              "default": "false",
+              "fieldName": "error"
             },
             {
-              "name": "href",
-              "description": "Link behavior props",
+              "name": "info",
+              "description": "Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "''",
-              "fieldName": "href"
+              "fieldName": "info"
             },
             {
-              "name": "name",
-              "description": "The name of the list menu item",
+              "name": "label",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "''",
-              "fieldName": "name"
-            },
-            {
-              "name": "new-tab",
-              "description": "Opens the link in a new tab if true",
-              "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
-                  }
-                ]
-              },
-              "default": "false",
-              "fieldName": "newTab"
+              "fieldName": "label"
             },
             {
-              "name": "selected",
-              "description": "Selected item state",
+              "name": "name",
+              "description": "Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.",
               "type": {
-                "text": "boolean",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "selected"
+              "default": "''",
+              "fieldName": "name"
             },
             {
               "name": "value",
-              "description": "Value associated with the menu item",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
-              "default": "''",
+              "default": "'on'",
               "fieldName": "value"
-            },
+            }
+          ],
+          "members": [
             {
-              "name": "variant",
-              "description": "Defines the visual style of the list menu item.\n- 'button': A standard clickable item.\n- 'label': A non-interactive label, typically used for grouping items.",
+              "kind": "field",
+              "name": "checked",
+              "description": "Whether this radio card is selected. Managed by bds-radio-group; can be set directly when used standalone.",
               "type": {
-                "text": "\"button\" | \"label\"",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
-              "default": "LIST_MENU_ITEM_VARIANTS.BUTTON",
-              "fieldName": "variant"
-            }
-          ],
-          "members": [
+              "default": "false",
+              "attribute": "checked",
+              "reflects": true
+            },
             {
               "kind": "field",
-              "name": "activeItem",
-              "description": "Active state item",
+              "name": "disabled",
+              "description": "Disables the radio card, preventing it from being selected and interacted with.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "false",
               "readonly": true,
-              "attribute": "active-item",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "disabled",
-              "description": "Disabled state item",
+              "name": "error",
+              "description": "Whether the radio card is in an error state.",
               "type": {
                 "text": "boolean",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "false",
               "readonly": true,
-              "attribute": "disabled",
+              "attribute": "error",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "download",
-              "description": "Makes the link downloadable if true",
+              "name": "info",
+              "description": "Tooltip content attached to the radio card content. If empty, the info icon will not be rendered.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "''",
               "readonly": true,
-              "attribute": "download"
+              "attribute": "info"
             },
             {
               "kind": "field",
-              "name": "href",
-              "description": "Link behavior props",
+              "name": "label",
+              "description": "Label text displayed next to the radio indicator. Falls back to the default slot when empty.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
               "default": "''",
               "readonly": true,
-              "attribute": "href"
+              "attribute": "label"
             },
             {
               "kind": "field",
               "name": "name",
-              "description": "The name of the list menu item",
+              "description": "Name attribute stamped by the parent bds-radio-group. Set directly when used standalone.",
               "type": {
                 "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
@@ -2656,297 +4221,404 @@
             },
             {
               "kind": "field",
-              "name": "newTab",
-              "description": "Opens the link in a new tab if true",
+              "name": "value",
+              "description": "Value submitted with the form when this radio is selected.",
               "type": {
-                "text": "boolean",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "IRadioCard",
+                    "module": "./types/IRadioCard"
                   }
                 ]
               },
-              "default": "false",
+              "default": "'on'",
               "readonly": true,
-              "attribute": "new-tab"
-            },
+              "attribute": "value",
+              "reflects": true
+            }
+          ],
+          "events": [
             {
-              "kind": "field",
-              "name": "selected",
-              "description": "Selected item state",
+              "name": "bdsChange",
+              "description": "Emitted when the user selects this radio. Listened to by the parent bds-radio-group to enforce single selection.",
               "type": {
-                "text": "boolean",
+                "text": "CustomEvent<RadioCardChangeDetail>",
                 "references": [
                   {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
+                    "name": "RadioCardChangeDetail",
+                    "module": "./types/IRadioCard"
                   }
                 ]
+              }
+            }
+          ],
+          "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."
+            }
+          ],
+          "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": "BdsRadioCard",
+          "declaration": {
+            "name": "BdsRadioCard"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-radio-card",
+          "declaration": {
+            "name": "BdsRadioCard"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/forms/bds-radio-group/bds-radio-group.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.",
+          "attributes": [
+            {
+              "name": "disabled",
+              "description": "Disables all child radios and prevents selection. Also mirrored to isDisabled",
+              "type": {
+                "text": "boolean"
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "selected",
-              "reflects": true
+              "fieldName": "disabled"
             },
             {
-              "kind": "field",
-              "name": "value",
-              "description": "Value associated with the menu item",
+              "name": "error",
+              "description": "Shows error styling on the group helper text. Propagated to all child radios.",
               "type": {
-                "text": "string",
-                "references": [
-                  {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
-                  }
-                ]
+                "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": "\"\""
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "value",
-              "reflects": true
+              "fieldName": "errorMessage"
             },
             {
-              "kind": "field",
-              "name": "variant",
-              "description": "Defines the visual style of the list menu item.\n- 'button': A standard clickable item.\n- 'label': A non-interactive label, typically used for grouping items.",
+              "name": "helper-text",
+              "description": "Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.",
               "type": {
-                "text": "\"button\" | \"label\"",
-                "references": [
-                  {
-                    "name": "IListMenuItem",
-                    "module": "./types/IListMenuItem"
-                  }
-                ]
+                "text": "\"\""
               },
-              "default": "LIST_MENU_ITEM_VARIANTS.BUTTON",
-              "readonly": true,
-              "attribute": "variant",
-              "reflects": true
-            }
-          ],
-          "events": [
+              "default": "''",
+              "fieldName": "helperText"
+            },
             {
-              "name": "bdsSelect",
-              "description": "Event handler for activation",
+              "name": "info",
+              "description": "Tooltip text shown on the group label info icon.",
               "type": {
-                "text": "CustomEvent<IListMenuItemEvent>",
+                "text": "\"\""
+              },
+              "default": "''",
+              "fieldName": "info"
+            },
+            {
+              "name": "label",
+              "description": "Group label rendered above the radio options.",
+              "type": {
+                "text": "\"\""
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "name",
+              "description": "Name of the form control; submitted as the field key in FormData.",
+              "type": {
+                "text": "string"
+              },
+              "fieldName": "name"
+            },
+            {
+              "name": "orientation",
+              "description": "Layout direction of the radio options.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "IListMenuItemEvent",
-                    "module": "./types/IListMenuItem"
+                    "name": "Orientation",
+                    "module": "@/types"
                   }
                 ]
-              }
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Default slot for the content of the menu item."
-            }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "BdsListMenuItem",
-          "declaration": {
-            "name": "BdsListMenuItem"
-          }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "bds-list-menu-item",
-          "declaration": {
-            "name": "BdsListMenuItem"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/overlays/bds-popover/bds-popover.tsx",
-      "declarations": [
-        {
-          "kind": "class",
-          "customElement": true,
-          "tagName": "bds-popover",
-          "name": "BdsPopover",
-          "attributes": [
+              },
+              "default": "ORIENTATIONS.VERTICAL",
+              "fieldName": "orientation"
+            },
             {
-              "name": "closable",
-              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
+              "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": "closable"
+              "fieldName": "required"
             },
             {
-              "name": "disabled",
-              "description": "If true, disables the popover.",
+              "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": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "RadioGroupType",
+                    "module": "./types/types"
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "disabled"
+              "default": "RADIO_GROUP_TYPES.RADIO",
+              "fieldName": "type"
             },
             {
-              "name": "footer",
-              "description": "If true, displays the footer section with helper and button slots.",
+              "name": "value",
+              "description": "Currently selected radio value. Synced to children on change.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables all child radios and prevents selection. Also mirrored to isDisabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "footer"
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
             },
             {
-              "name": "header",
-              "description": "If true, displays the header section with icon and title slots.",
+              "kind": "field",
+              "name": "error",
+              "description": "Shows error styling on the group helper text. Propagated to all child radios.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "header"
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
             },
             {
-              "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",
+              "kind": "field",
+              "name": "errorMessage",
+              "description": "Error message rendered below the radio options when error is true. Replaces helperText.",
               "type": {
-                "text": "\"auto\" | \"full\" | number",
-                "references": [
-                  {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
-                  }
-                ]
+                "text": "\"\""
               },
-              "default": "320",
-              "fieldName": "width"
-            }
-          ],
-          "members": [
+              "default": "''",
+              "readonly": true,
+              "attribute": "error-message"
+            },
             {
               "kind": "field",
-              "name": "closable",
-              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
+              "name": "helperText",
+              "description": "Helper text rendered below the radio options. Shown in default state; replaced by errorMessage in error state.",
               "type": {
-                "text": "boolean"
+                "text": "\"\""
               },
-              "default": "false",
+              "default": "''",
               "readonly": true,
-              "attribute": "closable"
+              "attribute": "helper-text"
             },
             {
               "kind": "field",
-              "name": "disabled",
-              "description": "If true, disables the popover.",
+              "name": "info",
+              "description": "Tooltip text shown on the group label info icon.",
               "type": {
-                "text": "boolean",
-                "references": [
-                  {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
-                  }
-                ]
+                "text": "\"\""
               },
-              "default": "false",
+              "default": "''",
               "readonly": true,
-              "attribute": "disabled"
+              "attribute": "info"
             },
             {
               "kind": "field",
-              "name": "floatingOptions",
-              "description": "Override default options for the floating mixin.\nThis can be overridden by passing a different object to the `floatingOptions` prop.",
+              "name": "label",
+              "description": "Group label rendered above the radio options.",
               "type": {
-                "text": "FloatingPopoverProp",
-                "references": [
-                  {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
-                  }
-                ]
+                "text": "\"\""
               },
-              "default": "{}",
-              "readonly": true
+              "default": "''",
+              "readonly": true,
+              "attribute": "label"
             },
             {
               "kind": "field",
-              "name": "footer",
-              "description": "If true, displays the footer section with helper and button slots.",
+              "name": "name",
+              "description": "Name of the form control; submitted as the field key in FormData.",
               "type": {
-                "text": "boolean"
+                "text": "string"
               },
-              "default": "false",
               "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": "orientation",
+              "description": "Layout direction of the radio options.",
+              "type": {
+                "text": "\"horizontal\" | \"vertical\"",
+                "references": [
+                  {
+                    "name": "Orientation",
+                    "module": "@/types"
+                  }
+                ]
+              },
+              "default": "ORIENTATIONS.VERTICAL",
+              "readonly": true,
+              "attribute": "orientation",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "required",
+              "description": "Marks the group as required for form submission. Triggers validity error when no radio is selected.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "readonly": true,
-              "attribute": "header"
+              "attribute": "required",
+              "reflects": true
             },
             {
               "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": "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": "\"auto\" | \"full\" | number",
+                "text": "\"radio\" | \"radiobutton\" | \"radiocard\"",
                 "references": [
                   {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "RadioGroupType",
+                    "module": "./types/types"
                   }
                 ]
               },
-              "default": "320",
+              "default": "RADIO_GROUP_TYPES.RADIO",
               "readonly": true,
-              "attribute": "width"
-            }
-          ],
-          "slots": [
-            {
-              "name": "",
-              "description": "Default slot for the popover body content."
+              "attribute": "type",
+              "reflects": true
             },
             {
-              "name": "footer-button",
-              "description": "Slot for footer actions."
+              "kind": "field",
+              "name": "value",
+              "description": "Currently selected radio value. Synced to children on change.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "attribute": "value"
             },
             {
-              "name": "footer-helper",
-              "description": "Slot for footer helper content."
+              "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:"
+                    }
+                  ]
+                }
+              }
             },
             {
-              "name": "header-icon",
-              "description": "Slot for header icon."
+              "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": "CustomEvent<RadioGroupChangeDetail>",
+                "references": [
+                  {
+                    "name": "RadioGroupChangeDetail",
+                    "module": "./types/IRadioGroup"
+                  }
+                ]
+              }
             },
             {
-              "name": "header-title",
-              "description": "Slot for header title."
+              "name": "valueChange",
+              "description": "Emitted when the selected radio changes. Used for v-model two-way binding in Vue.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
             }
           ],
-          "cssParts": [
+          "slots": [
             {
-              "name": "arrow"
-            },
+              "name": "",
+              "description": "Default slot for `bds-radio` child elements."
+            }
+          ],
+          "cssProperties": [
             {
-              "name": "popover-content"
+              "name": "--layout-count",
+              "description": "Defines the number of columns for horizontal orientation. Default is 1."
             }
           ]
         }
@@ -2954,16 +4626,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsPopover",
+          "name": "BdsRadioGroup",
           "declaration": {
-            "name": "BdsPopover"
+            "name": "BdsRadioGroup"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-popover",
+          "name": "bds-radio-group",
           "declaration": {
-            "name": "BdsPopover"
+            "name": "BdsRadioGroup"
           }
         }
       ]