npm - @telesign/boreal-web-components - Versions diffs - 0.1.0-alpha.3 → 0.1.0-alpha.4 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (446) hide show

package/custom-elements.json CHANGED Viewed

@@ -1,6 +1,274 @@
 {
   "schemaVersion": "2.1.0",
   "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/components/images-icons/bds-avatar/bds-avatar.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-avatar",
+          "name": "BdsAvatar",
+          "description": "Avatar component used to display user initials or names for visual identification.",
+          "attributes": [
+            {
+              "name": "background",
+              "description": "Custom background color as hex code. If not provided, defaults to Boreal success color *",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "background"
+            },
+            {
+              "name": "initials-color",
+              "description": "Custom text color as hex code. If not provided, defaults to white *",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "initialsColor"
+            },
+            {
+              "name": "username",
+              "description": "The full name used to generate initials or display as label *",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "username"
+            },
+            {
+              "name": "variant",
+              "description": "Controls which avatar elements are displayed: icon (initials), name, or both.",
+              "type": {
+                "text": "\"full\" | \"icon\" | \"name\"",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "AVATAR_VARIANT.FULL",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "background",
+              "description": "Custom background color as hex code. If not provided, defaults to Boreal success color *",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "background"
+            },
+            {
+              "kind": "field",
+              "name": "initialsColor",
+              "description": "Custom text color as hex code. If not provided, defaults to white *",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "initials-color"
+            },
+            {
+              "kind": "field",
+              "name": "username",
+              "description": "The full name used to generate initials or display as label *",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "username"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Controls which avatar elements are displayed: icon (initials), name, or both.",
+              "type": {
+                "text": "\"full\" | \"icon\" | \"name\"",
+                "references": [
+                  {
+                    "name": "IAvatar",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "AVATAR_VARIANT.FULL",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsAvatar",
+          "declaration": {
+            "name": "BdsAvatar"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-avatar",
+          "declaration": {
+            "name": "BdsAvatar"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/feedback/bds-badge/bds-badge.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-badge",
+          "name": "BdsBadge",
+          "description": "Badge component for displaying contextual status information with optional icon support.",
+          "attributes": [
+            {
+              "name": "disabled",
+              "description": "Disables the badge when true, reducing opacity and preventing pointer interaction. Default is false.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IBadge",
+                    "module": "./types/IBadge"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "variant",
+              "description": "Controls the visual style of the badge. Accepted values: 'default' | 'info' | 'success' | 'warning' | 'danger'. Default is 'default'.",
+              "type": {
+                "text": "\"danger\" | \"default\" | \"info\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "IBadge",
+                    "module": "./types/IBadge"
+                  }
+                ]
+              },
+              "default": "BADGE_VARIANT.DEFAULT",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables the badge when true, reducing opacity and preventing pointer interaction. Default is false.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IBadge",
+                    "module": "./types/IBadge"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "description": "Controls the visual style of the badge. Accepted values: 'default' | 'info' | 'success' | 'warning' | 'danger'. Default is 'default'.",
+              "type": {
+                "text": "\"danger\" | \"default\" | \"info\" | \"success\" | \"warning\"",
+                "references": [
+                  {
+                    "name": "IBadge",
+                    "module": "./types/IBadge"
+                  }
+                ]
+              },
+              "default": "BADGE_VARIANT.DEFAULT",
+              "readonly": true,
+              "attribute": "variant"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The text content of the badge."
+            },
+            {
+              "name": "icon",
+              "description": "An icon displayed before the badge text content."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsBadge",
+          "declaration": {
+            "name": "BdsBadge"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-badge",
+          "declaration": {
+            "name": "BdsBadge"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/feedback/bds-banner/bds-banner.tsx",
@@ -100,7 +368,23 @@
             },
             {
               "kind": "method",
-              "name": "closeBanner",
+              "name": "close",
+              "description": "Programmatic method to close the banner and emit the `bdsClose` event",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "open",
               "description": "Programmatic method to close the banner and emit the `bdsClose` event",
               "return": {
                 "type": {
@@ -118,7 +402,7 @@
           "events": [
             {
               "name": "bdsClose",
-              "description": "Emitted when the banner is closed via the close button or closeBanner method.",
+              "description": "Emitted when the banner is closed via the close button or close method.",
               "type": {
                 "text": "CustomEvent<void>"
               }
@@ -1246,52 +1530,123 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/forms/bds-flag/bds-flag.tsx",
+      "path": "src/components/helpers/bds-divider.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.",
+          "tagName": "bds-divider",
+          "name": "BdsDivider",
+          "description": "Divider component for creating visual separators between content sections.",
           "attributes": [
             {
-              "name": "align-flag",
-              "description": "Determines whether the flag is displayed on the left or right side of the label.",
+              "name": "orientation",
+              "description": "The orientation of the divider.\nAllowed values: horizontal | vertical",
               "type": {
-                "text": "\"left\" | \"right\"",
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IDivider",
+                    "module": "./types/IDivider"
                   }
                 ]
               },
-              "default": "AlignFlag.LEFT",
-              "fieldName": "alignFlag"
-            },
+              "default": "DIVIDER_ORIENTATIONS.HORIZONTAL",
+              "fieldName": "orientation"
+            }
+          ],
+          "members": [
             {
-              "name": "call-sign",
-              "description": "Whether the country calling code should be displayed next to the label.",
+              "kind": "field",
+              "name": "orientation",
+              "description": "The orientation of the divider.\nAllowed values: horizontal | vertical",
               "type": {
-                "text": "boolean",
+                "text": "\"horizontal\" | \"vertical\"",
                 "references": [
                   {
-                    "name": "IFlag",
-                    "module": "./interfaces/IFlag"
+                    "name": "IDivider",
+                    "module": "./types/IDivider"
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "callSign"
-            },
+              "default": "DIVIDER_ORIENTATIONS.HORIZONTAL",
+              "readonly": true,
+              "attribute": "orientation",
+              "reflects": true
+            }
+          ],
+          "cssParts": [
             {
-              "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": "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": "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"
                   }
@@ -1519,185 +1874,90 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/overlays/bds-popover/bds-popover.tsx",
+      "path": "src/components/layouts/bds-grid/grid/bds-grid.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-popover",
-          "name": "BdsPopover",
+          "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": "closable",
-              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "fieldName": "closable"
-            },
-            {
-              "name": "disabled",
-              "description": "If true, disables the popover.",
+              "name": "layout",
+              "description": "`'fluid'` fills full width; `'fixed'` caps the column area at 960px and centres the container.",
               "type": {
-                "text": "boolean",
+                "text": "\"fixed\" | \"fluid\"",
                 "references": [
                   {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "IGrid",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "disabled"
-            },
-            {
-              "name": "footer",
-              "description": "If true, displays the footer section with helper and button slots.",
-              "type": {
-                "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"
+              "default": "GRID_LAYOUT.FLUID",
+              "fieldName": "layout"
             },
             {
-              "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": "row-gap",
+              "description": "Overrides the row gap independently of the column gutter.",
               "type": {
-                "text": "\"auto\" | \"full\" | number",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "IGrid",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "320",
-              "fieldName": "width"
+              "fieldName": "rowGap"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "closable",
-              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
-              "type": {
-                "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.",
+              "name": "layout",
+              "description": "`'fluid'` fills full width; `'fixed'` caps the column area at 960px and centres the container.",
               "type": {
-                "text": "FloatingPopoverProp",
+                "text": "\"fixed\" | \"fluid\"",
                 "references": [
                   {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "IGrid",
+                    "module": "./types"
                   }
                 ]
               },
-              "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": "footer"
-            },
-            {
-              "kind": "field",
-              "name": "header",
-              "description": "If true, displays the header section with icon and title slots.",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
+              "default": "GRID_LAYOUT.FLUID",
               "readonly": true,
-              "attribute": "header"
+              "attribute": "layout"
             },
             {
               "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": "rowGap",
+              "description": "Overrides the row gap independently of the column gutter.",
               "type": {
-                "text": "\"auto\" | \"full\" | number",
+                "text": "string",
                 "references": [
                   {
-                    "name": "IPopover",
-                    "module": "./types/IPopover"
+                    "name": "IGrid",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "320",
               "readonly": true,
-              "attribute": "width"
+              "attribute": "row-gap"
             }
           ],
           "slots": [
             {
               "name": "",
-              "description": "Default slot for the popover body content."
-            },
-            {
-              "name": "footer-button",
-              "description": "Slot for footer actions."
-            },
-            {
-              "name": "footer-helper",
-              "description": "Slot for footer helper content."
-            },
-            {
-              "name": "header-icon",
-              "description": "Slot for header icon."
-            },
-            {
-              "name": "header-title",
-              "description": "Slot for header title."
+              "description": "Direct `bds-grid-item` children."
             }
           ],
-          "cssParts": [
+          "cssProperties": [
             {
-              "name": "arrow"
-            },
-            {
-              "name": "popover-content"
+              "name": "--bds-grid-nav-offset",
+              "description": "Left offset reserved for navigation. Set to `64px` (global nav only) or `294px` (global + container nav)."
             }
           ]
         }
@@ -1705,113 +1965,1472 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsPopover",
+          "name": "BdsGrid",
           "declaration": {
-            "name": "BdsPopover"
+            "name": "BdsGrid"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-popover",
+          "name": "bds-grid",
           "declaration": {
-            "name": "BdsPopover"
+            "name": "BdsGrid"
           }
         }
       ]
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/feedback/bds-spinner/bds-spinner.tsx",
+      "path": "src/components/layouts/bds-grid/grid-item/bds-grid-item.tsx",
       "declarations": [
         {
           "kind": "class",
           "customElement": true,
-          "tagName": "bds-spinner",
-          "name": "BdsSpinner",
-          "description": "Spinner component used to indicate a loading or processing state.",
+          "tagName": "bds-grid-item",
+          "name": "BdsGridItem",
+          "description": "Grid item child of `bds-grid`. Must be a direct child of `bds-grid`.",
           "attributes": [
             {
-              "name": "label",
-              "description": "Accessible label announced by screen readers to describe the loading state.",
+              "name": "col-span",
+              "description": "Column span at all breakpoints (fallback). `'full'` spans all columns (`grid-column: 1 / -1`).",
               "type": {
-                "text": "string",
+                "text": "\"full\" | number",
                 "references": [
                   {
-                    "name": "ISpinner",
-                    "module": "./types/ISpinner"
+                    "name": "IGridItem",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "'Loading'",
-              "fieldName": "label"
+              "default": "GRID_ITEM_COL_SPAN.DEFAULT",
+              "fieldName": "colSpan"
             },
             {
-              "name": "size",
-              "description": "Controls the visual size of the spinner.",
+              "name": "col-span-2xl",
+              "description": "Override col-span at the `2xl` breakpoint (≥1344px).",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
+                "text": "\"full\" | number",
                 "references": [
                   {
-                    "name": "ISpinner",
-                    "module": "./types/ISpinner"
+                    "name": "IGridItem",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "SPINNER_SIZES.SMALL",
-              "fieldName": "size"
-            }
-          ],
-          "members": [
+              "fieldName": "colSpan2xl"
+            },
             {
-              "kind": "field",
-              "name": "label",
-              "description": "Accessible label announced by screen readers to describe the loading state.",
+              "name": "col-span-lg",
+              "description": "Override col-span at the `lg` breakpoint (≥960px).",
               "type": {
-                "text": "string",
+                "text": "\"full\" | number",
                 "references": [
                   {
-                    "name": "ISpinner",
-                    "module": "./types/ISpinner"
+                    "name": "IGridItem",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "'Loading'",
-              "readonly": true,
-              "attribute": "label"
+              "fieldName": "colSpanLg"
             },
             {
-              "kind": "field",
-              "name": "size",
-              "description": "Controls the visual size of the spinner.",
+              "name": "col-span-md",
+              "description": "Override col-span at the `md` breakpoint (≥769px).",
               "type": {
-                "text": "\"lg\" | \"md\" | \"sm\"",
+                "text": "\"full\" | number",
                 "references": [
                   {
-                    "name": "ISpinner",
-                    "module": "./types/ISpinner"
+                    "name": "IGridItem",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "SPINNER_SIZES.SMALL",
-              "readonly": true,
-              "attribute": "size"
-            }
-          ]
-        }
-      ],
+              "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\""
+              },
+              "default": "'menu'",
+              "fieldName": "menuRole"
+            },
+            {
+              "name": "multiple",
+              "description": "If true, allows multiple items to be selected. Default is false (single selection).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "multiple"
+            }
+          ],
+          "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\""
+              },
+              "default": "'menu'",
+              "readonly": true,
+              "attribute": "menu-role"
+            },
+            {
+              "kind": "field",
+              "name": "multiple",
+              "description": "If true, allows multiple items to be selected. Default is false (single selection).",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "multiple"
+            },
+            {
+              "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<string | string[]>"
+              }
+            },
+            {
+              "name": "bdsClicked",
+              "description": "Emitted when the selection changes, providing the current selected value(s).",
+              "type": {
+                "text": "CustomEvent<HTMLElement>",
+                "references": [
+                  {
+                    "name": "HTMLElement",
+                    "package": "global:"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot for bds-list-menu-item elements."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsListMenu",
+          "declaration": {
+            "name": "BdsListMenu"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-list-menu",
+          "declaration": {
+            "name": "BdsListMenu"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/actions/bds-list-menu/bds-list-menu-item/bds-list-menu-item.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.",
+          "attributes": [
+            {
+              "name": "active-item",
+              "description": "Active state item",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "activeItem"
+            },
+            {
+              "name": "disabled",
+              "description": "Disabled state item",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "download",
+              "description": "Makes the link downloadable if true",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "download"
+            },
+            {
+              "name": "href",
+              "description": "Link behavior props",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "fieldName": "href"
+            },
+            {
+              "name": "name",
+              "description": "The name of the list menu item",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "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"
+            },
+            {
+              "name": "selected",
+              "description": "Selected item state",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "selected"
+            },
+            {
+              "name": "value",
+              "description": "Value associated with the menu item",
+              "type": {
+                "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": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "active-item",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disabled state item",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "download",
+              "description": "Makes the link downloadable if true",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "download"
+            },
+            {
+              "kind": "field",
+              "name": "href",
+              "description": "Link behavior props",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "href"
+            },
+            {
+              "kind": "field",
+              "name": "name",
+              "description": "The name of the list menu item",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "name"
+            },
+            {
+              "kind": "field",
+              "name": "newTab",
+              "description": "Opens the link in a new tab if true",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "new-tab"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Selected item state",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "selected",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "value",
+              "description": "Value associated with the menu item",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "''",
+              "readonly": true,
+              "attribute": "value",
+              "reflects": true
+            },
+            {
+              "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.",
+              "type": {
+                "text": "\"button\" | \"label\"",
+                "references": [
+                  {
+                    "name": "IListMenuItem",
+                    "module": "./types/IListMenuItem"
+                  }
+                ]
+              },
+              "default": "LIST_MENU_ITEM_VARIANTS.BUTTON",
+              "readonly": true,
+              "attribute": "variant",
+              "reflects": true
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsSelect",
+              "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."
+            }
+          ]
+        }
+      ],
+      "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": [
+            {
+              "name": "closable",
+              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "closable"
+            },
+            {
+              "name": "disabled",
+              "description": "If true, disables the popover.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "footer",
+              "description": "If true, displays the footer section with helper and button slots.",
+              "type": {
+                "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": "IPopover",
+                    "module": "./types/IPopover"
+                  }
+                ]
+              },
+              "default": "320",
+              "fieldName": "width"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "closable",
+              "description": "If true, displays a close button inside the header. Requires `header` to be true.",
+              "type": {
+                "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": "IPopover",
+                    "module": "./types/IPopover"
+                  }
+                ]
+              },
+              "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": "footer"
+            },
+            {
+              "kind": "field",
+              "name": "header",
+              "description": "If true, displays the header section with icon and title slots.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "header"
+            },
+            {
+              "kind": "field",
+              "name": "width",
+              "description": "Width of the popover content.\n- number: width in pixels (e.g. 320 → \"320px\")\n- 'full': 100% of the trigger/parent width\n- 'auto': fits the content",
+              "type": {
+                "text": "\"auto\" | \"full\" | number",
+                "references": [
+                  {
+                    "name": "IPopover",
+                    "module": "./types/IPopover"
+                  }
+                ]
+              },
+              "default": "320",
+              "readonly": true,
+              "attribute": "width"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot for the popover body content."
+            },
+            {
+              "name": "footer-button",
+              "description": "Slot for footer actions."
+            },
+            {
+              "name": "footer-helper",
+              "description": "Slot for footer helper content."
+            },
+            {
+              "name": "header-icon",
+              "description": "Slot for header icon."
+            },
+            {
+              "name": "header-title",
+              "description": "Slot for header title."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "arrow"
+            },
+            {
+              "name": "popover-content"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsPopover",
+          "declaration": {
+            "name": "BdsPopover"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-popover",
+          "declaration": {
+            "name": "BdsPopover"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/feedback/bds-spinner/bds-spinner.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-spinner",
+          "name": "BdsSpinner",
+          "description": "Spinner component used to indicate a loading or processing state.",
+          "attributes": [
+            {
+              "name": "label",
+              "description": "Accessible label announced by screen readers to describe the loading state.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ISpinner",
+                    "module": "./types/ISpinner"
+                  }
+                ]
+              },
+              "default": "'Loading'",
+              "fieldName": "label"
+            },
+            {
+              "name": "size",
+              "description": "Controls the visual size of the spinner.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "ISpinner",
+                    "module": "./types/ISpinner"
+                  }
+                ]
+              },
+              "default": "SPINNER_SIZES.SMALL",
+              "fieldName": "size"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "label",
+              "description": "Accessible label announced by screen readers to describe the loading state.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ISpinner",
+                    "module": "./types/ISpinner"
+                  }
+                ]
+              },
+              "default": "'Loading'",
+              "readonly": true,
+              "attribute": "label"
+            },
+            {
+              "kind": "field",
+              "name": "size",
+              "description": "Controls the visual size of the spinner.",
+              "type": {
+                "text": "\"lg\" | \"md\" | \"sm\"",
+                "references": [
+                  {
+                    "name": "ISpinner",
+                    "module": "./types/ISpinner"
+                  }
+                ]
+              },
+              "default": "SPINNER_SIZES.SMALL",
+              "readonly": true,
+              "attribute": "size"
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsSpinner",
+          "declaration": {
+            "name": "BdsSpinner"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-spinner",
+          "declaration": {
+            "name": "BdsSpinner"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/feedback/bds-status/bds-status.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-status",
+          "name": "BdsStatus",
+          "description": "Status badge component for communicating the current state of an item or process.",
+          "attributes": [
+            {
+              "name": "indicator",
+              "description": "indicator is a string attribute. Controls the type of indicator rendered before the slotted label.\nAn invalid value falls back to `\"none\"` and a warning is set on the host element.",
+              "type": {
+                "text": "\"dot\" | \"icon\" | \"none\"",
+                "references": [
+                  {
+                    "name": "IStatus",
+                    "module": "./types/IStatus"
+                  }
+                ]
+              },
+              "default": "INDICATOR_TYPES.NONE",
+              "fieldName": "indicator"
+            },
+            {
+              "name": "state",
+              "description": "state is a string attribute. Controls the visual state variant of the status badge.\nDetermines the background, accent, and text colors applied to the element.\nAn invalid value falls back to `\"neutral\"` and a warning is set on the host element.",
+              "type": {
+                "text": "\"cancel\" | \"complete\" | \"in-progress\" | \"neutral\" | \"pending\"",
+                "references": [
+                  {
+                    "name": "IStatus",
+                    "module": "./types/IStatus"
+                  }
+                ]
+              },
+              "default": "PROCESS_STATUS.NEUTRAL",
+              "fieldName": "state"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "indicator",
+              "description": "indicator is a string attribute. Controls the type of indicator rendered before the slotted label.\nAn invalid value falls back to `\"none\"` and a warning is set on the host element.",
+              "type": {
+                "text": "\"dot\" | \"icon\" | \"none\"",
+                "references": [
+                  {
+                    "name": "IStatus",
+                    "module": "./types/IStatus"
+                  }
+                ]
+              },
+              "default": "INDICATOR_TYPES.NONE",
+              "readonly": true,
+              "attribute": "indicator"
+            },
+            {
+              "kind": "field",
+              "name": "state",
+              "description": "state is a string attribute. Controls the visual state variant of the status badge.\nDetermines the background, accent, and text colors applied to the element.\nAn invalid value falls back to `\"neutral\"` and a warning is set on the host element.",
+              "type": {
+                "text": "\"cancel\" | \"complete\" | \"in-progress\" | \"neutral\" | \"pending\"",
+                "references": [
+                  {
+                    "name": "IStatus",
+                    "module": "./types/IStatus"
+                  }
+                ]
+              },
+              "default": "PROCESS_STATUS.NEUTRAL",
+              "readonly": true,
+              "attribute": "state"
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "The label content of the badge, typically plain text."
+            },
+            {
+              "name": "icon",
+              "description": "Icon content rendered before the label."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsStatus",
+          "declaration": {
+            "name": "BdsStatus"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-status",
+          "declaration": {
+            "name": "BdsStatus"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/feedback/bds-tag/bds-tag.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-tag",
+          "name": "BdsTag",
+          "description": "Tag component used to represent categories, metadata, or removable filters.",
+          "attributes": [
+            {
+              "name": "close-button-label",
+              "description": "Aria label for the close button when visible.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "'Close tag'",
+              "fieldName": "closeButtonLabel"
+            },
+            {
+              "name": "color",
+              "description": "Visual color variant: 'gray', 'cyan', 'cobalt', 'teal', 'lime', 'orange', 'rose', or 'purple'.",
+              "type": {
+                "text": "\"cobalt\" | \"cyan\" | \"gray\" | \"lime\" | \"orange\" | \"purple\" | \"rose\" | \"teal\"",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "TAG_COLORS.GRAY",
+              "fieldName": "color"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables interaction with the tag. Reduces opacity and prevents interactions.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "multiselect",
+              "description": "Whether the tag is selectable or not.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "multiselect"
+            },
+            {
+              "name": "readonly",
+              "description": "Hides the close button that allows users to dismiss the tag.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "readonly"
+            },
+            {
+              "name": "selected",
+              "description": "Whether the tag is selected or not.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "selected"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "closeButtonLabel",
+              "description": "Aria label for the close button when visible.",
+              "type": {
+                "text": "string",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "'Close tag'",
+              "readonly": true,
+              "attribute": "close-button-label"
+            },
+            {
+              "kind": "field",
+              "name": "color",
+              "description": "Visual color variant: 'gray', 'cyan', 'cobalt', 'teal', 'lime', 'orange', 'rose', or 'purple'.",
+              "type": {
+                "text": "\"cobalt\" | \"cyan\" | \"gray\" | \"lime\" | \"orange\" | \"purple\" | \"rose\" | \"teal\"",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "TAG_COLORS.GRAY",
+              "readonly": true,
+              "attribute": "color"
+            },
+            {
+              "kind": "field",
+              "name": "disabled",
+              "description": "Disables interaction with the tag. Reduces opacity and prevents interactions.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "disabled"
+            },
+            {
+              "kind": "field",
+              "name": "multiselect",
+              "description": "Whether the tag is selectable or not.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "multiselect"
+            },
+            {
+              "kind": "field",
+              "name": "readonly",
+              "description": "Hides the close button that allows users to dismiss the tag.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "readonly"
+            },
+            {
+              "kind": "field",
+              "name": "selected",
+              "description": "Whether the tag is selected or not.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITag",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "selected"
+            }
+          ],
+          "events": [
+            {
+              "name": "bdsClose",
+              "description": "Emitted when the tag is closed via the close button or Delete key.",
+              "type": {
+                "text": "CustomEvent<{ id: string; selected: boolean; el: HTMLElement; }>",
+                "references": [
+                  {
+                    "name": "TagEventPayload",
+                    "module": "./types"
+                  }
+                ]
+              }
+            },
+            {
+              "name": "bdsSelect",
+              "description": "Emitted when the tag is selected via a click or Space/Enter key.",
+              "type": {
+                "text": "CustomEvent<{ id: string; selected: boolean; el: HTMLElement; }>",
+                "references": [
+                  {
+                    "name": "TagEventPayload",
+                    "module": "./types"
+                  }
+                ]
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Default slot for custom text content after the icon."
+            },
+            {
+              "name": "icon",
+              "description": "Icon slot for icon content before the text."
+            }
+          ]
+        }
+      ],
       "exports": [
         {
           "kind": "js",
-          "name": "BdsSpinner",
+          "name": "BdsTag",
           "declaration": {
-            "name": "BdsSpinner"
+            "name": "BdsTag"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-spinner",
+          "name": "bds-tag",
           "declaration": {
-            "name": "BdsSpinner"
+            "name": "BdsTag"
           }
         }
       ]
@@ -1870,153 +3489,461 @@
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "counter"
+              "fieldName": "counter"
+            },
+            {
+              "name": "custom-width",
+              "description": "Sets a custom width via the `--bds-text-field-width` CSS custom property.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "customWidth"
+            },
+            {
+              "name": "disabled",
+              "description": "Disables the input. Also toggled by `formDisabledCallback` via the mixin.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "disabled"
+            },
+            {
+              "name": "error",
+              "description": "When `true`, applies the error visual state.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "error"
+            },
+            {
+              "name": "error-message",
+              "description": "Message shown below the input when `error` is `true`. Replaces `helperText`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "errorMessage"
+            },
+            {
+              "name": "helper-text",
+              "description": "Helper text shown below the input when there is no error.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "helperText"
+            },
+            {
+              "name": "icon",
+              "description": "Icon font class rendered beside the sublabel inside the container (e.g. `bds-icon-settings`).",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "icon"
+            },
+            {
+              "name": "info",
+              "description": "Tooltip content attached to the label. Rendered via `bds-typography` `tooltipText` prop.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "info"
+            },
+            {
+              "name": "label",
+              "description": "Label text rendered above the input.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "label"
+            },
+            {
+              "name": "max-length",
+              "description": "Maximum character count. `0` means no maximum.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "maxLength"
+            },
+            {
+              "name": "min-length",
+              "description": "Minimum character count. `0` means no minimum.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "fieldName": "minLength"
+            },
+            {
+              "name": "name",
+              "description": "The name submitted with the form.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "name"
+            },
+            {
+              "name": "pattern",
+              "description": "Regex the value must match to pass `patternMismatch` validation. Also forwarded as the native `pattern` attribute to the inner `<input>`. Empty string disables pattern validation.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "pattern"
+            },
+            {
+              "name": "placeholder",
+              "description": "Native `placeholder` attribute forwarded to the inner `<input>`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "placeholder"
+            },
+            {
+              "name": "readonly",
+              "description": "Makes the input read-only. The value is still submitted with the form.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "readOnly"
+            },
+            {
+              "name": "required",
+              "description": "Marks the input as required for form validation.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "required"
+            },
+            {
+              "name": "sublabel",
+              "description": "Sublabel rendered inside the input container, before the text area.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "sublabel"
+            },
+            {
+              "name": "type",
+              "description": "The input type. Use `'password'` to enable the visibility toggle.",
+              "type": {
+                "text": "\"password\" | \"text\"",
+                "references": [
+                  {
+                    "name": "TextFieldType",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "TEXT_FIELD_TYPES.TEXT",
+              "fieldName": "type"
+            },
+            {
+              "name": "validation-timing",
+              "description": "Controls when built-in validation runs: `'blur'` | `'input'` | `'submit'` | `'change'`.",
+              "type": {
+                "text": "\"blur\" | \"change\" | \"input\" | \"submit\"",
+                "references": [
+                  {
+                    "name": "TextFieldValidationTiming",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "TEXT_FIELD_VALIDATION_TIMING.BLUR",
+              "fieldName": "validationTiming"
+            },
+            {
+              "name": "value",
+              "description": "The current value of the input.",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "value"
+            },
+            {
+              "name": "variant",
+              "description": "Visual style of the input container. `'outline'` shows a border; `'plain'` hides it at rest.",
+              "type": {
+                "text": "\"outline\" | \"plain\"",
+                "references": [
+                  {
+                    "name": "TextFieldVariant",
+                    "module": "./types"
+                  }
+                ]
+              },
+              "default": "TEXT_FIELD_VARIANTS.OUTLINE",
+              "fieldName": "variant"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "autocomplete",
+              "description": "Native `autocomplete` attribute forwarded to the inner `<input>`.",
+              "type": {
+                "text": "string"
+              },
+              "default": "'off'",
+              "readonly": true,
+              "attribute": "autocomplete"
+            },
+            {
+              "kind": "field",
+              "name": "charCount",
+              "description": "Maximum character count shown in the footer counter (e.g. `120` → `\"45/120\"`). Requires `counter`.",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "readonly": true,
+              "attribute": "char-count"
+            },
+            {
+              "kind": "field",
+              "name": "clearOnHover",
+              "description": "Shows a clear button that is hidden at rest and revealed when the user hovers over the field.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "clear-on-hover"
+            },
+            {
+              "kind": "field",
+              "name": "clearable",
+              "description": "Shows a clear button when the input has a value.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "clearable"
+            },
+            {
+              "kind": "field",
+              "name": "counter",
+              "description": "Enables the character counter in the footer. Requires `charCount` to be set.",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "counter"
             },
             {
-              "name": "custom-width",
+              "kind": "field",
+              "name": "customValidators",
+              "description": "Additional validators merged with the built-in ones.",
+              "type": {
+                "text": "IFormValidator[]",
+                "references": [
+                  {
+                    "name": "IFormValidator",
+                    "module": "@/types"
+                  }
+                ]
+              },
+              "default": "[]",
+              "readonly": true
+            },
+            {
+              "kind": "field",
+              "name": "customWidth",
               "description": "Sets a custom width via the `--bds-text-field-width` CSS custom property.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "customWidth"
+              "readonly": true,
+              "attribute": "custom-width"
             },
             {
+              "kind": "field",
               "name": "disabled",
               "description": "Disables the input. Also toggled by `formDisabledCallback` via the mixin.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "disabled"
+              "readonly": true,
+              "attribute": "disabled",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "error",
               "description": "When `true`, applies the error visual state.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "error"
+              "readonly": true,
+              "attribute": "error",
+              "reflects": true
             },
             {
-              "name": "error-message",
+              "kind": "field",
+              "name": "errorMessage",
               "description": "Message shown below the input when `error` is `true`. Replaces `helperText`.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "errorMessage"
+              "readonly": true,
+              "attribute": "error-message"
             },
             {
-              "name": "helper-text",
+              "kind": "field",
+              "name": "helperText",
               "description": "Helper text shown below the input when there is no error.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "helperText"
+              "readonly": true,
+              "attribute": "helper-text"
             },
             {
+              "kind": "field",
               "name": "icon",
               "description": "Icon font class rendered beside the sublabel inside the container (e.g. `bds-icon-settings`).",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "icon"
+              "readonly": true,
+              "attribute": "icon"
             },
             {
+              "kind": "field",
               "name": "info",
               "description": "Tooltip content attached to the label. Rendered via `bds-typography` `tooltipText` prop.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "info"
+              "readonly": true,
+              "attribute": "info"
             },
             {
+              "kind": "field",
               "name": "label",
               "description": "Label text rendered above the input.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "label"
+              "readonly": true,
+              "attribute": "label"
             },
             {
-              "name": "max-length",
+              "kind": "field",
+              "name": "maxLength",
               "description": "Maximum character count. `0` means no maximum.",
               "type": {
                 "text": "number"
               },
               "default": "0",
-              "fieldName": "maxLength"
+              "readonly": true,
+              "attribute": "max-length"
             },
             {
-              "name": "min-length",
+              "kind": "field",
+              "name": "minLength",
               "description": "Minimum character count. `0` means no minimum.",
               "type": {
                 "text": "number"
               },
               "default": "0",
-              "fieldName": "minLength"
+              "readonly": true,
+              "attribute": "min-length"
             },
             {
+              "kind": "field",
               "name": "name",
               "description": "The name submitted with the form.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "name"
+              "readonly": true,
+              "attribute": "name",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "pattern",
               "description": "Regex the value must match to pass `patternMismatch` validation. Also forwarded as the native `pattern` attribute to the inner `<input>`. Empty string disables pattern validation.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "pattern"
+              "readonly": true,
+              "attribute": "pattern"
             },
             {
+              "kind": "field",
               "name": "placeholder",
               "description": "Native `placeholder` attribute forwarded to the inner `<input>`.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "placeholder"
+              "readonly": true,
+              "attribute": "placeholder"
             },
             {
-              "name": "readonly",
+              "kind": "field",
+              "name": "readOnly",
               "description": "Makes the input read-only. The value is still submitted with the form.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "readOnly"
+              "readonly": true,
+              "attribute": "readonly"
             },
             {
+              "kind": "field",
               "name": "required",
               "description": "Marks the input as required for form validation.",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "required"
+              "readonly": true,
+              "attribute": "required",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "sublabel",
               "description": "Sublabel rendered inside the input container, before the text area.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "sublabel"
+              "readonly": true,
+              "attribute": "sublabel"
             },
             {
+              "kind": "field",
               "name": "type",
               "description": "The input type. Use `'password'` to enable the visibility toggle.",
               "type": {
@@ -2029,10 +3956,13 @@
                 ]
               },
               "default": "TEXT_FIELD_TYPES.TEXT",
-              "fieldName": "type"
+              "readonly": true,
+              "attribute": "type",
+              "reflects": true
             },
             {
-              "name": "validation-timing",
+              "kind": "field",
+              "name": "validationTiming",
               "description": "Controls when built-in validation runs: `'blur'` | `'input'` | `'submit'` | `'change'`.",
               "type": {
                 "text": "\"blur\" | \"change\" | \"input\" | \"submit\"",
@@ -2044,18 +3974,22 @@
                 ]
               },
               "default": "TEXT_FIELD_VALIDATION_TIMING.BLUR",
-              "fieldName": "validationTiming"
+              "readonly": true,
+              "attribute": "validation-timing"
             },
             {
+              "kind": "field",
               "name": "value",
               "description": "The current value of the input.",
               "type": {
                 "text": "string"
               },
               "default": "''",
-              "fieldName": "value"
+              "attribute": "value",
+              "reflects": true
             },
             {
+              "kind": "field",
               "name": "variant",
               "description": "Visual style of the input container. `'outline'` shows a border; `'plain'` hides it at rest.",
               "type": {
@@ -2068,443 +4002,557 @@
                 ]
               },
               "default": "TEXT_FIELD_VARIANTS.OUTLINE",
-              "fieldName": "variant"
+              "readonly": true,
+              "attribute": "variant",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "checkValidity",
+              "description": "Returns `true` if the element's value passes all constraints; `false` otherwise.\nAlso fires an `invalid` event if constraints are violated.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "reportValidity",
+              "description": "Returns `true` if the element's value passes all constraints; `false` otherwise.\nShows the browser's native validation UI when constraints are violated.",
+              "return": {
+                "type": {
+                  "text": "Promise<boolean>",
+                  "references": [
+                    {
+                      "name": "Promise",
+                      "package": "global:"
+                    }
+                  ]
+                }
+              }
             }
           ],
-          "members": [
+          "events": [
             {
-              "kind": "field",
-              "name": "autocomplete",
-              "description": "Native `autocomplete` attribute forwarded to the inner `<input>`.",
+              "name": "bdsBlur",
+              "description": "Emitted when the input loses focus.",
               "type": {
-                "text": "string"
-              },
-              "default": "'off'",
-              "readonly": true,
-              "attribute": "autocomplete"
+                "text": "CustomEvent<{ event: FocusEvent; }>",
+                "references": [
+                  {
+                    "name": "FocusEvent",
+                    "package": "global:"
+                  }
+                ]
+              }
             },
             {
-              "kind": "field",
-              "name": "charCount",
-              "description": "Maximum character count shown in the footer counter (e.g. `120` → `\"45/120\"`). Requires `counter`.",
+              "name": "bdsChange",
+              "description": "Emitted when the input loses focus after the value has changed.",
               "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "readonly": true,
-              "attribute": "char-count"
+                "text": "CustomEvent<{ value: string; event: Event; }>",
+                "references": [
+                  {
+                    "name": "Event",
+                    "module": "@stencil/core"
+                  }
+                ]
+              }
             },
             {
-              "kind": "field",
-              "name": "clearOnHover",
-              "description": "Shows a clear button that is hidden at rest and revealed when the user hovers over the field.",
+              "name": "bdsClear",
+              "description": "Emitted when the user activates the clear button.",
               "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "readonly": true,
-              "attribute": "clear-on-hover"
+                "text": "CustomEvent<void>"
+              }
             },
             {
-              "kind": "field",
-              "name": "clearable",
-              "description": "Shows a clear button when the input has a value.",
+              "name": "bdsFocus",
+              "description": "Emitted when the input gains focus.",
               "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "readonly": true,
-              "attribute": "clearable"
+                "text": "CustomEvent<{ event: FocusEvent; }>",
+                "references": [
+                  {
+                    "name": "FocusEvent",
+                    "package": "global:"
+                  }
+                ]
+              }
             },
             {
-              "kind": "field",
-              "name": "counter",
-              "description": "Enables the character counter in the footer. Requires `charCount` to be set.",
+              "name": "bdsInput",
+              "description": "Emitted on every keystroke with the current value and the originating event.",
               "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "readonly": true,
-              "attribute": "counter"
+                "text": "CustomEvent<{ value: string; event: InputEvent; }>",
+                "references": [
+                  {
+                    "name": "InputEvent",
+                    "package": "global:"
+                  }
+                ]
+              }
             },
             {
-              "kind": "field",
-              "name": "customValidators",
-              "description": "Additional validators merged with the built-in ones.",
+              "name": "bdsValidationChange",
+              "description": "Emitted after each validation run with the full validity snapshot.",
+              "type": {
+                "text": "CustomEvent<{ valid: boolean; validity: ValidityState; value: string; touched: boolean; dirty: boolean; }>",
+                "references": [
+                  {
+                    "name": "ValidityState",
+                    "package": "global:"
+                  }
+                ]
+              }
+            },
+            {
+              "name": "valueChange",
+              "description": "Emitted whenever the value changes. Used by framework wrappers for 2-way binding.",
+              "type": {
+                "text": "CustomEvent<string>"
+              }
+            }
+          ],
+          "slots": [
+            {
+              "name": "prefix",
+              "description": "Inline content rendered before the input (e.g. icon or status indicator). Intended for single-line elements only; multi-line content will be clipped."
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "BdsTextField",
+          "declaration": {
+            "name": "BdsTextField"
+          }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "bds-text-field",
+          "declaration": {
+            "name": "BdsTextField"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/actions/bds-toggle/bds-toggle.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "tagName": "bds-toggle",
+          "name": "BdsToggle",
+          "description": "Toggle/Switch component for boolean selection.",
+          "attributes": [
+            {
+              "name": "checked",
+              "description": "Whether the toggle is on. Defaults to `false`.",
               "type": {
-                "text": "IFormValidator[]",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "IFormValidator",
-                    "module": "@/types"
+                    "name": "IToggle",
+                    "module": "./types"
                   }
                 ]
               },
-              "default": "[]",
-              "readonly": true
-            },
-            {
-              "kind": "field",
-              "name": "customWidth",
-              "description": "Sets a custom width via the `--bds-text-field-width` CSS custom property.",
-              "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "readonly": true,
-              "attribute": "custom-width"
+              "default": "false",
+              "fieldName": "checked"
             },
             {
-              "kind": "field",
               "name": "disabled",
-              "description": "Disables the input. Also toggled by `formDisabledCallback` via the mixin.",
+              "description": "Disables the control. Defaults to `false`.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "disabled",
-              "reflects": true
+              "fieldName": "disabled"
             },
             {
-              "kind": "field",
               "name": "error",
               "description": "When `true`, applies the error visual state.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "false",
-              "readonly": true,
-              "attribute": "error",
-              "reflects": true
+              "fieldName": "error"
             },
             {
-              "kind": "field",
-              "name": "errorMessage",
+              "name": "error-message",
               "description": "Message shown below the input when `error` is `true`. Replaces `helperText`.",
               "type": {
-                "text": "string"
-              },
-              "default": "''",
-              "readonly": true,
-              "attribute": "error-message"
-            },
-            {
-              "kind": "field",
-              "name": "helperText",
-              "description": "Helper text shown below the input when there is no error.",
-              "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "helper-text"
+              "fieldName": "errorMessage"
             },
             {
-              "kind": "field",
-              "name": "icon",
-              "description": "Icon font class rendered beside the sublabel inside the container (e.g. `bds-icon-settings`).",
+              "name": "helper-text",
+              "description": "Help text displayed below the toggle. Defaults to `\"\"`.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "icon"
+              "fieldName": "helperText"
             },
             {
-              "kind": "field",
               "name": "info",
               "description": "Tooltip content attached to the label. Rendered via `bds-typography` `tooltipText` prop.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "info"
+              "fieldName": "info"
             },
             {
-              "kind": "field",
               "name": "label",
-              "description": "Label text rendered above the input.",
+              "description": "Label displayed next to the toggle. Defaults to `\"\"`.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "''",
-              "readonly": true,
-              "attribute": "label"
-            },
-            {
-              "kind": "field",
-              "name": "maxLength",
-              "description": "Maximum character count. `0` means no maximum.",
-              "type": {
-                "text": "number"
-              },
-              "default": "0",
-              "readonly": true,
-              "attribute": "max-length"
+              "fieldName": "label"
             },
             {
-              "kind": "field",
-              "name": "minLength",
-              "description": "Minimum character count. `0` means no minimum.",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "number"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "0",
-              "readonly": true,
-              "attribute": "min-length"
+              "fieldName": "name"
             },
             {
-              "kind": "field",
-              "name": "name",
-              "description": "The name submitted with the form.",
+              "name": "placement",
+              "description": "Position of the label relative to the switch.\nAccepts `TOGGLE_PLACEMENT` values. Defaults to `TOGGLE_PLACEMENT.LEFT`.",
               "type": {
-                "text": "string"
+                "text": "\"left\" | \"right\"",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "''",
-              "readonly": true,
-              "attribute": "name",
-              "reflects": true
+              "default": "TOGGLE_PLACEMENT.LEFT",
+              "fieldName": "placement"
             },
             {
-              "kind": "field",
-              "name": "pattern",
-              "description": "Regex the value must match to pass `patternMismatch` validation. Also forwarded as the native `pattern` attribute to the inner `<input>`. Empty string disables pattern validation.",
+              "name": "required",
+              "description": "Marks the control as required for form submission. Defaults to `false`.",
               "type": {
-                "text": "string"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "''",
-              "readonly": true,
-              "attribute": "pattern"
+              "default": "false",
+              "fieldName": "required"
             },
             {
-              "kind": "field",
-              "name": "placeholder",
-              "description": "Native `placeholder` attribute forwarded to the inner `<input>`.",
+              "name": "value",
+              "description": "Value submitted with the form data when checked.\nBehaves like the `value` attribute of a native `<input type=\"checkbox\">`. Defaults to `\"on\"`.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "''",
-              "readonly": true,
-              "attribute": "placeholder"
-            },
+              "default": "'on'",
+              "fieldName": "value"
+            }
+          ],
+          "members": [
             {
               "kind": "field",
-              "name": "readOnly",
-              "description": "Makes the input read-only. The value is still submitted with the form.",
+              "name": "checked",
+              "description": "Whether the toggle is on. Defaults to `false`.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
-              "attribute": "readonly"
+              "attribute": "checked",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "required",
-              "description": "Marks the input as required for form validation.",
+              "name": "disabled",
+              "description": "Disables the control. Defaults to `false`.",
               "type": {
-                "text": "boolean"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "false",
               "readonly": true,
-              "attribute": "required",
+              "attribute": "disabled",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "sublabel",
-              "description": "Sublabel rendered inside the input container, before the text area.",
+              "name": "error",
+              "description": "When `true`, applies the error visual state.",
               "type": {
-                "text": "string"
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
-              "default": "''",
+              "default": "false",
               "readonly": true,
-              "attribute": "sublabel"
+              "attribute": "error",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "type",
-              "description": "The input type. Use `'password'` to enable the visibility toggle.",
+              "name": "errorMessage",
+              "description": "Message shown below the input when `error` is `true`. Replaces `helperText`.",
               "type": {
-                "text": "\"password\" | \"text\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "TextFieldType",
+                    "name": "IToggle",
                     "module": "./types"
                   }
                 ]
               },
-              "default": "TEXT_FIELD_TYPES.TEXT",
+              "default": "''",
               "readonly": true,
-              "attribute": "type",
+              "attribute": "error-message",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "validationTiming",
-              "description": "Controls when built-in validation runs: `'blur'` | `'input'` | `'submit'` | `'change'`.",
+              "name": "helperText",
+              "description": "Help text displayed below the toggle. Defaults to `\"\"`.",
               "type": {
-                "text": "\"blur\" | \"change\" | \"input\" | \"submit\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "TextFieldValidationTiming",
+                    "name": "IToggle",
                     "module": "./types"
                   }
                 ]
               },
-              "default": "TEXT_FIELD_VALIDATION_TIMING.BLUR",
+              "default": "''",
               "readonly": true,
-              "attribute": "validation-timing"
+              "attribute": "helper-text",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "value",
-              "description": "The current value of the input.",
+              "name": "info",
+              "description": "Tooltip content attached to the label. Rendered via `bds-typography` `tooltipText` prop.",
               "type": {
-                "text": "string"
+                "text": "string",
+                "references": [
+                  {
+                    "name": "IToggle",
+                    "module": "./types"
+                  }
+                ]
               },
               "default": "''",
-              "attribute": "value",
-              "reflects": true
+              "readonly": true,
+              "attribute": "info"
             },
             {
               "kind": "field",
-              "name": "variant",
-              "description": "Visual style of the input container. `'outline'` shows a border; `'plain'` hides it at rest.",
+              "name": "label",
+              "description": "Label displayed next to the toggle. Defaults to `\"\"`.",
               "type": {
-                "text": "\"outline\" | \"plain\"",
+                "text": "string",
                 "references": [
                   {
-                    "name": "TextFieldVariant",
+                    "name": "IToggle",
                     "module": "./types"
                   }
                 ]
               },
-              "default": "TEXT_FIELD_VARIANTS.OUTLINE",
+              "default": "''",
               "readonly": true,
-              "attribute": "variant",
+              "attribute": "label",
               "reflects": true
             },
             {
-              "kind": "method",
-              "name": "checkValidity",
-              "description": "Returns `true` if the element's value passes all constraints; `false` otherwise.\nAlso fires an `invalid` event if constraints are violated.",
-              "return": {
-                "type": {
-                  "text": "Promise<boolean>",
-                  "references": [
-                    {
-                      "name": "Promise",
-                      "package": "global:"
-                    }
-                  ]
-                }
-              }
-            },
-            {
-              "kind": "method",
-              "name": "reportValidity",
-              "description": "Returns `true` if the element's value passes all constraints; `false` otherwise.\nShows the browser's native validation UI when constraints are violated.",
-              "return": {
-                "type": {
-                  "text": "Promise<boolean>",
-                  "references": [
-                    {
-                      "name": "Promise",
-                      "package": "global:"
-                    }
-                  ]
-                }
-              }
-            }
-          ],
-          "events": [
-            {
-              "name": "bdsBlur",
-              "description": "Emitted when the input loses focus.",
+              "kind": "field",
+              "name": "name",
+              "description": "Name of the form control, submitted as a key in the form data.",
               "type": {
-                "text": "CustomEvent<{ event: FocusEvent; }>",
+                "text": "string",
                 "references": [
                   {
-                    "name": "FocusEvent",
-                    "package": "global:"
+                    "name": "IToggle",
+                    "module": "./types"
                   }
                 ]
-              }
+              },
+              "readonly": true,
+              "attribute": "name",
+              "reflects": true
             },
             {
-              "name": "bdsChange",
-              "description": "Emitted when the input loses focus after the value has changed.",
+              "kind": "field",
+              "name": "placement",
+              "description": "Position of the label relative to the switch.\nAccepts `TOGGLE_PLACEMENT` values. Defaults to `TOGGLE_PLACEMENT.LEFT`.",
               "type": {
-                "text": "CustomEvent<{ value: string; event: Event; }>",
+                "text": "\"left\" | \"right\"",
                 "references": [
                   {
-                    "name": "Event",
-                    "module": "@stencil/core"
+                    "name": "IToggle",
+                    "module": "./types"
                   }
                 ]
-              }
-            },
-            {
-              "name": "bdsClear",
-              "description": "Emitted when the user activates the clear button.",
-              "type": {
-                "text": "CustomEvent<void>"
-              }
+              },
+              "default": "TOGGLE_PLACEMENT.LEFT",
+              "readonly": true,
+              "attribute": "placement",
+              "reflects": true
             },
             {
-              "name": "bdsFocus",
-              "description": "Emitted when the input gains focus.",
+              "kind": "field",
+              "name": "required",
+              "description": "Marks the control as required for form submission. Defaults to `false`.",
               "type": {
-                "text": "CustomEvent<{ event: FocusEvent; }>",
+                "text": "boolean",
                 "references": [
                   {
-                    "name": "FocusEvent",
-                    "package": "global:"
+                    "name": "IToggle",
+                    "module": "./types"
                   }
                 ]
-              }
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "required",
+              "reflects": true
             },
             {
-              "name": "bdsInput",
-              "description": "Emitted on every keystroke with the current value and the originating event.",
+              "kind": "field",
+              "name": "value",
+              "description": "Value submitted with the form data when checked.\nBehaves like the `value` attribute of a native `<input type=\"checkbox\">`. Defaults to `\"on\"`.",
               "type": {
-                "text": "CustomEvent<{ value: string; event: InputEvent; }>",
+                "text": "string",
                 "references": [
                   {
-                    "name": "InputEvent",
-                    "package": "global:"
+                    "name": "IToggle",
+                    "module": "./types"
                   }
                 ]
-              }
-            },
+              },
+              "default": "'on'",
+              "readonly": true,
+              "attribute": "value"
+            }
+          ],
+          "events": [
             {
-              "name": "bdsValidationChange",
-              "description": "Emitted after each validation run with the full validity snapshot.",
+              "name": "bdsChange",
+              "description": "Emitted when the user toggles the switch. Payload: `{ checked: boolean, value: string }`.",
               "type": {
-                "text": "CustomEvent<{ valid: boolean; validity: ValidityState; value: string; touched: boolean; dirty: boolean; }>",
+                "text": "CustomEvent<IToggleEventChange>",
                 "references": [
                   {
-                    "name": "ValidityState",
-                    "package": "global:"
+                    "name": "IToggleEventChange",
+                    "module": "./types/IEventChange"
                   }
                 ]
               }
             },
             {
               "name": "valueChange",
-              "description": "Emitted whenever the value changes. Used by framework wrappers for 2-way binding.",
+              "description": "Emitted when the checked state changes. Useful for 2-way binding / v-model. Payload: `boolean`.",
               "type": {
-                "text": "CustomEvent<string>"
+                "text": "CustomEvent<boolean>"
               }
             }
           ],
           "slots": [
             {
-              "name": "prefix",
-              "description": "Inline content rendered before the input (e.g. icon or status indicator). Intended for single-line elements only; multi-line content will be clipped."
+              "name": "",
+              "description": "Default slot for label content (used when `label` prop is not provided)."
+            },
+            {
+              "name": "help-text",
+              "description": "Slot for help text below the toggle (used when `helperText` prop is not provided)."
+            }
+          ],
+          "cssParts": [
+            {
+              "name": "container"
             }
           ]
         }
@@ -2512,16 +4560,16 @@
       "exports": [
         {
           "kind": "js",
-          "name": "BdsTextField",
+          "name": "BdsToggle",
           "declaration": {
-            "name": "BdsTextField"
+            "name": "BdsToggle"
           }
         },
         {
           "kind": "custom-element-definition",
-          "name": "bds-text-field",
+          "name": "bds-toggle",
           "declaration": {
-            "name": "BdsTextField"
+            "name": "BdsToggle"
           }
         }
       ]
@@ -2692,6 +4740,21 @@
               "default": "''",
               "fieldName": "customClass"
             },
+            {
+              "name": "downloadable",
+              "description": "Enables download behavior for anchor.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITypography",
+                    "module": "./types/ITypography"
+                  }
+                ]
+              },
+              "default": "false",
+              "fieldName": "downloadable"
+            },
             {
               "name": "element",
               "description": "HTML tag used for rendering.",
@@ -2768,10 +4831,10 @@
               "fieldName": "htmlFor"
             },
             {
-              "name": "is-downloadable",
-              "description": "Enables download behavior for anchor.",
+              "name": "max-lines",
+              "description": "Max lines when ellipsis is enabled.",
               "type": {
-                "text": "boolean",
+                "text": "number",
                 "references": [
                   {
                     "name": "ITypography",
@@ -2779,11 +4842,11 @@
                   }
                 ]
               },
-              "default": "false",
-              "fieldName": "isDownloadable"
+              "default": "1",
+              "fieldName": "maxLines"
             },
             {
-              "name": "is-required",
+              "name": "required",
               "description": "Marks the field as required.",
               "type": {
                 "text": "boolean",
@@ -2795,22 +4858,7 @@
                 ]
               },
               "default": "false",
-              "fieldName": "isRequired"
-            },
-            {
-              "name": "max-lines",
-              "description": "Max lines when ellipsis is enabled.",
-              "type": {
-                "text": "number",
-                "references": [
-                  {
-                    "name": "ITypography",
-                    "module": "./types/ITypography"
-                  }
-                ]
-              },
-              "default": "1",
-              "fieldName": "maxLines"
+              "fieldName": "required"
             },
             {
               "name": "size",
@@ -2917,6 +4965,23 @@
               "readonly": true,
               "attribute": "custom-class"
             },
+            {
+              "kind": "field",
+              "name": "downloadable",
+              "description": "Enables download behavior for anchor.",
+              "type": {
+                "text": "boolean",
+                "references": [
+                  {
+                    "name": "ITypography",
+                    "module": "./types/ITypography"
+                  }
+                ]
+              },
+              "default": "false",
+              "readonly": true,
+              "attribute": "downloadable"
+            },
             {
               "kind": "field",
               "name": "element",
@@ -3004,10 +5069,10 @@
             },
             {
               "kind": "field",
-              "name": "isDownloadable",
-              "description": "Enables download behavior for anchor.",
+              "name": "maxLines",
+              "description": "Max lines when ellipsis is enabled.",
               "type": {
-                "text": "boolean",
+                "text": "number",
                 "references": [
                   {
                     "name": "ITypography",
@@ -3015,13 +5080,13 @@
                   }
                 ]
               },
-              "default": "false",
+              "default": "1",
               "readonly": true,
-              "attribute": "is-downloadable"
+              "attribute": "max-lines"
             },
             {
               "kind": "field",
-              "name": "isRequired",
+              "name": "required",
               "description": "Marks the field as required.",
               "type": {
                 "text": "boolean",
@@ -3034,26 +5099,9 @@
               },
               "default": "false",
               "readonly": true,
-              "attribute": "is-required",
+              "attribute": "required",
               "reflects": true
             },
-            {
-              "kind": "field",
-              "name": "maxLines",
-              "description": "Max lines when ellipsis is enabled.",
-              "type": {
-                "text": "number",
-                "references": [
-                  {
-                    "name": "ITypography",
-                    "module": "./types/ITypography"
-                  }
-                ]
-              },
-              "default": "1",
-              "readonly": true,
-              "attribute": "max-lines"
-            },
             {
               "kind": "field",
               "name": "size",