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

package/cdn/custom-elements.json

@@ -6009,6 +6009,775 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "components/data-table/data-table-column.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwDataTableColumn",
+          "slots": [
+            {
+              "description": "This element has no rendered output; it is a configuration element only.",
+              "name": ""
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The key in each row data object that this column displays. Required.",
+              "attribute": "name",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The column header label. Falls back to `name` if not set.",
+              "attribute": "label",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sortable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the column header clickable for sorting.",
+              "attribute": "sortable",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "width",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
+              "attribute": "width",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "minWidth",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A CSS min-width value for this column.",
+              "attribute": "min-width",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "align",
+              "type": {
+                "text": "'start' | 'center' | 'end'"
+              },
+              "default": "'start'",
+              "description": "Alignment of cell content within the column.",
+              "attribute": "align",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "hidden",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides the column without removing it from the DOM.",
+              "attribute": "hidden",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "_renderCell",
+              "type": {
+                "text": "(\n    value: unknown,\n    row: Record<string, unknown>,\n    column: CwDataTableColumn\n  ) => TemplateResult | string | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handlePropertyChange"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "name",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The key in each row data object that this column displays. Required.",
+              "fieldName": "name"
+            },
+            {
+              "name": "label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The column header label. Falls back to `name` if not set.",
+              "fieldName": "label"
+            },
+            {
+              "name": "sortable",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Makes the column header clickable for sorting.",
+              "fieldName": "sortable"
+            },
+            {
+              "name": "width",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A CSS width value for this column, e.g. \"200px\" or \"20%\".",
+              "fieldName": "width"
+            },
+            {
+              "name": "min-width",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "A CSS min-width value for this column.",
+              "fieldName": "minWidth"
+            },
+            {
+              "name": "align",
+              "type": {
+                "text": "'start' | 'center' | 'end'"
+              },
+              "default": "'start'",
+              "description": "Alignment of cell content within the column.",
+              "fieldName": "align"
+            },
+            {
+              "name": "hidden",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Hides the column without removing it from the DOM.",
+              "fieldName": "hidden"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Data table columns define the columns of a [data table](/components/data-table).",
+          "tagNameWithoutPrefix": "data-table-column",
+          "tagName": "cw-data-table-column",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Data table columns define the columns of a [data table](/components/data-table).\n * @documentation https://cw-elements-b0c7e5.gitlab.io/components/data-table\n * @status experimental\n * @since 1.2\n *\n * @slot - This element has no rendered output; it is a configuration element only.\n */",
+          "documentation": "https://cw-elements-b0c7e5.gitlab.io/components/data-table",
+          "status": "experimental",
+          "since": "1.2"
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwDataTableColumn",
+            "module": "components/data-table/data-table-column.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "components/data-table/data-table.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "",
+          "name": "CwDataTable",
+          "cssProperties": [
+            {
+              "description": "Border color used when `bordered` is set. Default: `var(--cw-color-neutral-200)`.",
+              "name": "--cw-data-table-border-color"
+            },
+            {
+              "description": "Alternate row background color when `striped` is set. Default: `var(--cw-color-neutral-50)`.",
+              "name": "--cw-data-table-stripe-color"
+            },
+            {
+              "description": "Row background on hover. Default: `var(--cw-color-neutral-100)`.",
+              "name": "--cw-data-table-row-hover-color"
+            },
+            {
+              "description": "Selected row background. Default: `var(--cw-color-primary-50)`.",
+              "name": "--cw-data-table-selected-row-color"
+            },
+            {
+              "description": "Header row background. Default: `var(--cw-color-neutral-50)`.",
+              "name": "--cw-data-table-header-background"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "The outer scrollable wrapper.",
+              "name": "base"
+            },
+            {
+              "description": "The `<table>` element.",
+              "name": "table"
+            },
+            {
+              "description": "The `<tr>` in `<thead>`.",
+              "name": "header-row"
+            },
+            {
+              "description": "Each `<th>` element.",
+              "name": "header-cell"
+            },
+            {
+              "description": "The clickable button inside a sortable `<th>`.",
+              "name": "sort-button"
+            },
+            {
+              "description": "The sort direction icon inside a sortable `<th>`.",
+              "name": "sort-icon"
+            },
+            {
+              "description": "Each `<tr>` in `<tbody>`.",
+              "name": "body-row"
+            },
+            {
+              "description": "Added to body rows that are selected.",
+              "name": "body-row--selected"
+            },
+            {
+              "description": "Each `<td>` element.",
+              "name": "body-cell"
+            },
+            {
+              "description": "The `<th>` or `<td>` that holds the selection checkbox.",
+              "name": "checkbox-cell"
+            },
+            {
+              "description": "The loading overlay shown when `loading` is true.",
+              "name": "loading"
+            },
+            {
+              "description": "The empty-state container shown when `data` is empty.",
+              "name": "empty"
+            }
+          ],
+          "slots": [
+            {
+              "description": "Place `<cw-data-table-column>` elements here to define columns.",
+              "name": ""
+            },
+            {
+              "description": "Content shown when `data` is empty and not loading.",
+              "name": "empty"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "dependencies",
+              "type": {
+                "text": "object"
+              },
+              "static": true,
+              "default": "{ 'cw-checkbox': CwCheckbox, 'cw-icon': CwIcon, 'cw-spinner': CwSpinner }"
+            },
+            {
+              "kind": "field",
+              "name": "columns",
+              "type": {
+                "text": "CwDataTableColumn[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "selectedIds",
+              "privacy": "private",
+              "default": "new Set<string>()"
+            },
+            {
+              "kind": "field",
+              "name": "data",
+              "type": {
+                "text": "Record<string, unknown>[]"
+              },
+              "default": "[]",
+              "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."
+            },
+            {
+              "kind": "field",
+              "name": "rowId",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The key in each row object used as a stable row identity for selection. Falls back to row index when not set.",
+              "attribute": "row-id"
+            },
+            {
+              "kind": "field",
+              "name": "selection",
+              "type": {
+                "text": "'none' | 'single' | 'multiple'"
+              },
+              "default": "'none'",
+              "description": "Controls row selection behavior.",
+              "attribute": "selection",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sortColumn",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The column currently used for sorting, identified by its `name`.",
+              "attribute": "sort-column",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "sortDirection",
+              "type": {
+                "text": "'asc' | 'desc'"
+              },
+              "default": "'asc'",
+              "description": "The direction of the current sort.",
+              "attribute": "sort-direction",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "serverSort",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "attribute": "server-sort",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a loading spinner overlay over the table body.",
+              "attribute": "loading",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "striped",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Applies alternating row background colors.",
+              "attribute": "striped",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "bordered",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adds borders between cells.",
+              "attribute": "bordered",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "caption",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "An accessible caption for the table, rendered as a visually hidden `<caption>`.",
+              "attribute": "caption"
+            },
+            {
+              "kind": "field",
+              "name": "emptyText",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No data found'",
+              "description": "Text shown in the empty state when `data` is empty and `loading` is false.",
+              "attribute": "empty-text"
+            },
+            {
+              "kind": "field",
+              "name": "selectedRows",
+              "type": {
+                "text": "Record<string, unknown>[]"
+              },
+              "description": "Returns the currently selected row objects. Set this property to programmatically control selection."
+            },
+            {
+              "kind": "method",
+              "name": "getRowId",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "string"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "getSortedData",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "Record<string, unknown>[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getVisibleColumns",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CwDataTableColumn[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "getColumns",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "CwDataTableColumn[]"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "handleSlotChange",
+              "privacy": "private"
+            },
+            {
+              "kind": "method",
+              "name": "handleSortClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "columnName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleRowClick",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleRowCheckboxChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                },
+                {
+                  "name": "index",
+                  "type": {
+                    "text": "number"
+                  }
+                },
+                {
+                  "name": "checked",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleSelectAllChange",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "checked",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "handleDataChange"
+            },
+            {
+              "kind": "method",
+              "name": "renderSortIcon",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "columnName",
+                  "type": {
+                    "text": "string"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderHeaderCell",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "col",
+                  "type": {
+                    "text": "CwDataTableColumn"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "renderBodyCell",
+              "privacy": "private",
+              "parameters": [
+                {
+                  "name": "col",
+                  "type": {
+                    "text": "CwDataTableColumn"
+                  }
+                },
+                {
+                  "name": "row",
+                  "type": {
+                    "text": "Record<string, unknown>"
+                  }
+                }
+              ]
+            }
+          ],
+          "events": [
+            {
+              "type": {
+                "text": "SortChangeEvent"
+              },
+              "description": "Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`.",
+              "name": "cw-sort-change",
+              "reactName": "onCwSortChange",
+              "eventName": "CwSortChangeEvent"
+            },
+            {
+              "type": {
+                "text": "CwRowSelectionChangeEvent"
+              },
+              "description": "Emitted when row selection changes. `detail: { selectedRows: object[] }`.",
+              "name": "cw-row-selection-change",
+              "reactName": "onCwRowSelectionChange",
+              "eventName": "CwRowSelectionChangeEvent"
+            },
+            {
+              "type": {
+                "text": "RowClickEvent"
+              },
+              "description": "Emitted when a body row is clicked. `detail: { row: object, index: number }`.",
+              "name": "cw-row-click",
+              "reactName": "onCwRowClick",
+              "eventName": "CwRowClickEvent"
+            }
+          ],
+          "attributes": [
+            {
+              "name": "row-id",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The key in each row object used as a stable row identity for selection. Falls back to row index when not set.",
+              "fieldName": "rowId"
+            },
+            {
+              "name": "selection",
+              "type": {
+                "text": "'none' | 'single' | 'multiple'"
+              },
+              "default": "'none'",
+              "description": "Controls row selection behavior.",
+              "fieldName": "selection"
+            },
+            {
+              "name": "sort-column",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "The column currently used for sorting, identified by its `name`.",
+              "fieldName": "sortColumn"
+            },
+            {
+              "name": "sort-direction",
+              "type": {
+                "text": "'asc' | 'desc'"
+              },
+              "default": "'asc'",
+              "description": "The direction of the current sort.",
+              "fieldName": "sortDirection"
+            },
+            {
+              "name": "server-sort",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "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.",
+              "fieldName": "serverSort"
+            },
+            {
+              "name": "loading",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Shows a loading spinner overlay over the table body.",
+              "fieldName": "loading"
+            },
+            {
+              "name": "striped",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Applies alternating row background colors.",
+              "fieldName": "striped"
+            },
+            {
+              "name": "bordered",
+              "type": {
+                "text": "boolean"
+              },
+              "default": "false",
+              "description": "Adds borders between cells.",
+              "fieldName": "bordered"
+            },
+            {
+              "name": "caption",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "An accessible caption for the table, rendered as a visually hidden `<caption>`.",
+              "fieldName": "caption"
+            },
+            {
+              "name": "empty-text",
+              "type": {
+                "text": "string"
+              },
+              "default": "'No data found'",
+              "description": "Text shown in the empty state when `data` is empty and `loading` is false.",
+              "fieldName": "emptyText"
+            }
+          ],
+          "superclass": {
+            "name": "CwElement",
+            "module": "/src/internal/cw-element.js"
+          },
+          "summary": "Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.",
+          "tagNameWithoutPrefix": "data-table",
+          "tagName": "cw-data-table",
+          "customElement": true,
+          "jsDoc": "/**\n * @summary Data tables display structured tabular data with support for sorting, row selection, and custom cell rendering.\n * @documentation https://cw-elements-b0c7e5.gitlab.io/components/data-table\n * @status experimental\n * @since 1.2\n *\n * @dependency cw-checkbox\n * @dependency cw-icon\n * @dependency cw-spinner\n *\n * @event {SortChangeEvent} cw-sort-change - Emitted when the user clicks a sortable column header. `detail: { column: string, direction: 'asc' | 'desc' }`.\n * @event {CwRowSelectionChangeEvent} cw-row-selection-change - Emitted when row selection changes. `detail: { selectedRows: object[] }`.\n * @event {RowClickEvent} cw-row-click - Emitted when a body row is clicked. `detail: { row: object, index: number }`.\n *\n * @slot - Place `<cw-data-table-column>` elements here to define columns.\n * @slot empty - Content shown when `data` is empty and not loading.\n *\n * @csspart base - The outer scrollable wrapper.\n * @csspart table - The `<table>` element.\n * @csspart header-row - The `<tr>` in `<thead>`.\n * @csspart header-cell - Each `<th>` element.\n * @csspart sort-button - The clickable button inside a sortable `<th>`.\n * @csspart sort-icon - The sort direction icon inside a sortable `<th>`.\n * @csspart body-row - Each `<tr>` in `<tbody>`.\n * @csspart body-row--selected - Added to body rows that are selected.\n * @csspart body-cell - Each `<td>` element.\n * @csspart checkbox-cell - The `<th>` or `<td>` that holds the selection checkbox.\n * @csspart loading - The loading overlay shown when `loading` is true.\n * @csspart empty - The empty-state container shown when `data` is empty.\n *\n * @cssproperty --cw-data-table-border-color - Border color used when `bordered` is set. Default: `var(--cw-color-neutral-200)`.\n * @cssproperty --cw-data-table-stripe-color - Alternate row background color when `striped` is set. Default: `var(--cw-color-neutral-50)`.\n * @cssproperty --cw-data-table-row-hover-color - Row background on hover. Default: `var(--cw-color-neutral-100)`.\n * @cssproperty --cw-data-table-selected-row-color - Selected row background. Default: `var(--cw-color-primary-50)`.\n * @cssproperty --cw-data-table-header-background - Header row background. Default: `var(--cw-color-neutral-50)`.\n */",
+          "documentation": "https://cw-elements-b0c7e5.gitlab.io/components/data-table",
+          "status": "experimental",
+          "since": "1.2",
+          "dependencies": [
+            "cw-checkbox",
+            "cw-icon",
+            "cw-spinner"
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "CwDataTable",
+            "module": "components/data-table/data-table.js"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "components/date-picker/date-picker.js",
@@ -21254,7 +22023,7 @@
   "package": {
     "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",
     "author": "Matt Hand",
     "homepage": "https://cw-elements-b0c7e5.gitlab.io",
     "license": "MIT"