@futdevpro/dynamo-e2e 1.18.25 → 1.18.29

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

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

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

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

@@ -0,0 +1,41 @@
+import { Page } from '@playwright/test';
+import { DyE2E_UICheckContext_Interface } from '../_models/ui-check-context.interface';
+import { DyE2E_UICheckDetector_Interface } from '../_models/ui-check-detector.interface';
+import { DyE2E_UICheckFinding_Interface } from '../_models/ui-check-finding.interface';
+import { DyE2E_UICheckReport_Interface, DyE2E_UICheckWaiver_Interface } from '../_models/ui-check-report.interface';
+/** Options of one UI check run. */
+export interface DyE2E_UICheckRunOptions_Interface {
+    /** The detectors to run (default: the whole default list). Extend it, do not shrink it — waive instead. */
+    detectors?: DyE2E_UICheckDetector_Interface[];
+    /** Coded, dated exceptions for known findings. */
+    waivers?: DyE2E_UICheckWaiver_Interface[];
+    /** "Today" for the waiver expiry (`YYYY-MM-DD`, default: the current UTC date). */
+    today?: string;
+}
+/**
+ * Runs the UI detectors on one page and returns VERDICTS (BFR-FLEET-012). The page is expected on `context.url`.
+ * Measuring detectors run first (on the page as loaded), interactive ones after them (each reloads the page).
+ * A crashed detector is a failed check; a finding is suppressed only by a valid, unexpired, coded waiver.
+ *
+ * ```ts
+ * const report = await DyE2E_UICheckRunner_Util.run(page, { url: page.url(), accountKind: 'anonymous' });
+ * DyE2E_UICheckRunner_Util.assertClean(report);
+ * ```
+ */
+export declare class DyE2E_UICheckRunner_Util {
+    /** A waiver's trace code. */
+    static readonly waiverCodePattern: RegExp;
+    /** Runs the check — see the class doc. */
+    static run(page: Page, context: DyE2E_UICheckContext_Interface, options?: DyE2E_UICheckRunOptions_Interface): Promise<DyE2E_UICheckReport_Interface>;
+    /** Throws (with the formatted report) when the report has a finding or a crashed detector. */
+    static assertClean(report: DyE2E_UICheckReport_Interface): void;
+    /** The report as readable text — findings, crashes, waived and expired waivers, each with its measurement. */
+    static format(report: DyE2E_UICheckReport_Interface): string;
+    /** Throws for a waiver without a trace code, a reason or a valid expiry date. */
+    static validateWaivers(waivers: DyE2E_UICheckWaiver_Interface[]): void;
+    /** The target of a finding in one line: selector, text, test id, label. */
+    static describeTarget(finding: DyE2E_UICheckFinding_Interface): string;
+    /** Whether `waiver` applies to `finding`. */
+    private static waiverMatches;
+}
+//# sourceMappingURL=ui-check-runner.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-runner.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_collections/ui-check-runner.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAC;AACzF,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EACL,6BAA6B,EAE7B,6BAA6B,EAC9B,MAAM,sCAAsC,CAAC;AAI9C,mCAAmC;AACnC,MAAM,WAAW,iCAAiC;IAChD,2GAA2G;IAC3G,SAAS,CAAC,EAAE,+BAA+B,EAAE,CAAC;IAC9C,kDAAkD;IAClD,OAAO,CAAC,EAAE,6BAA6B,EAAE,CAAC;IAC1C,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,qBAAa,wBAAwB;IAEnC,6BAA6B;IAC7B,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAmC;IAE5E,0CAA0C;WAC7B,GAAG,CACd,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,8BAA8B,EACvC,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,6BAA6B,CAAC;IA4CzC,8FAA8F;IAC9F,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,6BAA6B,GAAG,IAAI;IAM/D,8GAA8G;IAC9G,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,6BAA6B,GAAG,MAAM;IA0B5D,iFAAiF;IACjF,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,6BAA6B,EAAE,GAAG,IAAI;IAuBtE,2EAA2E;IAC3E,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,8BAA8B,GAAG,MAAM;IAOtE,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAC,aAAa;CAY7B"}

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

