@describe-me/vitest 0.5.0 → 0.5.2

package/README.md

@@ -10,6 +10,9 @@ reporter that writes `.describe-me/`.
 pnpm add -D @describe-me/vitest @describe-me/react describe-me
 ```
 
+All describe-me packages must be on the same version
+([Add it to your project](https://github.com/grzehub/describe-me#add-it-to-your-project)).
+
 ## Usage
 
 One line in the Vitest config registers the setup file and the reporter, and
@@ -23,9 +26,9 @@ plugin detects where the tests run:
   `@testing-library/user-event` call, turns on `test.css` so imported
   stylesheets reach the snapshots, and sets `RTL_SKIP_AUTO_CLEANUP` so the
   component is unmounted only after the closing frame. The setup file sets
-  React's `IS_REACT_ACT_ENVIRONMENT` where Testing Library would, so act
-  warnings match a run without describe-me. It also works without user-event
-  installed.
+  React's `IS_REACT_ACT_ENVIRONMENT` where Testing Library would and turns it
+  off while the recorder waits, so act warnings match a run without
+  describe-me. It also works without user-event installed.
 
 jsdom has no layout, so positioned popovers show in the top-left corner and
 canvas stays blank
@@ -55,7 +58,9 @@ A test that records no frame before the closing one (no recording `render`,
 no interaction, no `step()`) costs no snapshot and is left out of the
 manifest. `describeMe({ include, exclude })` chooses which test files are
 recorded, with picomatch globs relative to the Vitest root. `exclude` wins.
-Tests in other files still run, but record nothing. The reporter takes the
+Tests in other files still run, but record nothing. Leaving `include` out
+records every test file. `include: []` records none and warns, while
+`exclude: '**'` records none without a warning. The reporter takes the
 same two options, but on its own it only filters the manifest: without the
 plugin the setup file does not know them.
 
@@ -70,6 +75,10 @@ test page, and the local files it links are copied into the output directory
 interaction, or `{ pending: '<selector>' }` once a loader is gone. See
 [Render frame timing](https://github.com/grzehub/describe-me#render-frame-timing).
 
+The plugin adds its reporter to the ones your config names. If it names
+none, the reporter joins the ones Vitest picks on its own, such as `minimal`
+for AI agents and `github-actions` in GitHub Actions.
+
 The pieces can also be wired by hand. Tests then import from the adapter
 themselves: `render` from `@describe-me/react` in browser mode, and `render`,
 `fireEvent` and `cleanup` from `@describe-me/react/testing-library` in jsdom:

package/dist/act-neutral-wait.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Run a recorder wait with React's `IS_REACT_ACT_ENVIRONMENT` flag off, as
+ * Testing Library's `asyncWrapper` does for `waitFor` and user-event. Otherwise
+ * an update that lands in the wait logs an act warning that a run without
+ * describe-me never shows.
+ */
+export declare function actNeutralWait(wait: () => Promise<void>): Promise<void>;

package/dist/act-neutral-wait.js

@@ -0,0 +1,30 @@
+/**
+ * Waits can overlap, for example an un-awaited interaction or `flush()` with
+ * captures in flight. The flag from before the first one comes back when the
+ * last one ends.
+ */
+let depth = 0;
+let previous;
+/**
+ * Run a recorder wait with React's `IS_REACT_ACT_ENVIRONMENT` flag off, as
+ * Testing Library's `asyncWrapper` does for `waitFor` and user-event. Otherwise
+ * an update that lands in the wait logs an act warning that a run without
+ * describe-me never shows.
+ */
+export async function actNeutralWait(wait) {
+    const host = globalThis;
+    if (depth === 0) {
+        previous = host.IS_REACT_ACT_ENVIRONMENT;
+        host.IS_REACT_ACT_ENVIRONMENT = false;
+    }
+    depth++;
+    try {
+        await wait();
+    }
+    finally {
+        depth--;
+        if (depth === 0) {
+            host.IS_REACT_ACT_ENVIRONMENT = previous;
+        }
+    }
+}

package/dist/asset-store.js

@@ -1,7 +1,8 @@
 import { createHash } from 'node:crypto';
-import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { copyFileSync, existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
 import { dirname, extname, join, resolve, sep } from 'node:path';
 import { ASSET_URL_PREFIX } from '@describe-me/core/types';
+import { collectableFiles } from './collectable-files.js';
 import { cssAssetReferences } from './css-asset-references.js';
 import { rewriteCssReferences } from './rewrite-css-references.js';
 import { rewriteHeadReferences } from './rewrite-head-references.js';
@@ -233,7 +234,7 @@ export class AssetStore {
      * re-run were rewritten by an earlier run.
      */
     collectGarbage(files, inlineTexts = []) {
-        const stored = readdirSync(this.dir);
+        const stored = collectableFiles(this.dir);
         if (stored.length === 0) {
             return;
         }

package/dist/collect-component-docs-safely.js

@@ -13,6 +13,12 @@ function warnAboutMissingTypeScript() {
  * props tables instead of a crashing reporter.
  */
 export async function collectComponentDocsSafely(root, entries) {
+    const rendered = Array.from(entries);
+    // Importing TypeScript takes a few hundred milliseconds, wasted on a run
+    // that recorded no component.
+    if (rendered.length === 0) {
+        return {};
+    }
     try {
         await import('typescript');
     }
@@ -21,5 +27,5 @@ export async function collectComponentDocsSafely(root, entries) {
         return {};
     }
     const { collectComponentDocs } = await import('./collect-component-docs.js');
-    return collectComponentDocs(root, entries);
+    return collectComponentDocs(root, rendered);
 }

package/dist/collectable-files.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The names of the entries in `dir` that garbage collection may delete. No
+ * store writes a folder, so a folder belongs to someone else and is left out.
+ */
+export declare function collectableFiles(dir: string): string[];

package/dist/collectable-files.js

@@ -0,0 +1,10 @@
+import { readdirSync } from 'node:fs';
+/**
+ * The names of the entries in `dir` that garbage collection may delete. No
+ * store writes a folder, so a folder belongs to someone else and is left out.
+ */
+export function collectableFiles(dir) {
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => !entry.isDirectory())
+        .map((entry) => entry.name);
+}

package/dist/compile-include.d.ts

@@ -0,0 +1,3 @@
+import type { CompiledGlob } from './runtime-options.js';
+/** Keeps an omitted `include` (`null`, every test file) apart from an empty list (no test file). */
+export declare function compileInclude(patterns: string | string[] | undefined): CompiledGlob[] | null;

package/dist/compile-include.js

@@ -0,0 +1,8 @@
+import { compileGlobs } from './compile-globs.js';
+/** Keeps an omitted `include` (`null`, every test file) apart from an empty list (no test file). */
+export function compileInclude(patterns) {
+    if (patterns === undefined) {
+        return null;
+    }
+    return compileGlobs(patterns);
+}

package/dist/default-reporters.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The reporters the installed Vitest uses when the config names none, such as
+ * `minimal` for AI agents and `github-actions` in GitHub Actions.
+ */
+export declare function defaultReporters(): string[];

package/dist/default-reporters.js

@@ -0,0 +1,35 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { isAgent } from 'std-env';
+import { configDefaults } from 'vitest/config';
+/**
+ * Vitest 4.0 has no `agent` reporter and loads the name as a reporter module,
+ * which fails the run. An unreadable version counts as 4.0.
+ */
+function hasAgentReporter() {
+    try {
+        const manifest = createRequire(import.meta.url).resolve('vitest/package.json');
+        const { version } = JSON.parse(readFileSync(manifest, 'utf8'));
+        const [major, minor] = version.split('.').map(Number);
+        return major > 4 || (major === 4 && minor >= 1);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The reporters the installed Vitest uses when the config names none, such as
+ * `minimal` for AI agents and `github-actions` in GitHub Actions.
+ */
+export function defaultReporters() {
+    // Vitest 5 exports the list. Vitest 4 exports none and fills it while
+    // resolving the config, only when it is still empty, so its rule is rebuilt here.
+    if (configDefaults.reporters.length > 0) {
+        return [...configDefaults.reporters];
+    }
+    const reporters = [isAgent && hasAgentReporter() ? 'agent' : 'default'];
+    if (process.env.GITHUB_ACTIONS === 'true') {
+        reporters.push('github-actions');
+    }
+    return reporters;
+}

package/dist/file-filter.d.ts

@@ -1,6 +1,7 @@
 import type { RuntimeOptions } from './runtime-options.js';
 /**
- * Takes a path relative to the root, with posix separators. Build it once and
+ * Takes a path relative to the root, with posix separators. An `include` of
+ * `null` selects every file, an empty list selects none. Build it once and
  * reuse the returned function, which memoizes per file name. The test runtime
  * imports this file, so no Node imports.
  */

package/dist/file-filter.js

@@ -2,12 +2,13 @@ function toRegExps(globs) {
     return globs.map((glob) => new RegExp(glob.source, glob.flags));
 }
 /**
- * Takes a path relative to the root, with posix separators. Build it once and
+ * Takes a path relative to the root, with posix separators. An `include` of
+ * `null` selects every file, an empty list selects none. Build it once and
  * reuse the returned function, which memoizes per file name. The test runtime
  * imports this file, so no Node imports.
  */
 export function fileFilter(options) {
-    const include = toRegExps(options.include);
+    const include = options.include === null ? null : toRegExps(options.include);
     const exclude = toRegExps(options.exclude);
     const answers = new Map();
     return (fileName) => {
@@ -15,7 +16,7 @@ export function fileFilter(options) {
         if (known !== undefined) {
             return known;
         }
-        const included = include.length === 0 || include.some((glob) => glob.test(fileName));
+        const included = include === null || include.some((glob) => glob.test(fileName));
         const answer = included && !exclude.some((glob) => glob.test(fileName));
         answers.set(fileName, answer);
         return answer;

package/dist/plugin.d.ts

@@ -25,13 +25,16 @@ export interface DescribeMeOptions {
      * DOM environments only. Load the browser build of styled-components (v5+)
      * instead of the Node one, whose `createGlobalStyle` never inserts its CSS on
      * the client: global resets and fonts would be missing from every snapshot.
-     * Applied when styled-components is installed. Default: true.
+     * Applied when styled-components is installed. For 6.0 to 6.3 it also points
+     * `tslib` at the `tslib.es6.mjs` they resolve, so the optimizer keeps its
+     * exports. Default: true.
      */
     styledComponentsBrowserBuild?: boolean;
     /**
      * Test files to record, as globs relative to the Vitest root, matched with
      * picomatch, dotfiles included. Tests in other files still run, but record
-     * nothing and leave the manifest. Default: every test file.
+     * nothing and leave the manifest. An empty list records no test file and
+     * warns. Default: every test file.
      */
     include?: string | string[];
     /** Test files never to record, as globs like `include`. Wins over `include`. Default: none. */

package/dist/plugin.js

@@ -1,10 +1,12 @@
 import { adapterPackageRoot } from './adapter-package-root.js';
 import { compileGlobs } from './compile-globs.js';
+import { compileInclude } from './compile-include.js';
+import { defaultReporters } from './default-reporters.js';
 import { projectModulePath } from './project-module-path.js';
 import { registerExports } from './register-exports.js';
 import DescribeMeReporter from './reporter.js';
 import { RUNTIME_OPTIONS_KEY } from './runtime-options.js';
-import { styledComponentsBrowserBuild } from './styled-components-browser-build.js';
+import { styledComponentsBrowserBuild, } from './styled-components-browser-build.js';
 import { validateRenderFrame } from './validate-render-frame.js';
 /** For each framework and environment: the render module tests import, and our adapter that wraps it. */
 const RENDER_MODULES = {
@@ -49,7 +51,7 @@ function browserConfig(renderModule) {
         },
     };
 }
-function domConfig(userConfig, options) {
+function domConfig(userConfig, styledComponents) {
     const userTest = userConfig.test;
     const test = {
         setupFiles: ['@describe-me/vitest/setup-dom'],
@@ -65,14 +67,19 @@ function domConfig(userConfig, options) {
     else if (userTest.css === false) {
         console.warn('describe-me: `test.css` is false, so imported stylesheets are stubbed and will be missing from the snapshots.');
     }
-    const styledComponents = options.styledComponentsBrowserBuild === false
-        ? undefined
-        : styledComponentsBrowserBuild(userConfig.root ?? process.cwd());
     if (!styledComponents) {
         return { test };
     }
     console.info('describe-me: using the browser build of styled-components, for createGlobalStyle');
-    return { resolve: styledComponents.resolve, test: { ...test, ...styledComponents.test } };
+    const { config } = styledComponents;
+    return { resolve: config.resolve, test: { ...test, ...config.test } };
+}
+/** Looked up before the reporter is created, which needs its warning. */
+function styledComponentsFor(environment, userConfig, options) {
+    if (environment !== 'dom' || options.styledComponentsBrowserBuild === false) {
+        return undefined;
+    }
+    return styledComponentsBrowserBuild(userConfig.root ?? process.cwd());
 }
 /**
  * One-line integration: `plugins: [describeMe()]`.
@@ -105,21 +112,27 @@ export function describeMe(options = {}) {
             // Checked here, so invalid options fail before any test runs. Vite
             // deep-merges `provide`, so the user's own keys survive.
             const runtimeOptions = {
-                include: compileGlobs(options.include),
+                include: compileInclude(options.include),
                 exclude: compileGlobs(options.exclude),
                 renderFrame: validateRenderFrame(options.renderFrame),
             };
             const provide = { [RUNTIME_OPTIONS_KEY]: runtimeOptions };
+            const styledComponents = styledComponentsFor(environment, userConfig, options);
+            const setupWarnings = styledComponents?.warning ? [styledComponents.warning] : [];
             const reporter = new DescribeMeReporter({
                 outDir,
                 include: options.include,
                 exclude: options.exclude,
                 previewHead: options.previewHead,
+                setupWarnings,
             });
-            // Vite concatenates arrays when merging, so only add `default` when the
-            // user has not chosen their own reporters; otherwise they would lose it.
-            const reporters = userConfig.test?.reporters ? [reporter] : ['default', reporter];
-            const config = environment === 'browser' ? browserConfig(renderModule) : domConfig(userConfig, options);
+            // Vite concatenates our list with the user's. Any list replaces the
+            // reporters Vitest picks on its own, so without one of the user's, ours
+            // joins Vitest's defaults.
+            const reporters = userConfig.test?.reporters ? [reporter] : [...defaultReporters(), reporter];
+            const config = environment === 'browser'
+                ? browserConfig(renderModule)
+                : domConfig(userConfig, styledComponents);
             return { ...config, test: { ...config.test, reporters, provide } };
         },
         async resolveId(source, importer) {

package/dist/print-diagnostics.d.ts

@@ -1,8 +1,9 @@
 import type { Manifest } from '@describe-me/core/types';
 /**
- * Warn, one line per kind, about what the manifest could not document. Prints
- * nothing when everything is named, documented and loadable, every font is
- * loaded and no stylesheet comes from a remote host. The viewer shows the same
- * list in its header.
+ * Warn about what the manifest could not document, one line per kind. Setup
+ * warnings come first, one line each, because they can explain failing tests.
+ * Prints nothing when the setup is sound, everything is named, documented and
+ * loadable, every font is loaded and no stylesheet comes from a remote host.
+ * The viewer shows the same list in its header.
  */
 export declare function printDiagnostics(manifest: Manifest): void;

package/dist/print-diagnostics.js

@@ -13,13 +13,17 @@ function plural(count, one, many) {
     return `${count} ${count === 1 ? one : many}`;
 }
 /**
- * Warn, one line per kind, about what the manifest could not document. Prints
- * nothing when everything is named, documented and loadable, every font is
- * loaded and no stylesheet comes from a remote host. The viewer shows the same
- * list in its header.
+ * Warn about what the manifest could not document, one line per kind. Setup
+ * warnings come first, one line each, because they can explain failing tests.
+ * Prints nothing when the setup is sound, everything is named, documented and
+ * loadable, every font is loaded and no stylesheet comes from a remote host.
+ * The viewer shows the same list in its header.
  */
 export function printDiagnostics(manifest) {
-    const { anonymous, undocumented, assetsMissing, fontsMissing, remoteStylesheets } = manifestDiagnostics(manifest);
+    const { setupWarnings, anonymous, undocumented, assetsMissing, fontsMissing, remoteStylesheets } = manifestDiagnostics(manifest);
+    for (const warning of setupWarnings) {
+        console.warn(`describe-me: ${warning}`);
+    }
     if (anonymous.length > 0) {
         console.warn(`describe-me: ${plural(anonymous.length, 'test renders', 'tests render')} an anonymous component; export it from a project module or give it a displayName`);
     }

package/dist/read-generator.d.ts

@@ -0,0 +1,7 @@
+import type { ManifestGenerator } from '@describe-me/core/types';
+/**
+ * The name and version of this package, for the manifest's `generator`, or
+ * `undefined` when its package.json cannot be read, so the manifest is still
+ * written.
+ */
+export declare function readGenerator(): ManifestGenerator | undefined;

package/dist/read-generator.js

@@ -0,0 +1,21 @@
+import { readFileSync } from 'node:fs';
+/**
+ * The name and version of this package, for the manifest's `generator`, or
+ * `undefined` when its package.json cannot be read, so the manifest is still
+ * written.
+ */
+export function readGenerator() {
+    try {
+        // The compiled file sits in `dist/`, one level below the package root, and
+        // `exports` does not list `./package.json`.
+        const file = new URL('../package.json', import.meta.url);
+        const { name, version } = JSON.parse(readFileSync(file, 'utf8'));
+        if (typeof name !== 'string' || typeof version !== 'string') {
+            return undefined;
+        }
+        return { name, version };
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/read-runtime-options.js

@@ -3,7 +3,7 @@ import { RUNTIME_OPTIONS_KEY } from './runtime-options.js';
 /** Without the plugin nothing is provided, so a hand-wired setup keeps recording every test. */
 export function readRuntimeOptions() {
     return (inject(RUNTIME_OPTIONS_KEY) ?? {
-        include: [],
+        include: null,
         exclude: [],
         renderFrame: 'eager',
     });

package/dist/register-recording-hooks.d.ts

@@ -1,3 +1,4 @@
+import type { AroundWait } from '@describe-me/core';
 import type { RuntimeOptions } from './runtime-options.js';
 /**
  * The per-test lifecycle shared by every environment: begin a recording, take
@@ -7,4 +8,4 @@ import type { RuntimeOptions } from './runtime-options.js';
  * jsdom. Concurrent tests would share the one recorder, so they are not
  * recorded.
  */
-export declare function registerRecordingHooks(options: RuntimeOptions): void;
+export declare function registerRecordingHooks(options: RuntimeOptions, aroundWait?: AroundWait): void;

package/dist/register-recording-hooks.js

@@ -9,10 +9,10 @@ import { fileFilter } from './file-filter.js';
  * jsdom. Concurrent tests would share the one recorder, so they are not
  * recorded.
  */
-export function registerRecordingHooks(options) {
+export function registerRecordingHooks(options, aroundWait) {
     const isRecordedFile = fileFilter(options);
     let warnedConcurrent = false;
-    recorder.configure({ renderFrame: options.renderFrame });
+    recorder.configure({ renderFrame: options.renderFrame, aroundWait });
     beforeEach((context) => {
         if (context.task.concurrent) {
             if (!warnedConcurrent) {

package/dist/reporter.d.ts

@@ -4,7 +4,8 @@ export interface DescribeMeReporterOptions {
     outDir?: string;
     /**
      * Which test files appear in the manifest: globs relative to the Vitest
-     * root, matched with picomatch, dotfiles included. Default: every test file.
+     * root, matched with picomatch, dotfiles included. An empty list leaves every
+     * file out of the manifest and warns. Default: every test file.
      */
     include?: string | string[];
     /**
@@ -18,11 +19,16 @@ export interface DescribeMeReporterOptions {
      * Project files it links are copied into the output directory. Default: none.
      */
     previewHead?: string;
+    /** Problems in the project's setup, filled by the plugin. Default: none. */
+    setupWarnings?: string[];
 }
 export default class DescribeMeReporter implements Reporter {
     private readonly outDirOption;
     private readonly isRecordedFile;
+    private readonly emptyInclude;
     private readonly previewHead;
+    private readonly generator;
+    private readonly setupWarnings;
     private root;
     private outDir;
     private snapshots;

package/dist/reporter.js

@@ -8,11 +8,13 @@ import { META_KEY, } from '@describe-me/core/types';
 import { AssetStore } from './asset-store.js';
 import { collectComponentDocsSafely } from './collect-component-docs-safely.js';
 import { compileGlobs } from './compile-globs.js';
+import { compileInclude } from './compile-include.js';
 import { componentEntries } from './component-entries.js';
 import { fileFilter } from './file-filter.js';
 import { FontAudit } from './font-audit.js';
 import { isRecordedTest } from './is-recorded-test.js';
 import { printDiagnostics } from './print-diagnostics.js';
+import { readGenerator } from './read-generator.js';
 import { SnapshotStore } from './snapshot-store.js';
 import { stableTestIds } from './stable-test-ids.js';
 import { StyleStore } from './style-store.js';
@@ -26,7 +28,10 @@ function recordOf(tc) {
 export default class DescribeMeReporter {
     outDirOption;
     isRecordedFile;
+    emptyInclude;
     previewHead;
+    generator;
+    setupWarnings;
     root = process.cwd();
     outDir = '';
     snapshots;
@@ -36,12 +41,13 @@ export default class DescribeMeReporter {
     modules = new Map();
     constructor(options = {}) {
         this.outDirOption = options.outDir ?? '.describe-me';
-        this.isRecordedFile = fileFilter({
-            include: compileGlobs(options.include),
-            exclude: compileGlobs(options.exclude),
-        });
+        const include = compileInclude(options.include);
+        this.isRecordedFile = fileFilter({ include, exclude: compileGlobs(options.exclude) });
+        this.emptyInclude = include !== null && include.length === 0;
         // A blank head, such as an empty preview-head.html, is the same as none.
         this.previewHead = options.previewHead?.trim() ? options.previewHead : undefined;
+        this.generator = readGenerator();
+        this.setupWarnings = options.setupWarnings ?? [];
     }
     onInit(vitest) {
         this.root = vitest.config.root;
@@ -54,6 +60,11 @@ export default class DescribeMeReporter {
         if (this.previewHead !== undefined && /<script\b/i.test(this.previewHead)) {
             console.warn('describe-me: previewHead contains a <script>, which the viewer never runs.');
         }
+        // Here and not in the constructor: the plugin builds the reporter in
+        // `config()`, which also runs for a `vite build` that shares the config.
+        if (this.emptyInclude) {
+            console.warn("describe-me: include is an empty list, so no test file is recorded. Leave include out to record every test file, or set exclude: '**' to record none without this warning.");
+        }
     }
     onTestRunStart() {
         this.assets.startRun();
@@ -136,6 +147,7 @@ export default class DescribeMeReporter {
         const assetsMissing = this.assets.missing();
         const manifest = {
             version: 1,
+            generator: this.generator,
             generatedAt: new Date().toISOString(),
             root: this.root,
             modules,
@@ -150,6 +162,10 @@ export default class DescribeMeReporter {
         const styleFiles = this.styles.collectGarbage(snapshotFiles);
         this.assets.collectGarbage([...snapshotFiles, ...styleFiles], head === undefined ? [] : [head]);
         this.auditFonts(manifest);
+        // Never seeded from the last run: the plugin checks the setup on every start.
+        if (this.setupWarnings.length > 0) {
+            manifest.setupWarnings = this.setupWarnings;
+        }
         writeFileSync(join(this.outDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
         printDiagnostics(manifest);
     }

package/dist/runtime-options.d.ts

@@ -10,8 +10,11 @@ export interface CompiledGlob {
     flags: string;
 }
 export interface RuntimeOptions {
-    /** Empty means every test file. */
-    include: CompiledGlob[];
+    /**
+     * `null` means every test file, an empty list means none. `null` survives
+     * `provide` / `inject` and Vite's config merge, `undefined` would not.
+     */
+    include: CompiledGlob[] | null;
     /** Wins over `include`. */
     exclude: CompiledGlob[];
     renderFrame: RenderFrameMode;

package/dist/setup-dom.js

@@ -3,14 +3,16 @@
  * `setupFiles: ['@describe-me/vitest/setup-dom']`. Patches Testing Library's
  * userEvent, when it is installed, so every interaction records a frame, sets
  * React's act flag where Testing Library would, and registers the recording
- * hooks. Which test files are recorded (`include` / `exclude`) and when the
+ * hooks. The act flag is off while the recorder waits, as in Testing Library's
+ * own waits. Which test files are recorded (`include` / `exclude`) and when the
  * render frame is taken (`renderFrame`) come from the plugin. Never imports
  * `vitest/browser`, which only exists in browser mode.
  */
+import { actNeutralWait } from './act-neutral-wait.js';
 import { mirrorReactActEnvironment } from './mirror-react-act-environment.js';
 import { patchTestingLibraryUserEvent } from './patch-testing-library-user-event.js';
 import { readRuntimeOptions } from './read-runtime-options.js';
 import { registerRecordingHooks } from './register-recording-hooks.js';
 await patchTestingLibraryUserEvent();
 mirrorReactActEnvironment();
-registerRecordingHooks(readRuntimeOptions());
+registerRecordingHooks(readRuntimeOptions(), actNeutralWait);

package/dist/snapshot-store.js

@@ -1,6 +1,7 @@
 import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readdirSync, rmSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
+import { collectableFiles } from './collectable-files.js';
 /**
  * Content-addressed store for the serialized DOM of every frame, living in
  * `<outDir>/snapshots`. Identical DOM across tests or runs is written once.
@@ -27,7 +28,7 @@ export class SnapshotStore {
         for (const path of referenced) {
             keep.add(path.replace('snapshots/', ''));
         }
-        for (const file of readdirSync(this.dir)) {
+        for (const file of collectableFiles(this.dir)) {
             if (!keep.has(file)) {
                 rmSync(join(this.dir, file), { force: true });
             }

package/dist/style-store.js

@@ -1,7 +1,8 @@
 import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { STYLE_URL_PREFIX } from '@describe-me/core/types';
+import { collectableFiles } from './collectable-files.js';
 import { splitStylesheet } from './split-stylesheet.js';
 /** Shorter sheets stay inline, where they cost less than a reference and a file of their own. */
 const MIN_EXTRACTED_LENGTH = 256;
@@ -54,7 +55,7 @@ export class StyleStore {
             }
         }
         const kept = [];
-        for (const file of readdirSync(this.dir)) {
+        for (const file of collectableFiles(this.dir)) {
             if (keep.has(file)) {
                 kept.push(`styles/${file}`);
             }

package/dist/styled-components-browser-build.d.ts

@@ -1,4 +1,10 @@
 import type { ViteUserConfig } from 'vitest/config';
+/** The config that loads the browser build, and a setup problem found on the way. */
+export interface StyledComponentsBrowserBuild {
+    config: ViteUserConfig;
+    /** Set when the build's tslib cannot be aliased, so it may fail to load. */
+    warning?: string;
+}
 /**
  * The Vite and Vitest config that makes a DOM environment load the browser
  * build of styled-components, or undefined when the project does not use
@@ -11,5 +17,9 @@ import type { ViteUserConfig } from 'vitest/config';
  * styled-components through Node, which ignores the alias, and would get a
  * second instance whose styles its serializer cannot see. Bundling both
  * together gives them one.
+ *
+ * The optimizer bundles tslib's UMD file without its default export, which the
+ * browser build of 6.0 to 6.3 destructures. An alias is the only resolution the
+ * optimizer applies, so `tslib` is aliased to its ES module for the whole config.
  */
-export declare function styledComponentsBrowserBuild(root: string): ViteUserConfig | undefined;
+export declare function styledComponentsBrowserBuild(root: string): StyledComponentsBrowserBuild | undefined;

package/dist/styled-components-browser-build.js

@@ -1,6 +1,7 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, join, resolve } from 'node:path';
+import { styledComponentsTslib } from './styled-components-tslib.js';
 function resolverFor(root) {
     // createRequire wants an absolute file inside the directory; it does not have to exist.
     const requireFromRoot = createRequire(join(resolve(root), 'package.json'));
@@ -41,6 +42,10 @@ function browserModule(pkg) {
  * styled-components through Node, which ignores the alias, and would get a
  * second instance whose styles its serializer cannot see. Bundling both
  * together gives them one.
+ *
+ * The optimizer bundles tslib's UMD file without its default export, which the
+ * browser build of 6.0 to 6.3 destructures. An alias is the only resolution the
+ * optimizer applies, so `tslib` is aliased to its ES module for the whole config.
  */
 export function styledComponentsBrowserBuild(root) {
     const resolveFromRoot = resolverFor(root);
@@ -62,8 +67,17 @@ export function styledComponentsBrowserBuild(root) {
     if (resolveFromRoot('jest-styled-components')) {
         include.push('jest-styled-components');
     }
-    return {
-        resolve: { alias: [{ find: /^styled-components$/, replacement }] },
+    const alias = [{ find: /^styled-components$/, replacement }];
+    const tslib = styledComponentsTslib(manifest);
+    if (tslib.kind === 'alias') {
+        alias.push({ find: /^tslib$/, replacement: tslib.replacement });
+    }
+    const config = {
+        resolve: { alias },
         test: { deps: { optimizer: { client: { enabled: true, include } } } },
     };
+    if (tslib.kind === 'warning') {
+        return { config, warning: tslib.warning };
+    }
+    return { config };
 }

package/dist/styled-components-tslib.d.ts

@@ -0,0 +1,16 @@
+/** How the browser build of styled-components gets its tslib helpers. */
+export type StyledComponentsTslib = {
+    kind: 'untouched';
+} | {
+    kind: 'alias';
+    replacement: string;
+} | {
+    kind: 'warning';
+    warning: string;
+};
+/**
+ * Where `tslib` should point for the styled-components whose `package.json`
+ * is given. Only 6.0 to 6.3 import tslib, and only tslib 2.5.3 and later ship
+ * the `tslib.es6.mjs` that keeps its exports intact through the optimizer.
+ */
+export declare function styledComponentsTslib(styledComponentsManifest: string): StyledComponentsTslib;

package/dist/styled-components-tslib.js

@@ -0,0 +1,40 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+function readPackage(manifest) {
+    return JSON.parse(readFileSync(manifest, 'utf8'));
+}
+function resolveTslib(styledComponentsManifest) {
+    try {
+        return createRequire(styledComponentsManifest).resolve('tslib/package.json');
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Where `tslib` should point for the styled-components whose `package.json`
+ * is given. Only 6.0 to 6.3 import tslib, and only tslib 2.5.3 and later ship
+ * the `tslib.es6.mjs` that keeps its exports intact through the optimizer.
+ */
+export function styledComponentsTslib(styledComponentsManifest) {
+    const styledComponents = readPackage(styledComponentsManifest);
+    if (!styledComponents.dependencies?.tslib) {
+        return { kind: 'untouched' };
+    }
+    // Resolved from styled-components itself, so a nested or pnpm-linked tslib
+    // wins over whatever the project hoists.
+    const tslibManifest = resolveTslib(styledComponentsManifest);
+    if (!tslibManifest) {
+        return { kind: 'untouched' };
+    }
+    const replacement = join(dirname(tslibManifest), 'tslib.es6.mjs');
+    if (existsSync(replacement)) {
+        return { kind: 'alias', replacement };
+    }
+    const tslib = readPackage(tslibManifest);
+    return {
+        kind: 'warning',
+        warning: `styled-components ${styledComponents.version} resolves tslib ${tslib.version}, which has no tslib.es6.mjs, so its browser build may fail to load ("Cannot destructure property '__extends'"). Upgrade styled-components to 6.1.10 or later, or override tslib to 2.5.3 or later.`,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@describe-me/vitest",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Vitest integration for describe-me: plugin, setup file and reporter",
   "keywords": [
     "vitest",
@@ -59,12 +59,14 @@
   ],
   "dependencies": {
     "picomatch": "^4.0.3",
-    "@describe-me/core": "^0.5.0"
+    "std-env": "^4.0.0",
+    "@describe-me/core": "^0.5.2"
   },
   "peerDependencies": {
     "vitest": "^4.0.0 || ^5.0.0",
     "typescript": "^5.0.0 || ^6.0.0",
-    "@testing-library/user-event": "^14.0.0"
+    "@testing-library/user-event": "^14.0.0",
+    "describe-me": "^0.5.2"
   },
   "peerDependenciesMeta": {
     "typescript": {
@@ -72,6 +74,9 @@
     },
     "@testing-library/user-event": {
       "optional": true
+    },
+    "describe-me": {
+      "optional": true
     }
   },
   "devDependencies": {