@theseam/ui-common 1.0.2-beta.83 → 1.0.2-beta.84

package/fesm2022/theseam-ui-common-datatable.mjs

@@ -1,6 +1,6 @@
 import { __decorate } from 'tslib';
 import { trigger, transition, style, animate } from '@angular/animations';
-import { coerceArray } from '@angular/cdk/coercion';
+import { coerceArray, coerceBooleanProperty } from '@angular/cdk/coercion';
 import { DataSource, isDataSource } from '@angular/cdk/collections';
 import * as i0 from '@angular/core';
 import { EventEmitter, Output, Input, ChangeDetectionStrategy, Component, ContentChildren, ViewChild, Directive, Injectable, inject, TemplateRef, ContentChild, Self, Inject, forwardRef, InjectionToken, Optional, isDevMode, input, ChangeDetectorRef, ElementRef, HostListener, HostBinding, NgModule } from '@angular/core';
@@ -14,7 +14,7 @@ import { InputBoolean, InputNumber } from '@theseam/ui-common/core';
 import { THESEAM_DATA_FILTER, THESEAM_DATA_FILTER_CONTAINER, composeDataFilterStates, composeDataFilters, TheSeamDataFiltersModule } from '@theseam/ui-common/data-filters';
 import { notNullOrUndefined, isNullOrUndefined, isNullOrUndefinedOrEmpty, notNullOrUndefinedOrEmpty, hasProperty, arrayMoveMutable, waitOnConditionAsync, observeControlValue } from '@theseam/ui-common/utils';
 import * as i4 from '@theseam/ui-common/menu';
-import { MenuComponent, TheSeamMenuModule } from '@theseam/ui-common/menu';
+import { MenuComponent, TheSeamMenuModule, TheSeamMenuHarness } from '@theseam/ui-common/menu';
 import * as i1 from '@theseam/ui-common/confirm-dialog';
 import { TheSeamConfirmDialogModule } from '@theseam/ui-common/confirm-dialog';
 import * as i2 from '@angular/router';
@@ -41,7 +41,7 @@ import { NgSelectModule } from '@ng-select/ng-select';
 import * as i4$1 from '@theseam/ui-common/form-field';
 import { TheSeamFormFieldModule } from '@theseam/ui-common/form-field';
 import * as i4$2 from '@theseam/ui-common/checkbox';
-import { TheSeamCheckboxComponent } from '@theseam/ui-common/checkbox';
+import { TheSeamCheckboxComponent, TheSeamCheckboxHarness } from '@theseam/ui-common/checkbox';
 import * as i3$2 from '@theseam/ui-common/dynamic';
 import { THESEAM_DYNAMIC_DATA } from '@theseam/ui-common/dynamic';
 import * as i1$3 from 'ngx-toastr';
@@ -58,6 +58,8 @@ import { OverlayModule } from '@angular/cdk/overlay';
 import * as i1$6 from '@theseam/ui-common/scrollbar';
 import { A11yModule } from '@angular/cdk/a11y';
 import { TheSeamToggleGroupModule } from '@theseam/ui-common/toggle-group';
+import { ComponentHarness, HarnessPredicate, ContentContainerComponentHarness } from '@angular/cdk/testing';
+import { TheSeamNgSelectHarness } from '@theseam/ui-common/testing';
 
 class DatatableActionMenuItemComponent {
     label;
@@ -4619,9 +4621,671 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.15", ngImpo
                 }]
         }] });
 