@@ -0,0 +1,128 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_UICheckRunner_Util = void 0;
+const ui_check_default_detectors_const_1 = require("./ui-check-default-detectors.const");
+const ui_check_guard_util_1 = require("./ui-check-guard.util");
+/**
+ * Runs the UI detectors on one page and returns VERDICTS (BFR-FLEET-012). The page is expected on `context.url`.
+ * Measuring detectors run first (on the page as loaded), interactive ones after them (each reloads the page).
+ * A crashed detector is a failed check; a finding is suppressed only by a valid, unexpired, coded waiver.
+ *
+ * ```ts
+ * const report = await DyE2E_UICheckRunner_Util.run(page, { url: page.url(), accountKind: 'anonymous' });
+ * DyE2E_UICheckRunner_Util.assertClean(report);
+ * ```
+ */
+class DyE2E_UICheckRunner_Util {
+    /** A waiver's trace code. */
+    static waiverCodePattern = /^(BL|BFR|BUG|CFR)-[A-Z0-9-]+$/;
+    /** Runs the check — see the class doc. */
+    static async run(page, context, options = {}) {
+        const detectors = options.detectors ?? [...ui_check_default_detectors_const_1.DyE2E_UICheckDefaultDetectors_Const];
+        const waivers = options.waivers ?? [];
+        const today = options.today ?? new Date().toISOString().slice(0, 10);
+        DyE2E_UICheckRunner_Util.validateWaivers(waivers);
+        // the guard fails the WHOLE run before the page is touched
+        detectors.filter((d) => d.interactive)
+            .forEach((d) => ui_check_guard_util_1.DyE2E_UICheckGuard_Util.assertInteractiveAllowed(context, d.id));
+        const ordered = [
+            ...detectors.filter((d) => !d.interactive),
+            ...detectors.filter((d) => d.interactive),
+        ];
+        const report = {
+            url: context.url, detectorsRun: [], findings: [], waived: [], expiredWaivers: [], errors: [], notes: [],
+        };
+        const active = waivers.filter((w) => w.expires >= today);
+        report.expiredWaivers = waivers.filter((w) => w.expires < today);
+        for (const detector of ordered) {
+            report.detectorsRun.push(detector.id);
+            try {
+                for (const finding of await detector.run(page, context)) {
+                    const waiver = active.find((w) => DyE2E_UICheckRunner_Util.waiverMatches(w, finding));
+                    if (waiver) {
+                        report.waived.push({ finding: finding, waiver: waiver });
+                    }
+                    else {
+                        report.findings.push(finding);
+                    }
+                }
+                report.notes.push(...(detector.notes ?? []).map((note) => `${detector.id}: ${note}`));
+            }
+            catch (error) {
+                report.errors.push({ detector: detector.id,
+                    message: error instanceof Error ? (error.stack ?? error.message) : String(error) });
+            }
+        }
+        return report;
+    }
+    /** Throws (with the formatted report) when the report has a finding or a crashed detector. */
+    static assertClean(report) {
+        if (report.findings.length || report.errors.length) {
+            throw new Error(DyE2E_UICheckRunner_Util.format(report));
+        }
+    }
+    /** The report as readable text — findings, crashes, waived and expired waivers, each with its measurement. */
+    static format(report) {
+        const lines = [`UI check of ${report.url} — detectors: ${report.detectorsRun.join(', ')}`,
+            `${report.findings.length} finding(s), ${report.errors.length} crashed detector(s), ` +
+                `${report.waived.length} waived, ${report.expiredWaivers.length} expired waiver(s), ${report.notes.length} note(s)`];
+        report.findings.forEach((f, i) => {
+            lines.push(`  ${i + 1}. [${f.detector} / ${f.errorClass}] ${DyE2E_UICheckRunner_Util.describeTarget(f)}`, `     measured: ${f.measured}`, `     expected: ${f.expected}`);
+        });
+        report.errors.forEach((e) => {
+            lines.push(`  ✖ ${e.detector} crashed: ${e.message.split('\n').slice(0, 3).join(' / ')}`);
+        });
+        report.waived.forEach((w) => {
+            lines.push(`  ~ waived (${w.waiver.code}, until ${w.waiver.expires}): [${w.finding.detector}] ` +
+                `${DyE2E_UICheckRunner_Util.describeTarget(w.finding)}`);
+        });
+        report.notes.forEach((note) => {
+            lines.push(`  ? ${note}`);
+        });
+        report.expiredWaivers.forEach((w) => {
+            lines.push(`  ! expired waiver ${w.code} (${w.detector}, expired ${w.expires}) — no longer applied`);
+        });
+        return lines.join('\n');
+    }
+    /** Throws for a waiver without a trace code, a reason or a valid expiry date. */
+    static validateWaivers(waivers) {
+        for (const waiver of waivers) {
+            const problems = [];
+            if (!DyE2E_UICheckRunner_Util.waiverCodePattern.test(waiver.code ?? '')) {
+                problems.push('code must be a BL- / BFR- / BUG- / CFR- trace code');
+            }
+            if (!(waiver.reason ?? '').trim()) {
+                problems.push('reason is empty');
+            }
+            if (!/^\d{4}-\d{2}-\d{2}$/.test(waiver.expires ?? '') || isNaN(Date.parse(waiver.expires))) {
+                problems.push('expires must be a YYYY-MM-DD date');
+            }
+            if (!(waiver.detector ?? '').trim()) {
+                problems.push('detector is empty');
+            }
+            if (problems.length) {
+                throw new Error(`Invalid UI-check waiver ${JSON.stringify(waiver)}: ${problems.join('; ')} — a detector is ` +
+                    'never switched off silently (BFR-FLEET-012).');
+            }
+        }
+    }
+    /** The target of a finding in one line: selector, text, test id, label. */
+    static describeTarget(finding) {
+        const t = finding.target;
+        return [t.selector, t.text ? `"${t.text}"` : '', t.testId ? `[data-testid=${t.testId}]` : '',
+            t.ariaLabel ? `(aria-label "${t.ariaLabel}")` : ''].filter(Boolean).join(' ');
+    }
+    /** Whether `waiver` applies to `finding`. */
+    static waiverMatches(waiver, finding) {
+        if (waiver.detector !== finding.detector) {
+            return false;
+        }
+        if (!waiver.target) {
+            return true;
+        }
+        return [finding.target.selector, finding.target.text, finding.target.testId ?? '']
+            .some((value) => value.includes(waiver.target));
+    }
+}
+exports.DyE2E_UICheckRunner_Util = DyE2E_UICheckRunner_Util;
+//# sourceMappingURL=ui-check-runner.util.js.map

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

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

