@ggui-ai/ui-gen 0.22.0 → 0.24.0

package/src/harness/check/runtime-render/render-check.ts

@@ -15,18 +15,11 @@
 // All checks are best-effort: if a heuristic can't find an element, the
 // check fails with a descriptive reason rather than throwing.
 
-import type {
-  DataContract,
-  JsonObject,
-  PropsSpec,
-} from "@ggui-ai/protocol";
+import type { RenderCheckHostOptions } from "./render-check-host.js";
+import type { GenerationRuntimeProbeCheck } from "@ggui-ai/mcp-server-core";
+import type { DataContract, JsonObject, PropsSpec } from "@ggui-ai/protocol";
 import { HOOK_NAME_RE, listContractGadgets } from "@ggui-ai/protocol";
-import {
-  createProbe,
-  createProbeWireConfig,
-  type ActionFiredEvent,
-  type Probe,
-} from "./probe.js";
+import { createProbe, createProbeWireConfig, type ActionFiredEvent, type Probe } from "./probe.js";
 import { loadComponent } from "./load-component.js";
 import { findWiring, type WiringDetection } from "./find-wiring.js";
 import { installProductionActShim } from "./production-act-shim.js";
@@ -45,6 +38,7 @@ import {
   type ParentLink,
 } from "./host-boundary.js";
 import { hostGlobals, openRecord } from "../../../internal/open-record.js";
+import type { ProbeHostLoad } from "../../../evaluation/types-public.js";
 import { primeInputs } from "@ggui-ai/ui-visual-tester/prime-inputs";
 
 /**
@@ -72,15 +66,32 @@ type ProbeModuleNamespace = {
  */
 export type CheckOutcome = "verified" | "failed" | "unverified" | "skipped";
 
