@piwitests/reporter 0.40.0 → 0.42.0

package/dist/internal/capture/attachments.d.ts

@@ -14,6 +14,7 @@ declare const ATTACHMENT_NAMES: {
     readonly network: "piwi-network";
     readonly pageInventory: "piwi-page-inventory";
     readonly locatorPages: "piwi-locator-pages";
+    readonly codeReach: "piwi-code-reach";
     readonly webVitals: "piwi-web-vitals";
     readonly locatorSuggestion: "piwi-locator-suggestion";
     readonly pageState: "piwi-page-state";

package/dist/internal/capture/attachments.js

@@ -35,6 +35,7 @@ var ATTACHMENT_NAMES = {
   network: "piwi-network",
   pageInventory: "piwi-page-inventory",
   locatorPages: "piwi-locator-pages",
+  codeReach: "piwi-code-reach",
   webVitals: "piwi-web-vitals",
   locatorSuggestion: "piwi-locator-suggestion",
   pageState: "piwi-page-state",

package/dist/internal/capture/capture-fixtures.d.ts

@@ -1,7 +1,8 @@
 import { ProbeArg } from '@piwitests/picker-dom';
 export { ProbeArg, ProbedAttrs, probeElementAttrs } from '@piwitests/picker-dom';
-import { TestType, Fixtures, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, Locator } from '@playwright/test';
+import { Page, TestType, Fixtures, PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, Locator } from '@playwright/test';
 import { LocatorPageUse } from '@piwitests/core/wire';
+import { JsCoverageEntry } from '@piwitests/core/code-reach';
 
 /** A main-frame navigation, full or same-document: the page starts over. */
 declare function noteNavigation(page: object): void;
@@ -41,6 +42,30 @@ declare function boxCaptureFrames(extraPrefixes?: readonly string[]): void;
  */
 declare function internalCall<T>(owner: unknown, run: () => Promise<T>): Promise<T>;
 
+/** Where code reach resolves paths. */
+interface CodeReachRoots {
+    /** Directories a module path or a map source is tried against, first match wins; the repository root is last. */
+    roots: string[];
+    /** Paths go out relative to it. */
+    repoRoot: string;
+}
+/** Fetches a source map's text; null when it cannot. */
+type MapFetcher = (url: string) => Promise<string | null>;
+/**
+ * The roots for a test: `codeReachRoots` when set, else the Playwright config's
+ * directory; the repository root always comes last, since bundlers name
+ * sources from the project root (Turbopack's `[project]/`).
+ */
+declare function codeReachRoots(configDir: string, configured: string[] | null | undefined): CodeReachRoots;
+/** The repository-relative files the covered scripts reached, sorted and capped. */
+declare function resolveCodeReach(entries: JsCoverageEntry[], roots: CodeReachRoots, fetchMap: MapFetcher): Promise<string[]>;
+/** A map fetcher through the page's request context, bounded in size and time. */
+declare function pageMapFetcher(page: Page): MapFetcher;
+/** Start JavaScript coverage on a page; false when the browser has none or it fails. */
+declare function startCodeReach(page: Page): Promise<boolean>;
+/** Stop JavaScript coverage and return its entries; null when it cannot be read. */
+declare function stopCodeReach(page: Page): Promise<JsCoverageEntry[] | null>;
+
 type FixtureArgs = {
     [key: string]: any;
 };
@@ -63,6 +88,8 @@ declare function computeCoreVitals(lcpEntries: RawVitalEntry[] | null, shiftEntr
     cls: number | null;
     inp: number | null;
 } | null;
+/** The code reach roots from `PIWI_CODE_REACH_ROOTS` (a JSON array or a path list). */
+declare function configuredCodeReachRoots(): string[] | null;
 /** Page state captured at test end. Storage values and cookie values are NEVER included. */
 interface PageState {
     url: string;
@@ -185,4 +212,4 @@ declare const piwiFixtures: Fixtures<PiwiFixtures, {}, PlaywrightTestArgs & Play
  */
 declare function extendPiwiFixtures<TestArgs extends FixtureArgs, WorkerArgs extends FixtureArgs>(test: TestType<TestArgs, WorkerArgs>): TestType<TestArgs & PiwiFixtures, WorkerArgs>;
 
-export { CAPTURED_ATTRS_ARG, LocatorPageLog, type PageState, type PiwiFixtures, type RawPageState, type RawVitalEntry, ariaSnapshotBestEffort, ariaSnapshotJSONBestEffort, boxCaptureFrames, buildPageState, callMethod, computeCoreVitals, extendPiwiFixtures, internalCall, noteLocatorCall, noteNavigation, piwiFixtures };
+export { CAPTURED_ATTRS_ARG, LocatorPageLog, type PageState, type PiwiFixtures, type RawPageState, type RawVitalEntry, ariaSnapshotBestEffort, ariaSnapshotJSONBestEffort, boxCaptureFrames, buildPageState, callMethod, codeReachRoots, computeCoreVitals, configuredCodeReachRoots, extendPiwiFixtures, internalCall, noteLocatorCall, noteNavigation, pageMapFetcher, piwiFixtures, resolveCodeReach, startCodeReach, stopCodeReach };