package/build/_modules/ui-check/_models/ui-check-context.interface.d.ts

@@ -0,0 +1,39 @@
+import { Page } from '@playwright/test';
+/** Who is logged in while an interactive detector presses controls. */
+export type DyE2E_UICheckAccount_Type = 'anonymous' | 'throwaway';
+/**
+ * The page a UI check runs on, and the safety limits of the run.
+ *
+ * Interactive detectors (they press controls) run ONLY on a test host (`test.*`, `*.test`, `localhost`, … or
+ * `allowHosts`), and only anonymously or with a throwaway account — the runner refuses anything else.
+ */
+export interface DyE2E_UICheckContext_Interface {
+    /** The page under check — interactive detectors reload it before every press. */
+    url: string;
+    /** Declared by the caller: `throwaway` = an account created for this run and deleted afterwards. */
+    accountKind: DyE2E_UICheckAccount_Type;
+    /** Extra hosts treated as test hosts (exact match). */
+    allowHosts?: string[];
+    /** At most this many controls are pressed per detector and page (default 60). */
+    maxControls?: number;
+    /** Wait after a press before the effect is read, ms (default 600). */
+    settleMs?: number;
+    /** Controls whose text / label / test id matches any of these are never pressed (added to the default list). */
+    extraDenyPatterns?: RegExp[];
+    /**
+     * Mutating requests (non-GET) are ABORTED by default during a press — the press is still counted as an effect.
+     * A request whose URL matches one of these is let through, unless it hits the hard deny list (payment, e-mail) or
+     * carries a non-reserved e-mail address in its body.
+     */
+    mutationAllow?: RegExp[];
+    /** Own e-mail domains that may appear in a let-through request body (besides the reserved ones). */
+    ownEmailDomains?: string[];
+    /**
+     * Runs after every (re)load, before anything is listed or pressed — closes the ENTRY dialogs a returning user no
+     * longer sees (an environment notice, a cookie banner). While a modal dialog stays open, only its controls count.
+     */
+    prepare?: (page: Page) => Promise<void>;
+    /** Every press (and what it caused) is written into the report notes — for debugging a detector on a real page. */
+    trace?: boolean;
+}
+//# sourceMappingURL=ui-check-context.interface.d.ts.map

