@atomic-testing/component-driver-mui-x-v8 0.58.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tianzhen Lin (Tangent)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# @atomic-testing/component-driver-mui-x-v7
+
+Component drivers for [Material UI X](https://mui.com/x/) v7 components.
+They provide Atomic Testing wrappers for the latest MUI X widgets.
+
+## Installation
+
+```bash
+pnpm add @atomic-testing/component-driver-mui-x-v7
+```
+
+See the [docs](https://atomic-testing.dev/) for usage instructions.

package/dist/components/datagrid/DataGridCellQuery.d.ts

@@ -0,0 +1,9 @@
+export interface CellQueryByColumnIndex {
+    rowIndex: number;
+    columnIndex: number;
+}
+export interface CellQueryByColumnField {
+    rowIndex: number;
+    columnField: string;
+}
+export type DataGridCellQuery = CellQueryByColumnIndex | CellQueryByColumnField;

package/dist/components/datagrid/DataGridCellQuery.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=DataGridCellQuery.js.map

package/dist/components/datagrid/DataGridCellQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGridCellQuery.js","sourceRoot":"","sources":["../../../src/components/datagrid/DataGridCellQuery.ts"],"names":[],"mappings":""}

package/dist/components/datagrid/DataGridDataRowDriver.d.ts

@@ -0,0 +1,8 @@
+import { IComponentDriverOption, Interactor, PartLocator } from '@atomic-testing/core';
+import { DataGridRowDriverBase } from './DataGridRowDriverBase';
+export declare class DataGridDataRowDriver extends DataGridRowDriverBase {
+    private readonly _dataCellLocator;
+    constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
+    protected getCellLocator(): PartLocator;
+    get driverName(): string;
+}

package/dist/components/datagrid/DataGridDataRowDriver.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataGridDataRowDriver = void 0;
+const core_1 = require("@atomic-testing/core");
+const DataGridRowDriverBase_1 = require("./DataGridRowDriverBase");
+class DataGridDataRowDriver extends DataGridRowDriverBase_1.DataGridRowDriverBase {
+    constructor(locator, interactor, option) {
+        super(locator, interactor, Object.assign(Object.assign({}, option), { parts: {} }));
+        this._dataCellLocator = core_1.locatorUtil.append(locator, (0, core_1.byRole)('cell'));
+    }
+    getCellLocator() {
+        return this._dataCellLocator;
+    }
+    get driverName() {
+        return 'MuiV8DataGridDataRowDriver';
+    }
+}
+exports.DataGridDataRowDriver = DataGridDataRowDriver;
+//# sourceMappingURL=DataGridDataRowDriver.js.map

package/dist/components/datagrid/DataGridDataRowDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGridDataRowDriver.js","sourceRoot":"","sources":["../../../src/components/datagrid/DataGridDataRowDriver.ts"],"names":[],"mappings":";;;AAAA,+CAA4G;AAE5G,mEAAgE;AAEhE,MAAa,qBAAsB,SAAQ,6CAAqB;IAE9D,YAAY,OAAoB,EAAE,UAAsB,EAAE,MAAwC;QAChG,KAAK,CAAC,OAAO,EAAE,UAAU,kCACpB,MAAM,KACT,KAAK,EAAE,EAAE,IACT,CAAC;QAEH,IAAI,CAAC,gBAAgB,GAAG,kBAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,CAAC;IACtE,CAAC;IAEkB,cAAc;QAC/B,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAa,UAAU;QACrB,OAAO,4BAA4B,CAAC;IACtC,CAAC;CACF;AAlBD,sDAkBC"}

package/dist/components/datagrid/DataGridFooterDriver.d.ts

@@ -0,0 +1,27 @@
+import { HTMLElementDriver } from '@atomic-testing/component-driver-html';
+import { ComponentDriver, IComponentDriverOption, Interactor, Optional, PartLocator } from '@atomic-testing/core';
+import { DataGridPaginationActionDriver } from './DataGridPaginationActionDriver';
+declare const parts: {
+    paginationAction: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof DataGridPaginationActionDriver;
+    };
+    paginationDescription: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof HTMLElementDriver;
+    };
+};
+/**
+ * Driver for Material UI v6 DataGridPro component.
+ * @see https://mui.com/x/react-data-grid/
+ */
+export declare class DataGridFooterDriver extends ComponentDriver<typeof parts> {
+    constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
+    isPreviousPageEnabled(): Promise<boolean>;
+    gotoPreviousPage(): Promise<void>;
+    isNextPageEnabled(): Promise<boolean>;
+    gotoNextPage(): Promise<void>;
+    getPaginationDescription(): Promise<Optional<string>>;
+    get driverName(): string;
+}
+export {};

