@cordwainer/cw-elements 1.1.1 → 1.2.0-alpha.1

package/dist/react/visually-hidden/index.js

@@ -1,10 +1,10 @@
 import {
   visually_hidden_default
-} from "../../chunks/chunk.HCIKWZOI.js";
-import "../../chunks/chunk.AHG6W2GG.js";
+} from "../../chunks/chunk.AT2PWN2E.js";
+import "../../chunks/chunk.5DVQN6KA.js";
 import "../../chunks/chunk.YKKSQ2FG.js";
 import "../../chunks/chunk.TUVJKY7S.js";
-import "../../chunks/chunk.75LMNY6V.js";
+import "../../chunks/chunk.OO6TR3ZT.js";
 import "../../chunks/chunk.Q44EX5TP.js";
 export {
   visually_hidden_default as default

package/dist/types/vue/index.d.ts

@@ -16,6 +16,13 @@ import type { CwCheckbox } from "../../components/checkbox/checkbox.component.js
 import type { CwColorPicker } from "../../components/color-picker/color-picker.component.js";
 import type { CwCombobox } from "../../components/combobox/combobox.component.js";
 import type { CwCopyButton } from "../../components/copy-button/copy-button.component.js";
+import type { CwDataTableColumn } from "../../components/data-table-column/data-table-column.component.js";
+import type {
+  CwDataTable,
+  SortChangeEvent,
+  CwRowSelectionChangeEvent,
+  RowClickEvent,
+} from "../../components/data-table/data-table.component.js";
 import type { CwDatePicker } from "../../components/date-picker/date-picker.component.js";
 import type { CwDetails } from "../../components/details/details.component.js";
 import type { CwDialog } from "../../components/dialog/dialog.component.js";
@@ -566,6 +573,61 @@ scenarios. */
   "oncw-error"?: (e: CustomEvent<never>) => void;
 };
 