package/build/_modules/ui-check/_models/ui-check-context.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-context.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-context.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,uEAAuE;AACvE,MAAM,MAAM,yBAAyB,GAAG,WAAW,GAAG,WAAW,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,8BAA8B;IAC7C,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,oGAAoG;IACpG,WAAW,EAAE,yBAAyB,CAAC;IACvC,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gHAAgH;IAChH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,oGAAoG;IACpG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,mHAAmH;IACnH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/build/_modules/ui-check/_models/ui-check-context.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ui-check-context.interface.js.map

package/build/_modules/ui-check/_models/ui-check-context.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-context.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-context.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ui-check/_models/ui-check-detector.interface.d.ts

@@ -0,0 +1,32 @@
+import { Page } from '@playwright/test';
+import { DyE2E_UICheckContext_Interface } from './ui-check-context.interface';
+import { DyE2E_UICheckFinding_Interface } from './ui-check-finding.interface';
+/** The human-found defect a detector was written for — every detector starts from one (BFR-FLEET-012). */
+export interface DyE2E_UICheckOrigin_Interface {
+    /** The defect's trace code (BL / BFR / BUG). */
+    code: string;
+    /** Who identified it (owner, QA, a tester). */
+    foundBy: string;
+    /** When (ISO date). */
+    date: string;
+}
+/**
+ * One scripted, per-error-class UI detector. It returns VERDICTS: an empty list means the page is clean for this
+ * error class. A detector is added to the default list only after it caught the real, human-identified defect and
+ * stayed silent on the fixed version.
+ */
+export interface DyE2E_UICheckDetector_Interface {
+    /** Stable id, kebab-case. */
+    id: string;
+    /** The error class it detects. */
+    errorClass: string;
+    /** One sentence: what the detector measures. */
+    description: string;
+    origin: DyE2E_UICheckOrigin_Interface;
+    /** It presses controls ⇒ test host + anonymous / throwaway account only. */
+    interactive: boolean;
+    /** What the last run could not measure (a skipped control, a page that changed) — copied into the report. */
+    notes?: string[];
+    run(page: Page, context: DyE2E_UICheckContext_Interface): Promise<DyE2E_UICheckFinding_Interface[]>;
+}
+//# sourceMappingURL=ui-check-detector.interface.d.ts.map

package/build/_modules/ui-check/_models/ui-check-detector.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-detector.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-detector.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAE9E,0GAA0G;AAC1G,MAAM,WAAW,6BAA6B;IAC5C,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,6BAA6B,CAAC;IACtC,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;IACrB,6GAA6G;IAC7G,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAAC;CACrG"}

package/build/_modules/ui-check/_models/ui-check-detector.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ui-check-detector.interface.js.map

package/build/_modules/ui-check/_models/ui-check-detector.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-detector.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-detector.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ui-check/_models/ui-check-finding.interface.d.ts