package/dist/components/datagrid/DataGridFooterDriver.js

@@ -0,0 +1,69 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataGridFooterDriver = void 0;
+const component_driver_html_1 = require("@atomic-testing/component-driver-html");
+const core_1 = require("@atomic-testing/core");
+const DataGridPaginationActionDriver_1 = require("./DataGridPaginationActionDriver");
+const parts = {
+    paginationAction: {
+        locator: (0, core_1.byCssClass)('MuiTablePagination-actions'),
+        driver: DataGridPaginationActionDriver_1.DataGridPaginationActionDriver,
+    },
+    paginationDescription: {
+        locator: (0, core_1.byCssClass)('MuiTablePagination-displayedRows'),
+        driver: component_driver_html_1.HTMLElementDriver,
+    },
+};
+/**
+ * Driver for Material UI v6 DataGridPro component.
+ * @see https://mui.com/x/react-data-grid/
+ */
+class DataGridFooterDriver extends core_1.ComponentDriver {
+    constructor(locator, interactor, option) {
+        super(locator, interactor, Object.assign(Object.assign({}, option), { parts }));
+    }
+    isPreviousPageEnabled() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('paginationAction');
+            return this.parts.paginationAction.isPreviousPageEnabled();
+        });
+    }
+    gotoPreviousPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('paginationAction');
+            yield this.parts.paginationAction.gotoPreviousPage();
+        });
+    }
+    isNextPageEnabled() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('paginationAction');
+            return this.parts.paginationAction.isNextPageEnabled();
+        });
+    }
+    gotoNextPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('paginationAction');
+            yield this.parts.paginationAction.gotoNextPage();
+        });
+    }
+    getPaginationDescription() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('paginationDescription');
+            return this.parts.paginationDescription.getText();
+        });
+    }
+    get driverName() {
+        return 'MuiV8DataGridFooterDriver';
+    }
+}
+exports.DataGridFooterDriver = DataGridFooterDriver;
+//# sourceMappingURL=DataGridFooterDriver.js.map

package/dist/components/datagrid/DataGridFooterDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGridFooterDriver.js","sourceRoot":"","sources":["../../../src/components/datagrid/DataGridFooterDriver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iFAA0E;AAC1E,+CAQ8B;AAE9B,qFAAkF;AAElF,MAAM,KAAK,GAAG;IACZ,gBAAgB,EAAE;QAChB,OAAO,EAAE,IAAA,iBAAU,EAAC,4BAA4B,CAAC;QACjD,MAAM,EAAE,+DAA8B;KACvC;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,IAAA,iBAAU,EAAC,kCAAkC,CAAC;QACvD,MAAM,EAAE,yCAAiB;KAC1B;CACkB,CAAC;AAEtB;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,sBAA6B;IACrE,YAAY,OAAoB,EAAE,UAAsB,EAAE,MAAwC;QAChG,KAAK,CAAC,OAAO,EAAE,UAAU,kCACpB,MAAM,KACT,KAAK,IACL,CAAC;IACL,CAAC;IAEK,qBAAqB;;YACzB,MAAM,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,qBAAqB,EAAE,CAAC;QAC7D,CAAC;KAAA;IAEK,gBAAgB;;YACpB,MAAM,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;YACpD,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,CAAC;QACvD,CAAC;KAAA;IAEK,iBAAiB;;YACrB,MAAM,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,CAAC;QACzD,CAAC;KAAA;IAEK,YAAY;;YAChB,MAAM,IAAI,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC;YACpD,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;QACnD,CAAC;KAAA;IAEK,wBAAwB;;YAC5B,MAAM,IAAI,CAAC,oBAAoB,CAAC,uBAAuB,CAAC,CAAC;YACzD,OAAO,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,OAAO,EAAE,CAAC;QACpD,CAAC;KAAA;IAED,IAAa,UAAU;QACrB,OAAO,2BAA2B,CAAC;IACrC,CAAC;CACF;AApCD,oDAoCC"}