+/**
+ * The checks this probe runs, by name (ggui#1380). ONE union: the same
+ * values a generation's metadata lists in `failChecks`
+ * (`GenerationRuntimeProbeCheck` in `@ggui-ai/mcp-server-core`), declared
+ * there and named here — the same pattern as `RuntimeProbeStatus`.
+ */
+export type RenderCheckKind = GenerationRuntimeProbeCheck;
+
+/**
+ * Every {@link RenderCheckKind}, once, in the order the union declares them.
+ * The order is the order a probe's `failChecks` lists the checks that failed,
+ * so a render crash always reads first. `satisfies` refuses a kind outside
+ * the union; the pin beside the adapter refuses a member missing here.
+ */
+export const RENDER_CHECK_KINDS = [
+  "render-no-throw",
+  "prop-sensitivity",
+  "action-wiring",
+  "selection-identity",
+  "prop-coverage",
+  "optional-props-omitted",
+  "stream-rerender",
+] as const satisfies readonly RenderCheckKind[];
+
 export interface RenderCheckIssue {
-  readonly check:
-    | "render-no-throw"
-    | "action-wiring"
-    | "selection-identity"
-    | "prop-coverage"
-    | "prop-sensitivity"
-    | "stream-rerender"
-    | "optional-props-omitted";
+  readonly check: RenderCheckKind;
   readonly outcome: CheckOutcome;
   readonly subject?: string;
   readonly reason: string;
@@ -114,17 +125,33 @@ export interface RenderCheckIssue {
  * priming failure never aborts the check — it is recorded here, on every
  * action-wiring issue, so it is visible in the feedback instead of vanishing.
  */
-export type InputPrimingDiagnostic =
-  | { readonly primed: number }
-  | { readonly error: string };
+export type InputPrimingDiagnostic = { readonly primed: number } | { readonly error: string };
+
+/**
+ * The check started but did not finish (ggui#1299). The only kind is a
+ * wall-clock timeout in the isolated worker. It is not a verdict on the
+ * component: `issues` is empty and `ok` is false because nothing was
+ * verified, never because something failed.
+ */
+export interface RenderCheckIncomplete {
+  readonly kind: "timeout";
+  /** How long the worker ran before it was stopped. */
+  readonly elapsedMs: number;
+  /** The wall-clock bound it crossed. */
+  readonly boundMs: number;
+}
 
 export interface RenderCheckResult {
   readonly ok: boolean;
   readonly issues: readonly RenderCheckIssue[];
+  /** Present only when the check did not finish; see {@link RenderCheckIncomplete}. */
+  readonly incomplete?: RenderCheckIncomplete;
   readonly stats: {
     readonly actionsChecked: number;
     readonly streamsChecked: number;
     readonly renderMs: number;
+    /** Host load around an isolated check (absent in-process). */
+    readonly hostLoad?: ProbeHostLoad;
   };
 }
 
@@ -134,6 +161,14 @@ export interface RunRenderCheckInput {
   readonly contract?: DataContract;
 }
 
+/**
+ * Options of {@link runRenderCheck} (ggui#1380): the host's options —
+ * `bounds` are the isolated subprocess's wall-clock, heap and grace (see
+ * `RenderCheckHostBounds`); they apply to the worker path only and are
+ * ignored in-process. One shape, declared once on the host.
+ */
+export type RunRenderCheckOptions = RenderCheckHostOptions;
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Public entry
 // ─────────────────────────────────────────────────────────────────────────────
@@ -160,13 +195,15 @@ export interface RunRenderCheckInput {
  */
 export async function runRenderCheck(
   input: RunRenderCheckInput,
+  options: RunRenderCheckOptions = {}
 ): Promise<RenderCheckResult> {
   const g = hostGlobals();
   if ("window" in g && "document" in g) {
+    // In-process: nothing to bound — the check shares the caller's process.
     return runRenderCheckInProcess(input);
   }
   const { runRenderCheckViaWorker } = await import("./render-check-host.js");
-  return runRenderCheckViaWorker(input);
+  return runRenderCheckViaWorker(input, options);
 }
 
 /**
@@ -179,7 +216,7 @@ export async function runRenderCheck(
  * dispatcher explicitly.
  */
 export async function runRenderCheckInProcess(
-  input: RunRenderCheckInput,
+  input: RunRenderCheckInput
 ): Promise<RenderCheckResult> {
   const t0 = Date.now();
   const issues: RenderCheckIssue[] = [];
@@ -207,7 +244,7 @@ export async function runRenderCheckInProcess(
     const { GguiWireProvider } = Wire;
 
     const moduleResolutions: Record<string, unknown> = {
-      "react": React,
+      react: React,
       "react/jsx-runtime": ReactJsxRuntime,
       "@ggui-ai/wire": Wire,
     };
@@ -243,9 +280,7 @@ export async function runRenderCheckInProcess(
     // a direct dep. Swallow on miss —
     // same posture as design subpaths above.
     try {
-      moduleResolutions["@ggui-ai/gadgets"] = await import(
-        "@ggui-ai/gadgets"
-      );
+      moduleResolutions["@ggui-ai/gadgets"] = await import("@ggui-ai/gadgets");
     } catch {
       /* skip — sandbox will report a clear error if the component imports it */
     }
@@ -347,11 +382,7 @@ export async function runRenderCheckInProcess(
       if (!capturedComponentStack) {
         // Try to find any arg that looks like a "    at X (...)" stack.
         for (const arg of args) {
-          if (
-            typeof arg === "string" &&
-            /^\s*at\s+\S/m.test(arg) &&
-            arg.length > 20
-          ) {
+          if (typeof arg === "string" && /^\s*at\s+\S/m.test(arg) && arg.length > 20) {
             capturedComponentStack = arg;
             break;
           }
@@ -426,11 +457,19 @@ export async function runRenderCheckInProcess(
             children: React.createElement(ProbeErrorBoundary, {
               children: React.createElement(Component, input.mockupProps),
             }),
-          }),
-        ),
+          })
+        )
       );
       const timeoutPromise = new Promise<never>((_, reject) => {
-        setTimeout(() => reject(new Error(`[runtime-render] render exceeded ${RENDER_TIMEOUT_MS}ms — classified as runtime-hang`)), RENDER_TIMEOUT_MS).unref?.();
+        setTimeout(
+          () =>
+            reject(
+              new Error(
+                `[runtime-render] render exceeded ${RENDER_TIMEOUT_MS}ms — classified as runtime-hang`
+              )
+            ),
+          RENDER_TIMEOUT_MS
+        ).unref?.();
       });
       renderResult = await Promise.race([renderPromise, timeoutPromise]);
     } catch (e) {
@@ -457,7 +496,10 @@ export async function runRenderCheckInProcess(
         .split("\n")
         .map((l) => l.trim())
         .filter((l) => l.startsWith("at "))
-        .filter((l) => !/(node_modules|happy-dom|@testing-library|react-dom|node:internal|node:async)/.test(l))
+        .filter(
+          (l) =>
+            !/(node_modules|happy-dom|@testing-library|react-dom|node:internal|node:async)/.test(l)
+        )
         .slice(0, 5);
       // Prefer the ErrorBoundary-captured stack (richer + names component
       // wrappers like memo/forwardRef), fall back to the spy-captured one.
@@ -497,9 +539,7 @@ export async function runRenderCheckInProcess(
       const compBlock = componentFrames.length
         ? `\n  Component stack: ${componentFrames.join(" > ")}`
         : "";
-      const errMsg = boundaryRef.error
-        ? boundaryRef.error.message
-        : "(no error message)";
+      const errMsg = boundaryRef.error ? boundaryRef.error.message : "(no error message)";
       issues.push({
         check: "render-no-throw",
         outcome: "failed",
@@ -577,7 +617,7 @@ export async function runRenderCheckInProcess(
       if (input.contract?.actionSpec) {
         for (const [name, entry] of Object.entries(input.contract.actionSpec)) {
           const idField = idLikeRequiredStringField(
-            entry.schema as Record<string, unknown> | undefined,
+            entry.schema as Record<string, unknown> | undefined
           );
           if (idField === null) continue;
           const issue = await checkSelectionIdentity({
@@ -634,8 +674,7 @@ export async function runRenderCheckInProcess(
       // prop — not dead), and non-scalar props are all skipped.
       if (input.contract?.propsSpec) {
         const propsSpec5c = input.contract.propsSpec as PropsSpec;
-        const normalize = (s: string | null): string =>
-          (s ?? "").replace(/\s+/g, " ").trim();
+        const normalize = (s: string | null): string => (s ?? "").replace(/\s+/g, " ").trim();
         const baseText = normalize(container.textContent);
         for (const [propName, entry] of Object.entries(propsSpec5c.properties)) {
           if (!entry.required) continue;
@@ -663,7 +702,7 @@ export async function runRenderCheckInProcess(
                     [propName]: varied,
                   }),
                 }),
-              }),
+              })
             );
           } catch {
             continue; // crash on varied value ⇒ the prop is read, not dead
@@ -676,8 +715,7 @@ export async function runRenderCheckInProcess(
               check: "prop-sensitivity",
               outcome: "failed",
               subject: propName,
-              reason:
-                `props.${propName} is displayed ('${marker}' appears in the DOM) but changing its value to '${String(varied)}' left the rendered output BYTE-IDENTICAL — the value is baked into the component instead of derived from the prop. A cached reuse of this blueprint under a different ${propName} would show the original value.`,
+              reason: `props.${propName} is displayed ('${marker}' appears in the DOM) but changing its value to '${String(varied)}' left the rendered output BYTE-IDENTICAL — the value is baked into the component instead of derived from the prop. A cached reuse of this blueprint under a different ${propName} would show the original value.`,
             });
           }
         }
@@ -711,9 +749,10 @@ export async function runRenderCheckInProcess(
       const declaredProps = input.contract?.propsSpec?.properties;
       if (declaredProps) {
         const optionalFilled = Object.entries(declaredProps)
-          .filter(([name, entry]) =>
-            (entry as { required?: boolean }).required !== true &&
-            input.mockupProps[name] !== undefined,
+          .filter(
+            ([name, entry]) =>
+              (entry as { required?: boolean }).required !== true &&
+              input.mockupProps[name] !== undefined
           )
           .map(([name]) => name);
         if (optionalFilled.length > 0) {
@@ -743,11 +782,10 @@ export async function runRenderCheckInProcess(
                 children: React.createElement(OmitErrorBoundary, {
                   children: React.createElement(Component, requiredOnlyProps),
                 }),
-              }),
+              })
             );
           } catch (e) {
-            omitBoundaryRef.error ??=
-              e instanceof Error ? e : new Error(String(e));
+            omitBoundaryRef.error ??= e instanceof Error ? e : new Error(String(e));
           }
           if (omitBoundaryRef.error) {
             issues.push({
@@ -769,8 +807,16 @@ export async function runRenderCheckInProcess(
 
     return finalize(issues, t0, actionsChecked, streamsChecked);
   } finally {
-    try { uninstallSpy?.(); } catch { /* ignore */ }
-    try { uninstallGadgetRegistry?.(); } catch { /* ignore */ }
+    try {
+      uninstallSpy?.();
+    } catch {
+      /* ignore */
+    }
+    try {
+      uninstallGadgetRegistry?.();
+    } catch {
+      /* ignore */
+    }
     teardown();
   }
 }
@@ -814,9 +860,7 @@ export async function runRenderCheckInProcess(
  * Returns an uninstaller; the caller MUST invoke it — `globalThis` is
  * a process global and a leaked slot taints the next check.
  */
-export function installGadgetStubRegistry(
-  contract: DataContract | undefined,
-): () => void {
+export function installGadgetStubRegistry(contract: DataContract | undefined): () => void {
   const declared = contract?.clientCapabilities?.gadgets;
   if (!declared || Object.keys(declared).length === 0) {
     return () => {};
@@ -829,9 +873,8 @@ export function installGadgetStubRegistry(
   const valueStub = new Proxy(
     {},
     {
-      get: (_t, key) =>
-        key === "then" || typeof key === "symbol" ? undefined : noop,
-    },
+      get: (_t, key) => (key === "then" || typeof key === "symbol" ? undefined : noop),
+    }
   );
   const result = { status: "idle", value: valueStub, start: noop };
   // Unknown top-level keys resolve to a no-op (covers `map.foo()`);
@@ -886,9 +929,7 @@ export function installGadgetStubRegistry(
  * `__ggui__.gadgets` registry). Only operator-registered wrapper
  * packages need a sandbox shim.
  */
-function collectThirdPartyGadgetPackages(
-  contract: DataContract | undefined,
-): string[] {
+function collectThirdPartyGadgetPackages(contract: DataContract | undefined): string[] {
   if (!contract) return [];
   const packages = new Set<string>();
   for (const use of listContractGadgets(contract)) {
@@ -934,7 +975,7 @@ function buildGadgetPackageProbeShim(packageName: string): ProbeModuleNamespace
       const impl = resolveExport(name);
       if (typeof impl !== "function") {
         throw new Error(
-          `[gadget] export '${name}' from '${packageName}' is not loaded in the render-check probe — the component imports it but the contract's clientCapabilities.gadgets never declared it, so installGadgetStubRegistry planted no stub.`,
+          `[gadget] export '${name}' from '${packageName}' is not loaded in the render-check probe — the component imports it but the contract's clientCapabilities.gadgets never declared it, so installGadgetStubRegistry planted no stub.`
         );
       }
       return (impl as (...a: unknown[]) => unknown)(...args);
@@ -950,9 +991,8 @@ function buildGadgetPackageProbeShim(packageName: string): ProbeModuleNamespace
       },
       // `key in ns` checks (esbuild interop may probe) report true so
       // the named import binds to the thunk rather than `undefined`.
-      has: (_t, key) =>
-        typeof key !== "symbol" && key !== "then" && key !== "default",
-    },
+      has: (_t, key) => typeof key !== "symbol" && key !== "then" && key !== "default",
+    }
   ) as ProbeModuleNamespace;
 }
 
@@ -1020,12 +1060,16 @@ async function setupHappyDom(): Promise<() => void> {
       return;
     }
     // Not ours — re-throw on next tick so the default handler runs.
-    process.nextTick(() => { throw err; });
+    process.nextTick(() => {
+      throw err;
+    });
   };
   const unhandledHandler = (reason: unknown): void => {
     if (isTeardownArtifact(reason)) return;
     const err = reason instanceof Error ? reason : new Error(String(reason));
-    process.nextTick(() => { throw err; });
+    process.nextTick(() => {
+      throw err;
+    });
   };
   process.on("uncaughtException", uncaughtHandler);
   process.on("unhandledRejection", unhandledHandler);
@@ -1125,9 +1169,9 @@ function finalize(
   issues: RenderCheckIssue[],
   t0: number,
   actionsChecked: number,
-  streamsChecked: number,
+  streamsChecked: number
 ): RenderCheckResult {
-  const ok = !issues.some(i => i.outcome === "failed");
+  const ok = !issues.some((i) => i.outcome === "failed");
   return {
     ok,
     issues,
@@ -1167,7 +1211,9 @@ async function checkActionWiring(input: CheckActionInput): Promise<RenderCheckIs
       check: "action-wiring",
       outcome: "failed",
       subject: actionName,
-      reason: wiring.reason ?? `Action '${actionName}' is declared in contract but useAction('${actionName}') is not wired to any UI element`,
+      reason:
+        wiring.reason ??
+        `Action '${actionName}' is declared in contract but useAction('${actionName}') is not wired to any UI element`,
       diagnostics: baseDiagnostics,
     };
   }
@@ -1178,7 +1224,9 @@ async function checkActionWiring(input: CheckActionInput): Promise<RenderCheckIs
       check: "action-wiring",
       outcome: "unverified",
       subject: actionName,
-      reason: wiring.reason ?? "Source indicates non-click or non-native wiring; static probe did not verify execution deterministically.",
+      reason:
+        wiring.reason ??
+        "Source indicates non-click or non-native wiring; static probe did not verify execution deterministically.",
       diagnostics: baseDiagnostics,
     };
   }
@@ -1229,24 +1277,20 @@ async function checkActionWiring(input: CheckActionInput): Promise<RenderCheckIs
  * `id`/`Id`/`ID` and whose declared type is string — the shape the
  * matcher's booking/selection contracts carry (`bookSlot { slotId }`).
  */
-function idLikeRequiredStringField(
-  schema: Record<string, unknown> | undefined,
-): string | null {
+function idLikeRequiredStringField(schema: Record<string, unknown> | undefined): string | null {
   if (schema === undefined) return null;
-  const properties = schema['properties'];
-  const required = schema['required'];
-  if (properties === null || typeof properties !== 'object') return null;
+  const properties = schema["properties"];
+  const required = schema["required"];
+  if (properties === null || typeof properties !== "object") return null;
   if (!Array.isArray(required)) return null;
-  for (const [propName, propSchema] of Object.entries(
-    properties as Record<string, unknown>,
-  )) {
+  for (const [propName, propSchema] of Object.entries(properties as Record<string, unknown>)) {
     if (!/id$/i.test(propName)) continue;
     if (!required.includes(propName)) continue;
     const t =
-      propSchema !== null && typeof propSchema === 'object'
-        ? (propSchema as Record<string, unknown>)['type']
+      propSchema !== null && typeof propSchema === "object"
+        ? (propSchema as Record<string, unknown>)["type"]
         : undefined;
-    if (t === 'string') return propName;
+    if (t === "string") return propName;
   }
   return null;
 }
@@ -1269,16 +1313,16 @@ interface CheckSelectionIdentityInput {
  * null (covered by other checks or genuinely unjudgeable here).
  */
 async function checkSelectionIdentity(
-  input: CheckSelectionIdentityInput,
+  input: CheckSelectionIdentityInput
 ): Promise<RenderCheckIssue | null> {
   const { container, probe, user, actionName, idField } = input;
 
   const clickables = Array.from(
-    container.querySelectorAll<MinimalElement>('button, [role="button"]'),
+    container.querySelectorAll<MinimalElement>('button, [role="button"]')
   );
   const byLabel = new Map<string, MinimalElement[]>();
   for (const el of clickables) {
-    const label = (el.textContent ?? '').replace(/\s+/g, ' ').trim();
+    const label = (el.textContent ?? "").replace(/\s+/g, " ").trim();
     if (label.length === 0) continue;
     const group = byLabel.get(label);
     if (group) group.push(el);
@@ -1288,9 +1332,7 @@ async function checkSelectionIdentity(
   for (const [label, group] of byLabel) {
     if (group.length < 2) continue;
 
-    const payloadFor = async (
-      el: MinimalElement,
-    ): Promise<unknown | undefined> => {
+    const payloadFor = async (el: MinimalElement): Promise<unknown | undefined> => {
       const before = probe.getFireLog().length;
       try {
         await user.click(el);
@@ -1301,10 +1343,7 @@ async function checkSelectionIdentity(
       const events = probe
         .getFireLog()
         .slice(before)
-        .filter(
-          (e): e is ActionFiredEvent =>
-            e.kind === 'action.fired' && e.name === actionName,
-        );
+        .filter((e): e is ActionFiredEvent => e.kind === "action.fired" && e.name === actionName);
       return events.length > 0 ? events[events.length - 1]!.payload : undefined;
     };
 
@@ -1315,9 +1354,9 @@ async function checkSelectionIdentity(
     if (first === undefined || second === undefined) continue;
 
     const idOf = (payload: unknown): string | undefined => {
-      if (payload === null || typeof payload !== 'object') return undefined;
+      if (payload === null || typeof payload !== "object") return undefined;
       const v = (payload as Record<string, unknown>)[idField];
-      return typeof v === 'string' ? v : undefined;
+      return typeof v === "string" ? v : undefined;
     };
     const firstId = idOf(first);
     const secondId = idOf(second);
@@ -1326,11 +1365,10 @@ async function checkSelectionIdentity(
 
     if (firstId === secondId) {
       return {
-        check: 'selection-identity',
-        outcome: 'failed',
+        check: "selection-identity",
+        outcome: "failed",
         subject: actionName,
-        reason:
-          `Two clickable elements share the visible label '${label}', and clicking EACH fired '${actionName}' with the same ${idField} ('${firstId}') — the action payload is keyed on the display value, not the element's identity. Distinct cells must send their own ${idField} (the contract requires it), or selecting one "${label}" acts on every "${label}".`,
+        reason: `Two clickable elements share the visible label '${label}', and clicking EACH fired '${actionName}' with the same ${idField} ('${firstId}') — the action payload is keyed on the display value, not the element's identity. Distinct cells must send their own ${idField} (the contract requires it), or selecting one "${label}" acts on every "${label}".`,
         elementHint: describeElement(group[0]!),
       };
     }
@@ -1377,16 +1415,16 @@ async function simulateAndCheck(input: SimulateAndCheckInput): Promise<SimulateR
     }
     await flushPromises();
     const newEvents = probe.getFireLog().slice(before);
-    const matched = newEvents.some(e => e.kind === eventKind && e.name === actionName);
+    const matched = newEvents.some((e) => e.kind === eventKind && e.name === actionName);
     if (matched) return { fired: true };
   }
 
   // Capture what DID fire — useful diagnostic.
   const allFired = probe
     .getFireLog()
-    .filter(e => e.kind === "action.fired")
-    .map(e => e.name);
-  const otherActionsFired = Array.from(new Set(allFired)).filter(n => n !== actionName);
+    .filter((e) => e.kind === "action.fired")
+    .map((e) => e.name);
+  const otherActionsFired = Array.from(new Set(allFired)).filter((n) => n !== actionName);
 
   return {
     fired: false,
@@ -1398,7 +1436,7 @@ async function simulateAndCheck(input: SimulateAndCheckInput): Promise<SimulateR
 async function dispatchTrigger(
   el: MinimalElement,
   kind: "click" | "submit" | "change" | "keyboard-enter",
-  user: { click: (el: MinimalElement) => Promise<void> },
+  user: { click: (el: MinimalElement) => Promise<void> }
 ): Promise<void> {
   switch (kind) {
     case "click":
@@ -1409,7 +1447,10 @@ async function dispatchTrigger(
       // dispatch a 'submit' event on it. happy-dom respects this.
       const form = closestForm(el);
       if (!form) return;
-      const ev = new (globalThis as { Event: typeof Event }).Event("submit", { bubbles: true, cancelable: true });
+      const ev = new (globalThis as { Event: typeof Event }).Event("submit", {
+        bubbles: true,
+        cancelable: true,
+      });
       toEventDispatcher(form).dispatchEvent(ev);
       return;
     }
@@ -1425,8 +1466,14 @@ async function dispatchTrigger(
     }
     case "keyboard-enter": {
       // Click first to focus, then dispatch an Enter keydown.
-      try { await user.click(el); } catch { /* ignore */ }
-      const KeyboardEventCtor = (globalThis as { KeyboardEvent?: new (type: string, init: object) => Event }).KeyboardEvent;
+      try {
+        await user.click(el);
+      } catch {
+        /* ignore */
+      }
+      const KeyboardEventCtor = (
+        globalThis as { KeyboardEvent?: new (type: string, init: object) => Event }
+      ).KeyboardEvent;
       if (KeyboardEventCtor) {
         const ev = new KeyboardEventCtor("keydown", { key: "Enter", bubbles: true });
         toEventDispatcher(el).dispatchEvent(ev);
@@ -1463,7 +1510,10 @@ function setSyntheticValue(el: MinimalElement): void {
         const current = node.value ?? "";
         let pick = opts[0]!.value;
         for (let i = 0; i < opts.length; i++) {
-          if (opts[i]!.value !== current) { pick = opts[i]!.value; break; }
+          if (opts[i]!.value !== current) {
+            pick = opts[i]!.value;
+            break;
+          }
         }
         node.value = pick;
       }
@@ -1514,7 +1564,7 @@ function findCandidateElements(
   container: MinimalElement,
   kind: "click" | "submit" | "change" | "keyboard-enter",
   name: string,
-  label: string,
+  label: string
 ): MinimalElement[] {
   switch (kind) {
     case "click":
@@ -1522,7 +1572,7 @@ function findCandidateElements(
     case "submit": {
       // submit-eligible: <form>, button[type=submit], input[type=submit]
       const all = container.querySelectorAll<MinimalElement>(
-        'form, button[type="submit"], input[type="submit"]',
+        'form, button[type="submit"], input[type="submit"]'
       );
       return Array.from(all);
     }
@@ -1575,7 +1625,9 @@ interface CheckStreamRerenderInput {
   React: typeof import("react");
 }
 
-async function checkStreamRerender(input: CheckStreamRerenderInput): Promise<RenderCheckIssue | null> {
+async function checkStreamRerender(
+  input: CheckStreamRerenderInput
+): Promise<RenderCheckIssue | null> {
   const { container, eventName, probe } = input;
 
   if (!probe.getRegistered().streams.includes(eventName)) {
@@ -1594,7 +1646,7 @@ async function checkStreamRerender(input: CheckStreamRerenderInput): Promise<Ren
   // in multiple common field names so downstream consumers find it.
   const payload = { id: marker, text: marker, value: marker, message: marker, name: marker };
 
-  await new Promise<void>(resolve => {
+  await new Promise<void>((resolve) => {
     setTimeout(() => {
       probe.emitStream(eventName, payload);
       resolve();
@@ -1624,7 +1676,11 @@ async function checkStreamRerender(input: CheckStreamRerenderInput): Promise<Ren
 // Helpers
 // ─────────────────────────────────────────────────────────────────────────────
 
-function findActionElements(container: MinimalElement, name: string, label: string): MinimalElement[] {
+function findActionElements(
+  container: MinimalElement,
+  name: string,
+  label: string
+): MinimalElement[] {
   const candidates: MinimalElement[] = [];
   const seen = new Set<MinimalElement>();
 
@@ -1633,7 +1689,7 @@ function findActionElements(container: MinimalElement, name: string, label: stri
   const labelKey = norm(label);
 
   const allClickable = container.querySelectorAll<MinimalElement>(
-    'button, [role="button"], input[type="submit"], input[type="button"], a[href]',
+    'button, [role="button"], input[type="submit"], input[type="button"], a[href]'
   );
 
   // Pass 1: text/aria-label/data-action match
@@ -1696,5 +1752,5 @@ function pickScalarMarker(value: unknown): string | null {
 }
 
 function flushPromises(): Promise<void> {
-  return new Promise(resolve => setTimeout(resolve, 0));
+  return new Promise((resolve) => setTimeout(resolve, 0));
 }