@rindo/core 4.23.2 → 4.26.0

package/internal/hydrate/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal/hydrate",
-  "version": "4.23.2",
+  "version": "4.26.0",
   "description": "Rindo internal hydrate platform to be imported by the Rindo Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "private": true

package/internal/hydrate/runner.d.ts

@@ -138,12 +138,29 @@ export interface SerializeDocumentOptions extends HydrateDocumentOptions {
 	 */
 	removeHtmlComments?: boolean;
 	/**
-	 * If set to `true` the component will be rendered within a Declarative Shadow DOM.
-	 * If set to `false` Rindo will ignore the contents of the shadow root and render the
-	 * element as given in provided template.
-	 * @default true
+	 * Configure how Rindo serializes the components shadow root.
+	 * - If set to `declarative-shadow-dom` the component will be rendered within a Declarative Shadow DOM.
+	 * - If set to `scoped` Rindo will render the contents of the shadow root as a `scoped: true` component
+	 *   and the shadow DOM will be created during client-side hydration.
+	 * - Alternatively you can mix and match the two by providing an object with `declarative-shadow-dom` and `scoped` keys,
+	 * the value arrays containing the tag names of the components that should be rendered in that mode.
+	 *
+	 * Examples:
+	 * - `{ 'declarative-shadow-dom': ['my-component-1', 'another-component'], default: 'scoped' }`
+	 * Render all components as `scoped` apart from `my-component-1` and `another-component`
+	 * -  `{ 'scoped': ['an-option-component'], default: 'declarative-shadow-dom' }`
+	 * Render all components within `declarative-shadow-dom` apart from `an-option-component`
+	 * - `'scoped'` Render all components as `scoped`
+	 * - `false` disables shadow root serialization
+	 *
+	 * *NOTE* `true` has been deprecated in favor of `declarative-shadow-dom` and `scoped`
+	 * @default 'declarative-shadow-dom'
 	 */
-	serializeShadowRoot?: boolean;
+	serializeShadowRoot?: "declarative-shadow-dom" | "scoped" | {
+		"declarative-shadow-dom"?: string[];
+		scoped?: string[];
+		default: "declarative-shadow-dom" | "scoped";
+	} | boolean;
 	/**
 	 * The `fullDocument` flag determines the format of the rendered output. Set it to true to
 	 * generate a complete HTML document, or false to render only the component.

package/internal/hydrate/runner.js

@@ -1,5 +1,5 @@
 /*
- Rindo Hydrate Runner v4.23.2 | MIT Licensed | https://rindojs.web.app
+ Rindo Hydrate Runner v4.26.0 | MIT Licensed | https://rindojs.web.app
  */
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
@@ -10416,7 +10416,7 @@ function normalizeSerializationOptions(opts = {}) {
     removeAttributeQuotes: typeof opts.removeAttributeQuotes !== "boolean" ? false : opts.removeAttributeQuotes,
     removeBooleanAttributeQuotes: typeof opts.removeBooleanAttributeQuotes !== "boolean" ? false : opts.removeBooleanAttributeQuotes,
     removeHtmlComments: typeof opts.removeHtmlComments !== "boolean" ? false : opts.removeHtmlComments,
-    serializeShadowRoot: typeof opts.serializeShadowRoot !== "boolean" ? true : opts.serializeShadowRoot,
+    serializeShadowRoot: typeof opts.serializeShadowRoot === "undefined" ? "declarative-shadow-dom" : opts.serializeShadowRoot,
     fullDocument: typeof opts.fullDocument !== "boolean" ? true : opts.fullDocument
   };
 }