package/dist/components/datagrid/DataGridHeaderRowDriver.d.ts

@@ -0,0 +1,9 @@
+import { IComponentDriverOption, Interactor, PartLocator } from '@atomic-testing/core';
+import { DataGridRowDriverBase } from './DataGridRowDriverBase';
+export declare class DataGridHeaderRowDriver extends DataGridRowDriverBase {
+    private readonly _headerCellLocator;
+    constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
+    getColumnCount(): Promise<number>;
+    protected getCellLocator(): PartLocator;
+    get driverName(): string;
+}

package/dist/components/datagrid/DataGridHeaderRowDriver.js

@@ -0,0 +1,33 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataGridHeaderRowDriver = void 0;
+const core_1 = require("@atomic-testing/core");
+const DataGridRowDriverBase_1 = require("./DataGridRowDriverBase");
+class DataGridHeaderRowDriver extends DataGridRowDriverBase_1.DataGridRowDriverBase {
+    constructor(locator, interactor, option) {
+        super(locator, interactor, Object.assign(Object.assign({}, option), { parts: {} }));
+        this._headerCellLocator = core_1.locatorUtil.append(locator, (0, core_1.byRole)('columnheader'));
+    }
+    getColumnCount() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.getCellCount();
+        });
+    }
+    getCellLocator() {
+        return this._headerCellLocator;
+    }
+    get driverName() {
+        return 'MuiV8DataGridHeaderRowDriver';
+    }
+}
+exports.DataGridHeaderRowDriver = DataGridHeaderRowDriver;
+//# sourceMappingURL=DataGridHeaderRowDriver.js.map

package/dist/components/datagrid/DataGridHeaderRowDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGridHeaderRowDriver.js","sourceRoot":"","sources":["../../../src/components/datagrid/DataGridHeaderRowDriver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,+CAA4G;AAE5G,mEAAgE;AAEhE,MAAa,uBAAwB,SAAQ,6CAAqB;IAEhE,YAAY,OAAoB,EAAE,UAAsB,EAAE,MAAwC;QAChG,KAAK,CAAC,OAAO,EAAE,UAAU,kCACpB,MAAM,KACT,KAAK,EAAE,EAAE,IACT,CAAC;QAEH,IAAI,CAAC,kBAAkB,GAAG,kBAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAA,aAAM,EAAC,cAAc,CAAC,CAAC,CAAC;IAChF,CAAC;IAEK,cAAc;;YAClB,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7B,CAAC;KAAA;IAEkB,cAAc;QAC/B,OAAO,IAAI,CAAC,kBAAkB,CAAC;IACjC,CAAC;IAED,IAAa,UAAU;QACrB,OAAO,8BAA8B,CAAC;IACxC,CAAC;CACF;AAtBD,0DAsBC"}

package/dist/components/datagrid/DataGridPaginationActionDriver.d.ts