+const SIMPLE_COLUMNS = [
+    { prop: 'name', name: 'Name' },
+    { prop: 'age', name: 'Age' },
+    { prop: 'color', name: 'Color' },
+];
+const SIMPLE_ROWS = [
+    { name: 'Mark', age: 27, color: 'blue' },
+    { name: 'Joe', age: 33, color: 'green' },
+    { name: 'Alice', age: 30, color: 'red' },
+    { name: 'Bill', age: 40, color: 'orange' },
+    { name: 'Sally', age: 25, color: 'purple' },
+];
+const FILTERABLE_COLUMNS = [
+    { prop: 'name', name: 'Name', filterable: true },
+    {
+        prop: 'age',
+        name: 'Age',
+        filterable: true,
+        filterOptions: { filterType: 'search-numeric' },
+    },
+    {
+        prop: 'startDate',
+        name: 'Start Date',
+        cellType: 'date',
+        cellTypeConfig: { type: 'date' },
+        filterable: true,
+        filterOptions: { dateType: 'date' },
+    },
+    { prop: 'color', name: 'Favorite Color', filterable: true },
+    {
+        prop: 'candy',
+        name: 'Favorite Candy',
+        filterable: true,
+        filterOptions: {
+            filterProp: 'candyAttributes',
+            filterType: 'search-candy',
+        },
+    },
+];
+const FILTERABLE_ROWS = [
+    {
+        name: 'Mark',
+        age: 27,
+        color: 'blue',
+        candy: 'Reeses',
+        candyAttributes: ['chocolatey', 'nutty'],
+        startDate: '2017-01-21 20:15:20.4166667 +00:00',
+    },
+    {
+        name: 'Joe',
+        age: 33,
+        color: 'green',
+        candy: 'Hershey Bar',
+        candyAttributes: ['chocolatey'],
+        startDate: '2012-04-25 17:29:36.4266667 +00:00',
+    },
+    {
+        name: 'Shelby',
+        age: 30,
+        color: 'purple',
+        candy: 'Snickers',
+        candyAttributes: ['chocolatey', 'nutty'],
+        startDate: '2020-11-18 20:47:25.1733333 +00:00',
+    },
+    {
+        name: 'Jason',
+        age: 'abc',
+        color: 'orange',
+        candy: 'Whoppers',
+        candyAttributes: ['chocolatey'],
+        startDate: '2016-05-24 23:13:26.3400000 +00:00',
+    },
+    {
+        name: 'David',
+        age: null,
+        color: 'blue',
+        candy: 'Skittles',
+        candyAttributes: ['fruity'],
+        startDate: '2021-06-29 16:31:37.2733333 +00:00',
+    },
+    {
+        name: 'Pam',
+        age: null,
+        color: 'red',
+        candy: 'Starbursts',
+        candyAttributes: ['fruity'],
+        startDate: '2012-08-11 04:00:00.000000 +00:00',
+    },
+    {
+        name: 'New Employee',
+        age: null,
+        color: null,
+        candy: null,
+        candyAttributes: undefined,
+        startDate: null,
+    },
+];
+function createRows(count) {
+    const colors = ['blue', 'green', 'red', 'orange', 'purple', 'grey'];
+    return Array.from({ length: count }, (_, i) => ({
+        name: `Person ${i + 1}`,
+        age: 20 + (i % 50),
+        color: colors[i % colors.length],
+    }));
+}
+
+class TheSeamDatatableActionMenuHarness extends ComponentHarness {
+    static hostSelector = 'seam-datatable-action-menu';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    async _getMenuHarness() {
+        return this.locatorFor(TheSeamMenuHarness)();
+    }
+    /** Whether the action menu is open. */
+    async isOpen() {
+        return (await this._getMenuHarness()).isOpen();
+    }
+    /** Opens the action menu. */
+    async open() {
+        return (await this._getMenuHarness()).open();
+    }
+    /** Closes the action menu. */
+    async close() {
+        return (await this._getMenuHarness()).close();
+    }
+    /**
+     * Gets the menu items in the action menu.
+     * The menu must be opened first (call `open()`) or use `clickItem()` which opens automatically.
+     */
+    async getItems(filters) {
+        return (await this._getMenuHarness()).getItems(filters);
+    }
+    /**
+     * Opens the menu and clicks an item by text.
+     * Supports sub-menu navigation via additional filter arguments.
+     */
+    async clickItem(itemFilter, ...subItemFilters) {
+        return (await this._getMenuHarness()).clickItem(itemFilter, ...subItemFilters);
+    }
+}
+
+class TheSeamDatatableCellHarness extends ComponentHarness {
+    static hostSelector = '.datatable-body-cell';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options).addOption('text', options.text, (harness, text) => HarnessPredicate.stringMatches(harness.getText(), text));
+    }
+    /** Gets the text content of the cell. */
+    async getText() {
+        return (await this.host()).text();
+    }
+    /** Clicks the cell. */
+    async click() {
+        return (await this.host()).click();
+    }
+    /**
+     * Gets a child harness of the given type from within this cell.
+     * Useful for retrieving cell-type harnesses (e.g., currency, date, icon).
+     *
+     * Returns `null` if no matching harness is found.
+     */
+    async getCellTypeHarness(harnessType) {
+        return this.locatorForOptional(harnessType)();
+    }
+}
+
+class TheSeamDatatableColumnFilterMenuHarness extends ComponentHarness {
+    static hostSelector = 'seam-datatable-column-filter-menu';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    /** Gets the filter type by checking which sub-component is rendered. */
+    async getFilterType() {
+        if ((await this.locatorForOptional('seam-datatable-column-filter-search-text')()) !== null) {
+            return 'search-text';
+        }
+        if ((await this.locatorForOptional('seam-datatable-column-filter-search-numeric')()) !== null) {
+            return 'search-numeric';
+        }
+        if ((await this.locatorForOptional('seam-datatable-column-filter-search-date')()) !== null) {
+            return 'search-date';
+        }
+        return 'custom';
+    }
+    /** Gets the search type ng-select harness. */
+    async getSearchTypeSelect() {
+        return this.locatorFor(TheSeamNgSelectHarness)();
+    }
+    /** Gets the current search type value (e.g. "Contains", "Equals", "Between"). */
+    async getSearchType() {
+        const select = await this.getSearchTypeSelect();
+        return select.getValue();
+    }
+    /**
+     * Selects a search type from the dropdown by its displayed label
+     * (e.g. `'Before'`, `'Contains'`, `'Between'`).
+     *
+     * Note: this matches the visible option text, not the underlying form value
+     * (e.g. pass `'Before'` not `'lt'`).
+     */
+    async selectSearchType(label) {
+        const select = await this.getSearchTypeSelect();
+        await select.clickOption({ label });
+    }
+    /** Gets the primary search input (formControlName="searchText"). */
+    async getSearchInput() {
+        return this.locatorForOptional('input[formcontrolname="searchText"]')();
+    }
+    /** Gets the range start input (formControlName="fromText"). */
+    async getRangeStartInput() {
+        return this.locatorForOptional('input[formcontrolname="fromText"]')();
+    }
+    /** Gets the range end input (formControlName="toText"). */
+    async getRangeEndInput() {
+        return this.locatorForOptional('input[formcontrolname="toText"]')();
+    }
+    /**
+     * Sets the primary search value.
+     * Clears any existing value first, then types the new value.
+     */
+    async setSearchValue(value) {
+        const input = await this.getSearchInput();
+        if (!input) {
+            throw Error('Search input not found. The current search type may not have a text input.');
+        }
+        await input.clear();
+        await input.sendKeys(value);
+    }
+    /**
+     * Sets the range values (for "Between" search types on numeric/date filters).
+     */
+    async setRangeValues(from, to) {
+        const fromInput = await this.getRangeStartInput();
+        const toInput = await this.getRangeEndInput();
+        if (!fromInput || !toInput) {
+            throw Error('Range inputs not found. The current search type may not support range values.');
+        }
+        await fromInput.clear();
+        await fromInput.sendKeys(from);
+        await toInput.clear();
+        await toInput.sendKeys(to);
+    }
+    /** Clicks the "Clear" button to reset the filter. */
+    async clear() {
+        const buttons = await this.locatorForAll('button')();
+        for (const btn of buttons) {
+            if ((await btn.text()).trim() === 'Clear') {
+                return btn.click();
+            }
+        }
+        throw Error('Clear button not found.');
+    }
+    /** Clicks the "Apply" button (only present in submit mode). */
+    async apply() {
+        const submitBtn = await this.locatorForOptional('button[type="submit"]')();
+        if (!submitBtn) {
+            throw Error('Apply button not found. The filter may be using valueChanges mode.');
+        }
+        return submitBtn.click();
+    }
+    /** Whether the "Apply" button is present (submit mode). */
+    async hasApplyButton() {
+        return (await this.locatorForOptional('button[type="submit"]')()) !== null;
+    }
+    /** Whether the "Clear" button is disabled (filter is already at default). */
+    async isClearDisabled() {
+        const buttons = await this.locatorForAll('button')();
+        for (const btn of buttons) {
+            if ((await btn.text()).trim() === 'Clear') {
+                const disabled = await btn.getAttribute('disabled');
+                return disabled !== null;
+            }
+        }
+        throw Error('Clear button not found.');
+    }
+}
+
+class TheSeamDatatableColumnPreferencesButtonHarness extends ComponentHarness {
+    static hostSelector = 'seam-datatable-column-preferences-button';
+    _documentRootLocator = this.documentRootLocatorFactory();
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    async _getMenuHarness() {
+        return this.locatorFor(TheSeamMenuHarness)();
+    }
+    /** Opens the preferences menu by clicking the button. */
+    async open() {
+        return (await this._getMenuHarness()).open();
+    }
+    /** Closes the preferences menu. */
+    async close() {
+        return (await this._getMenuHarness()).close();
+    }
+    /** Whether the preferences menu is open. */
+    async isOpen() {
+        return (await this._getMenuHarness()).isOpen();
+    }
+    /**
+     * Opens the "Show/Hide Columns" popover and returns the checkbox harnesses
+     * for each column. The checkboxes are rendered inside a CDK overlay popover.
+     */
+    async getColumnCheckboxes() {
+        await this.open();
+        const menu = await this._getMenuHarness();
+        const items = await menu.getItems({ text: /Show\/Hide Columns/ });
+        if (items.length === 0) {
+            throw Error('"Show/Hide Columns" menu item not found.');
+        }
+        await items[0].click();
+        // The column preferences component renders in a popover (CDK overlay)
+        return this._documentRootLocator.locatorForAll(TheSeamCheckboxHarness)();
+    }
+    /**
+     * Toggles a column's visibility by name.
+     * Opens the Show/Hide Columns popover and clicks the matching checkbox.
+     */
+    async toggleColumn(name) {
+        const checkboxes = await this.getColumnCheckboxes();
+        for (const checkbox of checkboxes) {
+            const host = await checkbox.host();
+            const text = await host.text();
+            const matches = typeof name === 'string' ? text.trim() === name : name.test(text.trim());
+            if (matches) {
+                await checkbox.click();
+                return;
+            }
+        }
+        throw Error(`Column checkbox matching "${name}" not found.`);
+    }
+    /** Clicks the "Reset Columns" menu item. */
+    async resetColumns() {
+        const menu = await this._getMenuHarness();
+        await menu.clickItem({ text: /Reset Columns/ });
+    }
+}
+
+class TheSeamDatatableExportButtonHarness extends ComponentHarness {
+    static hostSelector = 'seam-datatable-export-button';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    async _getMenuHarness() {
+        return this.locatorFor(TheSeamMenuHarness)();
+    }
+    /** Opens the export menu. */
+    async open() {
+        return (await this._getMenuHarness()).open();
+    }
+    /** Closes the export menu. */
+    async close() {
+        return (await this._getMenuHarness()).close();
+    }
+    /** Whether the export menu is open. */
+    async isOpen() {
+        return (await this._getMenuHarness()).isOpen();
+    }
+    /** Whether the export button is disabled. */
+    async isDisabled() {
+        return (await this._getMenuHarness()).isDisabled();
+    }
+    /** Gets the exporter menu items. The menu must be opened first or use `clickExporter()`. */
+    async getExporters(filters) {
+        return (await this._getMenuHarness()).getItems(filters);
+    }
+    /** Opens the menu and clicks an exporter by label. */
+    async clickExporter(label) {
+        return (await this._getMenuHarness()).clickItem({ text: label });
+    }
+}
+
+class TheSeamDatatableHeaderCellHarness extends ComponentHarness {
+    static hostSelector = '.datatable-header-cell';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options)
+            .addOption('name', options.name, (harness, name) => HarnessPredicate.stringMatches(harness.getName(), name))
+            .addOption('sortDirection', options.sortDirection, async (harness, dir) => (await harness.getSortDirection()) === dir);
+    }
+    /** Gets the column name text. */
+    async getName() {
+        const sortBtn = await this.locatorForOptional('.datatable-sort-target')();
+        if (sortBtn) {
+            return sortBtn.text();
+        }
+        // Fallback: get text from the header cell itself
+        return (await this.host()).text();
+    }
+    /** Gets the current sort direction of this column. */
+    async getSortDirection() {
+        const host = await this.host();
+        if (await host.hasClass('sort-asc')) {
+            return 'asc';
+        }
+        if (await host.hasClass('sort-desc')) {
+            return 'desc';
+        }
+        return 'none';
+    }
+    /** Whether this column is sortable. */
+    async isSortable() {
+        return (await this.host()).hasClass('sortable');
+    }
+    /** Clicks the sort button to cycle the sort direction. */
+    async sort() {
+        const sortBtn = await this.locatorForOptional('.datatable-sort-target')();
+        if (sortBtn) {
+            return sortBtn.click();
+        }
+        // Fallback: click the header cell itself
+        return (await this.host()).click();
+    }
+    /** Whether this column has a filter button. */
+    async isFilterable() {
+        const filterBtn = await this.locatorForOptional('.datatable-column-header-filter-button')();
+        return filterBtn !== null;
+    }
+    /** Whether the column filter is currently active. */
+    async isFilterActive() {
+        const filterBtn = await this.locatorForOptional('.datatable-column-header-filter-button')();
+        if (!filterBtn) {
+            return false;
+        }
+        return filterBtn.hasClass('datatable-column-header-filter-button-active');
+    }
+    /** Opens the column filter menu by clicking the filter button. */
+    async openFilter() {
+        const filterBtn = await this.locatorForOptional('.datatable-column-header-filter-button')();
+        if (!filterBtn) {
+            throw Error('This column does not have a filter button.');
+        }
+        return filterBtn.click();
+    }
+    /**
+     * Opens the filter and returns the filter menu harness.
+     * The filter menu renders in a CDK overlay, so this uses the document root locator.
+     */
+    async getFilterMenu() {
+        await this.openFilter();
+        const rootLocator = this.documentRootLocatorFactory();
+        const menu = await rootLocator.locatorForOptional(TheSeamDatatableColumnFilterMenuHarness)();
+        if (!menu) {
+            throw Error('Column filter menu not found after opening. It may not have rendered yet.');
+        }
+        return menu;
+    }
+    /** Whether this header cell is a checkbox column (select-all). */
+    async isCheckboxColumn() {
+        const checkbox = await this.locatorForOptional('.datatable-checkbox input[type="checkbox"]')();
+        return checkbox !== null;
+    }
+    /** Clicks the select-all checkbox in this header cell. */
+    async clickCheckbox() {
+        const checkbox = await this.locatorForOptional('.datatable-checkbox input[type="checkbox"]')();
+        if (!checkbox) {
+            throw Error('This header cell does not have a select-all checkbox.');
+        }
+        return checkbox.click();
+    }
+}
+
+class TheSeamDatatableMenuBarHarness extends ContentContainerComponentHarness {
+    static hostSelector = 'seam-datatable-menu-bar';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    /** Gets the text content of the menu bar. */
+    async getTextContent() {
+        return (await this.host()).text();
+    }
+}
+
+class TheSeamDatatablePagerButtonHarness extends ComponentHarness {
+    static hostSelector = '.pager .pages';
+    /** Creates a `HarnessPredicate` used to locate a particular `MyMenuHarness`. */
+    static with(options) {
+        return new HarnessPredicate(TheSeamDatatablePagerButtonHarness, options).addOption('page number', options.pageNumber, (harness, index) => HarnessPredicate.stringMatches(harness.getLabel(), `page ${index}`));
+    }
+    async getLabel() {
+        return (await this.host()).getAttribute('aria-label');
+    }
+    async getAnchor() {
+        return this.locatorFor('a')();
+    }
+}
+
+class TheSeamDatatablePagerHarness extends ComponentHarness {
+    static hostSelector = 'datatable-pager';
+    _activePageButton = this.locatorFor('.pager .pages.active');
+    async getPageButtonHarness(pageNumber) {
+        const getBtnAtIndex = this.locatorFor(TheSeamDatatablePagerButtonHarness.with({ pageNumber }));
+        return getBtnAtIndex();
+    }
+    async getCurrentPageNumber() {
+        const btn = await this._activePageButton();
+        const label = await btn.getAttribute('aria-label');
+        if (label === null) {
+            throw Error(`Current page label not found.`);
+        }
+        return parseInt(label.replace('page ', ''), 10);
+    }
+}
+
+class TheSeamDatatableRowHarness extends ComponentHarness {
+    static hostSelector = '.datatable-body-row';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options).addOption('selected', options.selected, async (harness, selected) => (await harness.isSelected()) === selected);
+    }
+    /** Gets all cells in this row, optionally filtered. */
+    async getCells(filters) {
+        return this.locatorForAll(filters
+            ? TheSeamDatatableCellHarness.with(filters)
+            : TheSeamDatatableCellHarness)();
+    }
+    /** Gets a cell by its index in the row. */
+    async getCell(index) {
+        const cells = await this.getCells();
+        if (index < 0 || index >= cells.length) {
+            throw Error(`Cell index ${index} is out of bounds. Row has ${cells.length} cells.`);
+        }
+        return cells[index];
+    }
+    /** Convenience method to get the text content of a cell by index. */
+    async getCellText(index) {
+        return (await this.getCell(index)).getText();
+    }
+    /** Whether this row is selected. */
+    async isSelected() {
+        return (await this.host()).hasClass('active');
+    }
+    /** Clicks the row to activate it. */
+    async click() {
+        return (await this.host()).click();
+    }
+    /** Gets the action menu harness for this row, or `null` if no action menu exists. */
+    async getActionMenu() {
+        return this.locatorForOptional(TheSeamDatatableActionMenuHarness)();
+    }
+    // -- Row Detail --
+    /** Whether this row's detail section is expanded. */
+    async isExpanded() {
+        const detail = await this.locatorForOptional('.datatable-row-detail')();
+        return detail !== null;
+    }
+    /** Gets the row detail content element, or `null` if not expanded. */
+    async getDetailContent() {
+        return this.locatorForOptional('.datatable-row-detail')();
+    }
+    // -- Selection --
+    /** Whether this row has a selection checkbox. */
+    async hasCheckbox() {
+        const checkbox = await this.locatorForOptional('.datatable-checkbox input[type="checkbox"]')();
+        return checkbox !== null;
+    }
+    /** Clicks the selection checkbox on this row. */
+    async clickCheckbox() {
+        const checkbox = await this.locatorForOptional('.datatable-checkbox input[type="checkbox"]')();
+        if (!checkbox) {
+            throw Error('This row does not have a selection checkbox.');
+        }
+        return checkbox.click();
+    }
+}
+
+class TheSeamDatatableHarness extends ComponentHarness {
+    static hostSelector = 'seam-datatable';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    _pager = this.locatorForOptional(TheSeamDatatablePagerHarness);
+    // -- Pager --
+    async getCurrentPage() {
+        const pager = await this._pager();
+        if (!pager) {
+            throw Error('Pager not found on this datatable.');
+        }
+        return pager.getCurrentPageNumber();
+    }
+    async getPager() {
+        return this._pager();
+    }
+    // -- Rows --
+    /** Gets all visible body rows, optionally filtered. */
+    async getRows(filters) {
+        return this.locatorForAll(filters
+            ? TheSeamDatatableRowHarness.with(filters)
+            : TheSeamDatatableRowHarness)();
+    }
+    /** Gets a body row by its index. */
+    async getRow(index) {
+        const rows = await this.getRows();
+        if (index < 0 || index >= rows.length) {
+            throw Error(`Row index ${index} is out of bounds. Table has ${rows.length} rows.`);
+        }
+        return rows[index];
+    }
+    /** Gets the number of visible body rows. */
+    async getRowCount() {
+        return (await this.getRows()).length;
+    }
+    // -- Header Cells --
+    /** Gets all header cells, optionally filtered. */
+    async getHeaderCells(filters) {
+        return this.locatorForAll(filters
+            ? TheSeamDatatableHeaderCellHarness.with(filters)
+            : TheSeamDatatableHeaderCellHarness)();
+    }
+    /** Gets a header cell by column name. */
+    async getHeaderCell(name) {
+        const cells = await this.getHeaderCells({ name });
+        if (cells.length === 0) {
+            throw Error(`Header cell with name matching "${name}" not found.`);
+        }
+        return cells[0];
+    }
+    /** Gets the number of visible columns. */
+    async getColumnCount() {
+        return (await this.getHeaderCells()).length;
+    }
+    // -- Selection --
+    /** Gets all currently selected rows. */
+    async getSelectedRows() {
+        return this.getRows({ selected: true });
+    }
+    // -- Menu Bar & Preferences --
+    /** Gets the menu bar harness, or `null` if no menu bar is present. */
+    async getMenuBar() {
+        return this.locatorForOptional(TheSeamDatatableMenuBarHarness)();
+    }
+    /** Gets the column preferences button harness, or `null` if not present. */
+    async getColumnPreferencesButton() {
+        return this.locatorForOptional(TheSeamDatatableColumnPreferencesButtonHarness)();
+    }
+    // -- Convenience --
+    /** Gets the text content of a cell by row and column index. */
+    async getCellText(rowIndex, colIndex) {
+        const row = await this.getRow(rowIndex);
+        return row.getCellText(colIndex);
+    }
+    /** Whether the table is showing its empty message (no rows). */
+    async isEmpty() {
+        const emptyRow = await this.locatorForOptional('.empty-row')();
+        return emptyRow !== null;
+    }
+}
+
+class TheSeamDatatableRefreshButtonHarness extends ComponentHarness {
+    static hostSelector = 'seam-datatable-refresh-button';
+    static with(options = {}) {
+        return new HarnessPredicate(this, options);
+    }
+    _button = this.locatorFor('button');
+    /** Clicks the refresh button. */
+    async click() {
+        return (await this._button()).click();
+    }
+    /** Whether the underlying button is disabled. */
+    async isDisabled() {
+        const disabled = await (await this._button()).getAttribute('disabled');
+        return coerceBooleanProperty(disabled);
+    }
+}
+
 /**
  * Generated bundle index. Do not edit.
  */
 