@@ -10545,7 +10545,7 @@ style="${cssText}">`;
     }
     if (EMPTY_ELEMENTS.has(tagName) === false) {
       const shadowRoot = node.shadowRoot;
-      if (shadowRoot != null && opts.serializeShadowRoot) {
+      if (shadowRoot != null && opts.serializeShadowRoot !== false) {
         output.indent = output.indent + ((_c = opts.indentSpaces) != null ? _c : 0);
         yield* streamToHtml(shadowRoot, opts, output);
         output.indent = output.indent - ((_d = opts.indentSpaces) != null ? _d : 0);
@@ -10969,7 +10969,7 @@ var MockNode2 = class {
   }
   remove() {
     if (this.parentNode != null) {
-      this.parentNode.removeChild(this);
+      this.__parentNode ? this.__parentNode.removeChild(this) : this.parentNode.removeChild(this);
     }
   }
   replaceChild(newChild, oldChild) {
@@ -11923,6 +11923,10 @@ function createElement(ownerDocument, tagName) {
       return new MockMetaElement(ownerDocument);
     case "script":
       return new MockScriptElement(ownerDocument);
+    case "slot":
+      return new MockSlotElement(ownerDocument);
+    case "slot-fb":
+      return new MockHTMLElement(ownerDocument, tagName);
     case "style":
       return new MockStyleElement(ownerDocument);
     case "template":
@@ -11931,8 +11935,6 @@ function createElement(ownerDocument, tagName) {
       return new MockTitleElement(ownerDocument);
     case "ul":
       return new MockUListElement(ownerDocument);
-    case "slot-fb":
-      return new MockHTMLElement(ownerDocument, tagName);
   }
   if (ownerDocument != null && tagName.includes("-")) {
     const win2 = ownerDocument.defaultView;
@@ -12352,6 +12354,68 @@ var MockUListElement = class extends MockHTMLElement {
     super(ownerDocument, "ul");
   }
 };
+var MockSlotElement = class _MockSlotElement extends MockHTMLElement {
+  constructor(ownerDocument) {
+    super(ownerDocument, "slot");
+  }
+  assignedNodes(opts) {
+    let nodesToReturn = [];
+    const ownerHost = this.getRootNode().host;
+    if (!ownerHost) return nodesToReturn;
+    if (ownerHost.childNodes.length) {
+      if (this.name) {
+        nodesToReturn = ownerHost.childNodes.filter(
+          (n) => n.nodeType === 1 /* ELEMENT_NODE */ && n.getAttribute("slot") === this.name
+        );
+      } else {
+        nodesToReturn = ownerHost.childNodes.filter(
+          (n) => n.nodeType === 1 /* ELEMENT_NODE */ && !n.getAttribute("slot") || n.nodeType !== 1 /* ELEMENT_NODE */
+        );
+      }
+      if (nodesToReturn.length) return nodesToReturn;
+    }
+    if (!(opts == null ? void 0 : opts.flatten)) return this.childNodes.filter((n) => !(n instanceof _MockSlotElement));
+    return this.childNodes.reduce(
+      (acc, node) => {
+        if (node instanceof _MockSlotElement) {
+          acc.push(...node.assignedNodes(opts));
+        } else {
+          acc.push(node);
+        }
+        return acc;
+      },
+      []
+    );
+  }
+  assignedElements(opts) {
+    let elesToReturn = [];
+    const ownerHost = this.getRootNode().host;
+    if (!ownerHost) return elesToReturn;
+    if (ownerHost.children.length) {
+      if (this.name) {
+        elesToReturn = ownerHost.children.filter((n) => n.getAttribute("slot") == this.name);
+      } else {
+        elesToReturn = ownerHost.children.filter((n) => !n.getAttribute("slot"));
+      }
+      if (elesToReturn.length) return elesToReturn;
+    }
+    if (!(opts == null ? void 0 : opts.flatten)) return this.children.filter((n) => !(n instanceof _MockSlotElement));
+    return this.children.reduce(
+      (acc, node) => {
+        if (node instanceof _MockSlotElement) {
+          acc.push(...node.assignedElements(opts));
+        } else {
+          acc.push(node);
+        }
+        return acc;
+      },
+      []
+    );
+  }
+};
+patchPropAttributes(MockSlotElement.prototype, {
+  name: String
+});
 var CanvasRenderingContext = class {
   constructor(context, contextAttributes) {
     this.context = context;
@@ -13729,7 +13793,7 @@ function resetWindowDefaults(win2) {
   win2.__clearTimeout = nativeClearTimeout;
   win2.__setInterval = nativeSetInterval;
   win2.__setTimeout = nativeSetTimeout;
-  win2.__maxTimeout = 3e4;
+  win2.__maxTimeout = 6e4;
   win2.__allowInterval = true;
   win2.URL = nativeURL;
 }
@@ -14121,15 +14185,20 @@ var Build = {
 };
 
 // src/client/client-host-ref.ts
+import { BUILD as BUILD3 } from "@rindo/core/internal/app-data";
+
+// src/utils/es2022-rewire-class-members.ts
 import { BUILD as BUILD2 } from "@rindo/core/internal/app-data";
-var hostRefs = BUILD2.hotModuleReplacement ? window.__RINDO_HOSTREFS__ || (window.__RINDO_HOSTREFS__ = /* @__PURE__ */ new WeakMap()) : /* @__PURE__ */ new WeakMap();
+
+// src/client/client-host-ref.ts
+var hostRefs = BUILD3.hotModuleReplacement ? window.__RINDO_HOSTREFS__ || (window.__RINDO_HOSTREFS__ = /* @__PURE__ */ new WeakMap()) : /* @__PURE__ */ new WeakMap();
 
 // src/client/client-load-module.ts
-import { BUILD as BUILD4 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD5 } from "@rindo/core/internal/app-data";
 
 // src/client/client-log.ts
-import { BUILD as BUILD3 } from "@rindo/core/internal/app-data";
-var RINDO_DEV_MODE = BUILD3.isTesting ? ["RINDO:"] : [
+import { BUILD as BUILD4 } from "@rindo/core/internal/app-data";
+var RINDO_DEV_MODE = BUILD4.isTesting ? ["RINDO:"] : [
   "%crindo",
   "color: white;background:#4c47ff;font-weight: bold; font-size:10px; padding:2px 6px; border-radius: 5px"
 ];
@@ -14138,16 +14207,16 @@ var RINDO_DEV_MODE = BUILD3.isTesting ? ["RINDO:"] : [
 var modeResolutionChain = [];
 
 // src/client/client-task-queue.ts
-import { BUILD as BUILD6 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD7 } from "@rindo/core/internal/app-data";
 
 // src/client/client-window.ts
-import { BUILD as BUILD5 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD6 } from "@rindo/core/internal/app-data";
 var win = typeof window !== "undefined" ? window : {};
 var doc = win.document || { head: {} };
 var H = win.HTMLElement || class {
 };
-var supportsShadow = BUILD5.shadowDom;
-var supportsConstructableStylesheets = BUILD5.constructableCSS ? /* @__PURE__ */ (() => {
+var supportsShadow = BUILD6.shadowDom;
+var supportsConstructableStylesheets = BUILD6.constructableCSS ? /* @__PURE__ */ (() => {
   try {
     new CSSStyleSheet();
     return typeof new CSSStyleSheet().replaceSync === "function";
@@ -14157,10 +14226,10 @@ var supportsConstructableStylesheets = BUILD5.constructableCSS ? /* @__PURE__ */
 })() : false;
 
 // src/client/index.ts
-import { BUILD as BUILD28, Env, NAMESPACE as NAMESPACE2 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD29, Env, NAMESPACE as NAMESPACE2 } from "@rindo/core/internal/app-data";
 
 // src/runtime/bootstrap-custom-element.ts
-import { BUILD as BUILD25 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD26 } from "@rindo/core/internal/app-data";
 
 // src/utils/helpers.ts
 var isString = (v) => typeof v === "string";
@@ -14253,69 +14322,94 @@ var unwrapErr = (result) => {
 };
 
 // src/runtime/connected-callback.ts
-import { BUILD as BUILD23 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD24 } from "@rindo/core/internal/app-data";
 
 // src/runtime/client-hydrate.ts
-import { BUILD as BUILD14 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD12 } from "@rindo/core/internal/app-data";
 
 // src/runtime/dom-extras.ts
-import { BUILD as BUILD12 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD9 } from "@rindo/core/internal/app-data";
 
 // src/runtime/slot-polyfill-utils.ts
-import { BUILD as BUILD7 } from "@rindo/core/internal/app-data";
-
-// src/runtime/vdom/vdom-render.ts
-import { BUILD as BUILD11 } from "@rindo/core/internal/app-data";
-
-// src/runtime/vdom/h.ts
 import { BUILD as BUILD8 } from "@rindo/core/internal/app-data";
 
-// src/runtime/vdom/update-element.ts
+// src/runtime/profile.ts
 import { BUILD as BUILD10 } from "@rindo/core/internal/app-data";
 
-// src/runtime/vdom/set-accessor.ts
-import { BUILD as BUILD9 } from "@rindo/core/internal/app-data";
-var CAPTURE_EVENT_SUFFIX = "Capture";
-var CAPTURE_EVENT_REGEX = new RegExp(CAPTURE_EVENT_SUFFIX + "$");
-
-// src/runtime/profile.ts
-import { BUILD as BUILD13 } from "@rindo/core/internal/app-data";
+// src/runtime/vdom/h.ts
+import { BUILD as BUILD11 } from "@rindo/core/internal/app-data";
 
 // src/runtime/initialize-component.ts
-import { BUILD as BUILD22 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD23 } from "@rindo/core/internal/app-data";
+
+// src/utils/shadow-css.ts
+/**
+ * @license
+ * Copyright Google Inc. All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.io/license
+ *
+ * This file is a port of shadowCSS from `webcomponents.js` to TypeScript.
+ * https://github.com/webcomponents/webcomponentsjs/blob/4efecd7e0e/src/ShadowCSS/ShadowCSS.js
+ * https://github.com/angular/angular/blob/master/packages/compiler/src/shadow_css.ts
+ */
+var _polyfillHost = "-shadowcsshost";
+var _polyfillSlotted = "-shadowcssslotted";
+var _polyfillHostContext = "-shadowcsscontext";
+var _parenSuffix = ")(?:\\(((?:\\([^)(]*\\)|[^)(]*)+?)\\))?([^,{]*)";
+var _cssColonHostRe = new RegExp("(" + _polyfillHost + _parenSuffix, "gim");
+var _cssColonHostContextRe = new RegExp("(" + _polyfillHostContext + _parenSuffix, "gim");
+var _cssColonSlottedRe = new RegExp("(" + _polyfillSlotted + _parenSuffix, "gim");
+var _polyfillHostNoCombinator = _polyfillHost + "-no-combinator";
+var createSupportsRuleRe = (selector) => new RegExp(`((?<!(^@supports(.*)))|(?<={.*))(${selector}\\b)`, "gim");
+var _colonSlottedRe = createSupportsRuleRe("::slotted");
+var _colonHostRe = createSupportsRuleRe(":host");
+var _colonHostContextRe = createSupportsRuleRe(":host-context");
 
 // src/runtime/mode.ts
 var setMode = (handler) => modeResolutionChain.push(handler);
 
 // src/runtime/proxy-component.ts
-import { BUILD as BUILD21 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD22 } from "@rindo/core/internal/app-data";
 
 // src/runtime/set-value.ts
-import { BUILD as BUILD20 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD21 } from "@rindo/core/internal/app-data";
 
 // src/runtime/parse-property-value.ts
-import { BUILD as BUILD15 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD13 } from "@rindo/core/internal/app-data";
 
 // src/runtime/update-component.ts
-import { BUILD as BUILD19, NAMESPACE } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD20, NAMESPACE } from "@rindo/core/internal/app-data";
 
 // src/runtime/event-emitter.ts
-import { BUILD as BUILD17 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD15 } from "@rindo/core/internal/app-data";
 
 // src/runtime/element.ts
-import { BUILD as BUILD16 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD14 } from "@rindo/core/internal/app-data";
 
 // src/runtime/styles.ts
+import { BUILD as BUILD16 } from "@rindo/core/internal/app-data";
+
+// src/runtime/vdom/vdom-render.ts
+import { BUILD as BUILD19 } from "@rindo/core/internal/app-data";
+
+// src/runtime/vdom/update-element.ts
 import { BUILD as BUILD18 } from "@rindo/core/internal/app-data";
 
+// src/runtime/vdom/set-accessor.ts
+import { BUILD as BUILD17 } from "@rindo/core/internal/app-data";
+var CAPTURE_EVENT_SUFFIX = "Capture";
+var CAPTURE_EVENT_REGEX = new RegExp(CAPTURE_EVENT_SUFFIX + "$");
+
 // src/runtime/disconnected-callback.ts
-import { BUILD as BUILD24 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD25 } from "@rindo/core/internal/app-data";
 
 // src/runtime/bootstrap-lazy.ts
-import { BUILD as BUILD26 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD27 } from "@rindo/core/internal/app-data";
 
 // src/runtime/host-listener.ts
-import { BUILD as BUILD27 } from "@rindo/core/internal/app-data";
+import { BUILD as BUILD28 } from "@rindo/core/internal/app-data";
 
 // src/compiler/html/canonical-link.ts
 var updateCanonicalLink = (doc2, href) => {
@@ -15500,7 +15594,7 @@ function renderToString(html, options, asStream) {
   const opts = normalizeHydrateOptions(options);
   opts.serializeToHtml = true;
   opts.fullDocument = typeof opts.fullDocument === "boolean" ? opts.fullDocument : true;
-  opts.serializeShadowRoot = typeof opts.serializeShadowRoot === "boolean" ? opts.serializeShadowRoot : true;
+  opts.serializeShadowRoot = typeof opts.serializeShadowRoot === "undefined" ? "declarative-shadow-dom" : opts.serializeShadowRoot;
   opts.constrainTimeouts = false;
   return hydrateDocument(html, opts, asStream);
 }

package/internal/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rindo/core/internal",
-  "version": "4.23.2",
+  "version": "4.26.0",
   "description": "Rindo internals only to be imported by the Rindo Compiler. Breaking changes can and will happen at any time.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/internal/rindo-private.d.ts

@@ -1215,7 +1215,7 @@ export interface RenderNode extends HostElement {
      */
     ['s-sr']?: boolean;
     /**
-     * Slot name
+     * Slot name of either the slot itself or the slotted node
      */
     ['s-sn']?: string;
     /**
@@ -1248,7 +1248,7 @@ export interface RenderNode extends HostElement {
      * This is a reference for a original location node
      * back to the node that's been moved around.
      */
-    ['s-nr']?: RenderNode;
+    ['s-nr']?: PatchedSlotNode | RenderNode;
     /**
      * Original Order:
      * During SSR; a number representing the order of a slotted node
@@ -1319,6 +1319,12 @@ export interface RenderNode extends HostElement {
      * gives access to the original `appendChild` method
      */
     __appendChild?: <T extends Node>(newChild: T) => T;
+    /**
+     * On a `scoped: true` component
+     * with `experimentalSlotFixes` flag enabled,
+     * gives access to the original `insertBefore` method
+     */
+    __insertBefore?: <T extends Node>(node: T, child: Node | null) => T;
     /**
      * On a `scoped: true` component
      * with `experimentalSlotFixes` flag enabled,
@@ -1326,6 +1332,68 @@ export interface RenderNode extends HostElement {
      */
     __removeChild?: <T extends Node>(child: T) => T;
 }
+export interface PatchedSlotNode extends Node {
+    /**
+     * Slot name
+     */
+    ['s-sn']?: string;
+    /**
+     * Original Location Reference:
+     * A reference pointing to the comment
+     * which represents the original location
+     * before it was moved to its slot.
+     */
+    ['s-ol']?: RenderNode;
+    /**
+     * Slot host tag name:
+     * This is the tag name of the element where this node
+     * has been moved to during slot relocation.
+     *
+     * This allows us to check if the node has been moved and prevent
+     * us from thinking a node _should_ be moved when it may already be in
+     * its final destination.
+     *
+     * This value is set to `undefined` whenever the node is put back into its original location.
+     */
+    ['s-sh']?: string;
+    /**
+     * Is a `slot` node when `shadow: false` (or `scoped: true`).
+     *
+     * This is a node (either empty text-node or `<slot-fb>` element)
+     * that represents where a `<slot>` is located in the original JSX.
+     */
+    ['s-sr']?: boolean;
+    /**
+     * On a `scoped: true` component
+     * with `experimentalSlotFixes` flag enabled,
+     * returns the actual `parentNode` of the component
+     */
+    __parentNode?: RenderNode;
+    /**
+     * On a `scoped: true` component
+     * with `experimentalSlotFixes` flag enabled,
+     * returns the actual `nextSibling` of the component
+     */
+    __nextSibling?: RenderNode;
+    /**
+     * On a `scoped: true` component
+     * with `experimentalSlotFixes` flag enabled,
+     * returns the actual `previousSibling` of the component
+     */
+    __previousSibling?: RenderNode;
+    /**
+     * On a `scoped: true` component
+     * with `experimentalSlotFixes` flag enabled,
+     * returns the actual `nextElementSibling` of the component
+     */
+    __nextElementSibling?: RenderNode;
+    /**
+     * On a `scoped: true` component
+     * with `experimentalSlotFixes` flag enabled,
+     * returns the actual `nextElementSibling` of the component
+     */
+    __previousElementSibling?: RenderNode;
+}
 export type LazyBundlesRuntimeData = LazyBundleRuntimeData[];
 export type LazyBundleRuntimeData = [
     /** bundleIds */

package/internal/rindo-public-compiler.d.ts

@@ -849,12 +849,29 @@ export interface SerializeDocumentOptions extends HydrateDocumentOptions {
      */
     removeHtmlComments?: boolean;
     /**
-     * If set to `true` the component will be rendered within a Declarative Shadow DOM.
-     * If set to `false` Rindo will ignore the contents of the shadow root and render the
-     * element as given in provided template.
-     * @default true
+     * Configure how Rindo serializes the components shadow root.
+     * - If set to `declarative-shadow-dom` the component will be rendered within a Declarative Shadow DOM.
+     * - If set to `scoped` Rindo will render the contents of the shadow root as a `scoped: true` component
+     *   and the shadow DOM will be created during client-side hydration.
+     * - Alternatively you can mix and match the two by providing an object with `declarative-shadow-dom` and `scoped` keys,
+     * the value arrays containing the tag names of the components that should be rendered in that mode.
+     *
+     * Examples:
+     * - `{ 'declarative-shadow-dom': ['my-component-1', 'another-component'], default: 'scoped' }`
+     * Render all components as `scoped` apart from `my-component-1` and `another-component`
+     * -  `{ 'scoped': ['an-option-component'], default: 'declarative-shadow-dom' }`
+     * Render all components within `declarative-shadow-dom` apart from `an-option-component`
+     * - `'scoped'` Render all components as `scoped`
+     * - `false` disables shadow root serialization
+     *
+     * *NOTE* `true` has been deprecated in favor of `declarative-shadow-dom` and `scoped`
+     * @default 'declarative-shadow-dom'
      */
-    serializeShadowRoot?: boolean;
+    serializeShadowRoot?: 'declarative-shadow-dom' | 'scoped' | {
+        'declarative-shadow-dom'?: string[];
+        scoped?: string[];
+        default: 'declarative-shadow-dom' | 'scoped';
+    } | boolean;
     /**
      * The `fullDocument` flag determines the format of the rendered output. Set it to true to
      * generate a complete HTML document, or false to render only the component.
@@ -1834,18 +1851,16 @@ export interface TestingConfig extends JestConfig {
      */
     browserWSEndpoint?: string;
     /**
-     * Whether to run browser e2e tests in headless mode.
-     *
-     * Starting with Chrome v112, a new headless mode was introduced.
-     * The new headless mode unifies the "headful" and "headless" code paths in the Chrome distributable.
-     *
-     * To enable the "new" headless mode, a string value of "new" must be provided.
-     * To use the "old" headless mode, a boolean value of `true` must be provided.
-     * To use "headful" mode, a boolean value of `false` must be provided.
-     *
-     * Defaults to true.
+     * The browser channel to use for e2e tests (stable, beta, dev or canary).
+     * @default 'chrome'
+     */
+    browserChannel?: 'chrome' | 'chrome-beta' | 'chrome-dev' | 'chrome-canary';
+    /**
+     * Whether to run browser e2e tests in headless mode using Chrome Headless Shell
+     * @ref https://developer.chrome.com/blog/chrome-headless-shell
+     * @default shell
      */
-    browserHeadless?: boolean | 'new';
+    browserHeadless?: boolean | 'shell';
     /**
      * Slows down e2e browser operations by the specified amount of milliseconds.
      * Useful so that you can see what is going on.