@@ -0,0 +1,25 @@
+import { HTMLButtonDriver } from '@atomic-testing/component-driver-html';
+import { ComponentDriver, IComponentDriverOption, Interactor, PartLocator } from '@atomic-testing/core';
+declare const parts: {
+    previousButton: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof HTMLButtonDriver;
+    };
+    nextButton: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof HTMLButtonDriver;
+    };
+};
+/**
+ * Driver for Material UI v6 DataGridPro component.
+ * @see https://mui.com/x/react-data-grid/
+ */
+export declare class DataGridPaginationActionDriver extends ComponentDriver<typeof parts> {
+    constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
+    isPreviousPageEnabled(): Promise<boolean>;
+    gotoPreviousPage(): Promise<void>;
+    isNextPageEnabled(): Promise<boolean>;
+    gotoNextPage(): Promise<void>;
+    get driverName(): string;
+}
+export {};

package/dist/components/datagrid/DataGridPaginationActionDriver.js

@@ -0,0 +1,64 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataGridPaginationActionDriver = void 0;
+const component_driver_html_1 = require("@atomic-testing/component-driver-html");
+const core_1 = require("@atomic-testing/core");
+const parts = {
+    previousButton: {
+        locator: (0, core_1.byAttribute)('aria-label', 'Go to previous page'),
+        driver: component_driver_html_1.HTMLButtonDriver,
+    },
+    nextButton: {
+        locator: (0, core_1.byAttribute)('aria-label', 'Go to next page'),
+        driver: component_driver_html_1.HTMLButtonDriver,
+    },
+};
+/**
+ * Driver for Material UI v6 DataGridPro component.
+ * @see https://mui.com/x/react-data-grid/
+ */
+class DataGridPaginationActionDriver extends core_1.ComponentDriver {
+    constructor(locator, interactor, option) {
+        super(locator, interactor, Object.assign(Object.assign({}, option), { parts }));
+    }
+    isPreviousPageEnabled() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('previousButton');
+            const isDisabled = yield this.parts.previousButton.isDisabled();
+            return !isDisabled;
+        });
+    }
+    gotoPreviousPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('previousButton');
+            yield this.parts.previousButton.click();
+        });
+    }
+    isNextPageEnabled() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('nextButton');
+            const isDisabled = yield this.parts.nextButton.isDisabled();
+            return !isDisabled;
+        });
+    }
+    gotoNextPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('nextButton');
+            yield this.parts.nextButton.click();
+        });
+    }
+    get driverName() {
+        return 'MuiV8DataGridPaginationActionDriver';
+    }
+}
+exports.DataGridPaginationActionDriver = DataGridPaginationActionDriver;
+//# sourceMappingURL=DataGridPaginationActionDriver.js.map

package/dist/components/datagrid/DataGridPaginationActionDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataGridPaginationActionDriver.js","sourceRoot":"","sources":["../../../src/components/datagrid/DataGridPaginationActionDriver.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,iFAAyE;AACzE,+CAO8B;AAE9B,MAAM,KAAK,GAAG;IACZ,cAAc,EAAE;QACd,OAAO,EAAE,IAAA,kBAAW,EAAC,YAAY,EAAE,qBAAqB,CAAC;QACzD,MAAM,EAAE,wCAAgB;KACzB;IACD,UAAU,EAAE;QACV,OAAO,EAAE,IAAA,kBAAW,EAAC,YAAY,EAAE,iBAAiB,CAAC;QACrD,MAAM,EAAE,wCAAgB;KACzB;CACkB,CAAC;AAEtB;;;GAGG;AACH,MAAa,8BAA+B,SAAQ,sBAA6B;IAC/E,YAAY,OAAoB,EAAE,UAAsB,EAAE,MAAwC;QAChG,KAAK,CAAC,OAAO,EAAE,UAAU,kCACpB,MAAM,KACT,KAAK,IACL,CAAC;IACL,CAAC;IAEK,qBAAqB;;YACzB,MAAM,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;YAClD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC;YAChE,OAAO,CAAC,UAAU,CAAC;QACrB,CAAC;KAAA;IAEK,gBAAgB;;YACpB,MAAM,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;YAClD,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC1C,CAAC;KAAA;IAEK,iBAAiB;;YACrB,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YAC5D,OAAO,CAAC,UAAU,CAAC;QACrB,CAAC;KAAA;IAEK,YAAY;;YAChB,MAAM,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;YAC9C,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtC,CAAC;KAAA;IAED,IAAa,UAAU;QACrB,OAAO,qCAAqC,CAAC;IAC/C,CAAC;CACF;AAjCD,wEAiCC"}

