xv-webcomponents 2.0.0-beta.2 → 2.0.0-beta.28

package/dist/types/components.d.ts

@@ -16,7 +16,7 @@ import { NOTIFICATION_VARIANTS_STR } from "./components/xv-notification/_vars";
 import { OverflowMenuEvent, OverflowMenuVariant } from "./components/xv-overflow-menu/_vars";
 import { XvPaginationVariant } from "./components/xv-pagination/xv-pagination.model";
 import { PROGRESS_ITEM_STATUS } from "./components/xv-progress-indicator/_vars";
-import { SelectRowDto, XVTableSortDto } from "./components/xv-table/_vars";
+import { XvCellAlign, XvCellOverflow, XvTableColumn, XvTableExpandedDetail, XvTableExpandMode, XvTableLayout, XvTableMode, XvTablePage, XvTableRowClickDetail, XvTableRowOrder, XvTableSelectionDetail, XvTableSelectionMode, XvTableSort } from "./components/xv-table/xv-table.model";
 import { TABS_VATIANT_STR } from "./components/xv-tabs/_vars";
 import { TagComboboxOptIn } from "./components/xv-tag-combobox/xv-tag-combobox.config";
 import { Placement } from "@popperjs/core";
@@ -31,7 +31,7 @@ export { NOTIFICATION_VARIANTS_STR } from "./components/xv-notification/_vars";
 export { OverflowMenuEvent, OverflowMenuVariant } from "./components/xv-overflow-menu/_vars";
 export { XvPaginationVariant } from "./components/xv-pagination/xv-pagination.model";
 export { PROGRESS_ITEM_STATUS } from "./components/xv-progress-indicator/_vars";
-export { SelectRowDto, XVTableSortDto } from "./components/xv-table/_vars";
+export { XvCellAlign, XvCellOverflow, XvTableColumn, XvTableExpandedDetail, XvTableExpandMode, XvTableLayout, XvTableMode, XvTablePage, XvTableRowClickDetail, XvTableRowOrder, XvTableSelectionDetail, XvTableSelectionMode, XvTableSort } from "./components/xv-table/xv-table.model";
 export { TABS_VATIANT_STR } from "./components/xv-tabs/_vars";
 export { TagComboboxOptIn } from "./components/xv-tag-combobox/xv-tag-combobox.config";
 export { Placement } from "@popperjs/core";
@@ -1079,42 +1079,395 @@ export namespace Components {
         "loading": boolean;
         "name"?: number | string;
     }