@@ -0,0 +1,30 @@
+/** The control or region a UI-check finding points at — enough to find it again without a screenshot. */
+export interface DyE2E_UICheckTarget_Interface {
+    /** A unique CSS path in the page (re-resolvable after a reload). */
+    selector: string;
+    tag: string;
+    /** Whitespace-collapsed visible text, capped at 120 chars. */
+    text: string;
+    testId: string | null;
+    ariaLabel: string | null;
+}
+/**
+ * One UI-check finding: a VERDICT (this is a defect of the detector's error class), not evidence for a reviewer.
+ * It carries what was measured and what the correct behaviour would have been (`core-error-debuggable`).
+ */
+export interface DyE2E_UICheckFinding_Interface {
+    /** The detector id (e.g. `dead-control`). */
+    detector: string;
+    /** The error class of the detector (e.g. `control-without-effect`). */
+    errorClass: string;
+    /** The page the finding was measured on. */
+    url: string;
+    target: DyE2E_UICheckTarget_Interface;
+    /** What was measured, in one sentence. */
+    measured: string;
+    /** What a working UI would have done. */
+    expected: string;
+    /** Raw measurements behind the verdict. */
+    details: Record<string, unknown>;
+}
+//# sourceMappingURL=ui-check-finding.interface.d.ts.map

package/build/_modules/ui-check/_models/ui-check-finding.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-finding.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-finding.interface.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,MAAM,WAAW,6BAA6B;IAC5C,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,6BAA6B,CAAC;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC"}

package/build/_modules/ui-check/_models/ui-check-finding.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ui-check-finding.interface.js.map

package/build/_modules/ui-check/_models/ui-check-finding.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-finding.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-finding.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ui-check/_models/ui-check-report.interface.d.ts

@@ -0,0 +1,38 @@
+import { DyE2E_UICheckFinding_Interface } from './ui-check-finding.interface';
+/**
+ * A coded, dated exception for one known finding — a detector is NEVER switched off silently (BFR-FLEET-012/-013).
+ * Without a trace code, a reason and an expiry date the runner rejects it; after the expiry it no longer applies.
+ */
+export interface DyE2E_UICheckWaiver_Interface {
+    /** The detector id the waiver applies to. */
+    detector: string;
+    /** Substring of the finding's selector, text or test id; omitted = every finding of the detector on the page. */
+    target?: string;
+    /** The open defect's trace code: `BL-…`, `BFR-…`, `BUG-…` or `CFR-…`. */
+    code: string;
+    reason: string;
+    /** ISO date (`YYYY-MM-DD`); from the next day on the waiver is expired. */
+    expires: string;
+}
+/** A finding the waiver suppressed — still listed in the report. */
+export interface DyE2E_UICheckWaived_Interface {
+    finding: DyE2E_UICheckFinding_Interface;
+    waiver: DyE2E_UICheckWaiver_Interface;
+}
+/** A detector that crashed — a crash is a failed check, never a clean one. */
+export interface DyE2E_UICheckError_Interface {
+    detector: string;
+    message: string;
+}
+/** The result of one UI check on one page. */
+export interface DyE2E_UICheckReport_Interface {
+    url: string;
+    detectorsRun: string[];
+    findings: DyE2E_UICheckFinding_Interface[];
+    waived: DyE2E_UICheckWaived_Interface[];
+    expiredWaivers: DyE2E_UICheckWaiver_Interface[];
+    errors: DyE2E_UICheckError_Interface[];
+    /** What a detector could not measure — read them: a skipped control is not a clean one. */
+    notes: string[];
+}
+//# sourceMappingURL=ui-check-report.interface.d.ts.map

package/build/_modules/ui-check/_models/ui-check-report.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-report.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-report.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,iHAAiH;IACjH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oEAAoE;AACpE,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,8BAA8B,CAAC;IACxC,MAAM,EAAE,6BAA6B,CAAC;CACvC;AAED,8EAA8E;AAC9E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,8CAA8C;AAC9C,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,8BAA8B,EAAE,CAAC;IAC3C,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACxC,cAAc,EAAE,6BAA6B,EAAE,CAAC;IAChD,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACvC,2FAA2F;IAC3F,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/build/_modules/ui-check/_models/ui-check-report.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ui-check-report.interface.js.map

