@wdio/browser-runner 8.29.6 → 8.30.0

package/build/browser/driver.js

@@ -3,7 +3,7 @@ import { webdriverMonad, sessionEnvironmentDetector } from '@wdio/utils';
 import { getEnvironmentVars } from 'webdriver';
 import { MESSAGE_TYPES } from '@wdio/types';
 import { browser } from '@wdio/globals';
-import { getCID } from './utils.js';
+import { getCID, sanitizeConsoleArgs } from './utils.js';
 import { WDIO_EVENT_NAME } from '../constants.js';
 const COMMAND_TIMEOUT = 30 * 1000; // 30s
 const CONSOLE_METHODS = ['log', 'info', 'warn', 'error', 'debug'];
@@ -147,7 +147,7 @@ export default class ProxyDriver {
                 import.meta.hot?.send(WDIO_EVENT_NAME, this.#consoleMessage({
                     name: 'consoleEvent',
                     type: method,
-                    args,
+                    args: sanitizeConsoleArgs(args),
                     cid
                 }));
                 origCommand(...args);

package/build/browser/expect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/browser/expect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA2E,MAAM,QAAQ,CAAA;AA2JxG,OAAO,EAAE,MAAM,EAAE,CAAA"}
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/browser/expect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA2E,MAAM,QAAQ,CAAA;AA2LxG,OAAO,EAAE,MAAM,EAAE,CAAA"}

package/build/browser/expect.js

@@ -1,6 +1,5 @@
 import { expect } from 'expect';
 import { MESSAGE_TYPES } from '@wdio/types';
-import { matchers } from 'virtual:wdio';
 import { $ } from '@wdio/globals';
 import { getCID } from './utils.js';
 import { WDIO_EVENT_NAME } from '../constants.js';
@@ -11,14 +10,13 @@ let matcherRequestCount = 0;
 const matcherRequests = new Map();
 const COMMAND_TIMEOUT = 30 * 1000; // 30s
 /**
- * Set up expect-webdriverio matchers for the browser environment.
- * Every assertion is send to the testrunner via a websocket connection
- * and is executed in the Node.js environment. This allows us to enable
- * matchers that require Node.js specific modules like `fs` or `child_process`,
- * for visual regression or snapshot testing for example.
+ * Matcher factory enables to run all matchers within the browser by sending all necessary information
+ * to the worker process and execute the actual assertion in the Node.js environment.
+ * @param matcherName name of the matcher
+ * @returns a matcher result computed in the Node.js environment
  */
