@futdevpro/dynamo-e2e 1.18.26 → 1.18.29

package/build/_modules/ui-check/_collections/detectors/non-toggling-control.detector.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_NonTogglingControl_Detector = void 0;
+const ui_check_page_scripts_const_1 = require("../constants/ui-check-page-scripts.const");
+const ui_check_guard_util_1 = require("../ui-check-guard.util");
+const ui_check_page_util_1 = require("../ui-check-page.util");
+/**
+ * A checkbox / switch that does not toggle like one: on a fresh page it is pressed, a dialog it opened is closed the
+ * user's way (its own accept / close button, else Escape), then it is pressed AGAIN. Each press must flip the state;
+ * a press that fails (something covers the control) or does not flip it is a finding.
+ *
+ * Origin: owner 2026-10-20 (`IN-2026-10-20-HONNIE-10`, `-11`) — the Terms checkbox of the registration could be
+ * pressed only after navigating away and back; a generated e2e case had found it on 2026-09-23 and was switched off
+ * instead (BFR-FLEET-013).
+ */
+class DyE2E_NonTogglingControl_Detector {
+    id = 'non-toggling-control';
+    errorClass = 'toggle-does-not-toggle';
+    description = 'A checkbox / switch whose press (first or second) does not flip its state.';
+    origin = {
+        code: 'BFR-FLEET-013', foundBy: 'owner (HONNIE-10 / -11)', date: '2026-10-20',
+    };
+    interactive = true;
+    notes = [];
+    /** Buttons that close a dialog the user's way. */
+    static closeButtonPattern = /^(accept|i accept|agree|i agree|ok|okay|close|done|got it|understood|elfogad|elfogadom|rendben|bezár|értem)/i;
+    async run(page, context) {
+        const guard = await ui_check_guard_util_1.DyE2E_UICheckGuard_Util.installNetworkGuard(page, context);
+        const findings = [];
+        this.notes = [];
+        try {
+            await ui_check_page_util_1.DyE2E_UICheckPage_Util.reload(page, context);
+            const listed = await ui_check_page_util_1.DyE2E_UICheckPage_Util.listControls(page, context, 'toggle');
+            for (const control of [...listed.controls, ...listed.denied.filter((c) => !c.destructive)]) {
+                await ui_check_page_util_1.DyE2E_UICheckPage_Util.reload(page, context);
+                const steps = [];
+                for (const press of [1, 2]) {
+                    const step = await this.pressOnce(page, control.selector, press, context);
+                    steps.push(step);
+                    if (context.trace) {
+                        this.notes.push(`trace "${control.text || control.ariaLabel}" press ${press}: ${step.before} → ` +
+                            `${step.after}${step.dialog ? ` (${step.dialog})` : ''}${step.pressError ? `, error ${step.pressError}` : ''}`);
+                    }
+                    if (step.pressError || step.after === step.before) {
+                        findings.push(this.finding(control, steps, context));
+                        break;
+                    }
+                }
+            }
+        }
+        finally {
+            await guard.remove();
+        }
+        return findings;
+    }
+    /** One press: state before, the press, the dialog it opened (closed), state after. */
+    async pressOnce(page, selector, press, context) {
+        const before = await ui_check_page_util_1.DyE2E_UICheckPage_Util.evaluate(page, ui_check_page_scripts_const_1.DyE2E_UICheckPageScripts_Const['toggleState'], selector);
+        const dialogsBefore = (await this.dialogs(page)).length;
+        let pressError = null;
+        let dialog = null;
+        try {
+            await page.locator(selector).first().click({ timeout: 3_000 });
+        }
+        catch (error) {
+            pressError = ui_check_page_util_1.DyE2E_UICheckPage_Util.describePressError(error);
+        }
+        await page.waitForTimeout(context.settleMs ?? ui_check_page_util_1.DyE2E_UICheckPage_Util.defaultSettleMs);
+        const dialogs = await this.dialogs(page);
+        if (!pressError && dialogs.length > dialogsBefore) {
+            dialog = await this.closeDialog(page, dialogs[dialogs.length - 1]);
+            await page.waitForTimeout(context.settleMs ?? ui_check_page_util_1.DyE2E_UICheckPage_Util.defaultSettleMs);
+        }
+        const after = await ui_check_page_util_1.DyE2E_UICheckPage_Util.evaluate(page, ui_check_page_scripts_const_1.DyE2E_UICheckPageScripts_Const['toggleState'], selector);
+        return { press: press, before: before, after: after, pressError: pressError, dialog: dialog };
+    }
+    /** The visible modal dialogs (their button texts). */
+    async dialogs(page) {
+        return ui_check_page_util_1.DyE2E_UICheckPage_Util.evaluate(page, ui_check_page_scripts_const_1.DyE2E_UICheckPageScripts_Const['openDialogs']);
+    }
+    /** Closes the newest dialog with its own accept / close button, else with Escape; returns how. */
+    async closeDialog(page, buttons) {
+        const label = buttons.find((text) => DyE2E_NonTogglingControl_Detector.closeButtonPattern.test(text));
+        if (label) {
+            const button = page.locator('[role="dialog"], [role="alertdialog"], mat-dialog-container, ' +
+                '.mat-mdc-dialog-container, dialog[open]').last().locator('button, [role="button"], a', { hasText: label })
+                .first();
+            try {
+                await button.click({ timeout: 3_000 });
+                return `opened a dialog, closed with its "${label}" button`;
+            }
+            catch (error) {
+                // the dialog's own button cannot be pressed (covered) ⇒ fall back to Escape
+            }
+        }
+        await page.keyboard.press('Escape');
+        return `opened a dialog (buttons: ${buttons.join(', ') || 'none'}), closed with Escape`;
+    }
+    /** The finding of a control whose last step failed. */
+    finding(control, steps, context) {
+        const last = steps[steps.length - 1];
+        const label = control.text || control.ariaLabel || control.testId || control.selector;
+        const history = steps.slice(0, -1).map((s) => `press ${s.press}: ${s.before} → ${s.after}${s.dialog ? ` (${s.dialog})` : ''}`).join('; ');
+        const what = last.pressError
+            ? `press ${last.press} failed: ${last.pressError}`
+            : `press ${last.press} left it "${last.after}"${last.dialog ? ` (${last.dialog})` : ''}`;
+        return {
+            detector: this.id,
+            errorClass: this.errorClass,
+            url: context.url,
+            target: ui_check_page_util_1.DyE2E_UICheckPage_Util.toTarget(control),
+            measured: `"${label}": ${history ? history + '; ' : ''}${what}.`,
+            expected: 'Every press flips the state (on ⇄ off), also right after a dialog it opened was closed.',
+            details: { steps: steps },
+        };
+    }
+}
+exports.DyE2E_NonTogglingControl_Detector = DyE2E_NonTogglingControl_Detector;
+//# sourceMappingURL=non-toggling-control.detector.js.map

