@arcgis/lumina-compiler 5.2.0-next.2 → 5.2.0-next.21

package/dist/puppeteerTesting/index.d.ts

@@ -1,13 +1,20 @@
-import { PuppeteerMatchers } from './vitest/matchers/index.ts';
-export type * from './puppeteer/types.ts';
-export type { NewE2EPageOptions } from './puppeteer/page.ts';
-export { newE2EPage } from './puppeteer/page.ts';
-export type { E2EElement } from './puppeteer/element.ts';
-export type { EventSpy } from './puppeteer/events.ts';
-export { setupPuppeteerTest } from './vitest/setupFile.ts';
+import type { Assertion } from "vitest";
+
+export type * from "./puppeteer/types.js";
+export { type NewE2EPageOptions } from "./puppeteer/page.js";
+export { newE2EPage } from "./puppeteer/page.js";
+export { type E2EElement } from "./puppeteer/element.js";
+export { type EventSpy } from "./puppeteer/events.js";
+
+
+
+/** @public */
 declare module "vitest" {
-    interface Assertion<T = any> extends PuppeteerMatchers<T> {
-    }
-    interface AsymmetricMatchersContaining extends PuppeteerMatchers {
-    }
+  type PuppeteerMatchers<R = unknown> = import("./vitest/matchers/index.js").PuppeteerMatchers<R>;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  interface Assertion<T = any> extends PuppeteerMatchers<T> {}
+  interface AsymmetricMatchersContaining extends PuppeteerMatchers {}
 }
+
+/** @internal */
+export type AssertionType = Assertion;

package/dist/puppeteerTesting/index.js

@@ -1,7 +1,7 @@
-import { expect as p, afterEach as S } from "vitest";
-import { toSystemPathSeparators as V, isPosix as L } from "@arcgis/components-build-utils";
+import { toSystemPathSeparators as S, isPosix as V } from "@arcgis/components-build-utils";
 import { p as T, i as h } from "../types-C3YmWTVv.js";
 import { l as y } from "../logger-C9XakOcA.js";
+import { expect as p, afterEach as L } from "vitest";
 async function D(s) {
   await s.exposeFunction("puppeteerOnEvent", (e, t) => {
     j(s._e2eEvents, e, t);
@@ -37,15 +37,19 @@ class C {
   constructor(e) {
     this.events = [], this._cursor = 0, this._queuedHandler = [], this.eventName = e;
   }
+  /** @public */
   get length() {
     return this.events.length;
   }
+  /** @public */
   get firstEvent() {
     return this.events.at(0);
   }
+  /** @public */
   get lastEvent() {
     return this.events.at(-1);
   }
+  /** @public */
   async next() {
     const e = this._cursor;
     this._cursor++;
@@ -64,6 +68,10 @@ class C {
       }));
     }
   }
+  /**
+   * @public
+   * @param event
+   */
   push(e) {
     this.events.push(e);
     const t = this._queuedHandler.shift();
@@ -131,8 +139,8 @@ function z() {
     isSerializedEvent: !0
   });
 }
