@govtechsg/sgds-web-component 3.26.0 → 3.26.1-rc.0

package/custom-elements.json

@@ -3352,6 +3352,13 @@
             }
           ],
           "members": [
+            {
+              "kind": "field",
+              "name": "hasSlotController",
+              "privacy": "private",
+              "default": "new HasSlotController(this, \"[default]\")",
+              "type": {}
+            },
             {
               "kind": "field",
               "name": "value",
@@ -4183,6 +4190,16 @@
                 "module": "src/base/option-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "_updateAriaLabel",
+              "privacy": "private",
+              "type": {},
+              "inheritedFrom": {
+                "name": "OptionElement",
+                "module": "src/base/option-element.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "emit",
@@ -5695,238 +5712,1586 @@
               "description": "The input's label",
               "fieldName": "label",
               "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "hintText",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "The input's hint text below the label",
+              "fieldName": "hintText",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "description": "The input's name attribute",
+              "fieldName": "name",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "placeholder",
+              "type": {
+                "text": "string"
+              },
+              "description": "The input's placeholder text.",
+              "fieldName": "placeholder",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "autofocus",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Autofocus the input",
+              "fieldName": "autofocus",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "disabled",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Disables the input.",
+              "fieldName": "disabled",
+              "inheritedFrom": {
+                "name": "DropdownElement",
+                "module": "src/base/dropdown-element.ts"
+              }
+            },
+            {
+              "name": "required",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the input a required field.",
+              "fieldName": "required",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Sets the loading state of the component",
+              "fieldName": "loading",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "value",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "IMPORTANT:\nWe still expose `.value` externally, but this is now the underlying ID or data\n(e.g. 1, 2, 'abc', ...), not the label that appears in the input box.",
+              "fieldName": "value",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "hasFeedback",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Allows invalidFeedback, invalid and valid styles to be visible with the input",
+              "fieldName": "hasFeedback",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "invalidFeedback",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Feedback text for error state when validated",
+              "fieldName": "invalidFeedback",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "invalid",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Marks the component as invalid. Replace the pseudo :invalid selector.",
+              "fieldName": "invalid",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "autocomplete",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"on\"",
+              "description": "Controlling of autocomplete behaviour",
+              "fieldName": "autocomplete",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "menuList",
+              "type": {
+                "text": "SgdsOptionData[]"
+              },
+              "default": "[]",
+              "description": "The list of items to display in the dropdown.\n`interface SgdsComboBoxItemData {\nlabel: string;\nvalue: string;\n}`",
+              "deprecated": "Deprecated in favour of slots",
+              "fieldName": "menuList",
+              "inheritedFrom": {
+                "name": "SelectElement",
+                "module": "src/base/select-element.ts"
+              }
+            },
+            {
+              "name": "hidden",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "fieldName": "hidden",
+              "inheritedFrom": {
+                "name": "DropdownListElement",
+                "module": "src/base/dropdown-list-element.ts"
+              }
+            },
+            {
+              "name": "floatingOpts",
+              "type": {
+                "text": "{ placement?: Placement; middleware?: Array<Middleware> }"
+              },
+              "default": "{}",
+              "description": "Additional configuration to pass to Floating UI.",
+              "fieldName": "floatingOpts",
+              "inheritedFrom": {
+                "name": "DropdownElement",
+                "module": "src/base/dropdown-element.ts"
+              }
+            },
+            {
+              "name": "menuIsOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, dropdown menu shows on first load",
+              "fieldName": "menuIsOpen",
+              "inheritedFrom": {
+                "name": "DropdownElement",
+                "module": "src/base/dropdown-element.ts"
+              }
+            },
+            {
+              "name": "readonly",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the input readonly.",
+              "fieldName": "readonly",
+              "inheritedFrom": {
+                "name": "DropdownElement",
+                "module": "src/base/dropdown-element.ts"
+              }
+            }
+          ],
+          "superclass": {
+            "name": "SelectElement",
+            "module": "/src/base/select-element"
+          },
+          "summary": "ComboBox component is used for users to make one or more selections from a list through user input, keyboard or mouse actions",
+          "tagName": "sgds-combo-box",
+          "customElement": true,
+          "modulePath": "src/components/ComboBox/sgds-combo-box.ts",
+          "cssProperties": [],
+          "cssParts": [],
+          "cssStates": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "ISgdsComboBoxInputEventDetail",
+          "declaration": {
+            "name": "ISgdsComboBoxInputEventDetail",
+            "module": "src/components/ComboBox/sgds-combo-box.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "SgdsComboBox",
+          "declaration": {
+            "name": "SgdsComboBox",
+            "module": "src/components/ComboBox/sgds-combo-box.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SgdsComboBox",
+            "module": "src/components/ComboBox/sgds-combo-box.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/DataTable/sgds-data-table-cell.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SgdsDataTableCell",
+          "slots": [
+            {
+              "description": "Content to display inside the cell.",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "colspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of columns this cell spans.",
+              "attribute": "colspan",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rowspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of rows this cell spans.",
+              "attribute": "rowspan",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "CustomEventInit<T>"
+                  }
+                }
+              ],
+              "description": "Emits a custom event with more convenient defaults.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-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": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "colspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of columns this cell spans.",
+              "fieldName": "colspan"
+            },
+            {
+              "name": "rowspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of rows this cell spans.",
+              "fieldName": "rowspan"
+            }
+          ],
+          "superclass": {
+            "name": "SgdsElement",
+            "module": "/src/base/sgds-element"
+          },
+          "summary": "Data container for a table cell. Rendered as a `<td>` by the parent `sgds-data-table-row`.",
+          "tagName": "sgds-data-table-cell",
+          "customElement": true,
+          "modulePath": "src/components/DataTable/sgds-data-table-cell.ts",
+          "cssProperties": [],
+          "cssParts": [],
+          "cssStates": [],
+          "events": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SgdsDataTableCell",
+          "declaration": {
+            "name": "SgdsDataTableCell",
+            "module": "src/components/DataTable/sgds-data-table-cell.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SgdsDataTableCell",
+            "module": "src/components/DataTable/sgds-data-table-cell.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/DataTable/sgds-data-table-head.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SgdsDataTableHead",
+          "slots": [
+            {
+              "description": "Content to display inside the header cell.",
+              "name": "default"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "width",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Sets the column width.",
+              "attribute": "width",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "colspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of columns this cell spans.",
+              "attribute": "colspan",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "rowspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of rows this cell spans.",
+              "attribute": "rowspan",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "textAlign",
+              "type": {
+                "text": "\"left\" | \"right\""
+              },
+              "default": "\"left\"",
+              "description": "Text alignment for the header content.",
+              "attribute": "textAlign",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "ariasort",
+              "type": {
+                "text": "\"ascending\" | \"descending\" | \"none\" | \"other\" | undefined"
+              },
+              "description": "Current sort direction for this column.",
+              "attribute": "ariasort",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sorting",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, clicking this header cycles through ascending → descending → none sort.",
+              "attribute": "sorting",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sortKey",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Column key emitted in the row's internal sort payload, used to identify which column to sort.",
+              "attribute": "sortKey",
+              "reflects": true
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "CustomEventInit<T>"
+                  }
+                }
+              ],
+              "description": "Emits a custom event with more convenient defaults.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-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": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
+              }
+            }
+          ],
+          "attributes": [
+            {
+              "name": "width",
+              "type": {
+                "text": "string | undefined"
+              },
+              "description": "Sets the column width.",
+              "fieldName": "width"
+            },
+            {
+              "name": "colspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of columns this cell spans.",
+              "fieldName": "colspan"
+            },
+            {
+              "name": "rowspan",
+              "type": {
+                "text": "number | undefined"
+              },
+              "description": "Number of rows this cell spans.",
+              "fieldName": "rowspan"
+            },
+            {
+              "name": "textAlign",
+              "type": {
+                "text": "\"left\" | \"right\""
+              },
+              "default": "\"left\"",
+              "description": "Text alignment for the header content.",
+              "fieldName": "textAlign"
+            },
+            {
+              "name": "ariasort",
+              "type": {
+                "text": "\"ascending\" | \"descending\" | \"none\" | \"other\" | undefined"
+              },
+              "description": "Current sort direction for this column.",
+              "fieldName": "ariasort"
+            },
+            {
+              "name": "sorting",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, clicking this header cycles through ascending → descending → none sort.",
+              "fieldName": "sorting"
+            },
+            {
+              "name": "sortKey",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Column key emitted in the row's internal sort payload, used to identify which column to sort.",
+              "fieldName": "sortKey"
+            }
+          ],
+          "superclass": {
+            "name": "SgdsElement",
+            "module": "/src/base/sgds-element"
+          },
+          "summary": "Data container for a table header cell. Rendered as a `<th>` by the parent `sgds-data-table-row`.",
+          "tagName": "sgds-data-table-head",
+          "customElement": true,
+          "modulePath": "src/components/DataTable/sgds-data-table-head.ts",
+          "cssProperties": [],
+          "cssParts": [],
+          "cssStates": [],
+          "events": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SgdsDataTableHead",
+          "declaration": {
+            "name": "SgdsDataTableHead",
+            "module": "src/components/DataTable/sgds-data-table-head.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SgdsDataTableHead",
+            "module": "src/components/DataTable/sgds-data-table-head.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/DataTable/sgds-data-table-row.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SgdsDataTableRow",
+          "slots": [
+            {
+              "description": "Insert `sgds-data-table-cell` or `sgds-data-table-head` elements.",
+              "name": "default"
+            },
+            {
+              "description": "Content shown in the animated expand area beneath the row.",
+              "name": "content"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "rowData",
+              "type": {
+                "text": "Record<string, unknown>"
+              },
+              "default": "{}",
+              "description": "Arbitrary data associated with this row. Returned in event detail on row selection.",
+              "attribute": "rowData",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "expand",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, the row has an expandable content area toggled by a chevron.",
+              "attribute": "expand",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, the expandable content area is open.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, the row is checked.",
+              "attribute": "checked",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "_isHeaderRow",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_cellSlotNames",
+              "privacy": "private",
+              "default": "new WeakMap<SgdsDataTableCell | SgdsDataTableHead, string>()",
+              "type": {}
+            },
+            {
+              "kind": "field",
+              "name": "_lightDomObserver",
+              "type": {
+                "text": "MutationObserver | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "checkbox",
+              "type": {
+                "text": "SgdsCheckbox | null"
+              },
+              "description": "The checkbox rendered inside this row, if `showCheckbox` is true."
+            },
+            {
+              "kind": "method",
+              "name": "handleExpandedChange",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "handleCheckedChange",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "privacy": "public",
+              "description": "Opens the expandable content area.",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "hide",
+              "privacy": "public",
+              "description": "Closes the expandable content area.",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_getCells",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_syncCellSlots",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "cells",
+                  "type": {
+                    "text": "Array<SgdsDataTableCell | SgdsDataTableHead>"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_handleLightDomChange",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_onCheckboxChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "CustomEvent"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_toggleExpand",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_onExpandKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_onSortKeyDown",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "KeyboardEvent"
+                  }
+                },
+                {
+                  "name": "header",
+                  "type": {
+                    "text": "SgdsDataTableHead"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_renderCell",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "el",
+                  "type": {
+                    "text": "SgdsDataTableCell | SgdsDataTableHead"
+                  }
+                },
+                {
+                  "name": "columnIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_renderExpandCell",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_renderExpandPlaceholder",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_renderCheckboxCell",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "CustomEventInit<T>"
+                  }
+                }
+              ],
+              "description": "Emits a custom event with more convenient defaults.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-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": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
+              }
+            }
+          ],
+          "events": [
+            {
+              "description": "Emitted when the expandable row begins to open.",
+              "name": "sgds-show",
+              "reactName": "onSgdsShow"
+            },
+            {
+              "description": "Emitted after the expandable row open animation completes.",
+              "name": "sgds-after-show",
+              "reactName": "onSgdsAfterShow"
+            },
+            {
+              "description": "Emitted when the expandable row begins to close.",
+              "name": "sgds-hide",
+              "reactName": "onSgdsHide"
+            },
+            {
+              "description": "Emitted after the expandable row close animation completes.",
+              "name": "sgds-after-hide",
+              "reactName": "onSgdsAfterHide"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "rowData",
+              "type": {
+                "text": "Record<string, unknown>"
+              },
+              "default": "{}",
+              "description": "Arbitrary data associated with this row. Returned in event detail on row selection.",
+              "fieldName": "rowData"
+            },
+            {
+              "name": "expand",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, the row has an expandable content area toggled by a chevron.",
+              "fieldName": "expand"
+            },
+            {
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, the expandable content area is open.",
+              "fieldName": "open"
+            },
+            {
+              "name": "checked",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, the row is checked.",
+              "fieldName": "checked"
+            }
+          ],
+          "superclass": {
+            "name": "SgdsElement",
+            "module": "/src/base/sgds-element"
+          },
+          "summary": "A data table row. Set `expand` to enable an expandable content area beneath\nthe row, then place detail content in the `content` slot.",
+          "tagName": "sgds-data-table-row",
+          "customElement": true,
+          "modulePath": "src/components/DataTable/sgds-data-table-row.ts",
+          "cssProperties": [],
+          "cssParts": [],
+          "cssStates": []
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "SgdsDataTableRow",
+          "declaration": {
+            "name": "SgdsDataTableRow",
+            "module": "src/components/DataTable/sgds-data-table-row.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "SgdsDataTableRow",
+            "module": "src/components/DataTable/sgds-data-table-row.ts"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/DataTable/sgds-data-table.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "SgdsDataTable",
+          "slots": [
+            {
+              "description": "Insert one or more `sgds-data-table-row` elements.",
+              "name": "default"
+            },
+            {
+              "description": "Custom content rendered when no body rows are available and `isLoading` is false.",
+              "name": "no-data"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "multiSelect",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, renders a checkbox column for row selection.",
+              "attribute": "multiSelect"
+            },
+            {
+              "kind": "field",
+              "name": "dataLength",
+              "type": {
+                "text": "number"
+              },
+              "default": "0",
+              "description": "Total number of data items (for server-side pagination).",
+              "attribute": "dataLength"
+            },
+            {
+              "kind": "field",
+              "name": "currentPage",
+              "type": {
+                "text": "number"
+              },
+              "default": "1",
+              "description": "Current page (1-based).",
+              "attribute": "currentPage"
+            },
+            {
+              "kind": "field",
+              "name": "itemsPerPage",
+              "type": {
+                "text": "number"
+              },
+              "default": "5",
+              "description": "Number of rows per page.",
+              "attribute": "itemsPerPage"
+            },
+            {
+              "kind": "field",
+              "name": "footerText",
+              "type": {
+                "text": "string"
+              },
+              "default": "\"\"",
+              "description": "Custom text shown on the footer's left side.",
+              "attribute": "footerText"
+            },
+            {
+              "kind": "field",
+              "name": "hideFooter",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "If true, hides the footer (summary text and pagination controls).",
+              "attribute": "hideFooter"
+            },
+            {
+              "kind": "field",
+              "name": "isLoading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, shows a loading state and hides body rows.",
+              "attribute": "isLoading"
+            },
+            {
+              "kind": "field",
+              "name": "serverSort",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "When true, emits sort events for external handling instead of local sorting.",
+              "attribute": "serverSort"
+            },
+            {
+              "kind": "field",
+              "name": "layout",
+              "type": {
+                "text": "\"auto\" | \"fixed\""
+              },
+              "default": "\"auto\"",
+              "description": "Controls the CSS `table-layout` algorithm.\nUse \"auto\" to let the browser size columns based on content, or \"fixed\" to distribute column widths evenly regardless of content.",
+              "attribute": "layout",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "mode",
+              "type": {
+                "text": "\"client\" | \"server\""
+              },
+              "default": "\"client\"",
+              "description": "Pagination mode. `client` (default) slices rows and renders pagination controls.\n`server` renders all slotted rows as-is — the caller is responsible for passing\nthe correct page of data and handling `sgds-page-change` externally.",
+              "attribute": "mode"
+            },
+            {
+              "kind": "field",
+              "name": "tableRows",
+              "type": {
+                "text": "SgdsDataTableRow[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "headerRows",
+              "type": {
+                "text": "SgdsDataTableRow[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_headerCells",
+              "type": {
+                "text": "SgdsDataTableHead[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_initialRowPositions",
+              "privacy": "private",
+              "default": "new WeakMap<SgdsDataTableRow, number>()",
+              "type": {}
+            },
+            {
+              "kind": "field",
+              "name": "_hasCapturedInitialRowPositions",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_rowHandlers",
+              "privacy": "private",
+              "default": "new WeakMap<SgdsDataTableRow, EventListener>()",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_isRowChecked",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "SgdsDataTableRow"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_updateHeaderCheckbox",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_syncHeaderCheckboxAfterRender",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_emitRowSelect",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_attachRowListener",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "SgdsDataTableRow"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_configureRows",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_applyColumnAlignment",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_extractCellText",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "SgdsDataTableRow"
+                  }
+                },
+                {
+                  "name": "columnIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_toComparableValue",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "SgdsDataTableRow"
+                  }
+                },
+                {
+                  "name": "key",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "columnIndex",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_compareValues",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "left",
+                  "type": {
+                    "text": "unknown"
+                  }
+                },
+                {
+                  "name": "right",
+                  "type": {
+                    "text": "unknown"
+                  }
+                },
+                {
+                  "name": "direction",
+                  "type": {
+                    "text": "\"ascending\" | \"descending\""
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_resetOtherHeaderSortStates",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "activeHeader",
+                  "type": {
+                    "text": "SgdsDataTableHead | null"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_getRowsInInitialPositionOrder",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "rows",
+                  "type": {
+                    "text": "SgdsDataTableRow[]"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_captureInitialRowPositions",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "rows",
+                  "type": {
+                    "text": "SgdsDataTableRow[]"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_handleSort",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_syncDomRowOrder",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_handleSlotChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "e",
+                  "type": {
+                    "text": "Event"
+                  }
+                }
+              ],
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "_updateVisibleRows",
+              "privacy": "private",
+              "type": {}
+            },
+            {
+              "kind": "method",
+              "name": "emit",
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "options",
+                  "optional": true,
+                  "type": {
+                    "text": "CustomEventInit<T>"
+                  }
+                }
+              ],
+              "description": "Emits a custom event with more convenient defaults.",
+              "type": {},
+              "inheritedFrom": {
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
               }
             },
             {
-              "name": "hintText",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "The input's hint text below the label",
-              "fieldName": "hintText",
+              "kind": "method",
+              "name": "define",
+              "static": true,
+              "parameters": [
+                {
+                  "name": "name",
+                  "type": {
+                    "text": "string"
+                  }
+                },
+                {
+                  "name": "elementConstructor",
+                  "default": "this"
+                },
+                {
+                  "name": "options",
+                  "default": "{}",
+                  "type": {
+                    "text": "ElementDefinitionOptions"
+                  }
+                }
+              ],
+              "type": {},
               "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
+                "name": "SgdsElement",
+                "module": "src/base/sgds-element.ts"
               }
-            },
+            }
+          ],
+          "events": [
             {
-              "name": "name",
-              "type": {
-                "text": "string"
-              },
-              "description": "The input's name attribute",
-              "fieldName": "name",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "description": "Emitted when row checkboxes change. Detail: `{ selected: rowData[] }`.",
+              "name": "sgds-row-select",
+              "reactName": "onSgdsRowSelect"
             },
             {
-              "name": "placeholder",
-              "type": {
-                "text": "string"
-              },
-              "description": "The input's placeholder text.",
-              "fieldName": "placeholder",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "description": "Emitted when `serverSort` is true and a sorting column header is clicked. Detail: `{ key: string; direction: \"ascending\" | \"descending\" | \"none\" }`.",
+              "name": "sgds-sort",
+              "reactName": "onSgdsSort"
             },
             {
-              "name": "autofocus",
+              "description": "Emitted when pagination changes page.",
+              "name": "sgds-page-change",
+              "reactName": "onSgdsPageChange"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "multiSelect",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Autofocus the input",
-              "fieldName": "autofocus",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "description": "If true, renders a checkbox column for row selection.",
+              "fieldName": "multiSelect"
             },
             {
-              "name": "disabled",
+              "name": "dataLength",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Disables the input.",
-              "fieldName": "disabled",
-              "inheritedFrom": {
-                "name": "DropdownElement",
-                "module": "src/base/dropdown-element.ts"
-              }
+              "default": "0",
+              "description": "Total number of data items (for server-side pagination).",
+              "fieldName": "dataLength"
             },
             {
-              "name": "required",
+              "name": "currentPage",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Makes the input a required field.",
-              "fieldName": "required",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "default": "1",
+              "description": "Current page (1-based).",
+              "fieldName": "currentPage"
             },
             {
-              "name": "loading",
+              "name": "itemsPerPage",
               "type": {
-                "text": "boolean"
+                "text": "number"
               },
-              "default": "false",
-              "description": "Sets the loading state of the component",
-              "fieldName": "loading",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "default": "5",
+              "description": "Number of rows per page.",
+              "fieldName": "itemsPerPage"
             },
             {
-              "name": "value",
+              "name": "footerText",
               "type": {
                 "text": "string"
               },
               "default": "\"\"",
-              "description": "IMPORTANT:\nWe still expose `.value` externally, but this is now the underlying ID or data\n(e.g. 1, 2, 'abc', ...), not the label that appears in the input box.",
-              "fieldName": "value",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "description": "Custom text shown on the footer's left side.",
+              "fieldName": "footerText"
             },
             {
-              "name": "hasFeedback",
+              "name": "hideFooter",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Allows invalidFeedback, invalid and valid styles to be visible with the input",
-              "fieldName": "hasFeedback",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
-            },
-            {
-              "name": "invalidFeedback",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"\"",
-              "description": "Feedback text for error state when validated",
-              "fieldName": "invalidFeedback",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "description": "If true, hides the footer (summary text and pagination controls).",
+              "fieldName": "hideFooter"
             },
             {
-              "name": "invalid",
+              "name": "isLoading",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "description": "Marks the component as invalid. Replace the pseudo :invalid selector.",
-              "fieldName": "invalid",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
-            },
-            {
-              "name": "autocomplete",
-              "type": {
-                "text": "string"
-              },
-              "default": "\"on\"",
-              "description": "Controlling of autocomplete behaviour",
-              "fieldName": "autocomplete",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
-            },
-            {
-              "name": "menuList",
-              "type": {
-                "text": "SgdsOptionData[]"
-              },
-              "default": "[]",
-              "description": "The list of items to display in the dropdown.\n`interface SgdsComboBoxItemData {\nlabel: string;\nvalue: string;\n}`",
-              "deprecated": "Deprecated in favour of slots",
-              "fieldName": "menuList",
-              "inheritedFrom": {
-                "name": "SelectElement",
-                "module": "src/base/select-element.ts"
-              }
+              "description": "When true, shows a loading state and hides body rows.",
+              "fieldName": "isLoading"
             },
             {
-              "name": "hidden",
+              "name": "serverSort",
               "type": {
                 "text": "boolean"
               },
               "default": "false",
-              "fieldName": "hidden",
-              "inheritedFrom": {
-                "name": "DropdownListElement",
-                "module": "src/base/dropdown-list-element.ts"
-              }
-            },
-            {
-              "name": "floatingOpts",
-              "type": {
-                "text": "{ placement?: Placement; middleware?: Array<Middleware> }"
-              },
-              "default": "{}",
-              "description": "Additional configuration to pass to Floating UI.",
-              "fieldName": "floatingOpts",
-              "inheritedFrom": {
-                "name": "DropdownElement",
-                "module": "src/base/dropdown-element.ts"
-              }
+              "description": "When true, emits sort events for external handling instead of local sorting.",
+              "fieldName": "serverSort"
             },
             {
-              "name": "menuIsOpen",
+              "name": "layout",
               "type": {
-                "text": "boolean"
+                "text": "\"auto\" | \"fixed\""
               },
-              "default": "false",
-              "description": "When true, dropdown menu shows on first load",
-              "fieldName": "menuIsOpen",
-              "inheritedFrom": {
-                "name": "DropdownElement",
-                "module": "src/base/dropdown-element.ts"
-              }
+              "default": "\"auto\"",
+              "description": "Controls the CSS `table-layout` algorithm.\nUse \"auto\" to let the browser size columns based on content, or \"fixed\" to distribute column widths evenly regardless of content.",
+              "fieldName": "layout"
             },
             {
-              "name": "readonly",
+              "name": "mode",
               "type": {
-                "text": "boolean"
+                "text": "\"client\" | \"server\""
               },
-              "default": "false",
-              "description": "Makes the input readonly.",
-              "fieldName": "readonly",
-              "inheritedFrom": {
-                "name": "DropdownElement",
-                "module": "src/base/dropdown-element.ts"
-              }
+              "default": "\"client\"",
+              "description": "Pagination mode. `client` (default) slices rows and renders pagination controls.\n`server` renders all slotted rows as-is — the caller is responsible for passing\nthe correct page of data and handling `sgds-page-change` externally.",
+              "fieldName": "mode"
             }
           ],
           "superclass": {
-            "name": "SelectElement",
-            "module": "/src/base/select-element"
+            "name": "SgdsElement",
+            "module": "/src/base/sgds-element"
           },
