support setting multiple modes

src/declarations/stencil-public-compiler.ts

@@ -957,10 +957,10 @@ export interface SerializeDocumentOptions extends HydrateDocumentOptions {
    */
   fullDocument?: boolean;
   /**
-   * Style mode to render the component in.
+   * Style modes to render the component in.
    * @see https://stenciljs.com/docs/styling#style-modes
    */
-  mode?: ResolutionHandler;
+  modes?: ResolutionHandler[];
 }
 
 export interface HydrateFactoryOptions extends SerializeDocumentOptions {

src/hydrate/runner/render.ts

@@ -135,13 +135,13 @@ async function render(win: MockWindow, opts: HydrateFactoryOptions, results: Hyd
   try {
     await Promise.resolve(beforeHydrateFn(win.document));
     return new Promise<HydrateResults>((resolve) => {
-      if (typeof opts.mode === 'function') {
+      if (Array.isArray(opts.modes)) {
         /**
          * Reset the mode resolution chain as we expect every `renderToString` call to render
          * the components in new environment/document.
          */
         modeResolutionChain.length = 0;
-        setMode(opts.mode);
+        opts.modes.forEach((mode) => setMode(mode));
       }
       return hydrateFactory(win, opts, results, afterHydrate, resolve);
     });

test/end-to-end/src/declarative-shadow-dom/test.e2e.ts

@@ -296,7 +296,7 @@ describe('renderToString', () => {
       const { html } = await renderToString('<prop-cmp first="Max" last="Mustermann"></prop-cmp>', {
         fullDocument: false,
         prettyHtml: true,
-        mode: () => 'ios',
+        modes: [() => 'ios'],
       });
       expect(html).toContain('<style>');
       expect(html).toContain(';color:white;');
@@ -310,7 +310,7 @@ describe('renderToString', () => {
       const { html } = await renderToString('<prop-cmp first="Max" last="Mustermann"></prop-cmp>', {
         fullDocument: false,
         prettyHtml: true,
-        mode: () => 'md',
+        modes: [() => 'md'],
       });
       expect(html).toContain(';color:black;');
       const page = await newE2EPage({ html, url: 'https://stencil.com' });