package/build/_modules/ui-check/_collections/detectors/non-toggling-control.detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"non-toggling-control.detector.js","sourceRoot":"","sources":["../../../../../src/_modules/ui-check/_collections/detectors/non-toggling-control.detector.ts"],"names":[],"mappings":"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"}

package/build/_modules/ui-check/_collections/ui-check-default-detectors.const.d.ts

@@ -0,0 +1,20 @@
+import { DyE2E_UICheckDetector_Interface } from '../_models/ui-check-detector.interface';
+/**
+ * The DEFAULT, growing UI detector list (BFR-FLEET-012) — every page, form and feature gets all of them.
+ *
+ * Each entry was written for a defect a HUMAN identified, and joined the list only after it caught that real defect AND
+ * stayed silent on the fixed version (the proofs: `__documentations/UI-CHECK-DETECTORS.md`). New human-found defect
+ * class ⇒ new detector; a project may add its own, and switch one off only with a coded, dated waiver.
+ */
+export declare const DyE2E_UICheckDefaultDetectors_Const: readonly DyE2E_UICheckDetector_Interface[];
+/**
+ * CANDIDATES — written, tested on minimal fixtures, but their real-defect proof is not complete yet, so they are NOT in
+ * the default list. Opt in:
+ * `detectors: [ ...DyE2E_UICheckDefaultDetectors_Const, ...DyE2E_UICheckCandidateDetectors_Const ]`.
+ *  - `nested-scroll`: fires on the real defect (`BL-QA-FDPUI-003`, MP TEST 2026-10-20), the "silent after the fix" half
+ *    waits for the fix;
+ *  - `non-toggling-control`: the owner's checkbox defect could not be reproduced on 2026-10-20 (MP + Adventor TEST,
+ *    desktop + mobile, five close paths) — the exact place is needed from the human who saw it.
+ */
+export declare const DyE2E_UICheckCandidateDetectors_Const: readonly DyE2E_UICheckDetector_Interface[];
+//# sourceMappingURL=ui-check-default-detectors.const.d.ts.map

package/build/_modules/ui-check/_collections/ui-check-default-detectors.const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-default-detectors.const.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_collections/ui-check-default-detectors.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAC;AAKzF;;;;;;GAMG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAAS,+BAA+B,EAEzF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,qCAAqC,EAAE,SAAS,+BAA+B,EAG3F,CAAC"}

