Open-source AI coworkers that each get a computer of their own: a browser, files and tools, with every action decided before it happens and recorded after. Bring any AG-UI agent.
/**
* Loaded before any test file, so a component that portals can be rendered at all.
*
* Base UI decides ONCE, while its module is first evaluated, whether its isomorphic layout effect
* is `useLayoutEffect` or a no-op:
*
* export const useIsoLayoutEffect = typeof document !== 'undefined' ? useLayoutEffect : noop;
*
* Every DOM test here registers happy-dom in its own `beforeAll`, which is far too late: bun walks
* all the test files into one process, so whichever of them imports a route first pulls Base UI in
* while `document` is still undefined, and the no-op is what every later file gets. A portal needs
* that effect to resolve its container — so `Dialog` mounts nothing, forever, and a test that opens
* one is left asserting against an empty `<body>` with no error to explain it.
*
* Worse, it decided that by import order. The same test passed on its own and failed in the suite,
* which is the failure `test-preload.ts` exists to stop in the other direction.
*
* So the DOM is registered here, that one module is evaluated against it, and the DOM is taken away
* again. Nothing else is left holding browser globals: server and worker tests run exactly as
* before, and each DOM test file still registers and unregisters its own happy-dom.
*/
import { mock } from "bun:test";
import { GlobalRegistrator } from "@happy-dom/global-registrator";
GlobalRegistrator.register();
/* `@base-ui/utils` is not a dependency of this package; the react package that owns it is. */
await import("@base-ui/react/dialog");
printNodesShortly(globalThis.Node);
GlobalRegistrator.unregister();
/** The longest stretch of a node's markup a failed assertion prints. */
const PRINTED_NODE_CHARS = 300;
/**
* A DOM node in a failed assertion is printed as its own markup, cut short, and not as everything it can reach.
*
* Bun prints the value a failed matcher received, and it printed a happy-dom node by walking every property it could
* reach: its window and document, and the `__reactFiber$` and `__reactProps$` that React keeps on each element it
* renders, which lead on to every component, query and client in the tree. The walk is synchronous, so a `waitFor`
* whose check failed while it waited held the whole event loop until the walk was done. One failed
* `expect(dialog).toBeNull()` in recorder-browsers.test.tsx took 3.3 s here and 8.8 s on GitHub's runner, where its test
* timed out: the fake DELETE the test had just let go could not answer until the print was over. And what it printed
* was the window's globals rather than the element.
*
* `Bun.inspect.custom` is what Bun's printer asks an object for first (bun.com/docs/runtime/utils; it is Node's
* `util.inspect.custom`). happy-dom's `Node` is one class for every window a file registers, so set once here it holds
* for every file.
*/
function printNodesShortly(node: typeof Node): void {
Object.defineProperty(node.prototype, Bun.inspect.custom, {
configurable: true,
value(this: Node): string {
// Read by its node type, not `instanceof Element`: a node can be printed after its file took the DOM away.
const markup =
this.nodeType === 1
? (this as Element).outerHTML
: `${this.nodeName} ${JSON.stringify(this.textContent ?? "")}`;
return markup.length > PRINTED_NODE_CHARS
? `${markup.slice(0, PRINTED_NODE_CHARS)}…`
: markup;
},
});
}
/**
* `markFor` globs the vendored brand marks, and `import.meta.glob` is Vite's — under `bun test` it
* is undefined and calling it throws. Anything that renders the New Bot dialog imports it
* transitively, so without this every such file would need its own stub, and two of them passed
* only because a stub in a *different* file leaked process-wide: exactly the walk-order dependency
* the note above exists to stop.
*
* Null for every brand, which is a real state — a row can have no mark. A file that needs a mark
* drawn calls `mock.module` itself and wins, because a later registration replaces this one.
*/
mock.module("../src/lib/marks", () => ({ markFor: () => null }));