package/dist/components/datagrid/DataGridProDriver.d.ts

@@ -0,0 +1,93 @@
+import { HTMLElementDriver } from '@atomic-testing/component-driver-html';
+import { ComponentDriver, IComponentDriverOption, Interactor, Optional, PartLocator } from '@atomic-testing/core';
+import { DataGridCellQuery } from './DataGridCellQuery';
+import { DataGridFooterDriver } from './DataGridFooterDriver';
+import { DataGridHeaderRowDriver } from './DataGridHeaderRowDriver';
+declare const parts: {
+    headerRow: {
+        locator: PartLocator;
+        driver: typeof DataGridHeaderRowDriver;
+    };
+    loading: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof HTMLElementDriver;
+    };
+    skeletonOverlay: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof HTMLElementDriver;
+    };
+    footer: {
+        locator: import("@atomic-testing/core").CssLocator;
+        driver: typeof DataGridFooterDriver;
+    };
+};
+/**
+ * Driver for Material UI v8  DataGridPro component.
+ * V8 DataGridPro component does not support data-testid, to use data-testid
+ * to locate the component, you need to put the data-testid on the parent element of the grid
+ * @see https://mui.com/x/react-data-grid/
+ */
+export declare class DataGridProDriver extends ComponentDriver<typeof parts> {
+    constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
+    /**
+     * Checks if the data grid is currently loading.
+     * @returns A promise that resolves to a boolean indicating if the data grid is loading.
+     */
+    isLoading(): Promise<boolean>;
+    /**
+     * Waits for the data grid to exit the loading state.
+     * @param timeoutMs The maximum time to wait for the load to complete, in milliseconds.
+     */
+    waitForLoad(timeoutMs?: number): Promise<void>;
+    /**
+     * The number of columns currently displayed in the data grid, note that data grid pro
+     * uses virtualize rendering, therefore the column count heavily depends on the viewport size
+     * @returns The number of columns currently displayed in the data grid
+     */
+    getColumnCount(): Promise<number>;
+    /**
+     * The array text of the header row, note that columns not shown in the viewport may not be included because of virtualize rendering
+     * @returns The array of text of the header row
+     */
+    getHeaderText(): Promise<string[]>;
+    /**
+     * The number of rows currently displayed in the data grid, note that data grid pro
+     * uses virtualize rendering, therefore the row count heavily depends on the viewport size
+     * @returns The number of columns currently displayed in the data grid
+     */
+    getRowCount(): Promise<number>;
+    /**
+     * Return the row driver for the row at the specified index, if the row does not exist, return null
+     * @param rowIndex
+     * @returns
+     */
+    getRow(rowIndex: number): Promise<DataGridHeaderRowDriver | null>;
+    /**
+     * The array text of the specified row, note that columns not shown in the viewport may not be included because of virtualize rendering
+     * @param rowIndex The index of the row
+     * @returns The array of text of the specified row
+     */
+    getRowText(rowIndex: number): Promise<string[]>;
+    /**
+     * Get the cell driver for the cell, if the cell does not exist, return null
+     * The cell driver is default to HTMLElementDriver, you can specify a different driver class
+     * @param query The query to locate the cell
+     * @param driverClass Optional, the driver class to use for the cell, default to HTMLElementDriver
+     * @returns
+     */
+    getCell<DriverT extends ComponentDriver>(query: DataGridCellQuery, driverClass?: typeof ComponentDriver): Promise<DriverT | null>;
+    /**
+     * Get the text content of the cell, if the cell does not exist, throw an error
+     * @param query The query to locate the cell
+     * @returns
+     */
+    getCellText(query: DataGridCellQuery): Promise<string>;
+    isFooterVisible(): Promise<boolean>;
+    isPreviousPageEnabled(): Promise<boolean>;
+    gotoPreviousPage(): Promise<void>;
+    isNextPageEnabled(): Promise<boolean>;
+    gotoNextPage(): Promise<void>;
+    getPaginationDescription(): Promise<Optional<string>>;
+    get driverName(): string;
+}
+export {};