package/build/_modules/ui-check/_collections/ui-check-default-detectors.const.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_UICheckCandidateDetectors_Const = exports.DyE2E_UICheckDefaultDetectors_Const = void 0;
+const dead_control_detector_1 = require("./detectors/dead-control.detector");
+const nested_scroll_detector_1 = require("./detectors/nested-scroll.detector");
+const non_toggling_control_detector_1 = require("./detectors/non-toggling-control.detector");
+/**
+ * The DEFAULT, growing UI detector list (BFR-FLEET-012) — every page, form and feature gets all of them.
+ *
+ * Each entry was written for a defect a HUMAN identified, and joined the list only after it caught that real defect AND
+ * stayed silent on the fixed version (the proofs: `__documentations/UI-CHECK-DETECTORS.md`). New human-found defect
+ * class ⇒ new detector; a project may add its own, and switch one off only with a coded, dated waiver.
+ */
+exports.DyE2E_UICheckDefaultDetectors_Const = [
+    new dead_control_detector_1.DyE2E_DeadControl_Detector(),
+];
+/**
+ * CANDIDATES — written, tested on minimal fixtures, but their real-defect proof is not complete yet, so they are NOT in
+ * the default list. Opt in:
+ * `detectors: [ ...DyE2E_UICheckDefaultDetectors_Const, ...DyE2E_UICheckCandidateDetectors_Const ]`.
+ *  - `nested-scroll`: fires on the real defect (`BL-QA-FDPUI-003`, MP TEST 2026-10-20), the "silent after the fix" half
+ *    waits for the fix;
+ *  - `non-toggling-control`: the owner's checkbox defect could not be reproduced on 2026-10-20 (MP + Adventor TEST,
+ *    desktop + mobile, five close paths) — the exact place is needed from the human who saw it.
+ */
+exports.DyE2E_UICheckCandidateDetectors_Const = [
+    new nested_scroll_detector_1.DyE2E_NestedScroll_Detector(),
+    new non_toggling_control_detector_1.DyE2E_NonTogglingControl_Detector(),
+];
+//# sourceMappingURL=ui-check-default-detectors.const.js.map

package/build/_modules/ui-check/_collections/ui-check-default-detectors.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-default-detectors.const.js","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_collections/ui-check-default-detectors.const.ts"],"names":[],"mappings":";;;AACA,6EAA+E;AAC/E,+EAAiF;AACjF,6FAA8F;AAE9F;;;;;;GAMG;AACU,QAAA,mCAAmC,GAA+C;IAC7F,IAAI,kDAA0B,EAAE;CACjC,CAAC;AAEF;;;;;;;;GAQG;AACU,QAAA,qCAAqC,GAA+C;IAC/F,IAAI,oDAA2B,EAAE;IACjC,IAAI,iEAAiC,EAAE;CACxC,CAAC"}

package/build/_modules/ui-check/_collections/ui-check-guard.util.d.ts

@@ -0,0 +1,60 @@
+import { Page, Request } from '@playwright/test';
+import { DyE2E_UICheckContext_Interface } from '../_models/ui-check-context.interface';
+/** What the network guard saw while it was installed. */
+export interface DyE2E_UICheckNetworkLog_Interface {
+    /** Requests started (document, xhr, fetch, websocket, eventsource) — an effect of a press. */
+    started: number;
+    /** Requests the guard aborted — they never reached a server. */
+    aborted: string[];
+}
+/** A removable network guard. */
+export interface DyE2E_UICheckNetworkGuard_Interface {
+    log: DyE2E_UICheckNetworkLog_Interface;
+    /** Zeroes the log (before the next press). */
+    reset(): void;
+    remove(): Promise<void>;
+}
+/**
+ * The safety layer of the interactive UI detectors (BFR-FLEET-012) — the rules are CODE, not advice:
+ *  1. a control is pressed only on a test host, anonymously or with a throwaway account;
+ *  2. a control whose text / label / test id names payment, e-mail sending, deletion, logout, publishing … is NEVER
+ *     pressed (`defaultDenyPattern`, plus `data-e2e-destructive`);
+ *  3. while a control is pressed, every mutating request (non-GET) is ABORTED — unless it matches `mutationAllow`, and
+ *     even then a payment / e-mail URL (`hardDenyUrlPattern`) or a non-reserved e-mail address in the body aborts it;
+ *     every navigation away from the page's host is aborted too;
+ *  4. every WebSocket opened while the guard is on is MOCKED: its messages never reach a server (a sent message still
+ *     counts as an effect) — a socket action (e.g. starting a paid run) cannot slip past the HTTP guard.
+ * So a press can never pay, never send a mail to a real address, and never change real data.
+ */
+export declare class DyE2E_UICheckGuard_Util {
+    /** Controls never pressed: payment, e-mail sending, deletion, logout, publishing (EN + HU). */
+    static readonly defaultDenyPattern: RegExp;
+    /** Request URLs never let through, even when `mutationAllow` matches: payment and e-mail sending. */
+    static readonly hardDenyUrlPattern: RegExp;
+    /** Methods that do not change server state. */
+    static readonly safeMethods: string[];
+    /** Resource types that count as the effect of a press. */
+    static readonly effectResourceTypes: string[];
+    /** E-mail addresses in a text (request body). */
+    private static readonly emailPattern;
+    /**
+     * Throws (with the reason) unless an interactive detector may run on `context`: a test host and an anonymous or
+     * throwaway account. Called by the runner BEFORE the page is touched.
+     */
+    static assertInteractiveAllowed(context: DyE2E_UICheckContext_Interface, detectorId: string): void;
+    /** Whether a control (its text, label, title, test id) is on the deny list. */
+    static isDenied(label: string, context: DyE2E_UICheckContext_Interface, destructive: boolean): boolean;
+    /** Whether a request may reach the server during a press (see the class doc). */
+    static isRequestAllowed(request: Request, context: DyE2E_UICheckContext_Interface): boolean;
+    /** Whether every e-mail address in `body` is reserved / undeliverable or on an own domain. */
+    static bodyEmailsAllowed(body: string, ownDomains: string[]): boolean;
+    /**
+     * Installs the network guard on `page` (HTTP route + request counter + WebSocket mock); `remove()` takes them off.
+     * Playwright has no `unrouteWebSocket`: after `remove()` NEW sockets connect to the server again, sockets opened
+     * while the guard was on stay mocked until the next load.
+     */
+    static installNetworkGuard(page: Page, context: DyE2E_UICheckContext_Interface): Promise<DyE2E_UICheckNetworkGuard_Interface>;
+    /** Whether two URLs share a host. */
+    private static sameHost;
+}
+//# sourceMappingURL=ui-check-guard.util.d.ts.map

