Skip to content

Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS

3.9 KB
Raw Blame

client/src/test/

Shared test helpers for the client suite. Deliberately not a barrel — these are test-only utilities, kept out of the enforced browser barrel described in the root AGENTS.md Module Organization section on purpose (see the comments atop pageNavTabAssertions.js / ariaRefAssertions.js). Grep this table before writing a new one.

File What it's for
actWarnings.js React act(...) warning diagnostics — records the test active when a warning was observed, without claiming to identify where asynchronous work began.
ariaRefAssertions.js Asserts a rendered tree's aria-controls/aria-labelledby IDREFs all resolve to a real element.
browserFixture.js startBrowserFixture — phase-bounded Vite + Chromium + warmup startup for *.browser.test.js (a stalled Chromium launch is retried once with a fresh process), naming the stalled phase and closing everything it started (a real launch is reaped through its own Playwright browser server: graceful close, then that server's kill, confirmed by the process's exit status); a timed-out launch attempt reports redacted Linux facts about its own browser child, and on GitHub Actions the ready/failure lines are kept in the step summary.
classNameScan.js Shared string-literal scanner (comment-stripping + literal walk) for the class-string convention guards.
dndKeyboardDrag.js Drives a real @dnd-kit keyboard drag under happy-dom, stubbing the layout happy-dom can't provide.
downloadPreflightConfirm.js clickStartDownload — waits for the confirm button to be enabled (built on enabledBarrier.js) before clicking, then settles.
enabledBarrier.js awaitEnabled / findEnabledByLabelText / findEnabledByRole — wait for a control to be enabled, not just present, before interacting.
fakeAudioContext.js Minimal Web Audio fake for playback tests (jsdom/node have no Web Audio).
formValidityPolyfill.js Fixes happy-dom's constraint-validation (stepMismatch) so implicit form submission behaves like a real browser.
imageGenPageMocks.jsx Shared vi.mock scaffold + fixtures + renderImageGenPage() for the ImageGen page suites.
mockEventSource.js Minimal EventSource stand-in for jsdom, with manual emit/emitRaw/fail control.
mockFrameWindows.js mockFrameWindows — per-iframe postMessage identities for protocol tests while remote frame loading stays disabled; callers restore spies at teardown.
pageLoadBarrier.js awaitPageLoaded — waits for a page's loading skeleton (by its accessible label) to be removed.
pageNavTabAssertions.js Pins a tabbed page's rendered tab id/label list against drift from the nav manifest it was built from.
settledInput.js typeSettled/clearSettled/retypeSettled — waits for a controlled input's value to actually reflect the typed text before it's read.
setup.js Vitest setup (auto-loaded): jest-dom matchers, the storage/form-validity polyfills, and the suite-wide async timeout.
storagePolyfill.js In-memory Storage polyfill installed when the test environment's real one is absent or unusable.
stripComments.js Blanks block/line comments out of a source string for the tree-wide convention guards that grep source.
swSandbox.js Evaluates the real public/sw.js in an isolated vm sandbox to exercise its event listeners directly.
timeouts.js ASYNC_UTIL_TIMEOUT_MS / TEST_TIMEOUT_MS — the suite's async time budgets, defined once so the ordering can't drift apart.
trackedFiles.js Shared git-tracked file walker for the repo-hygiene guards.
videoGenPageMocks.jsx Shared vi.mock scaffold + fixtures + renderVideoGenPage() for the VideoGen page suites.
voiceHotkeySpy.js Stand-in for the voice widget's app-global push-to-talk hotkey, for asserting a surface claimed/didn't leak a key.