+type CwDataTableColumnProps = {
+  /** The key in each row data object that this column displays. Required. */
+  name?: CwDataTableColumn["name"];
+  /** The column header label. Falls back to `name` if not set. */
+  label?: CwDataTableColumn["label"];
+  /** Makes the column header clickable for sorting. */
+  sortable?: CwDataTableColumn["sortable"];
+  /** A CSS width value for this column, e.g. "200px" or "20%". */
+  width?: CwDataTableColumn["width"];
+  /** A CSS min-width value for this column. */
+  "min-width"?: CwDataTableColumn["minWidth"];
+  /** Alignment of cell content within the column. */
+  align?: CwDataTableColumn["align"];
+  /** Hides the column without removing it from the DOM. */
+  hidden?: CwDataTableColumn["hidden"];
+  /** A custom cell renderer. Called once per row with the cell value, the full row object,
+and this column element. Return a Lit `TemplateResult` or a plain string. */
+  renderCell?: CwDataTableColumn["renderCell"];
+};
+
+type CwDataTableProps = {
+  /** The key in each row object used as a stable row identity for selection. Falls back to row index when not set. */
+  "row-id"?: CwDataTable["rowId"];
+  /** Controls row selection behavior. */
+  selection?: CwDataTable["selection"];
+  /** The column currently used for sorting, identified by its `name`. */
+  "sort-column"?: CwDataTable["sortColumn"];
+  /** The direction of the current sort. */
+  "sort-direction"?: CwDataTable["sortDirection"];
+  /** Disables client-side sorting. When set, the component emits `cw-sort-change` but does not
+reorder `data` itself — the consumer is responsible for fetching/providing sorted data. */
+  "server-sort"?: CwDataTable["serverSort"];
+  /** Shows a loading spinner overlay over the table body. */
+  loading?: CwDataTable["loading"];
+  /** Applies alternating row background colors. */
+  striped?: CwDataTable["striped"];
+  /** Adds borders between cells. */
+  bordered?: CwDataTable["bordered"];
+  /** An accessible caption for the table, rendered as a visually hidden `<caption>`. */
+  caption?: CwDataTable["caption"];
+  /** Text shown in the empty state when `data` is empty and `loading` is false. */
+  "empty-text"?: CwDataTable["emptyText"];
+  /** The array of row data objects to display. This is a property only and cannot be set as an attribute.
+Each object's keys correspond to column `name` values. */
+  data?: CwDataTable["data"];
+  /** Returns the currently selected row objects. Set this property to programmatically control selection. */
+  selectedRows?: CwDataTable["selectedRows"];
+  /** Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`. */
+  "oncw-sort-change"?: (e: CustomEvent<SortChangeEvent>) => void;
+  /** Emitted when row selection changes. `detail: { selectedRows: object[] }`. */
+  "oncw-row-selection-change"?: (e: CustomEvent<CwRowSelectionChangeEvent>) => void;
+  /** Emitted when a body row is clicked. `detail: { row: object, index: number }`. */
+  "oncw-row-click"?: (e: CustomEvent<RowClickEvent>) => void;
+};
+
 type CwDatePickerProps = {
   /** The name of the date picker, submitted as a name/value pair with form data. */
   name?: CwDatePicker["name"];
@@ -2318,6 +2380,53 @@ export type CustomElements = {
    */
   "cw-copy-button": DefineComponent<CwCopyButtonProps>;
 
+  /**
+   * Data table columns define the columns of a [data table](/components/data-table).
+   * ---
+   *
+   *
+   * ### **Slots:**
+   *  - _default_ - This element has no rendered output; it is a configuration element only.
+   */
+  "cw-data-table-column": DefineComponent<CwDataTableColumnProps>;
+
+  /**
+   * Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.
+   * ---
+   *
+   *
+   * ### **Events:**
+   *  - **cw-sort-change** - Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`.
+   * - **cw-row-selection-change** - Emitted when row selection changes. `detail: { selectedRows: object[] }`.
+   * - **cw-row-click** - Emitted when a body row is clicked. `detail: { row: object, index: number }`.
+   *
+   * ### **Slots:**
+   *  - _default_ - Place `<cw-data-table-column>` elements here to define columns.
+   * - **empty** - Content shown when `data` is empty and not loading.
+   *
+   * ### **CSS Properties:**
+   *  - **--cw-data-table-border-color** - Border color used when `bordered` is set. Default: `var(--cw-color-neutral-200)`. _(default: undefined)_
+   * - **--cw-data-table-stripe-color** - Alternate row background color when `striped` is set. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_
+   * - **--cw-data-table-row-hover-color** - Row background on hover. Default: `var(--cw-color-neutral-100)`. _(default: undefined)_
+   * - **--cw-data-table-selected-row-color** - Selected row background. Default: `var(--cw-color-primary-50)`. _(default: undefined)_
+   * - **--cw-data-table-header-background** - Header row background. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_
+   *
+   * ### **CSS Parts:**
+   *  - **base** - The outer scrollable wrapper.
+   * - **table** - The `<table>` element.
+   * - **header-row** - The `<tr>` in `<thead>`.
+   * - **header-cell** - Each `<th>` element.
+   * - **sort-button** - The clickable button inside a sortable `<th>`.
+   * - **sort-icon** - The sort direction icon inside a sortable `<th>`.
+   * - **body-row** - Each `<tr>` in `<tbody>`.
+   * - **body-row--selected** - Added to body rows that are selected.
+   * - **body-cell** - Each `<td>` element.
+   * - **checkbox-cell** - The `<th>` or `<td>` that holds the selection checkbox.
+   * - **loading** - The loading overlay shown when `loading` is true.
+   * - **empty** - The empty-state container shown when `data` is empty.
+   */
+  "cw-data-table": DefineComponent<CwDataTableProps>;
+
   /**
    * Date pickers let users select a date from a calendar.
    * ---

package/dist/utilities/icon-library.js

@@ -2,9 +2,9 @@ import "../chunks/chunk.HAL7R4WT.js";
 import {
   registerIconLibrary,
   unregisterIconLibrary
-} from "../chunks/chunk.OOAK7TAG.js";
-import "../chunks/chunk.3TFKS637.js";
+} from "../chunks/chunk.C4QY7KGQ.js";
 import "../chunks/chunk.CJFFVBAI.js";
+import "../chunks/chunk.3TFKS637.js";
 import "../chunks/chunk.4EHT37C5.js";
 import "../chunks/chunk.Q44EX5TP.js";
 export {

package/dist/vscode.html-custom-data.json

@@ -840,6 +840,123 @@
         }
       ]
     },
+    {
+      "name": "cw-data-table-column",
+      "description": "Data table columns define the columns of a [data table](/components/data-table).\n---\n\n\n### **Slots:**\n - _default_ - This element has no rendered output; it is a configuration element only.",
+      "attributes": [
+        {
+          "name": "name",
+          "description": "The key in each row data object that this column displays. Required.",
+          "values": []
+        },
+        {
+          "name": "label",
+          "description": "The column header label. Falls back to `name` if not set.",
+          "values": []
+        },
+        {
+          "name": "sortable",
+          "description": "Makes the column header clickable for sorting.",
+          "values": []
+        },
+        {
+          "name": "width",
+          "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
+          "values": []
+        },
+        {
+          "name": "min-width",
+          "description": "A CSS min-width value for this column.",
+          "values": []
+        },
+        {
+          "name": "align",
+          "description": "Alignment of cell content within the column.",
+          "values": [
+            { "name": "start" },
+            { "name": "center" },
+            { "name": "end" }
+          ]
+        },
+        {
+          "name": "hidden",
+          "description": "Hides the column without removing it from the DOM.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://cw-elements-b0c7e5.gitlab.io/components/data-table-column"
+        }
+      ]
+    },
+    {
+      "name": "cw-data-table",
+      "description": "Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.\n---\n\n\n### **Events:**\n - **cw-sort-change** - Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`.\n- **cw-row-selection-change** - Emitted when row selection changes. `detail: { selectedRows: object[] }`.\n- **cw-row-click** - Emitted when a body row is clicked. `detail: { row: object, index: number }`.\n\n### **Slots:**\n - _default_ - Place `<cw-data-table-column>` elements here to define columns.\n- **empty** - Content shown when `data` is empty and not loading.\n\n### **CSS Properties:**\n - **--cw-data-table-border-color** - Border color used when `bordered` is set. Default: `var(--cw-color-neutral-200)`. _(default: undefined)_\n- **--cw-data-table-stripe-color** - Alternate row background color when `striped` is set. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_\n- **--cw-data-table-row-hover-color** - Row background on hover. Default: `var(--cw-color-neutral-100)`. _(default: undefined)_\n- **--cw-data-table-selected-row-color** - Selected row background. Default: `var(--cw-color-primary-50)`. _(default: undefined)_\n- **--cw-data-table-header-background** - Header row background. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The outer scrollable wrapper.\n- **table** - The `<table>` element.\n- **header-row** - The `<tr>` in `<thead>`.\n- **header-cell** - Each `<th>` element.\n- **sort-button** - The clickable button inside a sortable `<th>`.\n- **sort-icon** - The sort direction icon inside a sortable `<th>`.\n- **body-row** - Each `<tr>` in `<tbody>`.\n- **body-row--selected** - Added to body rows that are selected.\n- **body-cell** - Each `<td>` element.\n- **checkbox-cell** - The `<th>` or `<td>` that holds the selection checkbox.\n- **loading** - The loading overlay shown when `loading` is true.\n- **empty** - The empty-state container shown when `data` is empty.",
+      "attributes": [
+        {
+          "name": "row-id",
+          "description": "The key in each row object used as a stable row identity for selection. Falls back to row index when not set.",
+          "values": []
+        },
+        {
+          "name": "selection",
+          "description": "Controls row selection behavior.",
+          "values": [
+            { "name": "none" },
+            { "name": "single" },
+            { "name": "multiple" }
+          ]
+        },
+        {
+          "name": "sort-column",
+          "description": "The column currently used for sorting, identified by its `name`.",
+          "values": []
+        },
+        {
+          "name": "sort-direction",
+          "description": "The direction of the current sort.",
+          "values": [{ "name": "asc" }, { "name": "desc" }]
+        },
+        {
+          "name": "server-sort",
+          "description": "Disables client-side sorting. When set, the component emits `cw-sort-change` but does not\nreorder `data` itself — the consumer is responsible for fetching/providing sorted data.",
+          "values": []
+        },
+        {
+          "name": "loading",
+          "description": "Shows a loading spinner overlay over the table body.",
+          "values": []
+        },
+        {
+          "name": "striped",
+          "description": "Applies alternating row background colors.",
+          "values": []
+        },
+        {
+          "name": "bordered",
+          "description": "Adds borders between cells.",
+          "values": []
+        },
+        {
+          "name": "caption",
+          "description": "An accessible caption for the table, rendered as a visually hidden `<caption>`.",
+          "values": []
+        },
+        {
+          "name": "empty-text",
+          "description": "Text shown in the empty state when `data` is empty and `loading` is false.",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Documentation",
+          "url": "https://cw-elements-b0c7e5.gitlab.io/components/data-table"
+        }
+      ]
+    },
     {
       "name": "cw-date-picker",
       "description": "Date pickers let users select a date from a calendar.\n---\n\n\n### **Events:**\n - **cw-change** - Emitted when the control's value changes.\n- **cw-clear** - Emitted when the control's value is cleared.\n- **cw-input** - Emitted when the control receives input.\n- **cw-focus** - Emitted when the control gains focus.\n- **cw-blur** - Emitted when the control loses focus.\n- **cw-show** - Emitted when the date picker's calendar opens.\n- **cw-after-show** - Emitted after the date picker's calendar opens and all animations are complete.\n- **cw-hide** - Emitted when the date picker's calendar closes.\n- **cw-after-hide** - Emitted after the date picker's calendar closes and all animations are complete.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **show()** - Shows the calendar.\n- **hide()** - Hides the calendar.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The date picker's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container the wraps the prefix, suffix, display input, clear icon, and expand icon.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected date, an `<input>` element.\n- **calendar** - The calendar container where the header and date grid are rendered.\n- **header** - The calendar's header containing the previous/next buttons and heading.\n- **heading** - The heading that displays the focused month and year.\n- **previous-button** - The button that navigates to the previous month.\n- **next-button** - The button that navigates to the next month.\n- **grid** - The grid that contains the weekday headers and days.\n- **day** - An individual day within the grid.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",

package/dist/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@cordwainer/cw-elements",
-  "version": "1.1.1",
+  "version": "1.2.0-alpha.1",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -1962,6 +1962,270 @@
             ]
           }
         },
+        {
+          "name": "cw-data-table-column",
+          "description": "Data table columns define the columns of a [data table](/components/data-table).\n---\n\n\n### **Slots:**\n - _default_ - This element has no rendered output; it is a configuration element only.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "name",
+              "description": "The key in each row data object that this column displays. Required.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "label",
+              "description": "The column header label. Falls back to `name` if not set.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "sortable",
+              "description": "Makes the column header clickable for sorting.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "width",
+              "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "min-width",
+              "description": "A CSS min-width value for this column.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "align",
+              "description": "Alignment of cell content within the column.",
+              "value": {
+                "type": "'start' | 'center' | 'end'",
+                "default": "'start'"
+              }
+            },
+            {
+              "name": "hidden",
+              "description": "Hides the column without removing it from the DOM.",
+              "value": { "type": "boolean", "default": "false" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "This element has no rendered output; it is a configuration element only."
+            }
+          ],
+          "events": [],
+          "js": {
+            "properties": [
+              {
+                "name": "name",
+                "description": "The key in each row data object that this column displays. Required.",
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "description": "The column header label. Falls back to `name` if not set.",
+                "type": "string"
+              },
+              {
+                "name": "sortable",
+                "description": "Makes the column header clickable for sorting.",
+                "type": "boolean"
+              },
+              {
+                "name": "width",
+                "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
+                "type": "string"
+              },
+              {
+                "name": "minWidth",
+                "description": "A CSS min-width value for this column.",
+                "type": "string"
+              },
+              {
+                "name": "align",
+                "description": "Alignment of cell content within the column.",
+                "type": "'start' | 'center' | 'end'"
+              },
+              {
+                "name": "hidden",
+                "description": "Hides the column without removing it from the DOM.",
+                "type": "boolean"
+              },
+              {
+                "name": "renderCell",
+                "description": "A custom cell renderer. Called once per row with the cell value, the full row object,\nand this column element. Return a Lit `TemplateResult` or a plain string."
+              }
+            ],
+            "events": []
+          }
+        },
+        {
+          "name": "cw-data-table",
+          "description": "Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.\n---\n\n\n### **Events:**\n - **cw-sort-change** - Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`.\n- **cw-row-selection-change** - Emitted when row selection changes. `detail: { selectedRows: object[] }`.\n- **cw-row-click** - Emitted when a body row is clicked. `detail: { row: object, index: number }`.\n\n### **Slots:**\n - _default_ - Place `<cw-data-table-column>` elements here to define columns.\n- **empty** - Content shown when `data` is empty and not loading.\n\n### **CSS Properties:**\n - **--cw-data-table-border-color** - Border color used when `bordered` is set. Default: `var(--cw-color-neutral-200)`. _(default: undefined)_\n- **--cw-data-table-stripe-color** - Alternate row background color when `striped` is set. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_\n- **--cw-data-table-row-hover-color** - Row background on hover. Default: `var(--cw-color-neutral-100)`. _(default: undefined)_\n- **--cw-data-table-selected-row-color** - Selected row background. Default: `var(--cw-color-primary-50)`. _(default: undefined)_\n- **--cw-data-table-header-background** - Header row background. Default: `var(--cw-color-neutral-50)`. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The outer scrollable wrapper.\n- **table** - The `<table>` element.\n- **header-row** - The `<tr>` in `<thead>`.\n- **header-cell** - Each `<th>` element.\n- **sort-button** - The clickable button inside a sortable `<th>`.\n- **sort-icon** - The sort direction icon inside a sortable `<th>`.\n- **body-row** - Each `<tr>` in `<tbody>`.\n- **body-row--selected** - Added to body rows that are selected.\n- **body-cell** - Each `<td>` element.\n- **checkbox-cell** - The `<th>` or `<td>` that holds the selection checkbox.\n- **loading** - The loading overlay shown when `loading` is true.\n- **empty** - The empty-state container shown when `data` is empty.",
+          "doc-url": "",
+          "attributes": [
+            {
+              "name": "row-id",
+              "description": "The key in each row object used as a stable row identity for selection. Falls back to row index when not set.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "selection",
+              "description": "Controls row selection behavior.",
+              "value": {
+                "type": "'none' | 'single' | 'multiple'",
+                "default": "'none'"
+              }
+            },
+            {
+              "name": "sort-column",
+              "description": "The column currently used for sorting, identified by its `name`.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "sort-direction",
+              "description": "The direction of the current sort.",
+              "value": { "type": "'asc' | 'desc'", "default": "'asc'" }
+            },
+            {
+              "name": "server-sort",
+              "description": "Disables client-side sorting. When set, the component emits `cw-sort-change` but does not\nreorder `data` itself — the consumer is responsible for fetching/providing sorted data.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "loading",
+              "description": "Shows a loading spinner overlay over the table body.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "striped",
+              "description": "Applies alternating row background colors.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "bordered",
+              "description": "Adds borders between cells.",
+              "value": { "type": "boolean", "default": "false" }
+            },
+            {
+              "name": "caption",
+              "description": "An accessible caption for the table, rendered as a visually hidden `<caption>`.",
+              "value": { "type": "string", "default": "''" }
+            },
+            {
+              "name": "empty-text",
+              "description": "Text shown in the empty state when `data` is empty and `loading` is false.",
+              "value": { "type": "string", "default": "'No data found'" }
+            }
+          ],
+          "slots": [
+            {
+              "name": "",
+              "description": "Place `<cw-data-table-column>` elements here to define columns."
+            },
+            {
+              "name": "empty",
+              "description": "Content shown when `data` is empty and not loading."
+            }
+          ],
+          "events": [
+            {
+              "name": "cw-sort-change",
+              "type": "SortChangeEvent",
+              "description": "Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`."
+            },
+            {
+              "name": "cw-row-selection-change",
+              "type": "CwRowSelectionChangeEvent",
+              "description": "Emitted when row selection changes. `detail: { selectedRows: object[] }`."
+            },
+            {
+              "name": "cw-row-click",
+              "type": "RowClickEvent",
+              "description": "Emitted when a body row is clicked. `detail: { row: object, index: number }`."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "data",
+                "description": "The array of row data objects to display. This is a property only and cannot be set as an attribute.\nEach object's keys correspond to column `name` values.",
+                "type": "Record<string, unknown>[]"
+              },
+              {
+                "name": "rowId",
+                "description": "The key in each row object used as a stable row identity for selection. Falls back to row index when not set.",
+                "type": "string"
+              },
+              {
+                "name": "selection",
+                "description": "Controls row selection behavior.",
+                "type": "'none' | 'single' | 'multiple'"
+              },
+              {
+                "name": "sortColumn",
+                "description": "The column currently used for sorting, identified by its `name`.",
+                "type": "string"
+              },
+              {
+                "name": "sortDirection",
+                "description": "The direction of the current sort.",
+                "type": "'asc' | 'desc'"
+              },
+              {
+                "name": "serverSort",
+                "description": "Disables client-side sorting. When set, the component emits `cw-sort-change` but does not\nreorder `data` itself — the consumer is responsible for fetching/providing sorted data.",
+                "type": "boolean"
+              },
+              {
+                "name": "loading",
+                "description": "Shows a loading spinner overlay over the table body.",
+                "type": "boolean"
+              },
+              {
+                "name": "striped",
+                "description": "Applies alternating row background colors.",
+                "type": "boolean"
+              },
+              {
+                "name": "bordered",
+                "description": "Adds borders between cells.",
+                "type": "boolean"
+              },
+              {
+                "name": "caption",
+                "description": "An accessible caption for the table, rendered as a visually hidden `<caption>`.",
+                "type": "string"
+              },
+              {
+                "name": "emptyText",
+                "description": "Text shown in the empty state when `data` is empty and `loading` is false.",
+                "type": "string"
+              },
+              {
+                "name": "selectedRows",
+                "description": "Returns the currently selected row objects. Set this property to programmatically control selection.",
+                "type": "Record<string, unknown>[]"
+              }
+            ],
+            "events": [
+              {
+                "name": "cw-sort-change",
+                "type": "SortChangeEvent",
+                "description": "Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`."
+              },
+              {
+                "name": "cw-row-selection-change",
+                "type": "CwRowSelectionChangeEvent",
+                "description": "Emitted when row selection changes. `detail: { selectedRows: object[] }`."
+              },
+              {
+                "name": "cw-row-click",
+                "type": "RowClickEvent",
+                "description": "Emitted when a body row is clicked. `detail: { row: object, index: number }`."
+              }
+            ]
+          }
+        },
         {
           "name": "cw-date-picker",
           "description": "Date pickers let users select a date from a calendar.\n---\n\n\n### **Events:**\n - **cw-change** - Emitted when the control's value changes.\n- **cw-clear** - Emitted when the control's value is cleared.\n- **cw-input** - Emitted when the control receives input.\n- **cw-focus** - Emitted when the control gains focus.\n- **cw-blur** - Emitted when the control loses focus.\n- **cw-show** - Emitted when the date picker's calendar opens.\n- **cw-after-show** - Emitted after the date picker's calendar opens and all animations are complete.\n- **cw-hide** - Emitted when the date picker's calendar closes.\n- **cw-after-hide** - Emitted after the date picker's calendar closes and all animations are complete.\n- **cw-invalid** - Emitted when the form control has been checked for validity and its constraints aren't satisfied.\n\n### **Methods:**\n - **show()** - Shows the calendar.\n- **hide()** - Hides the calendar.\n- **checkValidity()** - Checks for validity but does not show a validation message. Returns `true` when valid and `false` when invalid.\n- **getForm(): _HTMLFormElement | null_** - Gets the associated form, if one exists.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n- **focus(options: _FocusOptions_)** - Sets focus on the control.\n- **blur()** - Removes focus from the control.\n\n### **Slots:**\n - **label** - The input's label. Alternatively, you can use the `label` attribute.\n- **prefix** - Used to prepend a presentational icon or similar element to the combobox.\n- **suffix** - Used to append a presentational icon or similar element to the combobox.\n- **clear-icon** - An icon to use in lieu of the default clear icon.\n- **expand-icon** - The icon to show when the control is expanded and collapsed.\n- **help-text** - Text that describes how to use the input. Alternatively, you can use the `help-text` attribute.\n\n### **CSS Parts:**\n - **form-control** - The form control that wraps the label, input, and help text.\n- **form-control-label** - The label's wrapper.\n- **form-control-input** - The date picker's wrapper.\n- **form-control-help-text** - The help text's wrapper.\n- **combobox** - The container the wraps the prefix, suffix, display input, clear icon, and expand icon.\n- **prefix** - The container that wraps the prefix slot.\n- **suffix** - The container that wraps the suffix slot.\n- **display-input** - The element that displays the selected date, an `<input>` element.\n- **calendar** - The calendar container where the header and date grid are rendered.\n- **header** - The calendar's header containing the previous/next buttons and heading.\n- **heading** - The heading that displays the focused month and year.\n- **previous-button** - The button that navigates to the previous month.\n- **next-button** - The button that navigates to the next month.\n- **grid** - The grid that contains the weekday headers and days.\n- **day** - An individual day within the grid.\n- **clear-button** - The clear button.\n- **expand-icon** - The container that wraps the expand icon.",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cordwainer/cw-elements",
   "description": "Cordwainer Elements — Web Component Library, a hard fork of Shoelace (@shoelace-style/shoelace).",
-  "version": "1.1.1",
+  "version": "1.2.0-alpha.1",
   "homepage": "https://cw-elements-b0c7e5.gitlab.io",
   "author": "Matt Hand",
   "license": "MIT",