-          "summary": "ComboBox component is used for users to make one or more selections from a list through user input, keyboard or mouse actions",
-          "tagName": "sgds-combo-box",
+          "summary": "A data table container with pagination, row selection, loading, and sorting support.",
+          "tagName": "sgds-data-table",
           "customElement": true,
-          "modulePath": "src/components/ComboBox/sgds-combo-box.ts",
+          "modulePath": "src/components/DataTable/sgds-data-table.ts",
           "cssProperties": [],
           "cssParts": [],
           "cssStates": []
@@ -5935,26 +7300,18 @@
       "exports": [
         {
           "kind": "js",
-          "name": "ISgdsComboBoxInputEventDetail",
-          "declaration": {
-            "name": "ISgdsComboBoxInputEventDetail",
-            "module": "src/components/ComboBox/sgds-combo-box.ts"
-          }
-        },
-        {
-          "kind": "js",
-          "name": "SgdsComboBox",
+          "name": "SgdsDataTable",
           "declaration": {
-            "name": "SgdsComboBox",
-            "module": "src/components/ComboBox/sgds-combo-box.ts"
+            "name": "SgdsDataTable",
+            "module": "src/components/DataTable/sgds-data-table.ts"
           }
         },
         {
           "kind": "js",
           "name": "default",
           "declaration": {
-            "name": "SgdsComboBox",
-            "module": "src/components/ComboBox/sgds-combo-box.ts"
+            "name": "SgdsDataTable",
+            "module": "src/components/DataTable/sgds-data-table.ts"
           }
         }
       ]
@@ -16667,6 +18024,16 @@
                 "module": "src/base/option-element.ts"
               }
             },
+            {
+              "kind": "method",
+              "name": "_updateAriaLabel",
+              "privacy": "private",
+              "type": {},
+              "inheritedFrom": {
+                "name": "OptionElement",
+                "module": "src/base/option-element.ts"
+              }
+            },
             {
               "kind": "method",
               "name": "emit",
@@ -27022,6 +28389,12 @@
               "attribute": "value",
               "reflects": true
             },
+            {
+              "kind": "method",
+              "name": "_updateAriaLabel",
+              "privacy": "private",
+              "type": {}
+            },
             {
               "kind": "field",
               "name": "_renderItemContent",
@@ -28124,7 +29497,7 @@
   "package": {
     "name": "@govtechsg/sgds-web-component",
     "description": "",
-    "version": "3.26.0",
+    "version": "3.26.1-rc.0",
     "author": "GovTechSG",
     "license": "MIT"
   }