-    interface XvTableV2 {
-        "colsSize"?: (string | null)[];
-        "hover"?: boolean;
-        "loading"?: boolean;
+    /**
+     * A data table built on CSS grid with `subgrid` rows, so a row keeps its own box while its cells
+     * stay aligned to the table's columns and an expanded panel can span the full width.
+     * `columns` always describes the structure — widths, order, sorting, resizing, hiding and the
+     * stored layout all read from it. Rows come either from `rows` as data, or as slotted
+     * `xv-table-row` children when the cells hold arbitrary markup.
+     */
+    interface XvTable {
+        /**
+          * Stretches the table to the full width of its container.
+          * @default false
+         */
+        "block": boolean;
+        /**
+          * Clears the selection.
+         */
+        "clearSelection": () => Promise<void>;
+        /**
+          * Column definitions. Accepts its JSON string form so it is settable from plain markup.
+          * @default []
+         */
+        "columns": string | XvTableColumn[];
+        /**
+          * Tooltip on the column picker trigger.
+          * @default 'Columns'
+         */
+        "columnsLabel": string;
+        /**
+          * Supporting text under the title.
+          * @default ''
+         */
+        "description": string;
+        /**
+          * Shown when there are no rows.
+          * @default ''
+         */
+        "emptyLabel": string;
+        /**
+          * Accessible name of a row's expand toggle.
+          * @default 'Toggle row'
+         */
+        "expandLabel": string;
+        /**
+          * Whether rows expand, and whether more than one may be open.
+          * @default 'none'
+         */
+        "expandMode": XvTableExpandMode;
+        /**
+          * Values of the expanded rows.
+          * @default []
+         */
+        "expanded": string | unknown[];
+        /**
+          * The layout as it would be stored: only the deviations from the declared columns.
+         */
+        "getLayout": () => Promise<XvTableLayout>;
+        /**
+          * Highlights a row on pointer hover.
+          * @default false
+         */
+        "hover": boolean;
+        /**
+          * Title above the table.
+          * @default ''
+         */
+        "label": string;
+        /**
+          * Controlled column layout. Overrides whatever is stored.
+          * @default null
+         */
+        "layout": string | XvTableLayout;
+        /**
+          * Covers the body with a loading state.
+          * @default false
+         */
+        "loading": boolean;
+        /**
+          * Locale used for sorting and cell formatting. Falls back to the nearest `[lang]` ancestor.
+          * @default ''
+         */
+        "locale": string;
+        /**
+          * Width below which the table scrolls instead of squeezing, at any viewport. Left unset, a table only stops squeezing below 1180px, where it scrolls at the width its columns declared.
+          * @default 0
+         */
+        "minWidth": number;
+        /**
+          * Current page, 1-based.
+          * @default 1
+         */
+        "page": number;
+        /**
+          * Rows per page.
+          * @default 10
+         */
+        "pageSize": number;
+        /**
+          * Page size choices. Accepts a comma-separated attribute.
+          * @default [10, 20, 30, 40, 50, 100]
+         */
+        "pageSizeOptions": string | number[];
         /**
+          * `client` slices the `rows` prop; `server` only emits `pageChange`.
+          * @default 'none'
+         */
+        "paginationMode": XvTableMode;
+        /**
+          * Accessible name of a row's drag grip.
+          * @default 'Drag to reorder'
+         */
+        "reorderLabel": string;
+        /**
+          * Allows dragging column headers into a new order. Off by default, like `resizable`.
+          * @default false
+         */
+        "reorderable": boolean;
+        /**
+          * Text of the button that restores the declared column layout.
+          * @default 'Reset'
+         */
+        "resetLabel": string;
+        /**
+          * Drops the stored layout and returns to the declared columns.
+         */
+        "resetLayout": () => Promise<void>;
+        /**
+          * Allows dragging column edges. Off by default: no handle is rendered and nothing is bound until it is switched on. A column may switch itself off, never on.
+          * @default false
+         */
+        "resizable": boolean;
+        /**
+          * Emits `rowClick` when a row is clicked outside an interactive element.
+          * @default false
+         */
+        "rowClickable": boolean;
+        /**
+          * Property of a row object that identifies it in selection and expansion payloads.
+          * @default 'id'
+         */
+        "rowKey": string;
+        /**
+          * Whether the whole row drags, or only a grip in a leading control cell.
+          * @default 'icon'
+         */
+        "rowReorderHandle": 'icon' | 'row';
+        /**
+          * Allows dragging rows into a new order. Off by default: nothing is bound and no handle is rendered until it is switched on.
+          * @default false
+         */
+        "rowReorderable": boolean;
+        /**
+          * Row data. Ignored when `xv-table-row` children are slotted.
+          * @default []
+         */
+        "rows": string | any[];
+        /**
+          * Selects every selectable row.
+         */
+        "selectAll": () => Promise<void>;
+        /**
+          * Values of the selected rows.
+          * @default []
+         */
+        "selected": string | unknown[];
+        /**
+          * Text of the batch bar counter. `{count}` is replaced with the number of selected rows.
+          * @default ''
+         */
+        "selectedLabel": string;
+        /**
+          * `multiple` renders checkboxes, `single` renders radios.
+          * @default 'none'
+         */
+        "selection": XvTableSelectionMode;
+        /**
+          * Row height ladder.
           * @default SIZE_VAR.MD
          */
         "size": SIZE_VAR_STR;
+        /**
+          * Placeholder rows drawn while `loading`. Zero draws a spinner instead.
+          * @default 0
+         */
+        "skeletonRows": number;
+        /**
+          * Active sort, as `asc(field)` / `desc(field)` or an object.
+          * @default ''
+         */
+        "sortBy": string | XvTableSort;
+        /**
+          * `none` makes headers inert whatever the column says; `client` sorts the `rows` prop itself; `server` offers the affordance and only emits `sortChange` for the consumer to reload.
+          * @default 'none'
+         */
+        "sortMode": XvTableMode;
+        /**
+          * Keeps the header visible while the body scrolls.
+          * @default false
+         */
+        "stickyHeader": boolean;
+        /**
+          * Persists the column layout under this key. Empty means the layout is not remembered.
+          * @default ''
+         */
+        "storageKey": string;
+        /**
+          * Scopes the stored layout to a user.
+          * @default 'anonymous'
+         */
+        "storageOwner": string;
+        /**
+          * Total row count, for `server` pagination.
+          * @default 0
+         */
+        "total": number;
     }
-    interface XvTableV2Cell {
-        "align"?: 'left' | 'right' | 'center';
-        "multiline"?: boolean;
-        "name"?: string;
-        "sort"?: XV_SORT_DIR | '';
+    /**
+     * One cell of a table row. It holds arbitrary markup — buttons, links, tags, nested components —
+     * which is why the table stays composed rather than driven only by data.
+     * In a header row it also carries the column affordances: the sort arrow, the drag grip and the
+     * resize handle. The table renders this same component in both modes, so a header written as
+     * markup can do everything a header built from `columns` can.
+     */
+    interface XvTableCell {
+        /**
+          * Horizontal alignment of the content.
+          * @default 'start'
+         */
+        "align": XvCellAlign;
+        /**
+          * Lines kept before clamping, when `overflow` is `clamp`.
+          * @default 2
+         */
+        "clampLines": number;
+        /**
+          * Column this cell belongs to. Identifies it for sorting, resizing and the stored layout.
+          * @default ''
+         */
+        "columnId": string;
+        /**
+          * Renders the cell as a column header. Set by the table from the row it sits in.
+          * @default false
+         */
+        "header": boolean;
+        /**
+          * Lets the column picker hide this column. A header cell only.
+          * @default false
+         */
+        "hideable": boolean;
+        /**
+          * How content wider than the column behaves.
+          * @default 'ellipsis'
+         */
+        "overflow": XvCellOverflow;
+        /**
+          * Accessible name of the drag grip.
+          * @default 'Drag to reorder'
+         */
+        "reorderLabel": string;
+        /**
+          * Offers the drag grip. A header cell only.
+          * @default false
+         */
+        "reorderable": boolean;
+        /**
+          * Offers the resize handle. A header cell only.
+          * @default false
+         */
+        "resizable": boolean;
+        /**
+          * Direction currently sorted by; empty when this column is not the active one.
+          * @default ''
+         */
+        "sortDirection": XV_SORT_DIR | '';
+        /**
+          * Offers the sort affordance. A header cell only.
+          * @default false
+         */
+        "sortable": boolean;
+        /**
+          * Tooltip shown on hover. Only a cell that sets it pays for the tooltip component.
+          * @default ''
+         */
+        "tooltip": string;
+        /**
+          * Column width. Read off the header row when the table has no `columns`. Any CSS length.
+          * @default ''
+         */
+        "width": string;
     }
-    interface XvTableV2Expand {
+    /**
+     * One row of a table. Everything it needs is pushed down by `xv-table`, so it never reads the
+     * table's attributes itself — the old row did that on `slotchange` only and went stale.
+     */
+    interface XvTableRow {
         /**
+          * Blocks selection and expansion.
           * @default false
          */
         "disabled": boolean;
         /**
+          * Accessible name of the expand toggle. Set by the table.
+          * @default 'Toggle row'
+         */
+        "expandLabel": string;
+        /**
+          * Whether the row can be expanded. Set by the table.
+          * @default 'none'
+         */
+        "expandMode": XvTableExpandMode;
+        /**
+          * Whether this row has anything to expand. Set by the table.
           * @default false
          */
-        "open": boolean;
-    }
-    interface XvTableV2Row {
-        "checked"?: SelectRowDto['checked'];
-        "disabled"?: boolean;
-        "header"?: boolean;
-        "hover"?: boolean;
-        "name"?: SelectRowDto['name'];
-        "partial"?: SelectRowDto['partial'];
-        "readonly"?: boolean;
-        "required"?: boolean;
-        "value"?: SelectRowDto['value'];
-        "variant"?: 'checkbox' | 'radio' | '';
+        "expandable": boolean;
+        /**
+          * Whether the row's expand panel is open.
+          * @default false
+         */
+        "expanded": boolean;
+        /**
+          * Renders the row as a subtotal or grouping row: no controls, accented background.
+          * @default false
+         */
+        "group": boolean;
+        /**
+          * Whether the row carries `slot="expand"` content. Set by the table.
+          * @default false
+         */
+        "hasPanel": boolean;
+        /**
+          * Marks the row as the table's header. Its cells supply the column labels.
+          * @default false
+         */
+        "header": boolean;
+        /**
+          * Highlights the row on pointer hover. Set by the table.
+          * @default false
+         */
+        "hover": boolean;
+        /**
+          * Value of the row this one belongs to. Child rows are siblings in the same grid, so they keep the table's columns instead of living in a panel of their own.
+          * @default ''
+         */
+        "parent": string;
+        /**
+          * Indeterminate state of the header row's select-all checkbox.
+          * @default false
+         */
+        "partial": boolean;
+        /**
+          * Accessible name of the drag grip. Set by the table.
+          * @default 'Drag to reorder'
+         */
+        "reorderLabel": string;
+        /**
+          * Whether the whole row drags, or only its grip. Set by the table.
+          * @default 'icon'
+         */
+        "rowReorderHandle": 'icon' | 'row';
+        /**
+          * Whether this row can be dragged into a new position. Set by the table.
+          * @default false
+         */
+        "rowReorderable": boolean;
+        /**
+          * Whether the row offers its selection control. A header with no rows under it has nothing to pick.
+          * @default true
+         */
+        "selectable": boolean;
+        /**
+          * Whether the row is selected.
+          * @default false
+         */
+        "selected": boolean;
+        /**
+          * Selection control rendered in the leading cell. Set by the table.
+          * @default 'none'
+         */
+        "selectionMode": XvTableSelectionMode;
+        /**
+          * Row height ladder. Set by the table.
+          * @default SIZE_VAR.MD
+         */
+        "size": SIZE_VAR_STR;
+        /**
+          * Identifies the row in selection and expansion payloads.
+          * @default ''
+         */
+        "value": string | number;
     }
     interface XvTabsV2 {
         /**
@@ -1466,13 +1819,9 @@ export interface XvSliderV2CustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLXvSliderV2Element;
 }
-export interface XvTableV2CellCustomEvent<T> extends CustomEvent<T> {
+export interface XvTableCustomEvent<T> extends CustomEvent<T> {
     detail: T;
-    target: HTMLXvTableV2CellElement;
-}
-export interface XvTableV2RowCustomEvent<T> extends CustomEvent<T> {
-    detail: T;
-    target: HTMLXvTableV2RowElement;
+    target: HTMLXvTableElement;
 }
 export interface XvTabsV2CustomEvent<T> extends CustomEvent<T> {
     detail: T;
@@ -2131,52 +2480,58 @@ declare global {
         prototype: HTMLXvTabV2Element;
         new (): HTMLXvTabV2Element;
     };
-    interface HTMLXvTableV2Element extends Components.XvTableV2, HTMLStencilElement {
-    }
-    var HTMLXvTableV2Element: {
-        prototype: HTMLXvTableV2Element;
-        new (): HTMLXvTableV2Element;
-    };
-    interface HTMLXvTableV2CellElementEventMap {
-        "sortChange": XVTableSortDto;
+    interface HTMLXvTableElementEventMap {
+        "sortChange": XvTableSort;
+        "selectedChange": XvTableSelectionDetail;
+        "expandedChange": XvTableExpandedDetail;
+        "pageChange": XvTablePage;
+        "layoutChange": XvTableLayout;
+        "rowClick": XvTableRowClickDetail;
+        "rowOrderChange": XvTableRowOrder;
     }
-    interface HTMLXvTableV2CellElement extends Components.XvTableV2Cell, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLXvTableV2CellElementEventMap>(type: K, listener: (this: HTMLXvTableV2CellElement, ev: XvTableV2CellCustomEvent<HTMLXvTableV2CellElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+    /**
+     * A data table built on CSS grid with `subgrid` rows, so a row keeps its own box while its cells
+     * stay aligned to the table's columns and an expanded panel can span the full width.
+     * `columns` always describes the structure — widths, order, sorting, resizing, hiding and the
+     * stored layout all read from it. Rows come either from `rows` as data, or as slotted
+     * `xv-table-row` children when the cells hold arbitrary markup.
+     */
+    interface HTMLXvTableElement extends Components.XvTable, HTMLStencilElement {
+        addEventListener<K extends keyof HTMLXvTableElementEventMap>(type: K, listener: (this: HTMLXvTableElement, ev: XvTableCustomEvent<HTMLXvTableElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
         addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLXvTableV2CellElementEventMap>(type: K, listener: (this: HTMLXvTableV2CellElement, ev: XvTableV2CellCustomEvent<HTMLXvTableV2CellElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+        removeEventListener<K extends keyof HTMLXvTableElementEventMap>(type: K, listener: (this: HTMLXvTableElement, ev: XvTableCustomEvent<HTMLXvTableElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
         removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
         removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
         removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
     }
-    var HTMLXvTableV2CellElement: {
-        prototype: HTMLXvTableV2CellElement;
-        new (): HTMLXvTableV2CellElement;
+    var HTMLXvTableElement: {
+        prototype: HTMLXvTableElement;
+        new (): HTMLXvTableElement;
     };
-    interface HTMLXvTableV2ExpandElement extends Components.XvTableV2Expand, HTMLStencilElement {
+    /**
+     * One cell of a table row. It holds arbitrary markup — buttons, links, tags, nested components —
+     * which is why the table stays composed rather than driven only by data.
+     * In a header row it also carries the column affordances: the sort arrow, the drag grip and the
+     * resize handle. The table renders this same component in both modes, so a header written as
+     * markup can do everything a header built from `columns` can.
+     */
+    interface HTMLXvTableCellElement extends Components.XvTableCell, HTMLStencilElement {
     }
-    var HTMLXvTableV2ExpandElement: {
-        prototype: HTMLXvTableV2ExpandElement;
-        new (): HTMLXvTableV2ExpandElement;
+    var HTMLXvTableCellElement: {
+        prototype: HTMLXvTableCellElement;
+        new (): HTMLXvTableCellElement;
     };
-    interface HTMLXvTableV2RowElementEventMap {
-        "checkedChange": SelectRowDto;
-        "selectRow": SelectRowDto;
-    }
-    interface HTMLXvTableV2RowElement extends Components.XvTableV2Row, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLXvTableV2RowElementEventMap>(type: K, listener: (this: HTMLXvTableV2RowElement, ev: XvTableV2RowCustomEvent<HTMLXvTableV2RowElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLXvTableV2RowElementEventMap>(type: K, listener: (this: HTMLXvTableV2RowElement, ev: XvTableV2RowCustomEvent<HTMLXvTableV2RowElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+    /**
+     * One row of a table. Everything it needs is pushed down by `xv-table`, so it never reads the
+     * table's attributes itself — the old row did that on `slotchange` only and went stale.
+     */
+    interface HTMLXvTableRowElement extends Components.XvTableRow, HTMLStencilElement {
     }
-    var HTMLXvTableV2RowElement: {
-        prototype: HTMLXvTableV2RowElement;
-        new (): HTMLXvTableV2RowElement;
+    var HTMLXvTableRowElement: {
+        prototype: HTMLXvTableRowElement;
+        new (): HTMLXvTableRowElement;
     };
     interface HTMLXvTabsV2ElementEventMap {
         "activeChange": number | string;
@@ -2366,10 +2721,9 @@ declare global {
         "xv-radio-v2": HTMLXvRadioV2Element;
         "xv-slider-v2": HTMLXvSliderV2Element;
         "xv-tab-v2": HTMLXvTabV2Element;
-        "xv-table-v2": HTMLXvTableV2Element;
-        "xv-table-v2-cell": HTMLXvTableV2CellElement;
-        "xv-table-v2-expand": HTMLXvTableV2ExpandElement;
-        "xv-table-v2-row": HTMLXvTableV2RowElement;
+        "xv-table": HTMLXvTableElement;
+        "xv-table-cell": HTMLXvTableCellElement;
+        "xv-table-row": HTMLXvTableRowElement;
         "xv-tabs-v2": HTMLXvTabsV2Element;
         "xv-tag-combobox": HTMLXvTagComboboxElement;
         "xv-tag-v2": HTMLXvTagV2Element;
@@ -3499,45 +3853,407 @@ declare namespace LocalJSX {
         "loading"?: boolean;
         "name"?: number | string;
     }
-    interface XvTableV2 {
-        "colsSize"?: (string | null)[];
+    /**
+     * A data table built on CSS grid with `subgrid` rows, so a row keeps its own box while its cells
+     * stay aligned to the table's columns and an expanded panel can span the full width.
+     * `columns` always describes the structure — widths, order, sorting, resizing, hiding and the
+     * stored layout all read from it. Rows come either from `rows` as data, or as slotted
+     * `xv-table-row` children when the cells hold arbitrary markup.
+     */
+    interface XvTable {
+        /**
+          * Stretches the table to the full width of its container.
+          * @default false
+         */
+        "block"?: boolean;
+        /**
+          * Column definitions. Accepts its JSON string form so it is settable from plain markup.
+          * @default []
+         */
+        "columns"?: string | XvTableColumn[];
+        /**
+          * Tooltip on the column picker trigger.
+          * @default 'Columns'
+         */
+        "columnsLabel"?: string;
+        /**
+          * Supporting text under the title.
+          * @default ''
+         */
+        "description"?: string;
+        /**
+          * Shown when there are no rows.
+          * @default ''
+         */
+        "emptyLabel"?: string;
+        /**
+          * Accessible name of a row's expand toggle.
+          * @default 'Toggle row'
+         */
+        "expandLabel"?: string;
+        /**
+          * Whether rows expand, and whether more than one may be open.
+          * @default 'none'
+         */
+        "expandMode"?: XvTableExpandMode;
+        /**
+          * Values of the expanded rows.
+          * @default []
+         */
+        "expanded"?: string | unknown[];
+        /**
+          * Highlights a row on pointer hover.
+          * @default false
+         */
         "hover"?: boolean;
+        /**
+          * Title above the table.
+          * @default ''
+         */
+        "label"?: string;
+        /**
+          * Controlled column layout. Overrides whatever is stored.
+          * @default null
+         */
+        "layout"?: string | XvTableLayout;
+        /**
+          * Covers the body with a loading state.
+          * @default false
+         */
         "loading"?: boolean;
         /**
+          * Locale used for sorting and cell formatting. Falls back to the nearest `[lang]` ancestor.
+          * @default ''
+         */
+        "locale"?: string;
+        /**
+          * Width below which the table scrolls instead of squeezing, at any viewport. Left unset, a table only stops squeezing below 1180px, where it scrolls at the width its columns declared.
+          * @default 0
+         */
+        "minWidth"?: number;
+        /**
+          * Emitted when the set of expanded rows changes.
+         */
+        "onExpandedChange"?: (event: XvTableCustomEvent<XvTableExpandedDetail>) => void;
+        /**
+          * Emitted after a column is resized, reordered, hidden or reset.
+         */
+        "onLayoutChange"?: (event: XvTableCustomEvent<XvTableLayout>) => void;
+        /**
+          * Emitted when the page or the page size changes.
+         */
+        "onPageChange"?: (event: XvTableCustomEvent<XvTablePage>) => void;
+        /**
+          * Emitted when a row is clicked, while `rowClickable` is set.
+         */
+        "onRowClick"?: (event: XvTableCustomEvent<XvTableRowClickDetail>) => void;
+        /**
+          * Emitted when a row is dropped in a new position. The table does not move the row itself — reorder the data and it re-renders, which keeps the DOM and the data from drifting apart.
+         */
+        "onRowOrderChange"?: (event: XvTableCustomEvent<XvTableRowOrder>) => void;
+        /**
+          * Emitted when the set of selected rows changes. Named after the `selected` prop it reports: `selectionChange` is refused by Stencil as a native DOM event name.
+         */
+        "onSelectedChange"?: (event: XvTableCustomEvent<XvTableSelectionDetail>) => void;
+        /**
+          * Emitted when a sortable header is activated.
+         */
+        "onSortChange"?: (event: XvTableCustomEvent<XvTableSort>) => void;
+        /**
+          * Current page, 1-based.
+          * @default 1
+         */
+        "page"?: number;
+        /**
+          * Rows per page.
+          * @default 10
+         */
+        "pageSize"?: number;
+        /**
+          * Page size choices. Accepts a comma-separated attribute.
+          * @default [10, 20, 30, 40, 50, 100]
+         */
+        "pageSizeOptions"?: string | number[];
+        /**
+          * `client` slices the `rows` prop; `server` only emits `pageChange`.
+          * @default 'none'
+         */
+        "paginationMode"?: XvTableMode;
+        /**
+          * Accessible name of a row's drag grip.
+          * @default 'Drag to reorder'
+         */
+        "reorderLabel"?: string;
+        /**
+          * Allows dragging column headers into a new order. Off by default, like `resizable`.
+          * @default false
+         */
+        "reorderable"?: boolean;
+        /**
+          * Text of the button that restores the declared column layout.
+          * @default 'Reset'
+         */
+        "resetLabel"?: string;
+        /**
+          * Allows dragging column edges. Off by default: no handle is rendered and nothing is bound until it is switched on. A column may switch itself off, never on.
+          * @default false
+         */
+        "resizable"?: boolean;
+        /**
+          * Emits `rowClick` when a row is clicked outside an interactive element.
+          * @default false
+         */
+        "rowClickable"?: boolean;
+        /**
+          * Property of a row object that identifies it in selection and expansion payloads.
+          * @default 'id'
+         */
+        "rowKey"?: string;
+        /**
+          * Whether the whole row drags, or only a grip in a leading control cell.
+          * @default 'icon'
+         */
+        "rowReorderHandle"?: 'icon' | 'row';
+        /**
+          * Allows dragging rows into a new order. Off by default: nothing is bound and no handle is rendered until it is switched on.
+          * @default false
+         */
+        "rowReorderable"?: boolean;
+        /**
+          * Row data. Ignored when `xv-table-row` children are slotted.
+          * @default []
+         */
+        "rows"?: string | any[];
+        /**
+          * Values of the selected rows.
+          * @default []
+         */
+        "selected"?: string | unknown[];
+        /**
+          * Text of the batch bar counter. `{count}` is replaced with the number of selected rows.
+          * @default ''
+         */
+        "selectedLabel"?: string;
+        /**
+          * `multiple` renders checkboxes, `single` renders radios.
+          * @default 'none'
+         */
+        "selection"?: XvTableSelectionMode;
+        /**
+          * Row height ladder.
           * @default SIZE_VAR.MD
          */
         "size"?: SIZE_VAR_STR;
+        /**
+          * Placeholder rows drawn while `loading`. Zero draws a spinner instead.
+          * @default 0
+         */
+        "skeletonRows"?: number;
+        /**
+          * Active sort, as `asc(field)` / `desc(field)` or an object.
+          * @default ''
+         */
+        "sortBy"?: string | XvTableSort;
+        /**
+          * `none` makes headers inert whatever the column says; `client` sorts the `rows` prop itself; `server` offers the affordance and only emits `sortChange` for the consumer to reload.
+          * @default 'none'
+         */
+        "sortMode"?: XvTableMode;
+        /**
+          * Keeps the header visible while the body scrolls.
+          * @default false
+         */
+        "stickyHeader"?: boolean;
+        /**
+          * Persists the column layout under this key. Empty means the layout is not remembered.
+          * @default ''
+         */
+        "storageKey"?: string;
+        /**
+          * Scopes the stored layout to a user.
+          * @default 'anonymous'
+         */
+        "storageOwner"?: string;
+        /**
+          * Total row count, for `server` pagination.
+          * @default 0
+         */
+        "total"?: number;
     }
-    interface XvTableV2Cell {
-        "align"?: 'left' | 'right' | 'center';
-        "multiline"?: boolean;
-        "name"?: string;
-        "onSortChange"?: (event: XvTableV2CellCustomEvent<XVTableSortDto>) => void;
-        "sort"?: XV_SORT_DIR | '';
-    }
-    interface XvTableV2Expand {
+    /**
+     * One cell of a table row. It holds arbitrary markup — buttons, links, tags, nested components —
+     * which is why the table stays composed rather than driven only by data.
+     * In a header row it also carries the column affordances: the sort arrow, the drag grip and the
+     * resize handle. The table renders this same component in both modes, so a header written as
+     * markup can do everything a header built from `columns` can.
+     */
+    interface XvTableCell {
+        /**
+          * Horizontal alignment of the content.
+          * @default 'start'
+         */
+        "align"?: XvCellAlign;
         /**
+          * Lines kept before clamping, when `overflow` is `clamp`.
+          * @default 2
+         */
+        "clampLines"?: number;
+        /**
+          * Column this cell belongs to. Identifies it for sorting, resizing and the stored layout.
+          * @default ''
+         */
+        "columnId"?: string;
+        /**
+          * Renders the cell as a column header. Set by the table from the row it sits in.
           * @default false
          */
-        "disabled"?: boolean;
+        "header"?: boolean;
         /**
+          * Lets the column picker hide this column. A header cell only.
           * @default false
          */
-        "open"?: boolean;
+        "hideable"?: boolean;
+        /**
+          * How content wider than the column behaves.
+          * @default 'ellipsis'
+         */
+        "overflow"?: XvCellOverflow;
+        /**
+          * Accessible name of the drag grip.
+          * @default 'Drag to reorder'
+         */
+        "reorderLabel"?: string;
+        /**
+          * Offers the drag grip. A header cell only.
+          * @default false
+         */
+        "reorderable"?: boolean;
+        /**
+          * Offers the resize handle. A header cell only.
+          * @default false
+         */
+        "resizable"?: boolean;
+        /**
+          * Direction currently sorted by; empty when this column is not the active one.
+          * @default ''
+         */
+        "sortDirection"?: XV_SORT_DIR | '';
+        /**
+          * Offers the sort affordance. A header cell only.
+          * @default false
+         */
+        "sortable"?: boolean;
+        /**
+          * Tooltip shown on hover. Only a cell that sets it pays for the tooltip component.
+          * @default ''
+         */
+        "tooltip"?: string;
+        /**
+          * Column width. Read off the header row when the table has no `columns`. Any CSS length.
+          * @default ''
+         */
+        "width"?: string;
     }
-    interface XvTableV2Row {
-        "checked"?: SelectRowDto['checked'];
+    /**
+     * One row of a table. Everything it needs is pushed down by `xv-table`, so it never reads the
+     * table's attributes itself — the old row did that on `slotchange` only and went stale.
+     */
+    interface XvTableRow {
+        /**
+          * Blocks selection and expansion.
+          * @default false
+         */
         "disabled"?: boolean;
+        /**
+          * Accessible name of the expand toggle. Set by the table.
+          * @default 'Toggle row'
+         */
+        "expandLabel"?: string;
+        /**
+          * Whether the row can be expanded. Set by the table.
+          * @default 'none'
+         */
+        "expandMode"?: XvTableExpandMode;
+        /**
+          * Whether this row has anything to expand. Set by the table.
+          * @default false
+         */
+        "expandable"?: boolean;
+        /**
+          * Whether the row's expand panel is open.
+          * @default false
+         */
+        "expanded"?: boolean;
+        /**
+          * Renders the row as a subtotal or grouping row: no controls, accented background.
+          * @default false
+         */
+        "group"?: boolean;
+        /**
+          * Whether the row carries `slot="expand"` content. Set by the table.
+          * @default false
+         */
+        "hasPanel"?: boolean;
+        /**
+          * Marks the row as the table's header. Its cells supply the column labels.
+          * @default false
+         */
         "header"?: boolean;
+        /**
+          * Highlights the row on pointer hover. Set by the table.
+          * @default false
+         */
         "hover"?: boolean;
-        "name"?: SelectRowDto['name'];
-        "onCheckedChange"?: (event: XvTableV2RowCustomEvent<SelectRowDto>) => void;
-        "onSelectRow"?: (event: XvTableV2RowCustomEvent<SelectRowDto>) => void;
-        "partial"?: SelectRowDto['partial'];
-        "readonly"?: boolean;
-        "required"?: boolean;
-        "value"?: SelectRowDto['value'];
-        "variant"?: 'checkbox' | 'radio' | '';
+        /**
+          * Value of the row this one belongs to. Child rows are siblings in the same grid, so they keep the table's columns instead of living in a panel of their own.
+          * @default ''
+         */
+        "parent"?: string;
+        /**
+          * Indeterminate state of the header row's select-all checkbox.
+          * @default false
+         */
+        "partial"?: boolean;
+        /**
+          * Accessible name of the drag grip. Set by the table.
+          * @default 'Drag to reorder'
+         */
+        "reorderLabel"?: string;
+        /**
+          * Whether the whole row drags, or only its grip. Set by the table.
+          * @default 'icon'
+         */
+        "rowReorderHandle"?: 'icon' | 'row';
+        /**
+          * Whether this row can be dragged into a new position. Set by the table.
+          * @default false
+         */
+        "rowReorderable"?: boolean;
+        /**
+          * Whether the row offers its selection control. A header with no rows under it has nothing to pick.
+          * @default true
+         */
+        "selectable"?: boolean;
+        /**
+          * Whether the row is selected.
+          * @default false
+         */
+        "selected"?: boolean;
+        /**
+          * Selection control rendered in the leading cell. Set by the table.
+          * @default 'none'
+         */
+        "selectionMode"?: XvTableSelectionMode;
+        /**
+          * Row height ladder. Set by the table.
+          * @default SIZE_VAR.MD
+         */
+        "size"?: SIZE_VAR_STR;
+        /**
+          * Identifies the row in selection and expansion payloads.
+          * @default ''
+         */
+        "value"?: string | number;
     }
     interface XvTabsV2 {
         /**
@@ -4129,32 +4845,81 @@ declare namespace LocalJSX {
         "loading": boolean;
         "name": string;
     }
-    interface XvTableV2Attributes {
+    interface XvTableAttributes {
+        "columns": string | XvTableColumn[];
+        "rows": string | any[];
+        "rowKey": string;
         "size": SIZE_VAR_STR;
-        "hover": boolean;
+        "block": boolean;
         "loading": boolean;
+        "skeletonRows": number;
+        "hover": boolean;
+        "rowClickable": boolean;
+        "label": string;
+        "description": string;
+        "emptyLabel": string;
+        "selectedLabel": string;
+        "columnsLabel": string;
+        "resetLabel": string;
+        "expandLabel": string;
+        "reorderLabel": string;
+        "sortMode": XvTableMode;
+        "sortBy": string | XvTableSort;
+        "selection": XvTableSelectionMode;
+        "selected": string | unknown[];
+        "expandMode": XvTableExpandMode;
+        "expanded": string | unknown[];
+        "paginationMode": XvTableMode;
+        "page": number;
+        "pageSize": number;
+        "total": number;
+        "pageSizeOptions": string | number[];
+        "resizable": boolean;
+        "reorderable": boolean;
+        "rowReorderable": boolean;
+        "rowReorderHandle": 'icon' | 'row';
+        "stickyHeader": boolean;
+        "minWidth": number;
+        "storageKey": string;
+        "storageOwner": string;
+        "layout": string | XvTableLayout;
+        "locale": string;
     }
-    interface XvTableV2CellAttributes {
-        "multiline": boolean;
-        "name": string;
-        "align": 'left' | 'right' | 'center';
-        "sort": XV_SORT_DIR | '';
-    }
-    interface XvTableV2ExpandAttributes {
-        "open": boolean;
-        "disabled": boolean;
+    interface XvTableCellAttributes {
+        "columnId": string;
+        "align": XvCellAlign;
+        "overflow": XvCellOverflow;
+        "clampLines": number;
+        "tooltip": string;
+        "width": string;
+        "header": boolean;
+        "sortable": boolean;
+        "sortDirection": XV_SORT_DIR | '';
+        "hideable": boolean;
+        "resizable": boolean;
+        "reorderable": boolean;
+        "reorderLabel": string;
     }
-    interface XvTableV2RowAttributes {
-        "checked": SelectRowDto['checked'];
-        "partial": SelectRowDto['partial'];
-        "name": SelectRowDto['name'];
+    interface XvTableRowAttributes {
         "value": string;
+        "selectionMode": XvTableSelectionMode;
+        "expandMode": XvTableExpandMode;
+        "selectable": boolean;
+        "size": SIZE_VAR_STR;
+        "selected": boolean;
+        "partial": boolean;
+        "expanded": boolean;
+        "parent": string;
+        "expandable": boolean;
+        "hasPanel": boolean;
+        "group": boolean;
+        "header": boolean;
         "hover": boolean;
-        "readonly": boolean;
-        "required": boolean;
         "disabled": boolean;
-        "header": boolean;
-        "variant": 'checkbox' | 'radio' | '';
+        "rowReorderable": boolean;
+        "rowReorderHandle": 'icon' | 'row';
+        "expandLabel": string;
+        "reorderLabel": string;
     }
     interface XvTabsV2Attributes {
         "active": string;
@@ -4295,10 +5060,9 @@ declare namespace LocalJSX {
         "xv-radio-v2": Omit<XvRadioV2, keyof XvRadioV2Attributes> & { [K in keyof XvRadioV2 & keyof XvRadioV2Attributes]?: XvRadioV2[K] } & { [K in keyof XvRadioV2 & keyof XvRadioV2Attributes as `attr:${K}`]?: XvRadioV2Attributes[K] } & { [K in keyof XvRadioV2 & keyof XvRadioV2Attributes as `prop:${K}`]?: XvRadioV2[K] };
         "xv-slider-v2": Omit<XvSliderV2, keyof XvSliderV2Attributes> & { [K in keyof XvSliderV2 & keyof XvSliderV2Attributes]?: XvSliderV2[K] } & { [K in keyof XvSliderV2 & keyof XvSliderV2Attributes as `attr:${K}`]?: XvSliderV2Attributes[K] } & { [K in keyof XvSliderV2 & keyof XvSliderV2Attributes as `prop:${K}`]?: XvSliderV2[K] };
         "xv-tab-v2": Omit<XvTabV2, keyof XvTabV2Attributes> & { [K in keyof XvTabV2 & keyof XvTabV2Attributes]?: XvTabV2[K] } & { [K in keyof XvTabV2 & keyof XvTabV2Attributes as `attr:${K}`]?: XvTabV2Attributes[K] } & { [K in keyof XvTabV2 & keyof XvTabV2Attributes as `prop:${K}`]?: XvTabV2[K] };
-        "xv-table-v2": Omit<XvTableV2, keyof XvTableV2Attributes> & { [K in keyof XvTableV2 & keyof XvTableV2Attributes]?: XvTableV2[K] } & { [K in keyof XvTableV2 & keyof XvTableV2Attributes as `attr:${K}`]?: XvTableV2Attributes[K] } & { [K in keyof XvTableV2 & keyof XvTableV2Attributes as `prop:${K}`]?: XvTableV2[K] };
-        "xv-table-v2-cell": Omit<XvTableV2Cell, keyof XvTableV2CellAttributes> & { [K in keyof XvTableV2Cell & keyof XvTableV2CellAttributes]?: XvTableV2Cell[K] } & { [K in keyof XvTableV2Cell & keyof XvTableV2CellAttributes as `attr:${K}`]?: XvTableV2CellAttributes[K] } & { [K in keyof XvTableV2Cell & keyof XvTableV2CellAttributes as `prop:${K}`]?: XvTableV2Cell[K] };
-        "xv-table-v2-expand": Omit<XvTableV2Expand, keyof XvTableV2ExpandAttributes> & { [K in keyof XvTableV2Expand & keyof XvTableV2ExpandAttributes]?: XvTableV2Expand[K] } & { [K in keyof XvTableV2Expand & keyof XvTableV2ExpandAttributes as `attr:${K}`]?: XvTableV2ExpandAttributes[K] } & { [K in keyof XvTableV2Expand & keyof XvTableV2ExpandAttributes as `prop:${K}`]?: XvTableV2Expand[K] };
-        "xv-table-v2-row": Omit<XvTableV2Row, keyof XvTableV2RowAttributes> & { [K in keyof XvTableV2Row & keyof XvTableV2RowAttributes]?: XvTableV2Row[K] } & { [K in keyof XvTableV2Row & keyof XvTableV2RowAttributes as `attr:${K}`]?: XvTableV2RowAttributes[K] } & { [K in keyof XvTableV2Row & keyof XvTableV2RowAttributes as `prop:${K}`]?: XvTableV2Row[K] };
+        "xv-table": Omit<XvTable, keyof XvTableAttributes> & { [K in keyof XvTable & keyof XvTableAttributes]?: XvTable[K] } & { [K in keyof XvTable & keyof XvTableAttributes as `attr:${K}`]?: XvTableAttributes[K] } & { [K in keyof XvTable & keyof XvTableAttributes as `prop:${K}`]?: XvTable[K] };
+        "xv-table-cell": Omit<XvTableCell, keyof XvTableCellAttributes> & { [K in keyof XvTableCell & keyof XvTableCellAttributes]?: XvTableCell[K] } & { [K in keyof XvTableCell & keyof XvTableCellAttributes as `attr:${K}`]?: XvTableCellAttributes[K] } & { [K in keyof XvTableCell & keyof XvTableCellAttributes as `prop:${K}`]?: XvTableCell[K] };
+        "xv-table-row": Omit<XvTableRow, keyof XvTableRowAttributes> & { [K in keyof XvTableRow & keyof XvTableRowAttributes]?: XvTableRow[K] } & { [K in keyof XvTableRow & keyof XvTableRowAttributes as `attr:${K}`]?: XvTableRowAttributes[K] } & { [K in keyof XvTableRow & keyof XvTableRowAttributes as `prop:${K}`]?: XvTableRow[K] };
         "xv-tabs-v2": Omit<XvTabsV2, keyof XvTabsV2Attributes> & { [K in keyof XvTabsV2 & keyof XvTabsV2Attributes]?: XvTabsV2[K] } & { [K in keyof XvTabsV2 & keyof XvTabsV2Attributes as `attr:${K}`]?: XvTabsV2Attributes[K] } & { [K in keyof XvTabsV2 & keyof XvTabsV2Attributes as `prop:${K}`]?: XvTabsV2[K] };
         "xv-tag-combobox": Omit<XvTagCombobox, keyof XvTagComboboxAttributes> & { [K in keyof XvTagCombobox & keyof XvTagComboboxAttributes]?: XvTagCombobox[K] } & { [K in keyof XvTagCombobox & keyof XvTagComboboxAttributes as `attr:${K}`]?: XvTagComboboxAttributes[K] } & { [K in keyof XvTagCombobox & keyof XvTagComboboxAttributes as `prop:${K}`]?: XvTagCombobox[K] };
         "xv-tag-v2": Omit<XvTagV2, keyof XvTagV2Attributes> & { [K in keyof XvTagV2 & keyof XvTagV2Attributes]?: XvTagV2[K] } & { [K in keyof XvTagV2 & keyof XvTagV2Attributes as `attr:${K}`]?: XvTagV2Attributes[K] } & { [K in keyof XvTagV2 & keyof XvTagV2Attributes as `prop:${K}`]?: XvTagV2[K] };
@@ -4425,10 +5189,27 @@ declare module "@stencil/core" {
             "xv-radio-v2": LocalJSX.IntrinsicElements["xv-radio-v2"] & JSXBase.HTMLAttributes<HTMLXvRadioV2Element>;
             "xv-slider-v2": LocalJSX.IntrinsicElements["xv-slider-v2"] & JSXBase.HTMLAttributes<HTMLXvSliderV2Element>;
             "xv-tab-v2": LocalJSX.IntrinsicElements["xv-tab-v2"] & JSXBase.HTMLAttributes<HTMLXvTabV2Element>;
-            "xv-table-v2": LocalJSX.IntrinsicElements["xv-table-v2"] & JSXBase.HTMLAttributes<HTMLXvTableV2Element>;
-            "xv-table-v2-cell": LocalJSX.IntrinsicElements["xv-table-v2-cell"] & JSXBase.HTMLAttributes<HTMLXvTableV2CellElement>;
-            "xv-table-v2-expand": LocalJSX.IntrinsicElements["xv-table-v2-expand"] & JSXBase.HTMLAttributes<HTMLXvTableV2ExpandElement>;
-            "xv-table-v2-row": LocalJSX.IntrinsicElements["xv-table-v2-row"] & JSXBase.HTMLAttributes<HTMLXvTableV2RowElement>;
+            /**
+             * A data table built on CSS grid with `subgrid` rows, so a row keeps its own box while its cells
+             * stay aligned to the table's columns and an expanded panel can span the full width.
+             * `columns` always describes the structure — widths, order, sorting, resizing, hiding and the
+             * stored layout all read from it. Rows come either from `rows` as data, or as slotted
+             * `xv-table-row` children when the cells hold arbitrary markup.
+             */
+            "xv-table": LocalJSX.IntrinsicElements["xv-table"] & JSXBase.HTMLAttributes<HTMLXvTableElement>;
+            /**
+             * One cell of a table row. It holds arbitrary markup — buttons, links, tags, nested components —
+             * which is why the table stays composed rather than driven only by data.
+             * In a header row it also carries the column affordances: the sort arrow, the drag grip and the
+             * resize handle. The table renders this same component in both modes, so a header written as
+             * markup can do everything a header built from `columns` can.
+             */
+            "xv-table-cell": LocalJSX.IntrinsicElements["xv-table-cell"] & JSXBase.HTMLAttributes<HTMLXvTableCellElement>;
+            /**
+             * One row of a table. Everything it needs is pushed down by `xv-table`, so it never reads the
+             * table's attributes itself — the old row did that on `slotchange` only and went stale.
+             */
+            "xv-table-row": LocalJSX.IntrinsicElements["xv-table-row"] & JSXBase.HTMLAttributes<HTMLXvTableRowElement>;
             "xv-tabs-v2": LocalJSX.IntrinsicElements["xv-tabs-v2"] & JSXBase.HTMLAttributes<HTMLXvTabsV2Element>;
             "xv-tag-combobox": LocalJSX.IntrinsicElements["xv-tag-combobox"] & JSXBase.HTMLAttributes<HTMLXvTagComboboxElement>;
             "xv-tag-v2": LocalJSX.IntrinsicElements["xv-tag-v2"] & JSXBase.HTMLAttributes<HTMLXvTagV2Element>;