@atomic-testing/component-driver-mui-v9 0.88.0 → 0.90.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { HTMLButtonDriver, HTMLCheckboxDriver, HTMLElementDriver, HTMLRadioButtonGroupDriver, HTMLSelectDriver, HTMLTextInputDriver } from "@atomic-testing/component-driver-html";
-import { ComponentDriver, ComponentDriverCtor, ContainerDriver, ErrorBase, IComponentDriverOption, IContainerDriverOption, IFormFieldDriver, IInputDriver, IToggleDriver, Interactor, ListComponentDriver, ListComponentDriverSpecificOption, LocatorRelativePosition, Nullable, Optional, PartLocator, ScenePart } from "@atomic-testing/core";
+import { ComponentDriver, ComponentDriverCtor, ContainerDriver, ErrorBase, IComponentDriverOption, IContainerDriverOption, IFormFieldDriver, IInputDriver, IToggleDriver, Interactor, ItemNotFoundError, ListComponentDriver, ListComponentDriverSpecificOption, LocatorRelativePosition, Nullable, Optional, PartLocator, ScenePart } from "@atomic-testing/core";
 
 //#region src/components/AccordionDriver.d.ts
 declare const parts$13: {
@@ -366,8 +366,8 @@ declare const parts$8: {
 };
 declare class DialogDriver<ContentT extends ScenePart> extends ContainerDriver<ContentT, typeof parts$8> {
   constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IContainerDriverOption>);
-  overriddenParentLocator(): Optional<PartLocator>;
-  overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
+  static overriddenParentLocator(): Optional<PartLocator>;
+  static overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
   getTitle(): Promise<string | null>;
   /**
    * Dismiss the dialog by clicking outside its content, then wait for it to close.
@@ -413,8 +413,8 @@ declare class DialogDriver<ContentT extends ScenePart> extends ContainerDriver<C
  * `closeByBackdrop`.
  *
  * Subclasses supply {@link getSurfaceLocator} (the element whose visibility means
- * "open") and, when the overlay is portal-rendered, override
- * `overriddenParentLocator()`/`overrideLocatorRelativePosition()` to re-root.
+ * "open") and, when the overlay is portal-rendered, override the static
+ * `overriddenParentLocator()`/`overrideLocatorRelativePosition()` portal hooks to re-root.
  *
  * `closeByEscape` is intentionally absent: keyboard dismissal needs a key-press
  * primitive the `Interactor` interface does not yet expose, which would have to be
@@ -473,8 +473,8 @@ type DrawerAnchor = 'left' | 'right' | 'top' | 'bottom';
  */
 declare class DrawerDriver<ContentT extends ScenePart> extends OverlayDriver<ContentT, typeof drawerParts> {
   constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IContainerDriverOption>);
-  overriddenParentLocator(): Optional<PartLocator>;
-  overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
+  static overriddenParentLocator(): Optional<PartLocator>;
+  static overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
   protected getSurfaceLocator(): PartLocator;
   /**
    * The side the drawer is anchored to, read from the portal root's anchor class, or
@@ -577,8 +577,8 @@ declare const parts$6: {
 };
 declare class MenuDriver extends ComponentDriver<typeof parts$6> {
   constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
-  overriddenParentLocator(): Optional<PartLocator>;
-  overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
+  static overriddenParentLocator(): Optional<PartLocator>;
+  static overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
   getMenuItemByLabel(label: string): Promise<MenuItemDriver | null>;
   selectByLabel(label: string): Promise<void>;
   get driverName(): string;
@@ -1381,9 +1381,8 @@ declare class MenuItemDisabledError extends ErrorBase {
 //#endregion
 //#region src/errors/MenuItemNotFoundError.d.ts
 declare const MenuItemNotFoundErrorId = "MenuItemNotFoundError";
-declare class MenuItemNotFoundError extends ErrorBase {
+declare class MenuItemNotFoundError extends ItemNotFoundError {
   readonly label: string;
-  readonly driver: ComponentDriver<any>;
   constructor(label: string, driver: ComponentDriver<any>);
 }
 //#endregion

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { HTMLButtonDriver, HTMLCheckboxDriver, HTMLElementDriver, HTMLRadioButtonGroupDriver, HTMLSelectDriver, HTMLTextInputDriver } from "@atomic-testing/component-driver-html";
-import { ComponentDriver, ComponentDriverCtor, ContainerDriver, ErrorBase, IComponentDriverOption, IContainerDriverOption, IFormFieldDriver, IInputDriver, IToggleDriver, Interactor, ListComponentDriver, ListComponentDriverSpecificOption, LocatorRelativePosition, Nullable, Optional, PartLocator, ScenePart } from "@atomic-testing/core";
+import { ComponentDriver, ComponentDriverCtor, ContainerDriver, ErrorBase, IComponentDriverOption, IContainerDriverOption, IFormFieldDriver, IInputDriver, IToggleDriver, Interactor, ItemNotFoundError, ListComponentDriver, ListComponentDriverSpecificOption, LocatorRelativePosition, Nullable, Optional, PartLocator, ScenePart } from "@atomic-testing/core";
 
 //#region src/components/AccordionDriver.d.ts
 declare const parts$13: {
@@ -366,8 +366,8 @@ declare const parts$8: {
 };
 declare class DialogDriver<ContentT extends ScenePart> extends ContainerDriver<ContentT, typeof parts$8> {
   constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IContainerDriverOption>);
-  overriddenParentLocator(): Optional<PartLocator>;
-  overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
+  static overriddenParentLocator(): Optional<PartLocator>;
+  static overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
   getTitle(): Promise<string | null>;
   /**
    * Dismiss the dialog by clicking outside its content, then wait for it to close.
@@ -413,8 +413,8 @@ declare class DialogDriver<ContentT extends ScenePart> extends ContainerDriver<C
  * `closeByBackdrop`.
  *
  * Subclasses supply {@link getSurfaceLocator} (the element whose visibility means
- * "open") and, when the overlay is portal-rendered, override
- * `overriddenParentLocator()`/`overrideLocatorRelativePosition()` to re-root.
+ * "open") and, when the overlay is portal-rendered, override the static
+ * `overriddenParentLocator()`/`overrideLocatorRelativePosition()` portal hooks to re-root.
  *
  * `closeByEscape` is intentionally absent: keyboard dismissal needs a key-press
  * primitive the `Interactor` interface does not yet expose, which would have to be
@@ -473,8 +473,8 @@ type DrawerAnchor = 'left' | 'right' | 'top' | 'bottom';
  */
 declare class DrawerDriver<ContentT extends ScenePart> extends OverlayDriver<ContentT, typeof drawerParts> {
   constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IContainerDriverOption>);
-  overriddenParentLocator(): Optional<PartLocator>;
-  overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
+  static overriddenParentLocator(): Optional<PartLocator>;
+  static overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
   protected getSurfaceLocator(): PartLocator;
   /**
    * The side the drawer is anchored to, read from the portal root's anchor class, or
@@ -577,8 +577,8 @@ declare const parts$6: {
 };
 declare class MenuDriver extends ComponentDriver<typeof parts$6> {
   constructor(locator: PartLocator, interactor: Interactor, option?: Partial<IComponentDriverOption>);
-  overriddenParentLocator(): Optional<PartLocator>;
-  overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
+  static overriddenParentLocator(): Optional<PartLocator>;
+  static overrideLocatorRelativePosition(): Optional<LocatorRelativePosition>;
   getMenuItemByLabel(label: string): Promise<MenuItemDriver | null>;
   selectByLabel(label: string): Promise<void>;
   get driverName(): string;
@@ -1381,9 +1381,8 @@ declare class MenuItemDisabledError extends ErrorBase {
 //#endregion
 //#region src/errors/MenuItemNotFoundError.d.ts
 declare const MenuItemNotFoundErrorId = "MenuItemNotFoundError";
-declare class MenuItemNotFoundError extends ErrorBase {
+declare class MenuItemNotFoundError extends ItemNotFoundError {
   readonly label: string;
-  readonly driver: ComponentDriver<any>;
   constructor(label: string, driver: ComponentDriver<any>);
 }
 //#endregion

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { HTMLButtonDriver, HTMLCheckboxDriver, HTMLElementDriver, HTMLRadioButtonGroupDriver, HTMLSelectDriver, HTMLTextInputDriver } from "@atomic-testing/component-driver-html";
-import { ComponentDriver, ContainerDriver, ErrorBase, ListComponentDriver, byAttribute, byCssClass, byCssSelector, byDataTestId, byInputType, byLinkedElement, byRole, byTagName, byValue, escapeUtil, listHelper, locatorUtil, timingUtil } from "@atomic-testing/core";
+import { ComponentDriver, ContainerDriver, ErrorBase, ItemNotFoundError, ListComponentDriver, byAttribute, byCssClass, byCssSelector, byDataTestId, byInputType, byLinkedElement, byRole, byTagName, byValue, escapeUtil, listHelper, locatorUtil, timingUtil } from "@atomic-testing/core";
 //#region src/components/AccordionDriver.ts
 const parts$13 = {
 	/**
@@ -598,10 +598,10 @@ var DialogDriver = class extends ContainerDriver {
 			content: option?.content ?? {}
 		});
 	}
-	overriddenParentLocator() {
+	static overriddenParentLocator() {
 		return dialogRootLocator;
 	}
-	overrideLocatorRelativePosition() {
+	static overrideLocatorRelativePosition() {
 		return "Same";
 	}
 	async getTitle() {
@@ -681,8 +681,8 @@ const defaultTransitionDuration = 250;
 * `closeByBackdrop`.
 *
 * Subclasses supply {@link getSurfaceLocator} (the element whose visibility means
-* "open") and, when the overlay is portal-rendered, override
-* `overriddenParentLocator()`/`overrideLocatorRelativePosition()` to re-root.
+* "open") and, when the overlay is portal-rendered, override the static
+* `overriddenParentLocator()`/`overrideLocatorRelativePosition()` portal hooks to re-root.
 *
 * `closeByEscape` is intentionally absent: keyboard dismissal needs a key-press
 * primitive the `Interactor` interface does not yet expose, which would have to be
@@ -768,10 +768,10 @@ var DrawerDriver = class extends OverlayDriver {
 			content: option?.content ?? {}
 		});
 	}
-	overriddenParentLocator() {
+	static overriddenParentLocator() {
 		return drawerRootLocator;
 	}
-	overrideLocatorRelativePosition() {
+	static overrideLocatorRelativePosition() {
 		return "Same";
 	}
 	getSurfaceLocator() {
@@ -880,12 +880,12 @@ var InputDriver = class extends ComponentDriver {
 //#endregion
 //#region src/errors/MenuItemDisabledError.ts
 const MenuItemDisabledErrorId = "MenuItemDisabledError";
-function getErrorMessage$1(label) {
+function getErrorMessage(label) {
 	return `The menu item with label: ${label} is disabled`;
 }
 var MenuItemDisabledError = class extends ErrorBase {
 	constructor(label, driver) {
-		super(getErrorMessage$1(label), driver);
+		super(getErrorMessage(label), driver);
 		this.label = label;
 		this.driver = driver;
 		this.name = MenuItemDisabledErrorId;
@@ -935,14 +935,10 @@ var ListDriver = class extends ListComponentDriver {
 //#endregion
 //#region src/errors/MenuItemNotFoundError.ts
 const MenuItemNotFoundErrorId = "MenuItemNotFoundError";
-function getErrorMessage(label) {
-	return `Cannot find menu item with label: ${label}`;
-}
-var MenuItemNotFoundError = class extends ErrorBase {
+var MenuItemNotFoundError = class extends ItemNotFoundError {
 	constructor(label, driver) {
-		super(getErrorMessage(label), driver);
+		super(label, driver, `Cannot find menu item with label: ${label}`);
 		this.label = label;
-		this.driver = driver;
 		this.name = MenuItemNotFoundErrorId;
 	}
 };
@@ -974,10 +970,10 @@ var MenuDriver = class extends ComponentDriver {
 			parts: parts$6
 		});
 	}
-	overriddenParentLocator() {
+	static overriddenParentLocator() {
 		return menuRootLocator;
 	}
-	overrideLocatorRelativePosition() {
+	static overrideLocatorRelativePosition() {
 		return "Same";
 	}
 	async getMenuItemByLabel(label) {
@@ -1322,17 +1318,11 @@ var RatingDriver = class extends ComponentDriver {
 		return this.interactor.hasCssClass(this.locator, disabledClassName);
 	}
 	async setValue(value) {
-		const currentValue = await this.getValue();
-		if (value === currentValue) return true;
-		const valueToClick = value ?? currentValue;
-		if (valueToClick == null) return true;
-		const targetLocator = locatorUtil.append(this.parts.choices.locator, byValue(valueToClick.toString(), "Same"));
+		if (value === await this.getValue()) return true;
+		const targetValue = value == null ? "" : value.toString();
+		const targetLocator = locatorUtil.append(this.parts.choices.locator, byValue(targetValue, "Same"));
 		const targetExists = await this.interactor.exists(targetLocator);
-		if (targetExists) {
-			const id = await this.interactor.getAttribute(targetLocator, "id");
-			const labelLocator = locatorUtil.append(this.locator, byCssSelector(`label[for="${id}"]`));
-			await this.interactor.click(labelLocator);
-		}
+		if (targetExists) await this.interactor.activate(targetLocator);
 		return targetExists;
 	}
 	get driverName() {