-expect.extend(matchers.reduce((acc, matcherName) => {
-    acc[matcherName] = async function (context, ...args) {
+function createMatcher(matcherName) {
+    return async function (context, ...args) {
         const cid = getCID();
         if (!import.meta.hot || !cid) {
             return {
@@ -40,25 +38,26 @@ expect.extend(matchers.reduce((acc, matcherName) => {
             matcherName,
             args: args
         };
+        const isContextObject = typeof context === 'object';
         /**
          * Check if context is an WebdriverIO.Element
          */
-        if ('elementId' in context && typeof context.elementId === 'string') {
+        if (isContextObject && 'elementId' in context && typeof context.elementId === 'string') {
             expectRequest.element = context;
         }
         /**
          * Check if context is ChainablePromiseElement
          */
-        if ('then' in context && typeof context.selector === 'object') {
+        if (isContextObject && 'then' in context && typeof context.selector === 'object') {
             expectRequest.element = await context;
         }
         /**
-         * Check if context is a `Element` and transtform it into a WebdriverIO.Element
+         * Check if context is a `Element` and transform it into a WebdriverIO.Element
          */
         if (context instanceof Element) {
             expectRequest.element = await $(context);
         }
-        else if (typeof context === 'object' && !('sessionId' in context)) {
+        else if (isContextObject && !('sessionId' in context)) {
             /**
              * check if context is an object or promise and resolve it
              * but not pass through the browser object
@@ -68,6 +67,12 @@ expect.extend(matchers.reduce((acc, matcherName) => {
                 expectRequest.context = await context;
             }
         }
+        else if (!isContextObject) {
+            /**
+             * if context is not an object or promise, pass it through
+             */
+            expectRequest.context = context;
+        }
         /**
          * Avoid serialization issues when sending over the element. If we create
          * an element from an existing HTMLElement, it might have custom properties
@@ -97,18 +102,42 @@ expect.extend(matchers.reduce((acc, matcherName) => {
                 .replace('/@fs/', '/');
         }
         import.meta.hot.send(WDIO_EVENT_NAME, { type: MESSAGE_TYPES.expectRequestMessage, value: expectRequest });
-        const contextString = 'elementId' in context ? 'WebdriverIO.Element' : 'WebdriverIO.Browser';
+        const contextString = isContextObject
+            ? 'elementId' in context
+                ? 'WebdriverIO.Element'
+                : 'WebdriverIO.Browser'
+            : context;
         return new Promise((resolve, reject) => {
             const commandTimeout = setTimeout(() => reject(new Error(`Assertion expect(${contextString}).${matcherName}(...) timed out`)), COMMAND_TIMEOUT);
             matcherRequests.set(expectRequest.id, { resolve, commandTimeout });
         });
     };
-    return acc;
-}, {}));
+}
+/**
+ * request all available matchers from the testrunner
+ */
+import.meta.hot?.send(WDIO_EVENT_NAME, { type: MESSAGE_TYPES.expectMatchersRequest });
 /**
  * listen on assertion results from testrunner
  */
 import.meta.hot?.on(WDIO_EVENT_NAME, (message) => {
+    /**
+     * Set up `expect-webdriverio` matchers for the browser environment.
+     * Every assertion is send to the testrunner via a websocket connection
+     * and is executed in the Node.js environment. This allows us to enable
+     * matchers that require Node.js specific modules like `fs` or `child_process`,
+     * for visual regression or snapshot testing for example.
+     *
+     * The testrunner will send a list of available matchers to the browser
+     * since there might services or other hooks that add custom matchers.
+     */
+    if (message.type === MESSAGE_TYPES.expectMatchersResponse) {
+        const matchers = message.value.matchers.reduce((acc, matcherName) => {
+            acc[matcherName] = createMatcher(matcherName);
+            return acc;
+        }, {});
+        expect.extend(matchers);
+    }
     if (message.type !== MESSAGE_TYPES.expectResponseMessage) {
         return;
     }

package/build/browser/{fixtures → integrations}/stencil.d.ts

@@ -6,6 +6,10 @@ import type { NewSpecPageOptions } from '@stencil/core/internal';
  * @returns the created spec page
  */
 export declare function render(opts: NewSpecPageOptions): StencilEnvironment;
+/**
+ * Helper method to wait until all Stencil components are rendered
+ */
+export declare function waitForChanges(documentElement?: HTMLElement): Promise<void>;
 /**
  * A set of flags used for bitwise calculations against {@link ComponentRuntimeMeta#$flags$}.
  *

package/build/browser/integrations/stencil.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stencil.d.ts","sourceRoot":"","sources":["../../../src/browser/integrations/stencil.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAgBrE,OAAO,KAAK,EAMR,kBAAkB,EACrB,MAAM,wBAAwB,CAAA;AAe/B;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAwInE;AAsGD;;GAEG;AACH,wBAAgB,cAAc,CAAE,eAAe,cAA2B,iBA4BzE;AAED;;;;;GAKG;AACH,0BAAkB,SAAS;IACvB;;;OAGG;IACH,sBAAsB,IAAS;IAC/B;;;OAGG;IACH,sBAAsB,IAAS;IAC/B;;OAEG;IACH,iBAAiB,IAAS;IAM1B;;;;;OAKG;IACH,kBAAkB,IAAS;IAC3B;;;OAGG;IACH,oBAAoB,KAAS;IAC7B;;OAEG;IACH,OAAO,KAAS;IAEhB;;;;;OAKG;IACH,wBAAwB,KAA8C;CACzE;AASD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,iBACrB,GAAG,kBACD,OAAO,KACxB,GAyBF,CAAA"}

package/build/browser/{fixtures → integrations}/stencil.js

@@ -1,4 +1,5 @@
 import { h } from '@stencil/core';
+import { $ } from '@wdio/globals';
 /**
  * Emulate Node.js `nextTick` function in browser.
  * This is used by Stencil.js internally.
@@ -109,6 +110,9 @@ export function render(opts) {
         };
         renderVdom(ref, opts.template());
     }
+    else if (typeof opts.html === 'string') {
+        container.innerHTML = opts.html;
+    }
     let rootComponent = null;
     Object.defineProperty(page, 'root', {
         get() {
@@ -121,6 +125,16 @@ export function render(opts) {
             return container.firstElementChild;
         },
     });
+    Object.defineProperty(page, '$root', {
+        get() {
+            return $(page.root);
+        }
+    });
+    Object.defineProperty(page, '$container', {
+        get() {
+            return $(container);
+        }
+    });
     if (opts.hydrateServerSide) {
         insertVdomAnnotations(document, []);
     }
@@ -225,6 +239,35 @@ function findRootComponent(cmpTags, node) {
     }
     return null;
 }
+/**
+ * Helper method to wait until all Stencil components are rendered
+ */
+export function waitForChanges(documentElement = document.documentElement) {
+    return new Promise((resolve) => {
+        requestAnimationFrame(() => {
+            const promiseChain = [];
+            const waitComponentOnReady = (elm, promises) => {
+                if ('shadowRoot' in elm && elm.shadowRoot instanceof ShadowRoot) {
+                    waitComponentOnReady(elm.shadowRoot, promises);
+                }
+                const children = elm.children;
+                const len = children.length;
+                for (let i = 0; i < len; i++) {
+                    const childElm = children[i];
+                    const childStencilElm = childElm;
+                    if (childElm.tagName.includes('-') && typeof childStencilElm.componentOnReady === 'function') {
+                        promises.push(childStencilElm.componentOnReady().then(() => { }));
+                    }
+                    waitComponentOnReady(childElm, promises);
+                }
+            };
+            waitComponentOnReady(documentElement, promiseChain);
+            Promise.all(promiseChain)
+                .then(() => resolve())
+                .catch(() => resolve());
+        });
+    });
+}
 const formatLazyBundleRuntimeMeta = (bundleId, cmps) => {
     return [bundleId, cmps.map((cmp) => formatComponentRuntimeMeta(cmp, true))];
 };

package/build/browser/utils.d.ts

@@ -1,3 +1,4 @@
 export declare function getCID(): string | undefined;
 export declare const showPopupWarning: <T>(name: string, value: T, defaultValue?: T | undefined) => (...params: any[]) => T;
+export declare function sanitizeConsoleArgs(args: unknown[]): any[];
 //# sourceMappingURL=utils.d.ts.map

package/build/browser/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/browser/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,uBAYrB;AAED,eAAO,MAAM,gBAAgB,YAAa,MAAM,yDAA6C,GAAG,EAAE,MAYjG,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/browser/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,uBAYrB;AAED,eAAO,MAAM,gBAAgB,YAAa,MAAM,yDAA6C,GAAG,EAAE,MAYjG,CAAA;AAED,wBAAgB,mBAAmB,CAAE,IAAI,EAAE,OAAO,EAAE,SAyBnD"}

package/build/browser/utils.js

@@ -22,3 +22,27 @@ export const showPopupWarning = (name, value, defaultValue) => (...params) => {
   \`\`\``);
     return value;
 };
+export function sanitizeConsoleArgs(args) {
+    return args.map((arg) => {
+        try {
+            if (arg && typeof arg.elementId === 'string') {
+                return `WebdriverIO.Element<${arg.elementId}>`;
+            }
+            if (arg && typeof arg.sessionId === 'string') {
+                return `WebdriverIO.Browser<${arg.sessionId}>`;
+            }
+        }
+        catch (err) {
+            // ignore
+        }
+        if (arg instanceof HTMLElement ||
+            (arg && typeof arg === 'object' && 'then' in arg && typeof arg.then === 'function') ||
+            typeof arg === 'function') {
+            return arg.toString();
+        }
+        if (arg instanceof Error) {
+            return arg.stack;
+        }
+        return arg;
+    });
+}

package/build/vite/frameworks/stencil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stencil.d.ts","sourceRoot":"","sources":["../../../src/vite/frameworks/stencil.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,MAAM,CAAA;AAahD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,oBAAoB,oBAEhG;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,yBAwBvD;AAwID;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,gBAaxD"}
+{"version":3,"file":"stencil.d.ts","sourceRoot":"","sources":["../../../src/vite/frameworks/stencil.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAU,MAAM,MAAM,CAAA;AAahD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,oBAAoB,oBAEhG;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,yBAwBvD;AA2ID;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,MAAM,gBAaxD"}

package/build/vite/frameworks/stencil.js

@@ -30,7 +30,7 @@ export async function optimizeForStencil(rootDir) {
 }
 async function stencilVitePlugin(rootDir) {
     const { transpileSync, ts } = await import('@stencil/core/compiler/stencil.js');
-    const stencilHelperPath = path.resolve(__dirname, '..', '..', 'browser', 'fixtures', 'stencil.js');
+    const stencilHelperPath = path.resolve(__dirname, '..', '..', 'browser', 'integrations', 'stencil.js');
     return {
         name: 'wdio-stencil',
         enforce: 'pre',
@@ -56,15 +56,8 @@ async function stencilVitePlugin(rootDir) {
                 const stencilHelperImport = staticImports.find((imp) => imp.specifier === '@wdio/browser-runner/stencil');
                 if (stencilHelperImport) {
                     const imports = parseStaticImport(stencilHelperImport);
-                    const hasHImport = stencilImports.find((imp) => 'h' in (imp.namedImports || {}));
-                    const hasFragmentImport = stencilImports.find((imp) => 'Fragment' in (imp.namedImports || {}));
                     if ('render' in (imports.namedImports || {})) {
-                        if (!hasHImport) {
-                            code = `import { h } from '@stencil/core';\n${code}`;
-                        }
-                        if (!hasFragmentImport) {
-                            code = `import { Fragment } from '@stencil/core';\n${code}`;
-                        }
+                        code = injectStencilImports(code, stencilImports);
                     }
                 }
                 return { code };
@@ -97,14 +90,7 @@ async function stencilVitePlugin(rootDir) {
              * StencilJS does not import the `h` or `Fragment` function by default. We need to add it so the user
              * doesn't need to.
              */
-            const hasRenderFunctionImport = stencilImports.some((imp) => 'h' in (imp.namedImports || {}));
-            if (!hasRenderFunctionImport) {
-                transformedCode = `import { h } from '@stencil/core';\n${transformedCode}`;
-            }
-            const hasFragmentImport = stencilImports.some((imp) => 'Fragment' in (imp.namedImports || {}));
-            if (!hasFragmentImport) {
-                transformedCode = `import { Fragment } from '@stencil/core';\n${transformedCode}`;
-            }
+            transformedCode = injectStencilImports(transformedCode, stencilImports);
             return {
                 ...transpiledCode,
                 code: transformedCode,
@@ -113,6 +99,21 @@ async function stencilVitePlugin(rootDir) {
         }
     };
 }
+/**
+ * StencilJS does not import the `h` or `Fragment` function by default. We need to add it so the user
+ * doesn't need to.
+ */
+function injectStencilImports(code, imports) {
+    const hasRenderFunctionImport = imports.some((imp) => 'h' in (imp.namedImports || {}));
+    if (!hasRenderFunctionImport) {
+        code = `import { h } from '@stencil/core/internal/client';\n${code}`;
+    }
+    const hasFragmentImport = imports.some((imp) => 'Fragment' in (imp.namedImports || {}));
+    if (!hasFragmentImport) {
+        code = `import { Fragment } from '@stencil/core/internal/client';\n${code}`;
+    }
+    return code;
+}
 let _tsCompilerOptions = null;
 /**
  * Read the TypeScript compiler configuration file from disk

package/build/vite/plugins/testrunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testrunner.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/testrunner.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA2ClC,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,oBAAoB,GAAG,MAAM,EAAE,CA2I9E"}
+{"version":3,"file":"testrunner.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/testrunner.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAA;AA2ClC,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,CAAC,oBAAoB,GAAG,MAAM,EAAE,CA0I9E"}

package/build/vite/plugins/testrunner.js

@@ -2,7 +2,6 @@ import url from 'node:url';
 import path from 'node:path';
 import { builtinModules } from 'node:module';
 import logger from '@wdio/logger';
-import { matchers } from 'expect-webdriverio';
 import { polyfillPath } from 'modern-node-polyfills';
 import { deepmerge } from 'deepmerge-ts';
 import { resolve } from 'import-meta-resolve';
@@ -90,7 +89,6 @@ export function testrunner(options) {
                     import { fn } from '@wdio/browser-runner'
                     export const commands = ${JSON.stringify(protocolCommandList)}
                     export const automationProtocolPath = ${JSON.stringify(automationProtocolPath)}
-                    export const matchers = ${JSON.stringify(Object.keys(matchers))}
                     export const wrappedFn = (...args) => fn()(...args)
                 `;
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wdio/browser-runner",
-  "version": "8.29.6",
+  "version": "8.30.0",
   "description": "A WebdriverIO runner to run unit tests tests in the browser.",
   "author": "Christian Bromann <mail@bromann.dev>",
   "homepage": "https://github.com/webdriverio/webdriverio/tree/main/packages/wdio-browser-runner",
@@ -37,17 +37,17 @@
     "@originjs/vite-plugin-commonjs": "^1.0.3",
     "@types/istanbul-lib-source-maps": "^4.0.1",
     "@vitest/spy": "^1.0.1",
-    "@wdio/globals": "8.29.3",
-    "@wdio/local-runner": "8.29.5",
+    "@wdio/globals": "8.30.0",
+    "@wdio/local-runner": "8.30.0",
     "@wdio/logger": "8.28.0",
-    "@wdio/mocha-framework": "8.29.3",
-    "@wdio/protocols": "^8.24.12",
-    "@wdio/runner": "8.29.5",
-    "@wdio/types": "8.29.1",
-    "@wdio/utils": "8.29.3",
+    "@wdio/mocha-framework": "8.30.0",
+    "@wdio/protocols": "8.29.7",
+    "@wdio/runner": "8.30.0",
+    "@wdio/types": "8.30.0",
+    "@wdio/utils": "8.30.0",
     "deepmerge-ts": "^5.0.0",
     "expect": "^29.7.0",
-    "expect-webdriverio": "^4.9.3",
+    "expect-webdriverio": "^4.10.1",
     "get-port": "^7.0.0",
     "import-meta-resolve": "^4.0.0",
     "istanbul-lib-coverage": "^3.2.0",
@@ -62,8 +62,8 @@
     "vite": "~4.5.0",
     "vite-plugin-istanbul": "^5.0.0",
     "vite-plugin-top-level-await": "^1.3.0",
-    "webdriver": "8.29.3",
-    "webdriverio": "8.29.3"
+    "webdriver": "8.30.0",
+    "webdriverio": "8.30.0"
   },
   "scripts": {
     "prepare": "rimraf node_modules/@wdio/config node_modules/@wdio/repl node_modules/@wdio/utils"
@@ -71,5 +71,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "45ff936ee5c76137bf96c15a2fc36c362a0ff693"
+  "gitHead": "033e2a91e97c9bd060eb70f2e4e412d382bec3af"
 }

package/stencil/index.d.ts

@@ -17,6 +17,10 @@ export interface RenderOptions {
      * It will render the specified template (JSX) into `document.body`.
      */
     template?: () => any;
+    /**
+     * The initial HTML used to generate the test. This can be useful to construct a collection of components working together, and assign HTML attributes.
+     */
+    html?: string;
     /**
      * Sets the mocked `lang` attribute on `<html>`.
      */
@@ -24,25 +28,17 @@ export interface RenderOptions {
     /**
      * Useful for debugging hydrating components client-side. Sets that the `html` option already includes annotated prerender attributes and comments.
      */
-    hydrateClientSide?: boolean;
+    // hydrateClientSide?: boolean;
     /**
      * Useful for debugging hydrating components server-side. The output HTML will also include prerender annotations.
      */
-    hydrateServerSide?: boolean;
-    /**
-     * Sets the mocked `document.referrer`.
-     */
-    referrer?: string;
-    /**
-     * Manually set if the mocked document supports Shadow DOM or not. Default is `true`.
-     */
-    supportsShadowDom?: boolean;
+    // hydrateServerSide?: boolean;
     /**
      * When a component is pre-rendered it includes HTML annotations, such as `s-id` attributes and `<!-t.0->` comments. This information is used by clientside hydrating. Default is `false`.
      */
-    includeAnnotations?: boolean;
+    // includeAnnotations?: boolean;
     /**
-     * By default, any changes to component properties and attributes must `page.waitForChanges()` in order to test the updates. As an option, `autoAppluChanges` continuously flushes the queue on the background. Default is `false`.
+     * By default, any changes to component properties and attributes must `page.waitForChanges()` in order to test the updates. As an option, `autoApplyChanges` continuously flushes the queue on the background. Default is `false`.
      */
     autoApplyChanges?: boolean;
     /**
@@ -55,7 +51,7 @@ export interface RenderOptions {
      * When `true` all `BuildConditionals` will be assigned to the global testing `BUILD` object, regardless of their
      * value. When `false`, only `BuildConditionals` with a value of `true` will be assigned to the `BUILD` object.
      */
-    strictBuild?: boolean;
+    // strictBuild?: boolean;
 }
 
 export interface StencilEnvironment {
@@ -73,14 +69,33 @@ export interface StencilEnvironment {
      * Container element in which the template is being rendered into.
      */
     container: HTMLElement
+    /**
+     * The container element as WebdriverIO element.
+     */
+    $container: WebdriverIO.Element
     /**
      * The root component of the template.
      */
     root: HTMLElement
+    /**
+     * The root component as WebdriverIO element.
+     */
+    $root: WebdriverIO.Element
     /**
      * Removes the container element from the DOM.
      */
     unmount: () => void
 }
 
+/**
+ * Renders a Stencil component for testing into the page.
+ * @param opts options for the test page
+ * @returns a testing environment for the rendered component
+ */
 export function render(opts: RenderOptions): StencilEnvironment
+
+/**
+ * Waits for the next update cycle to complete.
+ * @returns a promise that resolves when the update cycle completes
+ */
+export function waitForChanges(): Promise<void>

package/build/browser/fixtures/stencil.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stencil.d.ts","sourceRoot":"","sources":["../../../src/browser/fixtures/stencil.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAA;AAgBrE,OAAO,KAAK,EAKR,kBAAkB,EACrB,MAAM,wBAAwB,CAAA;AAe/B;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CA2HnE;AAsGD;;;;;GAKG;AACH,0BAAkB,SAAS;IACvB;;;OAGG;IACH,sBAAsB,IAAS;IAC/B;;;OAGG;IACH,sBAAsB,IAAS;IAC/B;;OAEG;IACH,iBAAiB,IAAS;IAM1B;;;;;OAKG;IACH,kBAAkB,IAAS;IAC3B;;;OAGG;IACH,oBAAoB,KAAS;IAC7B;;OAEG;IACH,OAAO,KAAS;IAEhB;;;;;OAKG;IACH,wBAAwB,KAA8C;CACzE;AASD;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,iBACrB,GAAG,kBACD,OAAO,KACxB,GAyBF,CAAA"}