package/build/_modules/ui-check/_models/ui-check-report.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-check-report.interface.js","sourceRoot":"","sources":["../../../../src/_modules/ui-check/_models/ui-check-report.interface.ts"],"names":[],"mappings":""}

package/build/_modules/ui-check/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `@futdevpro/dynamo-e2e/ui-check` — scripted, per-error-class UI detectors that return VERDICTS (BFR-FLEET-012).
+ * The `/vqa` layer collects evidence for a reviewer; this layer fails the run.
+ *
+ * ```ts
+ * import { DyE2E_UICheckRunner_Util } from '@futdevpro/dynamo-e2e/ui-check';
+ *
+ * test('| the register page has no UI defect', async ({ page }) => {
+ *   await page.goto('/landing/register');
+ *   const report = await DyE2E_UICheckRunner_Util.run(page, { url: page.url(), accountKind: 'anonymous' });
+ *   DyE2E_UICheckRunner_Util.assertClean(report);
+ * });
+ * ```
+ */
+export * from './_collections/constants/ui-check-page-scripts.const';
+export * from './_collections/detectors/dead-control.detector';
+export * from './_collections/detectors/nested-scroll.detector';
+export * from './_collections/detectors/non-toggling-control.detector';
+export * from './_collections/ui-check-default-detectors.const';
+export * from './_collections/ui-check-guard.util';
+export * from './_collections/ui-check-page.util';
+export * from './_collections/ui-check-runner.util';
+export * from './_models/ui-check-context.interface';
+export * from './_models/ui-check-detector.interface';
+export * from './_models/ui-check-finding.interface';
+export * from './_models/ui-check-report.interface';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/ui-check/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/ui-check/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,sDAAsD,CAAC;AACrE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,iDAAiD,CAAC;AAChE,cAAc,wDAAwD,CAAC;AACvE,cAAc,iDAAiD,CAAC;AAChE,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC"}

package/build/_modules/ui-check/index.js

@@ -0,0 +1,43 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * `@futdevpro/dynamo-e2e/ui-check` — scripted, per-error-class UI detectors that return VERDICTS (BFR-FLEET-012).
+ * The `/vqa` layer collects evidence for a reviewer; this layer fails the run.
+ *
+ * ```ts
+ * import { DyE2E_UICheckRunner_Util } from '@futdevpro/dynamo-e2e/ui-check';
+ *
+ * test('| the register page has no UI defect', async ({ page }) => {
+ *   await page.goto('/landing/register');
+ *   const report = await DyE2E_UICheckRunner_Util.run(page, { url: page.url(), accountKind: 'anonymous' });
+ *   DyE2E_UICheckRunner_Util.assertClean(report);
+ * });
+ * ```
+ */
+__exportStar(require("./_collections/constants/ui-check-page-scripts.const"), exports);
+__exportStar(require("./_collections/detectors/dead-control.detector"), exports);
+__exportStar(require("./_collections/detectors/nested-scroll.detector"), exports);
+__exportStar(require("./_collections/detectors/non-toggling-control.detector"), exports);
+__exportStar(require("./_collections/ui-check-default-detectors.const"), exports);
+__exportStar(require("./_collections/ui-check-guard.util"), exports);
+__exportStar(require("./_collections/ui-check-page.util"), exports);
+__exportStar(require("./_collections/ui-check-runner.util"), exports);
+__exportStar(require("./_models/ui-check-context.interface"), exports);
+__exportStar(require("./_models/ui-check-detector.interface"), exports);
+__exportStar(require("./_models/ui-check-finding.interface"), exports);
+__exportStar(require("./_models/ui-check-report.interface"), exports);
+//# sourceMappingURL=index.js.map