-export { CURRENT_DATATABLE_PREFERENCES_VERSION, ColumnsAlteration, ColumnsDataFilter, ColumnsFiltersService, DatatableActionMenuComponent, DatatableActionMenuItemComponent, DatatableActionMenuItemDirective, DatatableActionMenuToggleDirective, DatatableCellTplDirective, DatatableColumnChangesService, DatatableColumnComponent, DatatableColumnFilterMenuComponent, DatatableColumnFilterSearchDateComponent, DatatableColumnFilterSearchNumericComponent, DatatableColumnFilterSearchTextComponent, DatatableColumnFilterTplDirective, DatatableColumnPreferencesButtonComponent, DatatableColumnPreferencesComponent, DatatableComponent, DatatableDataSource, DatatableExportButtonComponent, DatatableFilterDirective, DatatableFooterTplDirective, DatatableGqlDataSource, DatatableMenuBarColumnCenterComponent, DatatableMenuBarColumnLeftComponent, DatatableMenuBarColumnRightComponent, DatatableMenuBarComponent, DatatableMenuBarRowComponent, DatatableMenuBarTextComponent, DatatablePreferencesService, DatatableRefreshButtonComponent, DatatableRefreshService, DatatableRowActionItemDirective, DatatableRowDetailTplDirective, EMPTY_DATATABLE_PREFERENCES, SearchDateColumnsDataFilter, SearchNumericColumnsDataFilter, SearchTextColumnsDataFilter, THESEAM_COLUMNS_DATA_FILTER, THESEAM_COLUMNS_DATA_FILTERS_DEFAULT, THESEAM_COLUMNS_DATA_FILTER_DATE_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_TEXT_SEARCH_TYPES, THESEAM_DATATABLE, THESEAM_DATATABLE_CONFIG, THESEAM_DATATABLE_PREFERENCES_ACCESSOR, THESEAM_MENUBAR_ITEM_DATA, TheSeamDatatableColumnFilterDirective, TheSeamDatatableFooterDirective, TheSeamDatatableModule, TheSeamDatatableRowDetailDirective, TheSeamDatatableScrollbarHelperService, _THESEAM_DATATABLE, _THESEAM_DATATABLE_ACCESSOR, _THESEAM_DATA_FILTER_CONTAINER, getFormattedDateForComparison, isColumnBoundToProp, mapColumnsAlterationsStates, withStoredColumnInfo };
+export { CURRENT_DATATABLE_PREFERENCES_VERSION, ColumnsAlteration, ColumnsDataFilter, ColumnsFiltersService, DatatableActionMenuComponent, DatatableActionMenuItemComponent, DatatableActionMenuItemDirective, DatatableActionMenuToggleDirective, DatatableCellTplDirective, DatatableColumnChangesService, DatatableColumnComponent, DatatableColumnFilterMenuComponent, DatatableColumnFilterSearchDateComponent, DatatableColumnFilterSearchNumericComponent, DatatableColumnFilterSearchTextComponent, DatatableColumnFilterTplDirective, DatatableColumnPreferencesButtonComponent, DatatableColumnPreferencesComponent, DatatableComponent, DatatableDataSource, DatatableExportButtonComponent, DatatableFilterDirective, DatatableFooterTplDirective, DatatableGqlDataSource, DatatableMenuBarColumnCenterComponent, DatatableMenuBarColumnLeftComponent, DatatableMenuBarColumnRightComponent, DatatableMenuBarComponent, DatatableMenuBarRowComponent, DatatableMenuBarTextComponent, DatatablePreferencesService, DatatableRefreshButtonComponent, DatatableRefreshService, DatatableRowActionItemDirective, DatatableRowDetailTplDirective, EMPTY_DATATABLE_PREFERENCES, FILTERABLE_COLUMNS, FILTERABLE_ROWS, SIMPLE_COLUMNS, SIMPLE_ROWS, SearchDateColumnsDataFilter, SearchNumericColumnsDataFilter, SearchTextColumnsDataFilter, THESEAM_COLUMNS_DATA_FILTER, THESEAM_COLUMNS_DATA_FILTERS_DEFAULT, THESEAM_COLUMNS_DATA_FILTER_DATE_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_DATE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_DATE_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_RANGE_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_NUMERIC_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_NAME, THESEAM_COLUMNS_DATA_FILTER_TEXT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_SELECT_SEARCH_TYPES, THESEAM_COLUMNS_DATA_FILTER_TEXT_TEXT_SEARCH_TYPES, THESEAM_DATATABLE, THESEAM_DATATABLE_CONFIG, THESEAM_DATATABLE_PREFERENCES_ACCESSOR, THESEAM_MENUBAR_ITEM_DATA, TheSeamDatatableActionMenuHarness, TheSeamDatatableCellHarness, TheSeamDatatableColumnFilterDirective, TheSeamDatatableColumnFilterMenuHarness, TheSeamDatatableColumnPreferencesButtonHarness, TheSeamDatatableExportButtonHarness, TheSeamDatatableFooterDirective, TheSeamDatatableHarness, TheSeamDatatableHeaderCellHarness, TheSeamDatatableMenuBarHarness, TheSeamDatatableModule, TheSeamDatatablePagerButtonHarness, TheSeamDatatablePagerHarness, TheSeamDatatableRefreshButtonHarness, TheSeamDatatableRowDetailDirective, TheSeamDatatableRowHarness, TheSeamDatatableScrollbarHelperService, _THESEAM_DATATABLE, _THESEAM_DATATABLE_ACCESSOR, _THESEAM_DATA_FILTER_CONTAINER, createRows, getFormattedDateForComparison, isColumnBoundToProp, mapColumnsAlterationsStates, withStoredColumnInfo };
 //# sourceMappingURL=theseam-ui-common-datatable.mjs.map