package/build/_modules/ui-check/_collections/ui-check-guard.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-guard.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_collections/ui-check-guard.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAyB,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AAEvF,yDAAyD;AACzD,MAAM,WAAW,iCAAiC;IAChD,8FAA8F;IAC9F,OAAO,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,mCAAmC;IAClD,GAAG,EAAE,iCAAiC,CAAC;IACvC,8CAA8C;IAC9C,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAuB;IAElC,+FAA+F;IAC/F,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAKxB;IAElB,qGAAqG;IACrG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAGxB;IAElB,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAgC;IAErE,0DAA0D;IAC1D,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,EAAE,CAA8D;IAE3G,iDAAiD;IACjD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAqD;IAEzF;;;OAGG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,8BAA8B,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAWlG,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO;IAStG,iFAAiF;IACjF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,8BAA8B,GAAG,OAAO;IAmB3F,8FAA8F;IAC9F,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO;IAMrE;;;;OAIG;WACU,mBAAmB,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,mCAAmC,CAAC;IAqD/C,qCAAqC;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ;CAOxB"}

package/build/_modules/ui-check/_collections/ui-check-guard.util.js

@@ -0,0 +1,144 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_UICheckGuard_Util = void 0;
+const notification_sweep_util_1 = require("../../runtime/_collections/notification-sweep.util");
+/**
+ * The safety layer of the interactive UI detectors (BFR-FLEET-012) — the rules are CODE, not advice:
+ *  1. a control is pressed only on a test host, anonymously or with a throwaway account;
+ *  2. a control whose text / label / test id names payment, e-mail sending, deletion, logout, publishing … is NEVER
+ *     pressed (`defaultDenyPattern`, plus `data-e2e-destructive`);
+ *  3. while a control is pressed, every mutating request (non-GET) is ABORTED — unless it matches `mutationAllow`, and
+ *     even then a payment / e-mail URL (`hardDenyUrlPattern`) or a non-reserved e-mail address in the body aborts it;
+ *     every navigation away from the page's host is aborted too;
+ *  4. every WebSocket opened while the guard is on is MOCKED: its messages never reach a server (a sent message still
+ *     counts as an effect) — a socket action (e.g. starting a paid run) cannot slip past the HTTP guard.
+ * So a press can never pay, never send a mail to a real address, and never change real data.
+ */
+class DyE2E_UICheckGuard_Util {
+    /** Controls never pressed: payment, e-mail sending, deletion, logout, publishing (EN + HU). */
+    static defaultDenyPattern = new RegExp([
+        '\\blog\\s*-?\\s*out\\b', '\\bsign\\s*-?\\s*out\\b', 'kijelentkez', '\\bdelete\\b', 'törl[éő]', '\\bremove\\b',
+        'eltávolít', '\\bpay', 'fizet', '\\bbuy\\b', 'vásárl', '\\bcheckout\\b', '\\bpurchase', '\\border\\b', 'megrendel',
+        '\\bsubscri', 'előfizet', '\\bpublish', 'közzétesz', 'közzététel', '\\bsend\\b', 'küld', '\\binvite', 'meghív',
+        'e-?mail', '\\bdonat', 'adomány', '\\bdeactivat', '\\btransfer\\b', '\\bwithdraw', '\\bcredit', 'kredit',
+    ].join('|'), 'i');
+    /** Request URLs never let through, even when `mutationAllow` matches: payment and e-mail sending. */
+    static hardDenyUrlPattern = new RegExp([
+        'pay', 'checkout', 'purchase', 'order', 'invoice', 'billing', 'simplepay', 'barion', 'stripe', 'paypal', 'credit',
+        'mail', 'invite', 'newsletter', 'notify', 'send',
+    ].join('|'), 'i');
+    /** Methods that do not change server state. */
+    static safeMethods = ['GET', 'HEAD', 'OPTIONS'];
+    /** Resource types that count as the effect of a press. */
+    static effectResourceTypes = ['document', 'xhr', 'fetch', 'websocket', 'eventsource'];
+    /** E-mail addresses in a text (request body). */
+    static emailPattern = /[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}/gi;
+    /**
+     * Throws (with the reason) unless an interactive detector may run on `context`: a test host and an anonymous or
+     * throwaway account. Called by the runner BEFORE the page is touched.
+     */
+    static assertInteractiveAllowed(context, detectorId) {
+        if (!notification_sweep_util_1.DyE2E_NotificationSweep_Util.isSubmitAllowed(context.url, context.allowHosts ?? [])) {
+            throw new Error(`UI-check "${detectorId}" refused: "${context.url}" is not a test host (test.*, *.test, ` +
+                'localhost, 127.0.0.1 or allowHosts) — interactive detectors press controls, so they never run elsewhere.');
+        }
+        if (context.accountKind !== 'anonymous' && context.accountKind !== 'throwaway') {
+            throw new Error(`UI-check "${detectorId}" refused: accountKind must be "anonymous" or "throwaway" ` +
+                `(got "${String(context.accountKind)}") — a persistent or real account is never used for pressing controls.`);
+        }
+    }
+    /** Whether a control (its text, label, title, test id) is on the deny list. */
+    static isDenied(label, context, destructive) {
+        if (destructive) {
+            return true;
+        }
+        const patterns = [DyE2E_UICheckGuard_Util.defaultDenyPattern, ...(context.extraDenyPatterns ?? [])];
+        return patterns.some((pattern) => pattern.test(label));
+    }
+    /** Whether a request may reach the server during a press (see the class doc). */
+    static isRequestAllowed(request, context) {
+        const url = request.url();
+        if (request.isNavigationRequest() && !DyE2E_UICheckGuard_Util.sameHost(url, context.url)) {
+            return false;
+        }
+        if (DyE2E_UICheckGuard_Util.safeMethods.includes(request.method().toUpperCase())) {
+            return !(request.isNavigationRequest() && DyE2E_UICheckGuard_Util.hardDenyUrlPattern.test(new URL(url).pathname));
+        }
+        if (!(context.mutationAllow ?? []).some((pattern) => pattern.test(url))) {
+            return false;
+        }
+        if (DyE2E_UICheckGuard_Util.hardDenyUrlPattern.test(url)) {
+            return false;
+        }
+        return DyE2E_UICheckGuard_Util.bodyEmailsAllowed(request.postData() ?? '', context.ownEmailDomains ?? []);
+    }
+    /** Whether every e-mail address in `body` is reserved / undeliverable or on an own domain. */
+    static bodyEmailsAllowed(body, ownDomains) {
+        const emails = body.match(DyE2E_UICheckGuard_Util.emailPattern) ?? [];
+        return emails.every((email) => notification_sweep_util_1.DyE2E_NotificationSweep_Util.isAllowedProbeEmail(email, ownDomains));
+    }
+    /**
+     * Installs the network guard on `page` (HTTP route + request counter + WebSocket mock); `remove()` takes them off.
+     * Playwright has no `unrouteWebSocket`: after `remove()` NEW sockets connect to the server again, sockets opened
+     * while the guard was on stay mocked until the next load.
+     */
+    static async installNetworkGuard(page, context) {
+        const log = { started: 0, aborted: [] };
+        let active = true;
+        const socketHandler = (socket) => {
+            if (!active) {
+                socket.connectToServer();
+                return;
+            }
+            socket.onMessage(() => {
+                log.started++;
+                log.aborted.push(`WS message to ${socket.url()} (mocked, never forwarded)`);
+            });
+        };
+        if (typeof page.routeWebSocket !== 'function') {
+            throw new Error('UI-check guard refused: this Playwright has no page.routeWebSocket (needs >= 1.48) — without ' +
+                'it a WebSocket action of a pressed control could reach the server.');
+        }
+        await page.routeWebSocket(/.*/, socketHandler);
+        const onRequest = (request) => {
+            if (DyE2E_UICheckGuard_Util.effectResourceTypes.includes(request.resourceType())) {
+                log.started++;
+            }
+        };
+        const handler = async (route) => {
+            const request = route.request();
+            if (DyE2E_UICheckGuard_Util.isRequestAllowed(request, context)) {
+                await route.fallback();
+            }
+            else {
+                log.aborted.push(`${request.method()} ${request.url()}`);
+                await route.abort('blockedbyclient');
+            }
+        };
+        page.on('request', onRequest);
+        await page.route('**/*', handler);
+        return {
+            log: log,
+            reset: () => {
+                log.started = 0;
+                log.aborted = [];
+            },
+            remove: async () => {
+                active = false;
+                page.off('request', onRequest);
+                await page.unroute('**/*', handler);
+            },
+        };
+    }
+    /** Whether two URLs share a host. */
+    static sameHost(a, b) {
+        try {
+            return new URL(a).host === new URL(b).host;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+exports.DyE2E_UICheckGuard_Util = DyE2E_UICheckGuard_Util;
+//# sourceMappingURL=ui-check-guard.util.js.map

package/build/_modules/ui-check/_collections/ui-check-guard.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-guard.util.js","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_collections/ui-check-guard.util.ts"],"names":[],"mappings":"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"}

package/build/_modules/ui-check/_collections/ui-check-page.util.d.ts

@@ -0,0 +1,61 @@
+import { Page } from '@playwright/test';
+import { DyE2E_UICheckContext_Interface } from '../_models/ui-check-context.interface';
+import { DyE2E_UICheckTarget_Interface } from '../_models/ui-check-finding.interface';
+import { DyE2E_UICheckNetworkGuard_Interface } from './ui-check-guard.util';
+/** A control as listed in the page (`listControls`). */
+export interface DyE2E_UICheckControl_Interface extends DyE2E_UICheckTarget_Interface {
+    title: string;
+    destructive: boolean;
+}
+/** Everything a press caused (or failed to cause). */
+export interface DyE2E_UICheckPressEffect_Interface {
+    /** The press itself failed (covered, detached, timed out) — the first line of the error. */
+    pressError: string | null;
+    urlBefore: string;
+    urlAfter: string;
+    mutations: number;
+    mutationSamples: string[];
+    requests: number;
+    abortedRequests: string[];
+    popups: number;
+    downloads: number;
+    nativeDialogs: number;
+    consoleErrors: string[];
+    /** Any effect at all. */
+    hadEffect: boolean;
+}
+/** Shared page operations of the UI detectors. */
+export declare class DyE2E_UICheckPage_Util {
+    /** Default wait after a press, ms. */
+    static readonly defaultSettleMs: number;
+    /** Default number of controls pressed per detector and page. */
+    static readonly defaultMaxControls: number;
+    /** Console errors caused by the network guard's aborts (not by the product). */
+    static readonly guardInducedError: RegExp;
+    /** Runs one of `DyE2E_UICheckPageScripts_Const` in the page. */
+    static evaluate<T>(page: Page, script: string, arg?: unknown): Promise<T>;
+    /**
+     * Loads the page under check fresh, waits until it settled, and runs `context.prepare`. The console errors the page
+     * logs WITHOUT any press are added to `background` — a press is not blamed for them.
+     */
+    static reload(page: Page, context: DyE2E_UICheckContext_Interface, background?: Set<string>): Promise<void>;
+    /** A console error without its volatile parts (numbers, ids), so a repeating background error matches itself. */
+    static errorSignature(text: string): string;
+    /** The identity of a control across reloads (its CSS path may shift when an earlier press changed the page). */
+    static signature(control: DyE2E_UICheckControl_Interface): string;
+    /** The first line of a press error, plus the Playwright call-log line that names the cause (e.g. what covers it). */
+    static describePressError(error: unknown): string;
+    /** The visible, enabled controls of one kind, minus the denied ones (returned separately). */
+    static listControls(page: Page, context: DyE2E_UICheckContext_Interface, kind: 'press' | 'toggle'): Promise<{
+        controls: DyE2E_UICheckControl_Interface[];
+        denied: DyE2E_UICheckControl_Interface[];
+    }>;
+    /**
+     * Presses `selector` with every effect channel watched: URL, meaningful DOM mutations, requests (started — the
+     * guard aborts the mutating ones), popups, downloads, native dialogs, console errors.
+     */
+    static press(page: Page, selector: string, guard: DyE2E_UICheckNetworkGuard_Interface, context: DyE2E_UICheckContext_Interface, background?: Set<string>): Promise<DyE2E_UICheckPressEffect_Interface>;
+    /** The target part of a finding, from a listed control. */
+    static toTarget(control: DyE2E_UICheckControl_Interface): DyE2E_UICheckTarget_Interface;
+}
+//# sourceMappingURL=ui-check-page.util.d.ts.map

package/build/_modules/ui-check/_collections/ui-check-page.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-page.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_collections/ui-check-page.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAEtF,OAAO,EAA2B,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAErG,wDAAwD;AACxD,MAAM,WAAW,8BAA+B,SAAQ,6BAA6B;IACnF,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,sDAAsD;AACtD,MAAM,WAAW,kCAAkC;IACjD,4FAA4F;IAC5F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,kDAAkD;AAClD,qBAAa,sBAAsB;IAEjC,sCAAsC;IACtC,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAO;IAE9C,gEAAgE;IAChE,MAAM,CAAC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAM;IAEhD,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CACqE;IAE9G,gEAAgE;WACnD,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/E;;;OAGG;WACU,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,8BAA8B,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBjH,iHAAiH;IACjH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI3C,gHAAgH;IAChH,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM;IAIjE,qHAAqH;IACrH,MAAM,CAAC,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IASjD,8FAA8F;WACjF,YAAY,CACvB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,8BAA8B,EACvC,IAAI,EAAE,OAAO,GAAG,QAAQ,GACvB,OAAO,CAAC;QAAE,QAAQ,EAAE,8BAA8B,EAAE,CAAC;QAAC,MAAM,EAAE,8BAA8B,EAAE,CAAA;KAAE,CAAC;IAiBpG;;;OAGG;WACU,KAAK,CAChB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,mCAAmC,EAC1C,OAAO,EAAE,8BAA8B,EACvC,UAAU,GAAE,GAAG,CAAC,MAAM,CAAqB,GAC1C,OAAO,CAAC,kCAAkC,CAAC;IA8E9C,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,8BAA8B,GAAG,6BAA6B;CAIxF"}

package/build/_modules/ui-check/_collections/ui-check-page.util.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_UICheckPage_Util = void 0;
+const ui_check_page_scripts_const_1 = require("./constants/ui-check-page-scripts.const");
+const ui_check_guard_util_1 = require("./ui-check-guard.util");
+/** Shared page operations of the UI detectors. */
+class DyE2E_UICheckPage_Util {
+    /** Default wait after a press, ms. */
+    static defaultSettleMs = 600;
+    /** Default number of controls pressed per detector and page. */
+    static defaultMaxControls = 60;
+    /** Console errors caused by the network guard's aborts (not by the product). */
+    static guardInducedError = /ERR_BLOCKED_BY_CLIENT|Failed to fetch|NetworkError|Unknown Error|status of 0|net::ERR_FAILED|Load failed/i;
+    /** Runs one of `DyE2E_UICheckPageScripts_Const` in the page. */
+    static async evaluate(page, script, arg) {
+        return page.evaluate(`(${script})(${arg === undefined ? '' : JSON.stringify(arg)})`);
+    }
+    /**
+     * Loads the page under check fresh, waits until it settled, and runs `context.prepare`. The console errors the page
+     * logs WITHOUT any press are added to `background` — a press is not blamed for them.
+     */
+    static async reload(page, context, background) {
+        const onConsole = (message) => {
+            if (message.type() === 'error') {
+                background?.add(DyE2E_UICheckPage_Util.errorSignature(message.text()));
+            }
+        };
+        page.on('console', onConsole);
+        try {
+            await page.goto(context.url, { waitUntil: 'load' });
+            await page.waitForLoadState('networkidle', { timeout: 5_000 }).catch(() => undefined);
+            await page.waitForTimeout(context.settleMs ?? DyE2E_UICheckPage_Util.defaultSettleMs);
+            if (context.prepare) {
+                await context.prepare(page);
+                await page.waitForTimeout(context.settleMs ?? DyE2E_UICheckPage_Util.defaultSettleMs);
+            }
+        }
+        finally {
+            page.off('console', onConsole);
+        }
+    }
+    /** A console error without its volatile parts (numbers, ids), so a repeating background error matches itself. */
+    static errorSignature(text) {
+        return text.replace(/[0-9a-f]{8,}/gi, '#').replace(/\d+/g, '#').trim().slice(0, 160);
+    }
+    /** The identity of a control across reloads (its CSS path may shift when an earlier press changed the page). */
+    static signature(control) {
+        return [control.tag, control.testId ?? '', control.ariaLabel ?? '', control.text].join('|');
+    }
+    /** The first line of a press error, plus the Playwright call-log line that names the cause (e.g. what covers it). */
+    static describePressError(error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const lines = message.split('\n');
+        const cause = lines.find((line) => /intercepts pointer events|not visible|not enabled|not stable|detached|outside of the viewport/.test(line));
+        return (lines[0] + (cause ? ' — ' + cause.trim() : '')).slice(0, 400);
+    }
+    /** The visible, enabled controls of one kind, minus the denied ones (returned separately). */
+    static async listControls(page, context, kind) {
+        const all = await DyE2E_UICheckPage_Util.evaluate(page, ui_check_page_scripts_const_1.DyE2E_UICheckPageScripts_Const['listControls'], { kind: kind, max: (context.maxControls ?? DyE2E_UICheckPage_Util.defaultMaxControls) * 3 });
+        const controls = [];
+        const denied = [];
+        for (const control of all) {
+            const label = [control.text, control.ariaLabel, control.title, control.testId].filter(Boolean).join(' ');
+            (ui_check_guard_util_1.DyE2E_UICheckGuard_Util.isDenied(label, context, control.destructive) ? denied : controls).push(control);
+        }
+        return { controls: controls.slice(0, context.maxControls ?? DyE2E_UICheckPage_Util.defaultMaxControls),
+            denied: denied };
+    }
+    /**
+     * Presses `selector` with every effect channel watched: URL, meaningful DOM mutations, requests (started — the
+     * guard aborts the mutating ones), popups, downloads, native dialogs, console errors.
+     */
+    static async press(page, selector, guard, context, background = new Set()) {
+        const consoleErrors = [];
+        let popups = 0;
+        let downloads = 0;
+        let nativeDialogs = 0;
+        const onConsole = (message) => {
+            if (message.type() === 'error') {
+                consoleErrors.push(message.text().slice(0, 200));
+            }
+        };
+        const onPageError = (error) => {
+            consoleErrors.push(('uncaught: ' + error.message).slice(0, 200));
+        };
+        const onPopup = () => {
+            popups++;
+        };
+        const onDownload = (download) => {
+            downloads++;
+            download.cancel().catch(() => undefined);
+        };
+        const onDialog = (dialog) => {
+            nativeDialogs++;
+            dialog.dismiss().catch(() => undefined);
+        };
+        page.on('console', onConsole);
+        page.on('pageerror', onPageError);
+        page.on('popup', onPopup);
+        page.on('download', onDownload);
+        page.on('dialog', onDialog);
+        const urlBefore = page.url();
+        let pressError = null;
+        await DyE2E_UICheckPage_Util.evaluate(page, ui_check_page_scripts_const_1.DyE2E_UICheckPageScripts_Const['startMutationWatch']);
+        guard.reset();
+        try {
+            await page.locator(selector).first().click({ timeout: 3_000 });
+        }
+        catch (error) {
+            pressError = DyE2E_UICheckPage_Util.describePressError(error);
+        }
+        await page.waitForTimeout(context.settleMs ?? DyE2E_UICheckPage_Util.defaultSettleMs);
+        const urlAfter = page.url();
+        const watch = await DyE2E_UICheckPage_Util.evaluate(page, ui_check_page_scripts_const_1.DyE2E_UICheckPageScripts_Const['readMutationWatch'])
+            .catch(() => ({ count: -1, samples: ['the page navigated away'] }));
+        page.off('console', onConsole);
+        page.off('pageerror', onPageError);
+        page.off('popup', onPopup);
+        page.off('download', onDownload);
+        page.off('dialog', onDialog);
+        // the guard's own aborts surface as console errors too (`ERR_BLOCKED_BY_CLIENT`, a failed fetch, an HTTP status 0)
+        // ⇒ those are the measurement's, not the product's, and are dropped while something was aborted
+        // …and an error the page also logs without any press is background noise, not the press's
+        const productErrors = consoleErrors
+            .filter((text) => !guard.log.aborted.length
+            || !DyE2E_UICheckPage_Util.guardInducedError.test(text))
+            .filter((text) => !background.has(DyE2E_UICheckPage_Util.errorSignature(text)));
+        const hadEffect = urlAfter !== urlBefore || watch.count !== 0 || guard.log.started > 0 || popups > 0
+            || downloads > 0 || nativeDialogs > 0;
+        return {
+            pressError: pressError,
+            urlBefore: urlBefore,
+            urlAfter: urlAfter,
+            mutations: watch.count,
+            mutationSamples: watch.samples,
+            requests: guard.log.started,
+            abortedRequests: [...guard.log.aborted],
+            popups: popups,
+            downloads: downloads,
+            nativeDialogs: nativeDialogs,
+            consoleErrors: productErrors,
+            hadEffect: hadEffect,
+        };
+    }
+    /** The target part of a finding, from a listed control. */
+    static toTarget(control) {
+        return { selector: control.selector, tag: control.tag, text: control.text, testId: control.testId,
+            ariaLabel: control.ariaLabel };
+    }
+}
+exports.DyE2E_UICheckPage_Util = DyE2E_UICheckPage_Util;
+//# sourceMappingURL=ui-check-page.util.js.map