Add: example to matcher and refactored JSDoc across class

Author: SbsCruz

packages/dom/src/lib/ElementAssertion.ts

@@ -60,8 +60,8 @@ export class ElementAssertion<T extends Element> extends Assertion<T> {
   /**
    * Check if the element has a specific attribute.
    *
-   * @param name - The attribute name.
-   * @param expectedValue - The expected attribute value (Optional).
+   * @param name the attribute name.
+   * @param expectedValue the expected attribute value (Optional).
    * @returns the assertion instance.
    */
   public toHaveAttribute(name: string, expectedValue?: string): this {
@@ -97,7 +97,7 @@ export class ElementAssertion<T extends Element> extends Assertion<T> {
   /**
    * Asserts that the element has the specified class.
    *
-   * @param className The class name to check.
+   * @param className the class name to check.
    * @returns the assertion instance.
    */
   public toHaveClass(className: string): this {
@@ -131,7 +131,7 @@ export class ElementAssertion<T extends Element> extends Assertion<T> {
   /**
    * Asserts that the element has all of the specified classes.
    *
-   * @param classNames - A variadic list of class names to check.
+   * @param classNames a variadic list of class names to check.
    * @returns the assertion instance.
    */
   public toHaveAllClasses(...classNames: string[]): this {
@@ -148,13 +148,17 @@ export class ElementAssertion<T extends Element> extends Assertion<T> {
   /**
    * Asserts that the element has the specified CSS styles.
    *
-   * @param expected - The expected CSS styles.
-   * @returns The assertion instance.
+   * @example
+   * ```
+   * expect(component).toHaveStyle({ color: 'green', display: 'block' });
+   * ```
+   *
+   * @param expected the expected CSS styles.
+   * @returns the assertion instance.
    */
-
   public toHaveStyle(expected: Partial<CSSStyleDeclaration>): this {
     if (!this.actual.ownerDocument.defaultView) {
-      throw new Error("The element is not attached to a document with a default view.");
+      throw new Error("The element does not contain default view property.");
     }
     if (!(this.actual instanceof HTMLElement)) {
       throw new Error("The element is not an HTMLElement.");
@@ -188,10 +192,10 @@ export class ElementAssertion<T extends Element> extends Assertion<T> {
   /**
    * Helper method to assert the presence or absence of class names.
    *
-   * @param assertCondition - Boolean to determine assertion pass or fail.
-   * @param classNames - Array of class names involved in the assertion.
-   * @param message - Assertion error message.
-   * @param invertedMessage - Inverted assertion error message.
+   * @param assertCondition boolean to determine assertion pass or fail.
+   * @param classNames array of class names involved in the assertion.
+   * @param message assertion error message.
+   * @param invertedMessage inverted assertion error message.
    * @returns the assertion instance.
    */
   private assertClassPresence(