-const M = globalThis.HTMLElement ?? function() {
-};
+const M = globalThis.HTMLElement ?? (function() {
+});
 class d extends M {
   constructor(e = d._page, t = d._handle) {
     super(), this._queuedActions = [], this._temporaryDisableValidation = !1, this._page = e, this.handle = t, e._e2eElements.push(this);
@@ -167,6 +175,10 @@ class d extends M {
    * We can't directly call `new E22Element()` since it extends HTMLElement
    * which is not directly constructable. Instead, we register it as a custom
    * element.
+   *
+   * @public
+   * @param page
+   * @param handle
    */
   static create(e, t) {
     customElements.get("e2e-element") || customElements.define("e2e-element", d), d._page = e, d._handle = t;
@@ -181,6 +193,9 @@ class d extends M {
    * `my-cmp`, which is a child of this element, the call would be
    * `element.find('my-cmp >>> div')`. Returns `null` if no
    * elements were found.
+   *
+   * @public
+   * @param selector
    */
   async find(e) {
     return await x(this._page, this.handle, e);
@@ -193,6 +208,9 @@ class d extends M {
    * `my-cmp`, which is a child of this element, the call would be
    * `element.findAll('my-cmp >>> li')`. Returns an empty array if
    * no elements were found.
+   *
+   * @public
+   * @param selector
    */
   async findAll(e) {
     return await P(this._page, this.handle, e);
@@ -201,6 +219,10 @@ class d extends M {
    * Used to call a method on a component. For example, if a component
    * has the method `cmp.myMethod(arg1, arg2)`, calling this method
    * from a e2e test could be `cmp.callMethod('myMethod', arg1, arg2)`.
+   *
+   * @public
+   * @param methodName
+   * @param methodArgs
    */
   async callMethod(e, ...t) {
     return this._queuedActions.push({
@@ -212,6 +234,10 @@ class d extends M {
    * This is a convenience method to easily create a `CustomEvent`,
    * and dispatch it from the element, to include any custom event
    * `detail` data as the second argument.
+   *
+   * @public
+   * @param eventName
+   * @param eventInitDict
    */
   triggerEvent(e, t) {
     this._queuedActions.push({
@@ -225,6 +251,9 @@ class d extends M {
    * can be used along with `expect(spy).toHaveReceivedEvent()`,
    * `expect(spy).toHaveReceivedEventTimes(x)` and
    * `expect(spy).toHaveReceivedEventDetail({...})`.
+   *
+   * @public
+   * @param eventName
    */
   async spyOnEvent(e) {
     const t = new C(e);
@@ -236,6 +265,9 @@ class d extends M {
    * Calling `click()` on an element scrolls it into view if needed, and
    * then uses `page.mouse` to click in the center of the element.
    * Please see the puppeteer docs for more information.
+   *
+   * @public
+   * @param options
    */
   // eslint-disable-next-line @typescript-eslint/no-misused-promises
   async click(e) {
@@ -243,6 +275,8 @@ class d extends M {
   }
   /**
    * Sets focus on the element.
+   *
+   * @public
    */
   // eslint-disable-next-line @typescript-eslint/no-misused-promises
   async focus() {
@@ -250,6 +284,8 @@ class d extends M {
   }
   /**
    * Sets hover on the element.
+   *
+   * @public
    */
   async hover() {
     await this.handle.hover(), await this._page.waitForChanges();
@@ -257,6 +293,8 @@ class d extends M {
   /**
    * Resolves `true` when the element's style is `display !== 'none'`,
    * `visibility !== 'hidden'` and `opacity !== '0'`.
+   *
+   * @public
    */
   async isVisible() {
     this._validate();
@@ -282,6 +320,9 @@ class d extends M {
   }
   /**
    * Waits until the given event is listened in the element.
+   *
+   * @public
+   * @param eventName
    */
   async waitForEvent(e) {
     return await $(this._page, e, this.handle);
@@ -290,6 +331,8 @@ class d extends M {
    * Waits until the element's style is `display !== 'none'`,
    * `visibility !== 'hidden'`, `opacity !== '0'` and the element
    * is connected to the document.
+   *
+   * @public
    */
   async waitForVisible() {
     await this.awaitVisibility();
@@ -298,10 +341,16 @@ class d extends M {
    * Waits until the element's style is `display === 'none'`, or
    * `visibility === 'hidden'`, or `opacity === '0'`, or the element
    * is no longer connected to the document.
+   *
+   * @public
    */
   async waitForNotVisible() {
     await this.awaitVisibility(!1);
   }
+  /**
+   * @public
+   * @param waitForVisible
+   */
   async awaitVisibility(e = !0) {
     await new Promise((t, n) => {
       const a = async () => {
@@ -316,6 +365,8 @@ class d extends M {
   }
   /**
    * Resolves to true if the element is visible in the current viewport.
+   *
+   * @public
    */
   async isIntersectingViewport() {
     return await this.handle.isIntersectingViewport();
@@ -328,6 +379,10 @@ class d extends M {
    * Note: Modifier keys DO effect `elementHandle.press`. Holding down Shift
    * will type the text in upper case.
    * Key names: https://github.com/puppeteer/puppeteer/blob/main/src/common/USKeyboardLayout.ts
+   *
+   * @public
+   * @param key
+   * @param options
    */
   async press(e, t) {
     await this.handle.press(e, t), await this._page.waitForChanges();
@@ -335,6 +390,8 @@ class d extends M {
   /**
    * This method scrolls the element it into view if needed,
    * and then uses `page.touchscreen` to tap in the center of the element.
+   *
+   * @public
    */
   async tap() {
     await this.handle.tap(), await this._page.waitForChanges();
@@ -342,6 +399,10 @@ class d extends M {
   /**
    * Sends a keydown, keypress/input, and keyup event for each character in the text.
    * To press a special key, like Control or ArrowDown, use `keyboard.press`.
+   *
+   * @public
+   * @param text
+   * @param options
    */
   async type(e, t) {
     await this.handle.type(e, t), await this._page.waitForChanges();
@@ -349,6 +410,9 @@ class d extends M {
   /**
    * Returns the value of a specified attribute on the element. If the
    * given attribute does not exist, the value returned will be null.
+   *
+   * @public
+   * @param propertyName
    */
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   async getProperty(e) {
@@ -363,6 +427,10 @@ class d extends M {
    * component has the property `elm.myProp`, then calling
    * `elm.setProperty('myProp', 88)` would set the value `88` to
    * the `myProp` property on the component.
+   *
+   * @public
+   * @param propertyName
+   * @param value
    */
   setProperty(e, t) {
     this._queuedActions.push({
@@ -373,6 +441,9 @@ class d extends M {
   /**
    * Returns the value of a specified attribute on the element. If the
    * given attribute does not exist, the value returned will be null.
+   *
+   * @public
+   * @param name
    */
   getAttribute(e) {
     return this._validate(), super.getAttribute(e);
@@ -381,6 +452,10 @@ class d extends M {
    * Removes the attribute on the specified element. Note that
    * `await page.waitForChanges()` must be called before reading
    * the value if content has changed.
+   *
+   * @public
+   * @param name
+   * @param value
    */
   setAttribute(e, t) {
     super.setAttribute(e, t), this._queuedActions.push({
@@ -392,6 +467,9 @@ class d extends M {
    * Removes the attribute on the specified element. Note that
    * `await page.waitForChanges()` must be called before reading
    * the value if content has changed.
+   *
+   * @public
+   * @param name
    */
   removeAttribute(e) {
     super.removeAttribute(e), this._queuedActions.push({
@@ -405,6 +483,10 @@ class d extends M {
    * the value if content has changed. The optional `force` argument is a
    * `boolean` value to determine whether the attribute should be added or
    * removed, no matter whether the attribute is present or not at the moment.
+   *
+   * @public
+   * @param name
+   * @param force
    */
   toggleAttribute(e, t) {
     const n = super.toggleAttribute(e, t);
@@ -417,6 +499,8 @@ class d extends M {
    * Gets and sets `innerHTML` property of the element.
    * Note that `await page.waitForChanges()` must be called before reading
    * the value if content has changed.
+   *
+   * @public
    */
   get innerHTML() {
     return this._validate(), super.innerHTML;
@@ -431,6 +515,8 @@ class d extends M {
    * Gets and sets `innerText` property of the element.
    * Note that `await page.waitForChanges()` must be called before reading
    * the value if content has changed.
+   *
+   * @public
    */
   get innerText() {
     return this._validate(), super.innerText;
@@ -441,6 +527,7 @@ class d extends M {
       setPropertyValue: e
     });
   }
+  /** @public */
   get nodeValue() {
     return this._validate(), super.nodeValue;
   }
@@ -453,6 +540,8 @@ class d extends M {
   /**
    * Gets the element's `outerHTML. This is a read-only property and will
    * throw an error if set.
+   *
+   * @public
    */
   // eslint-disable-next-line @typescript-eslint/related-getter-setter-pairs
   get outerHTML() {
@@ -465,6 +554,8 @@ class d extends M {
    * The `textContent` property represents the text content of a node
    * and its descendants. Note that `await page.waitForChanges()` must
    * be called before reading the value if content has changed.
+   *
+   * @public
    */
   get textContent() {
     return this._validate(), super.textContent;
@@ -481,6 +572,9 @@ class d extends M {
    * those values may contain. Individual CSS property values are accessed by
    * simply indexing with CSS property names. The method is shortcut and an async
    * version of using `window.getComputedStyle(element)` directly.
+   *
+   * @public
+   * @param pseudoElement
    */
   async getComputedStyle(e) {
     e !== "::after" && e !== "::before" && e !== ":after" && e !== ":before" && (e = null);
@@ -523,6 +617,7 @@ class d extends M {
     );
     return t.getPropertyValue = (n) => t[n], t;
   }
+  /** @public */
   async e2eRunActions() {
     if (this._queuedActions.length === 0)
       return;
@@ -569,6 +664,7 @@ class d extends M {
     );
     return this._queuedActions.length = 0, t;
   }
+  /** @public */
   async e2eSync() {
     const e = this.handle.frame, { outerHtml: t, shadowRootHtml: n } = await e.evaluate(
       (r) => ({
@@ -618,6 +714,7 @@ class d extends M {
         throw new Error("trying to read from a disposed element");
     }
   }
+  /** @public */
   async e2eDispose() {
     this.handle && (await this.handle.dispose(), this.handle = null);
     const e = this._page._e2eElements.indexOf(this);
@@ -977,12 +1074,12 @@ function K(s) {
   if (s?.url) {
     const t = s.url.indexOf(_);
     e = `  ${decodeURIComponent(
-      t === -1 ? s.url : V(s.url.slice(t + _.length))
+      t === -1 ? s.url : S(s.url.slice(t + _.length))
     )}`, s.lineNumber && (e += `:${s.lineNumber}`), s.columnNumber && (e += `:${s.columnNumber}`);
   }
   return e;
 }
-const _ = L ? "/@fs" : "/@fs/";
+const _ = V ? "/@fs" : "/@fs/";
 function f(s, e) {
   if (typeof s != "object" || s === null)
     throw new Error(`${e} expect called with non-element value`);
@@ -1124,7 +1221,7 @@ const ne = (s, e) => {
   toHaveNthReceivedEventDetail: oe
 };
 function pe() {
-  p.extend(ce), S(() => {
+  p.extend(ce), L(() => {
     document.body.childNodes.forEach(R);
   });
 }