@govtechsg/sgds-web-component 3.21.1 → 3.21.2-rc.1

package/custom-elements.json

@@ -1214,167 +1214,287 @@
     },
     {
       "kind": "javascript-module",
-      "path": "src/components/Breadcrumb/sgds-breadcrumb-item.ts",
+      "path": "src/components/Button/sgds-button.ts",
       "declarations": [
         {
           "kind": "class",
           "description": "",
-          "name": "SgdsBreadcrumbItem",
+          "name": "SgdsButton",
           "slots": [
             {
-              "description": "The link of the item. Pass in anchor tags into this slot",
+              "description": "The button's label.",
               "name": "default"
+            },
+            {
+              "description": "The slot for icon to the left of the button text",
+              "name": "leftIcon"
+            },
+            {
+              "description": "The slot for icon to the right of the button text",
+              "name": "rightIcon"
             }
           ],
           "members": [
             {
               "kind": "field",
-              "name": "dependencies",
+              "name": "name",
               "type": {
-                "text": "Record<string, typeof SgdsElement>"
+                "text": "string"
               },
-              "static": true,
-              "default": "{\n    \"sgds-link\": SgdsLink,\n    \"sgds-icon\": SgdsIcon\n  }"
+              "description": "The name of the button, submitted as a name/value pair with form data only when this button is the submitter. Only works with `type=\"submit\"`. Has no effect when the button is rendered as a link (i.e. when `href` is set).",
+              "attribute": "name",
+              "reflects": true
             },
             {
               "kind": "field",
-              "name": "active",
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "The value of the button, submitted as a name/value pair with form data only when this button is the submitter. Only works with `type=\"submit\"`. Has no effect when the button is rendered as a link (i.e. when `href` is set).",
+              "attribute": "value",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "type",
+              "type": {
+                "text": "\"button\" | \"submit\" | \"reset\""
+              },
+              "default": "\"button\"",
+              "description": "The behavior of the button with default as `type='button', `reset` resets all the controls to their initial values and `submit` submits the form data to the server",
+              "attribute": "type",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "form",
+              "type": {
+                "text": "string"
+              },
+              "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
+              "attribute": "form",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "formAction",
+              "type": {
+                "text": "string"
+              },
+              "description": "Used to override the form owner's `action` attribute.",
+              "attribute": "formaction",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "formMethod",
+              "type": {
+                "text": "\"post\" | \"get\""
+              },
+              "description": "Used to override the form owner's `method` attribute.",
+              "attribute": "formmethod",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "formNoValidate",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Used to override the form owner's `novalidate` attribute.",
+              "attribute": "formnovalidate",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "formTarget",
+              "type": {
+                "text": "| \"_self\"\n    | \"_blank\"\n    | \"_parent\"\n    | \"_top\"\n    | string"
+              },
+              "description": "Used to override the form owner's `target` attribute.",
+              "attribute": "formtarget",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "fullWidth",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Indicates the link matches the current location of the page. Programmatically handled by SgdsBreadcrumb to set this prop to true for the last breadcrumb item",
-              "attribute": "active",
+              "description": "When set, the button will be in full width.",
+              "attribute": "fullWidth",
               "reflects": true
             },
             {
               "kind": "field",
-              "name": "_preventNavigation",
+              "name": "hasLeftIconSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Used only for SSR to indicate the presence of the `leftIcon` slot.",
+              "attribute": "hasLeftIconSlot"
+            },
+            {
+              "kind": "field",
+              "name": "hasRightIconSlot",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Used only for SSR to indicate the presence of the `rightIcon` slot.",
+              "attribute": "hasRightIconSlot"
+            },
+            {
+              "kind": "field",
+              "name": "hasSlotController",
               "privacy": "private",
+              "default": "new HasSlotController(this, \"leftIcon\", \"rightIcon\")",
               "type": {}
             },
             {
               "kind": "method",
-              "name": "emit",
+              "name": "_handleClick",
+              "privacy": "protected",
               "parameters": [
                 {
-                  "name": "name",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "options",
-                  "optional": true,
+                  "name": "event",
                   "type": {
-                    "text": "CustomEventInit<T>"
+                    "text": "MouseEvent"
                   }
                 }
               ],
-              "description": "Emits a custom event with more convenient defaults.",
               "type": {},
               "inheritedFrom": {
-                "name": "SgdsElement",
-                "module": "src/base/sgds-element.ts"
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "define",
-              "static": true,
-              "parameters": [
-                {
-                  "name": "name",
-                  "type": {
-                    "text": "string"
-                  }
-                },
-                {
-                  "name": "elementConstructor",
-                  "default": "this"
-                },
-                {
-                  "name": "options",
-                  "default": "{}",
-                  "type": {
-                    "text": "ElementDefinitionOptions"
-                  }
-                }
-              ],
-              "type": {},
+              "kind": "field",
+              "name": "_clickHandler",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "field",
+              "name": "variant",
+              "type": {
+                "text": "\"primary\" | \"outline\" | \"ghost\" | \"danger\""
+              },
+              "default": "\"primary\"",
+              "description": "Sets the visual variants such as: `primary`, `outline`, `ghost`. `danger` is @deprecated since v3.5.6",
+              "attribute": "variant",
+              "reflects": true,
               "inheritedFrom": {
-                "name": "SgdsElement",
-                "module": "src/base/sgds-element.ts"
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
               }
-            }
-          ],
-          "attributes": [
+            },
+            {
+              "kind": "field",
+              "name": "tone",
+              "type": {
+                "text": "\"brand\" | \"danger\" | \"fixed-light\" | \"neutral\""
+              },
+              "default": "\"brand\"",
+              "description": "Sets the visual colour of the button: `brand`, `danger`, `fixed-light`, `neutral`",
+              "attribute": "tone",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
             {
+              "kind": "field",
+              "name": "size",
+              "type": {
+                "text": "\"xs\" | \"sm\" | \"md\" | \"lg\""
+              },
+              "default": "\"md\"",
+              "description": "Specifies a small, medium or large button, the size is medium by default.",
+              "attribute": "size",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "field",
               "name": "active",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Indicates the link matches the current location of the page. Programmatically handled by SgdsBreadcrumb to set this prop to true for the last breadcrumb item",
-              "fieldName": "active"
-            }
-          ],
-          "superclass": {
-            "name": "SgdsElement",
-            "module": "/src/base/sgds-element"
-          },
-          "summary": "Breadcrumb Item are navigational links used in Breadcrumb component",
-          "tagName": "sgds-breadcrumb-item",
-          "customElement": true,
-          "modulePath": "src/components/Breadcrumb/sgds-breadcrumb-item.ts",
-          "cssProperties": [],
-          "cssParts": [],
-          "cssStates": [],
-          "events": []
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SgdsBreadcrumbItem",
-          "declaration": {
-            "name": "SgdsBreadcrumbItem",
-            "module": "src/components/Breadcrumb/sgds-breadcrumb-item.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "SgdsBreadcrumbItem",
-            "module": "src/components/Breadcrumb/sgds-breadcrumb-item.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/Breadcrumb/sgds-breadcrumb.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SgdsBreadcrumb",
-          "slots": [
+              "description": "Manually set the visual state of the button to `:active`",
+              "attribute": "active",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
             {
-              "description": "The slot to pass in custom elements of `SgdsBreadcrumbItems`.",
-              "name": "default"
-            }
-          ],
-          "members": [
+              "kind": "field",
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "The disabled state of the button",
+              "attribute": "disabled",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
             {
               "kind": "field",
-              "name": "dependencies",
+              "name": "href",
               "type": {
-                "text": "object"
+                "text": "string"
               },
-              "static": true,
-              "default": "{\n    \"sgds-overflow-menu\": SgdsOverflowMenu\n  }"
+              "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
+              "attribute": "href",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "target",
+              "type": {
+                "text": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\""
+              },
+              "default": "\"_self\"",
+              "description": "Where to display the linked URL, as the name for a browsing context. Forwards to the HTMLAnchor target attribute",
+              "attribute": "target",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "download",
+              "type": {
+                "text": "string"
+              },
+              "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
+              "attribute": "download",
+              "reflects": true,
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
             },
             {
               "kind": "field",
@@ -1382,38 +1502,152 @@
               "type": {
                 "text": "string"
               },
-              "default": "\"breadcrumb\"",
-              "description": "The aria-label of nav element within breadcrumb component.",
-              "attribute": "ariaLabel"
+              "description": "The aria-label attribute to passed to button element when necessary",
+              "attribute": "ariaLabel",
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, shows a loading spinner",
+              "attribute": "loading",
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
             },
             {
               "kind": "method",
-              "name": "_replaceExcessItemsWithDropdown",
-              "privacy": "private",
+              "name": "focus",
+              "privacy": "public",
               "parameters": [
                 {
-                  "name": "items",
+                  "name": "options",
+                  "optional": true,
                   "type": {
-                    "text": "SgdsBreadcrumbItem[]"
+                    "text": "FocusOptions"
                   }
                 }
               ],
-              "description": "creates `<sgds-breadcrumb-item>\n           <sgds-overflow-menu>\n             <sgds-dropdown-item></sgds-dropdown-item>\n              ...\n           </sgds-overflow-menu>\n         <sgds-breadcrumb-item>`",
-              "type": {}
+              "description": "Sets focus on the button.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
             },
             {
               "kind": "method",
-              "name": "_handleSlotChange",
-              "privacy": "private",
+              "name": "click",
+              "privacy": "public",
+              "description": "Simulates a click on the button.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "blur",
+              "privacy": "public",
+              "description": "Removes focus from the button.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_handleBlur",
+              "privacy": "protected",
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_handleFocus",
+              "privacy": "protected",
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_handleKeydown",
+              "privacy": "protected",
               "parameters": [
                 {
-                  "name": "e",
+                  "name": "event",
                   "type": {
-                    "text": "Event"
+                    "text": "KeyboardEvent"
                   }
                 }
               ],
-              "type": {}
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_assignSpinnerSize",
+              "privacy": "protected",
+              "parameters": [
+                {
+                  "name": "buttonSize",
+                  "type": {
+                    "text": "\"xs\" | \"sm\" | \"md\" | \"lg\""
+                  }
+                }
+              ],
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_assignSpinnerTone",
+              "privacy": "protected",
+              "return": {
+                "type": {
+                  "text": "SpinnerTone"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "buttonTone",
+                  "type": {
+                    "text": "ButtonTone"
+                  }
+                },
+                {
+                  "name": "buttonVariant",
+                  "type": {
+                    "text": "ButtonVariant"
+                  }
+                }
+              ],
+              "type": {},
+              "inheritedFrom": {
+                "name": "ButtonElement",
+                "module": "src/base/button-element.ts"
+              }
             },
             {
               "kind": "method",
@@ -1470,466 +1704,472 @@
               }
             }
           ],
+          "events": [
+            {
+              "description": "Emitted when the button is blurred.",
+              "name": "sgds-blur",
+              "reactName": "onSgdsBlur"
+            },
+            {
+              "description": "Emitted when the button is focused.",
+              "name": "sgds-focus",
+              "reactName": "onSgdsFocus"
+            }
+          ],
           "attributes": [
             {
-              "name": "ariaLabel",
+              "name": "name",
               "type": {
                 "text": "string"
               },
-              "default": "\"breadcrumb\"",
-              "description": "The aria-label of nav element within breadcrumb component.",
-              "fieldName": "ariaLabel"
-            }
-          ],
-          "superclass": {
-            "name": "SgdsElement",
-            "module": "/src/base/sgds-element"
-          },
-          "summary": "Breadcrumbs help users to navigate and understand where they are on the current website or service.",
-          "tagName": "sgds-breadcrumb",
-          "customElement": true,
-          "modulePath": "src/components/Breadcrumb/sgds-breadcrumb.ts",
-          "cssProperties": [],
-          "cssParts": [],
-          "cssStates": [],
-          "events": []
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "SgdsBreadcrumb",
-          "declaration": {
-            "name": "SgdsBreadcrumb",
-            "module": "src/components/Breadcrumb/sgds-breadcrumb.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "default",
-          "declaration": {
-            "name": "SgdsBreadcrumb",
-            "module": "src/components/Breadcrumb/sgds-breadcrumb.ts"
-          }
-        }
-      ]
-    },
-    {
-      "kind": "javascript-module",
-      "path": "src/components/Button/sgds-button.ts",
-      "declarations": [
-        {
-          "kind": "class",
-          "description": "",
-          "name": "SgdsButton",
-          "slots": [
-            {
-              "description": "The button's label.",
-              "name": "default"
+              "description": "The name of the button, submitted as a name/value pair with form data only when this button is the submitter. Only works with `type=\"submit\"`. Has no effect when the button is rendered as a link (i.e. when `href` is set).",
+              "fieldName": "name"
             },
             {
-              "description": "The slot for icon to the left of the button text",
-              "name": "leftIcon"
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "description": "The value of the button, submitted as a name/value pair with form data only when this button is the submitter. Only works with `type=\"submit\"`. Has no effect when the button is rendered as a link (i.e. when `href` is set).",
+              "fieldName": "value"
             },
             {
-              "description": "The slot for icon to the right of the button text",
-              "name": "rightIcon"
-            }
-          ],
-          "members": [
-            {
-              "kind": "field",
               "name": "type",
               "type": {
                 "text": "\"button\" | \"submit\" | \"reset\""
               },
               "default": "\"button\"",
               "description": "The behavior of the button with default as `type='button', `reset` resets all the controls to their initial values and `submit` submits the form data to the server",
-              "attribute": "type",
-              "reflects": true
+              "fieldName": "type"
             },
             {
-              "kind": "field",
               "name": "form",
               "type": {
                 "text": "string"
               },
               "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
-              "attribute": "form",
-              "reflects": true
+              "fieldName": "form"
             },
             {
-              "kind": "field",
-              "name": "formAction",
+              "name": "formaction",
               "type": {
                 "text": "string"
               },
               "description": "Used to override the form owner's `action` attribute.",
-              "attribute": "formaction",
-              "reflects": true
+              "fieldName": "formAction"
             },
             {
-              "kind": "field",
-              "name": "formMethod",
+              "name": "formmethod",
               "type": {
                 "text": "\"post\" | \"get\""
               },
               "description": "Used to override the form owner's `method` attribute.",
-              "attribute": "formmethod",
-              "reflects": true
+              "fieldName": "formMethod"
             },
             {
-              "kind": "field",
-              "name": "formNoValidate",
+              "name": "formnovalidate",
               "type": {
                 "text": "boolean"
               },
               "description": "Used to override the form owner's `novalidate` attribute.",
-              "attribute": "formnovalidate",
-              "reflects": true
+              "fieldName": "formNoValidate"
             },
             {
-              "kind": "field",
-              "name": "formTarget",
+              "name": "formtarget",
               "type": {
                 "text": "| \"_self\"\n    | \"_blank\"\n    | \"_parent\"\n    | \"_top\"\n    | string"
               },
               "description": "Used to override the form owner's `target` attribute.",
-              "attribute": "formtarget",
-              "reflects": true
+              "fieldName": "formTarget"
             },
             {
-              "kind": "field",
               "name": "fullWidth",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "When set, the button will be in full width.",
-              "attribute": "fullWidth",
-              "reflects": true
+              "fieldName": "fullWidth"
             },
             {
-              "kind": "field",
               "name": "hasLeftIconSlot",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Used only for SSR to indicate the presence of the `leftIcon` slot.",
-              "attribute": "hasLeftIconSlot"
+              "fieldName": "hasLeftIconSlot"
             },
             {
-              "kind": "field",
               "name": "hasRightIconSlot",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Used only for SSR to indicate the presence of the `rightIcon` slot.",
-              "attribute": "hasRightIconSlot"
-            },
-            {
-              "kind": "field",
-              "name": "hasSlotController",
-              "privacy": "private",
-              "default": "new HasSlotController(this, \"leftIcon\", \"rightIcon\")",
-              "type": {}
-            },
-            {
-              "kind": "method",
-              "name": "_handleClick",
-              "privacy": "protected",
-              "parameters": [
-                {
-                  "name": "event",
-                  "type": {
-                    "text": "MouseEvent"
-                  }
-                }
-              ],
-              "type": {},
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "_clickHandler",
-              "privacy": "private",
-              "type": {}
+              "fieldName": "hasRightIconSlot"
             },
             {
-              "kind": "field",
               "name": "variant",
               "type": {
-                "text": "\"primary\" | \"outline\" | \"ghost\" | \"danger\""
+                "text": "ButtonVariant"
               },
               "default": "\"primary\"",
               "description": "Sets the visual variants such as: `primary`, `outline`, `ghost`. `danger` is @deprecated since v3.5.6",
-              "attribute": "variant",
-              "reflects": true,
+              "fieldName": "variant",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "field",
               "name": "tone",
               "type": {
-                "text": "\"brand\" | \"danger\" | \"fixed-light\" | \"neutral\""
+                "text": "ButtonTone"
               },
               "default": "\"brand\"",
               "description": "Sets the visual colour of the button: `brand`, `danger`, `fixed-light`, `neutral`",
-              "attribute": "tone",
-              "reflects": true,
+              "fieldName": "tone",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "field",
               "name": "size",
               "type": {
                 "text": "\"xs\" | \"sm\" | \"md\" | \"lg\""
               },
               "default": "\"md\"",
               "description": "Specifies a small, medium or large button, the size is medium by default.",
-              "attribute": "size",
-              "reflects": true,
+              "fieldName": "size",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "field",
               "name": "active",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "Manually set the visual state of the button to `:active`",
-              "attribute": "active",
-              "reflects": true,
+              "fieldName": "active",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "field",
               "name": "disabled",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
               "description": "The disabled state of the button",
-              "attribute": "disabled",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "href",
-              "type": {
-                "text": "string"
-              },
-              "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
-              "attribute": "href",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "target",
-              "type": {
-                "text": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\""
-              },
-              "default": "\"_self\"",
-              "description": "Where to display the linked URL, as the name for a browsing context. Forwards to the HTMLAnchor target attribute",
-              "attribute": "target",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "download",
-              "type": {
-                "text": "string"
-              },
-              "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
-              "attribute": "download",
-              "reflects": true,
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "ariaLabel",
-              "type": {
-                "text": "string"
-              },
-              "description": "The aria-label attribute to passed to button element when necessary",
-              "attribute": "ariaLabel",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "kind": "field",
-              "name": "loading",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "When true, shows a loading spinner",
-              "attribute": "loading",
+              "fieldName": "disabled",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "focus",
-              "privacy": "public",
-              "parameters": [
-                {
-                  "name": "options",
-                  "optional": true,
-                  "type": {
-                    "text": "FocusOptions"
-                  }
-                }
-              ],
-              "description": "Sets focus on the button.",
-              "type": {},
+              "name": "href",
+              "type": {
+                "text": "string"
+              },
+              "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
+              "fieldName": "href",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "click",
-              "privacy": "public",
-              "description": "Simulates a click on the button.",
-              "type": {},
+              "name": "target",
+              "type": {
+                "text": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\""
+              },
+              "default": "\"_self\"",
+              "description": "Where to display the linked URL, as the name for a browsing context. Forwards to the HTMLAnchor target attribute",
+              "fieldName": "target",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "blur",
-              "privacy": "public",
-              "description": "Removes focus from the button.",
-              "type": {},
+              "name": "download",
+              "type": {
+                "text": "string"
+              },
+              "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
+              "fieldName": "download",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "_handleBlur",
-              "privacy": "protected",
-              "type": {},
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
+              },
+              "description": "The aria-label attribute to passed to button element when necessary",
+              "fieldName": "ariaLabel",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
             },
             {
-              "kind": "method",
-              "name": "_handleFocus",
-              "privacy": "protected",
-              "type": {},
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "When true, shows a loading spinner",
+              "fieldName": "loading",
               "inheritedFrom": {
                 "name": "ButtonElement",
                 "module": "src/base/button-element.ts"
               }
+            }
+          ],
+          "superclass": {
+            "name": "ButtonElement",
+            "module": "/src/base/button-element"
+          },
+          "summary": "Custom button styles for actions in forms, dialogs, and more with support for multiple sizes, states, and more.",
+          "tagName": "sgds-button",
+          "customElement": true,
+          "modulePath": "src/components/Button/sgds-button.ts",
+          "cssProperties": [],
+          "cssParts": [],
+          "cssStates": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SgdsButton",
+          "declaration": {
+            "name": "SgdsButton",
+            "module": "src/components/Button/sgds-button.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SgdsButton",
+            "module": "src/components/Button/sgds-button.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/Breadcrumb/sgds-breadcrumb-item.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SgdsBreadcrumbItem",
+          "slots": [
+            {
+              "description": "The link of the item. Pass in anchor tags into this slot",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "Record<string, typeof SgdsElement>"
+              },
+              "static": true,
+              "default": "{\n    \"sgds-link\": SgdsLink,\n    \"sgds-icon\": SgdsIcon\n  }"
+            },
+            {
+              "kind": "field",
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates the link matches the current location of the page. Programmatically handled by SgdsBreadcrumb to set this prop to true for the last breadcrumb item",
+              "attribute": "active",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_preventNavigation",
+              "privacy": "private",
+              "type": {}
             },
             {
               "kind": "method",
-              "name": "_handleKeydown",
-              "privacy": "protected",
+              "name": "emit",
               "parameters": [
                 {
-                  "name": "event",
+                  "name": "name",
                   "type": {
-                    "text": "KeyboardEvent"
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "CustomEventInit<T>"
                   }
                 }
               ],
+              "description": "Emits a custom event with more convenient defaults.",
               "type": {},
               "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
               }
             },
             {
               "kind": "method",
-              "name": "_assignSpinnerSize",
-              "privacy": "protected",
+              "name": "define",
+              "static": true,
               "parameters": [
                 {
-                  "name": "buttonSize",
+                  "name": "name",
                   "type": {
-                    "text": "\"xs\" | \"sm\" | \"md\" | \"lg\""
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "elementConstructor",
+                  "default": "this"
+                },
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "ElementDefinitionOptions"
                   }
                 }
               ],
               "type": {},
               "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
               }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "active",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Indicates the link matches the current location of the page. Programmatically handled by SgdsBreadcrumb to set this prop to true for the last breadcrumb item",
+              "fieldName": "active"
+            }
+          ],
+          "superclass": {
+            "name": "SgdsElement",
+            "module": "/src/base/sgds-element"
+          },
+          "summary": "Breadcrumb Item are navigational links used in Breadcrumb component",
+          "tagName": "sgds-breadcrumb-item",
+          "customElement": true,
+          "modulePath": "src/components/Breadcrumb/sgds-breadcrumb-item.ts",
+          "cssProperties": [],
+          "cssParts": [],
+          "cssStates": [],
+          "events": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SgdsBreadcrumbItem",
+          "declaration": {
+            "name": "SgdsBreadcrumbItem",
+            "module": "src/components/Breadcrumb/sgds-breadcrumb-item.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SgdsBreadcrumbItem",
+            "module": "src/components/Breadcrumb/sgds-breadcrumb-item.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/Breadcrumb/sgds-breadcrumb.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SgdsBreadcrumb",
+          "slots": [
+            {
+              "description": "The slot to pass in custom elements of `SgdsBreadcrumbItems`.",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{\n    \"sgds-overflow-menu\": SgdsOverflowMenu\n  }"
             },
             {
-              "kind": "method",
-              "name": "_assignSpinnerTone",
-              "privacy": "protected",
-              "return": {
-                "type": {
-                  "text": "SpinnerTone"
-                }
+              "kind": "field",
+              "name": "ariaLabel",
+              "type": {
+                "text": "string"
               },
+              "default": "\"breadcrumb\"",
+              "description": "The aria-label of nav element within breadcrumb component.",
+              "attribute": "ariaLabel"
+            },
+            {
+              "kind": "method",
+              "name": "_replaceExcessItemsWithDropdown",
+              "privacy": "private",
               "parameters": [
                 {
-                  "name": "buttonTone",
+                  "name": "items",
                   "type": {
-                    "text": "ButtonTone"
+                    "text": "SgdsBreadcrumbItem[]"
                   }
-                },
+                }
+              ],
+              "description": "creates `<sgds-breadcrumb-item>\n           <sgds-overflow-menu>\n             <sgds-dropdown-item></sgds-dropdown-item>\n              ...\n           </sgds-overflow-menu>\n         <sgds-breadcrumb-item>`",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "parameters": [
                 {
-                  "name": "buttonVariant",
+                  "name": "e",
                   "type": {
-                    "text": "ButtonVariant"
+                    "text": "Event"
                   }
                 }
               ],
-              "type": {},
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
+              "type": {}
             },
             {
               "kind": "method",
@@ -1986,250 +2226,46 @@
               }
             }
           ],
-          "events": [
-            {
-              "description": "Emitted when the button is blurred.",
-              "name": "sgds-blur",
-              "reactName": "onSgdsBlur"
-            },
-            {
-              "description": "Emitted when the button is focused.",
-              "name": "sgds-focus",
-              "reactName": "onSgdsFocus"
-            }
-          ],
           "attributes": [
-            {
-              "name": "type",
-              "type": {
-                "text": "\"button\" | \"submit\" | \"reset\""
-              },
-              "default": "\"button\"",
-              "description": "The behavior of the button with default as `type='button', `reset` resets all the controls to their initial values and `submit` submits the form data to the server",
-              "fieldName": "type"
-            },
-            {
-              "name": "form",
-              "type": {
-                "text": "string"
-              },
-              "description": "The \"form owner\" to associate the button with. If omitted, the closest containing form will be used instead. The\nvalue of this attribute must be an id of a form in the same document or shadow root as the button.",
-              "fieldName": "form"
-            },
-            {
-              "name": "formaction",
-              "type": {
-                "text": "string"
-              },
-              "description": "Used to override the form owner's `action` attribute.",
-              "fieldName": "formAction"
-            },
-            {
-              "name": "formmethod",
-              "type": {
-                "text": "\"post\" | \"get\""
-              },
-              "description": "Used to override the form owner's `method` attribute.",
-              "fieldName": "formMethod"
-            },
-            {
-              "name": "formnovalidate",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "Used to override the form owner's `novalidate` attribute.",
-              "fieldName": "formNoValidate"
-            },
-            {
-              "name": "formtarget",
-              "type": {
-                "text": "| \"_self\"\n    | \"_blank\"\n    | \"_parent\"\n    | \"_top\"\n    | string"
-              },
-              "description": "Used to override the form owner's `target` attribute.",
-              "fieldName": "formTarget"
-            },
-            {
-              "name": "fullWidth",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "When set, the button will be in full width.",
-              "fieldName": "fullWidth"
-            },
-            {
-              "name": "hasLeftIconSlot",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Used only for SSR to indicate the presence of the `leftIcon` slot.",
-              "fieldName": "hasLeftIconSlot"
-            },
-            {
-              "name": "hasRightIconSlot",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Used only for SSR to indicate the presence of the `rightIcon` slot.",
-              "fieldName": "hasRightIconSlot"
-            },
-            {
-              "name": "variant",
-              "type": {
-                "text": "ButtonVariant"
-              },
-              "default": "\"primary\"",
-              "description": "Sets the visual variants such as: `primary`, `outline`, `ghost`. `danger` is @deprecated since v3.5.6",
-              "fieldName": "variant",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "tone",
-              "type": {
-                "text": "ButtonTone"
-              },
-              "default": "\"brand\"",
-              "description": "Sets the visual colour of the button: `brand`, `danger`, `fixed-light`, `neutral`",
-              "fieldName": "tone",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "size",
-              "type": {
-                "text": "\"xs\" | \"sm\" | \"md\" | \"lg\""
-              },
-              "default": "\"md\"",
-              "description": "Specifies a small, medium or large button, the size is medium by default.",
-              "fieldName": "size",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "active",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "Manually set the visual state of the button to `:active`",
-              "fieldName": "active",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "disabled",
-              "type": {
-                "text": "boolean"
-              },
-              "default": "false",
-              "description": "The disabled state of the button",
-              "fieldName": "disabled",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "href",
-              "type": {
-                "text": "string"
-              },
-              "description": "When set, the underlying button will be rendered as an `<a>` with this `href` instead of a `<button>`.",
-              "fieldName": "href",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "target",
-              "type": {
-                "text": "\"_blank\" | \"_parent\" | \"_self\" | \"_top\""
-              },
-              "default": "\"_self\"",
-              "description": "Where to display the linked URL, as the name for a browsing context. Forwards to the HTMLAnchor target attribute",
-              "fieldName": "target",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "download",
-              "type": {
-                "text": "string"
-              },
-              "description": "Tells the browser to download the linked file as this filename. Only used when `href` is set.",
-              "fieldName": "download",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
             {
               "name": "ariaLabel",
               "type": {
                 "text": "string"
               },
-              "description": "The aria-label attribute to passed to button element when necessary",
-              "fieldName": "ariaLabel",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
-            },
-            {
-              "name": "loading",
-              "type": {
-                "text": "boolean"
-              },
-              "description": "When true, shows a loading spinner",
-              "fieldName": "loading",
-              "inheritedFrom": {
-                "name": "ButtonElement",
-                "module": "src/base/button-element.ts"
-              }
+              "default": "\"breadcrumb\"",
+              "description": "The aria-label of nav element within breadcrumb component.",
+              "fieldName": "ariaLabel"
             }
           ],
           "superclass": {
-            "name": "ButtonElement",
-            "module": "/src/base/button-element"
+            "name": "SgdsElement",
+            "module": "/src/base/sgds-element"
           },
-          "summary": "Custom button styles for actions in forms, dialogs, and more with support for multiple sizes, states, and more.",
-          "tagName": "sgds-button",
+          "summary": "Breadcrumbs help users to navigate and understand where they are on the current website or service.",
+          "tagName": "sgds-breadcrumb",
           "customElement": true,
-          "modulePath": "src/components/Button/sgds-button.ts",
+          "modulePath": "src/components/Breadcrumb/sgds-breadcrumb.ts",
           "cssProperties": [],
           "cssParts": [],
-          "cssStates": []
+          "cssStates": [],
+          "events": []
         }
       ],
       "exports": [
         {
           "kind": "js",
-          "name": "SgdsButton",
+          "name": "SgdsBreadcrumb",
           "declaration": {
-            "name": "SgdsButton",
-            "module": "src/components/Button/sgds-button.ts"
+            "name": "SgdsBreadcrumb",
+            "module": "src/components/Breadcrumb/sgds-breadcrumb.ts"
           }
         },
         {
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "SgdsButton",
-            "module": "src/components/Button/sgds-button.ts"
+            "name": "SgdsBreadcrumb",
+            "module": "src/components/Breadcrumb/sgds-breadcrumb.ts"
           }
         }
       ]
@@ -27502,7 +27538,7 @@
   "package": {
     "name": "@govtechsg/sgds-web-component",
     "description": "",
-    "version": "3.21.1",
+    "version": "3.21.2-rc.1",
     "author": "GovTechSG",
     "license": "MIT"
   }