package/dist/components/datagrid/DataGridProDriver.js

@@ -0,0 +1,227 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataGridProDriver = void 0;
+const component_driver_html_1 = require("@atomic-testing/component-driver-html");
+const core_1 = require("@atomic-testing/core");
+const DataGridFooterDriver_1 = require("./DataGridFooterDriver");
+const DataGridHeaderRowDriver_1 = require("./DataGridHeaderRowDriver");
+const parts = {
+    headerRow: {
+        locator: (0, core_1.byCssClass)('MuiDataGrid-columnHeaders').chain((0, core_1.byCssSelector)('[role=row]:first-of-type')),
+        driver: DataGridHeaderRowDriver_1.DataGridHeaderRowDriver,
+    },
+    loading: {
+        locator: (0, core_1.byRole)('progressbar'),
+        driver: component_driver_html_1.HTMLElementDriver,
+    },
+    skeletonOverlay: {
+        locator: (0, core_1.byCssClass)('MuiDataGrid-main--hasSkeletonLoadingOverlay'),
+        driver: component_driver_html_1.HTMLElementDriver,
+    },
+    footer: {
+        locator: (0, core_1.byCssClass)('MuiDataGrid-footerContainer'),
+        driver: DataGridFooterDriver_1.DataGridFooterDriver,
+    },
+};
+const dataRowLocator = (0, core_1.byCssSelector)('[role=row][data-rowindex]');
+/**
+ * Driver for Material UI v8  DataGridPro component.
+ * V8 DataGridPro component does not support data-testid, to use data-testid
+ * to locate the component, you need to put the data-testid on the parent element of the grid
+ * @see https://mui.com/x/react-data-grid/
+ */
+class DataGridProDriver extends core_1.ComponentDriver {
+    constructor(locator, interactor, option) {
+        super(locator, interactor, Object.assign(Object.assign({}, option), { parts }));
+    }
+    /**
+     * Checks if the data grid is currently loading.
+     * @returns A promise that resolves to a boolean indicating if the data grid is loading.
+     */
+    isLoading() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield Promise.all([this.parts.skeletonOverlay.isVisible(), this.parts.loading.isVisible()]);
+            return result.some(v => v);
+        });
+    }
+    /**
+     * Waits for the data grid to exit the loading state.
+     * @param timeoutMs The maximum time to wait for the load to complete, in milliseconds.
+     */
+    waitForLoad() {
+        return __awaiter(this, arguments, void 0, function* (timeoutMs = 10000) {
+            yield this.parts.headerRow.waitUntilComponentState();
+            yield this.waitUntil({ probeFn: () => this.isLoading(), terminateCondition: false, timeoutMs });
+        });
+    }
+    /**
+     * The number of columns currently displayed in the data grid, note that data grid pro
+     * uses virtualize rendering, therefore the column count heavily depends on the viewport size
+     * @returns The number of columns currently displayed in the data grid
+     */
+    getColumnCount() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.parts.headerRow.getColumnCount();
+        });
+    }
+    /**
+     * The array text of the header row, note that columns not shown in the viewport may not be included because of virtualize rendering
+     * @returns The array of text of the header row
+     */
+    getHeaderText() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.parts.headerRow.getRowText();
+        });
+    }
+    /**
+     * The number of rows currently displayed in the data grid, note that data grid pro
+     * uses virtualize rendering, therefore the row count heavily depends on the viewport size
+     * @returns The number of columns currently displayed in the data grid
+     */
+    getRowCount() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, e_1, _b, _c;
+            const gridRowLocator = core_1.locatorUtil.append(this.locator, dataRowLocator);
+            let count = 0;
+            try {
+                for (var _d = true, _e = __asyncValues(core_1.listHelper.getListItemIterator(this, gridRowLocator, component_driver_html_1.HTMLElementDriver)), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const _ = _c;
+                    count++;
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            return count;
+        });
+    }
+    /**
+     * Return the row driver for the row at the specified index, if the row does not exist, return null
+     * @param rowIndex
+     * @returns
+     */
+    getRow(rowIndex) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const rowLocator = core_1.locatorUtil.append(this.locator, (0, core_1.byCssSelector)(`[role=row][data-rowindex="${rowIndex}"]`));
+            const rowExists = yield this.interactor.exists(rowLocator);
+            if (rowExists) {
+                return new DataGridHeaderRowDriver_1.DataGridHeaderRowDriver(rowLocator, this.interactor, this.commutableOption);
+            }
+            return null;
+        });
+    }
+    /**
+     * The array text of the specified row, note that columns not shown in the viewport may not be included because of virtualize rendering
+     * @param rowIndex The index of the row
+     * @returns The array of text of the specified row
+     */
+    getRowText(rowIndex) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const row = yield this.getRow(rowIndex);
+            if (row != null) {
+                return row.getRowText();
+            }
+            throw new Error(`Row ${rowIndex} does not exist`);
+        });
+    }
+    /**
+     * Get the cell driver for the cell, if the cell does not exist, return null
+     * The cell driver is default to HTMLElementDriver, you can specify a different driver class
+     * @param query The query to locate the cell
+     * @param driverClass Optional, the driver class to use for the cell, default to HTMLElementDriver
+     * @returns
+     */
+    getCell(query_1) {
+        return __awaiter(this, arguments, void 0, function* (query, 
+        // @ts-ignore
+        driverClass = component_driver_html_1.HTMLElementDriver) {
+            const rowDriver = yield this.getRow(query.rowIndex);
+            if (rowDriver === null) {
+                return null;
+            }
+            if ('columnIndex' in query) {
+                return rowDriver.getCell(query.columnIndex, driverClass);
+            }
+            return rowDriver.getCell(query.columnField, driverClass);
+        });
+    }
+    /**
+     * Get the text content of the cell, if the cell does not exist, throw an error
+     * @param query The query to locate the cell
+     * @returns
+     */
+    getCellText(query) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const cell = yield this.getCell(query);
+            if (cell != null) {
+                const text = yield cell.getText();
+                return text;
+            }
+            //@ts-ignore
+            throw new Error(`Cell at row:${query.rowIndex} column:${(_a = query.columnIndex) !== null && _a !== void 0 ? _a : query.columnField} does not exist`);
+        });
+    }
+    //#region Footer
+    isFooterVisible() {
+        return this.parts.footer.isVisible();
+    }
+    isPreviousPageEnabled() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('footer');
+            return this.parts.footer.isPreviousPageEnabled();
+        });
+    }
+    gotoPreviousPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('footer');
+            yield this.parts.footer.gotoPreviousPage();
+        });
+    }
+    isNextPageEnabled() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('footer');
+            return this.parts.footer.isNextPageEnabled();
+        });
+    }
+    gotoNextPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('footer');
+            yield this.parts.footer.gotoNextPage();
+        });
+    }
+    getPaginationDescription() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.enforcePartExistence('footer');
+            return this.parts.footer.getText();
+        });
+    }
+    //#endregion Footer
+    get driverName() {
+        return 'MuiV8DataGridProDriver';
+    }
+}
+exports.DataGridProDriver = DataGridProDriver;
+//# sourceMappingURL=DataGridProDriver.js.map