@futdevpro/dynamo-e2e 1.18.38 → 1.18.39

package/CHANGELOG.md

@@ -3,6 +3,28 @@
 Minden release a `dynamo-e2e-foundation` HYPERPLAN MP-N ütemezést követi.
 Verzióformátum: `MM.mm.p` (két-számjegyes major-minor, Dynamo-konvenció).
 
+## [01.18.39] — 2026-11-02 — `/visual-gate`: the visual regression gate, first slice (R1-72 d)
+
+- **Why** (owner, 2026-11-02 21:39: the credit service's login "badly out of shape", "a review tool is needed";
+  `IN-2026-11-02-R1-72` (d)): the key pages, HU + EN, 1440 + 390, red in the CI when a page falls apart, disappears
+  or changes. The products wire it in.
+- **`DyE2E_BlockingOverlays_Util`**: closes the two overlays of a TEST deployment through the app's own buttons
+  (the ngx-dynamo storage service writes a control record and may encrypt, so a hand-made `localStorage` value is
+  not reliably valid): the TEST warning by its panel class (`.dynx-test-ribbon-warning-dialog`; every "do not show
+  again" box ticked, so the ribbon is not in the screenshot either), the cookie bar by its test id (necessary
+  only). Language-neutral hooks. `prepareStorageState({ browser, baseUrl, locale })` returns the state to start
+  every case from, once per language; it fails loudly when an overlay is still visible after closing it.
+  Nothing to close (production) is not an error.
+- **`DyE2E_VisualGate_Util`**: `cases({ pages })` (page × language × viewport, ids `<page>-<lang>-<viewport>`,
+  duplicate names refused); `inspect(page)` — an overlay still covering the page, `page-empty` (fewer than 20
+  visible characters or 5 visible elements), `horizontal-overflow` (the widest element named); `assertPage(page,
+  case)` — those first, with their reason, then `toHaveScreenshot(<id>.png)` (full page, animations off, masks,
+  2 % tolerance).
+- **Measured live** on the credit TEST `/login` (the real ngx-dynamo dialog + cookie bar): 4 / 4 cases closed both
+  overlays (the ribbon hidden too), HU and EN by the locale, no finding. ⚠️ A layout like the credit login before
+  ngx-fdp-templates 20.20.292 (a form across the whole page) is caught only by the baseline comparison, not by
+  the cheap checks.
+- 7 specs (4 on a real Chromium, fixture pages), 4 mutants killed; 620 / 0.
 ## [01.18.38] — 2026-11-01 — `/ui-check`: `error-destination`, a press that lands on an error (BFR-FLEET-012 ②)
 
 - **`error-destination`** (`press-leads-to-error`; owner, 2026-10-26, `IN-2026-10-26-ORC-02`: "…ha valamire

package/README.md

@@ -84,6 +84,29 @@ const report = await DyE2E_UICheckRunner_Util.run(page, { url: page.url(), accou
 DyE2E_UICheckRunner_Util.assertClean(report); // throws with every finding's measurement
 ```
 
+- `@futdevpro/dynamo-e2e/visual-gate` — the visual regression gate: closes the TEST warning and the cookie bar through
+  the app (`DyE2E_BlockingOverlays_Util.prepareStorageState`, once per language), then checks each key page in
+  HU + EN at 1440 + 390 (`DyE2E_VisualGate_Util.cases`): red when an overlay still covers it, it shows (almost)
+  nothing, it is wider than the screen, or it differs from the committed baseline (`toHaveScreenshot`).
+
+```ts
+import { DyE2E_BlockingOverlays_Util, DyE2E_VisualGate_Util } from '@futdevpro/dynamo-e2e/visual-gate';
+
+for (const gateCase of DyE2E_VisualGate_Util.cases({ pages: [ { name: 'login', path: '/login' } ] })) {
+  test(`| visual: ${gateCase.id}`, async ({ browser }) => {
+    const { storageState } = await DyE2E_BlockingOverlays_Util.prepareStorageState({
+      browser, baseUrl: BASE_URL, locale: gateCase.language.locale,
+    });
+    const context = await browser.newContext({ storageState, locale: gateCase.language.locale,
+      viewport: { width: gateCase.viewport.width, height: gateCase.viewport.height } });
+    const page = await context.newPage();
+
+    await page.goto(BASE_URL + gateCase.page.path);
+    await DyE2E_VisualGate_Util.assertPage(page, gateCase); // layout first, then the screenshot comparison
+  });
+}
+```
+
 ## Playwright preset — CI timeouts and the failure budget
 
 ```ts

package/build/_modules/visual-gate/_collections/blocking-overlays.util.d.ts

@@ -0,0 +1,63 @@
+import { Browser, BrowserContext, Page } from '@playwright/test';
+/** What `DyE2E_BlockingOverlays_Util.acknowledge` closed. */
+export interface DyE2E_BlockingOverlaysResult_Interface {
+    /** The TEST-environment warning was there and is acknowledged (every "do not show again" box ticked). */
+    isTestWarningAcknowledged: boolean;
+    /** The cookie bar was there and is decided (necessary cookies only). */
+    isCookieConsentDecided: boolean;
+}
+/** The browser state after the overlays are closed: reuse it as `storageState` of every visual-gate context. */
+export type DyE2E_BlockingOverlaysState_Type = Awaited<ReturnType<BrowserContext['storageState']>>;
+/**
+ * Closes the two overlays that cover every page of a TEST deployment before an automated check (R1-72 d): the
+ * TEST-environment warning (`dynamo-test-ribbon` of ngx-dynamo) and the cookie bar (`dynamo-cookie-consent`).
+ *
+ * @description Through the app itself, by its buttons — not by writing `localStorage` by hand: the ngx-dynamo storage
+ * service writes its own control record (`dynamo-control`) and may encrypt, so a hand-made value is not reliably
+ * valid (measured in futdevpro's `test-warning.global-setup.ts`). The hooks do not depend on the language: the
+ * warning dialog's own panel class, the cookie bar's `data-testid` (a test id built from a button caption changed
+ * when the caption was localised and silently broke a harness; FAM, adventor 2026-09-21).
+ */
+export declare class DyE2E_BlockingOverlays_Util {
+    /** The TEST-warning dialog (its `panelClass`). */
+    static readonly testWarningSelector: string;
+    /** The cookie bar. */
+    static readonly cookieConsentSelector: string;
+    /** The cookie bar's "necessary only" button (the summary view and the details view both carry it). */
+    static readonly cookieRejectSelector: string;
+    /** How often the page is looked at while waiting for an overlay, ms. */
+    static readonly lookIntervalMs: number;
+    /**
+     * Closes the TEST warning and the cookie bar on this page, in the order they cover each other (the warning first).
+     *
+     * @description Waits up to `timeoutMs` for both: either may render late (the cookie bar waits for the language
+     * map). On production neither exists — that is not an error, the result says so.
+     */
+    static acknowledge(page: Page, timeoutMs?: number): Promise<DyE2E_BlockingOverlaysResult_Interface>;
+    /**
+     * The overlays that still cover the page (empty when the page is free).
+     *
+     * @returns the names: `test-warning`, `cookie-consent`
+     */
+    static findVisible(page: Page): Promise<string[]>;
+    /**
+     * Opens the app once in a fresh context, closes both overlays, and returns the browser state to start every
+     * visual-gate context from (`browser.newContext({ storageState })`).
+     *
+     * @description Call it once per language with that language's `locale`: an app that stores the language it
+     * picked would otherwise carry the first language into every case. Fails loudly when an overlay is still visible
+     * after closing it (a silent "nothing to close" hid a broken harness before; FAM, adventor 2026-09-21).
+     */
+    static prepareStorageState(set: {
+        browser: Browser;
+        baseUrl: string;
+        locale?: string;
+        timeoutMs?: number;
+    }): Promise<{
+        storageState: DyE2E_BlockingOverlaysState_Type;
+        result: DyE2E_BlockingOverlaysResult_Interface;
+    }>;
+    /** Ticks every "do not show again" box of the warning (the ribbon too, so it is not in the screenshot), confirms. */
+    private static acknowledgeTestWarning;
+}
+//# sourceMappingURL=blocking-overlays.util.d.ts.map

package/build/_modules/visual-gate/_collections/blocking-overlays.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocking-overlays.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_collections/blocking-overlays.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAW,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI1E,6DAA6D;AAC7D,MAAM,WAAW,sCAAsC;IACrD,yGAAyG;IACzG,yBAAyB,EAAE,OAAO,CAAC;IACnC,wEAAwE;IACxE,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,gHAAgH;AAChH,MAAM,MAAM,gCAAgC,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;AAEnG;;;;;;;;;GASG;AACH,qBAAa,2BAA2B;IAEtC,kDAAkD;IAClD,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAsC;IAEjF,sBAAsB;IACtB,MAAM,CAAC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAoC;IAEjF,sGAAsG;IACtG,MAAM,CAAC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAA2C;IAEvF,wEAAwE;IACxE,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAO;IAE7C;;;;;OAKG;WACU,WAAW,CACtB,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,MAAwD,GAClE,OAAO,CAAC,sCAAsC,CAAC;IAyBlD;;;;OAIG;WACU,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAavD;;;;;;;OAOG;WACU,mBAAmB,CAAC,GAAG,EAAE;QACpC,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,gCAAgC,CAAC;QAAC,MAAM,EAAE,sCAAsC,CAAA;KAAE,CAAC;IAsB/G,qHAAqH;mBAChG,sBAAsB;CAU5C"}

package/build/_modules/visual-gate/_collections/blocking-overlays.util.js

@@ -0,0 +1,104 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_BlockingOverlays_Util = void 0;
+const visual_gate_defaults_const_1 = require("./visual-gate-defaults.const");
+/**
+ * Closes the two overlays that cover every page of a TEST deployment before an automated check (R1-72 d): the
+ * TEST-environment warning (`dynamo-test-ribbon` of ngx-dynamo) and the cookie bar (`dynamo-cookie-consent`).
+ *
+ * @description Through the app itself, by its buttons — not by writing `localStorage` by hand: the ngx-dynamo storage
+ * service writes its own control record (`dynamo-control`) and may encrypt, so a hand-made value is not reliably
+ * valid (measured in futdevpro's `test-warning.global-setup.ts`). The hooks do not depend on the language: the
+ * warning dialog's own panel class, the cookie bar's `data-testid` (a test id built from a button caption changed
+ * when the caption was localised and silently broke a harness; FAM, adventor 2026-09-21).
+ */
+class DyE2E_BlockingOverlays_Util {
+    /** The TEST-warning dialog (its `panelClass`). */
+    static testWarningSelector = '.dynx-test-ribbon-warning-dialog';
+    /** The cookie bar. */
+    static cookieConsentSelector = '[data-testid="cookie-consent"]';
+    /** The cookie bar's "necessary only" button (the summary view and the details view both carry it). */
+    static cookieRejectSelector = '[data-testid="cookie-consent-reject"]';
+    /** How often the page is looked at while waiting for an overlay, ms. */
+    static lookIntervalMs = 250;
+    /**
+     * Closes the TEST warning and the cookie bar on this page, in the order they cover each other (the warning first).
+     *
+     * @description Waits up to `timeoutMs` for both: either may render late (the cookie bar waits for the language
+     * map). On production neither exists — that is not an error, the result says so.
+     */
+    static async acknowledge(page, timeoutMs = visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.overlayTimeoutMs) {
+        const result = {
+            isTestWarningAcknowledged: false, isCookieConsentDecided: false,
+        };
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline && !(result.isTestWarningAcknowledged && result.isCookieConsentDecided)) {
+            const warning = page.locator(this.testWarningSelector).first();
+            const reject = page.locator(`${this.cookieRejectSelector}:visible`).first();
+            if (!result.isTestWarningAcknowledged && await warning.isVisible()) {
+                await this.acknowledgeTestWarning(warning);
+                result.isTestWarningAcknowledged = true;
+            }
+            else if (!result.isCookieConsentDecided && await reject.isVisible()) {
+                await reject.click();
+                await page.locator(this.cookieConsentSelector).first().waitFor({ state: 'hidden', timeout: 5_000 });
+                result.isCookieConsentDecided = true;
+            }
+            else {
+                await page.waitForTimeout(this.lookIntervalMs);
+            }
+        }
+        return result;
+    }
+    /**
+     * The overlays that still cover the page (empty when the page is free).
+     *
+     * @returns the names: `test-warning`, `cookie-consent`
+     */
+    static async findVisible(page) {
+        const visible = [];
+        if (await page.locator(this.testWarningSelector).first().isVisible()) {
+            visible.push('test-warning');
+        }
+        if (await page.locator(this.cookieConsentSelector).first().isVisible()) {
+            visible.push('cookie-consent');
+        }
+        return visible;
+    }
+    /**
+     * Opens the app once in a fresh context, closes both overlays, and returns the browser state to start every
+     * visual-gate context from (`browser.newContext({ storageState })`).
+     *
+     * @description Call it once per language with that language's `locale`: an app that stores the language it
+     * picked would otherwise carry the first language into every case. Fails loudly when an overlay is still visible
+     * after closing it (a silent "nothing to close" hid a broken harness before; FAM, adventor 2026-09-21).
+     */
+    static async prepareStorageState(set) {
+        const context = await set.browser.newContext({ locale: set.locale, ignoreHTTPSErrors: true });
+        try {
+            const page = await context.newPage();
+            await page.goto(set.baseUrl, { waitUntil: 'domcontentloaded' });
+            const result = await this.acknowledge(page, set.timeoutMs);
+            const stillVisible = await this.findVisible(page);
+            if (stillVisible.length) {
+                throw new Error(`[dynamo-e2e visual-gate] still covering the page after closing: ${stillVisible.join(', ')} (${set.baseUrl})`);
+            }
+            return { storageState: await context.storageState(), result: result };
+        }
+        finally {
+            await context.close();
+        }
+    }
+    /** Ticks every "do not show again" box of the warning (the ribbon too, so it is not in the screenshot), confirms. */
+    static async acknowledgeTestWarning(warning) {
+        const boxes = warning.locator('input[type="checkbox"]');
+        const count = await boxes.count();
+        for (let i = 0; i < count; i++) {
+            await boxes.nth(i).check();
+        }
+        await warning.locator('button').last().click();
+        await warning.waitFor({ state: 'hidden', timeout: 5_000 });
+    }
+}
+exports.DyE2E_BlockingOverlays_Util = DyE2E_BlockingOverlays_Util;
+//# sourceMappingURL=blocking-overlays.util.js.map

package/build/_modules/visual-gate/_collections/blocking-overlays.util.js.map

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

package/build/_modules/visual-gate/_collections/visual-gate-defaults.const.d.ts

@@ -0,0 +1,13 @@
+import { DyE2E_VisualGateLanguage_Interface } from '../_models/visual-gate-language.interface';
+import { DyE2E_VisualGateViewport_Interface } from '../_models/visual-gate-viewport.interface';
+/** The defaults of the visual gate (R1-72 d: "HU + EN, 1440 + 390"). */
+export declare const DyE2E_VisualGateDefaults_Const: {
+    viewports: DyE2E_VisualGateViewport_Interface[];
+    languages: DyE2E_VisualGateLanguage_Interface[];
+    minVisibleTextLength: number;
+    minVisibleElementCount: number;
+    overflowTolerancePx: number;
+    maxDiffPixelRatio: number;
+    overlayTimeoutMs: number;
+};
+//# sourceMappingURL=visual-gate-defaults.const.d.ts.map

package/build/_modules/visual-gate/_collections/visual-gate-defaults.const.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-defaults.const.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_collections/visual-gate-defaults.const.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAC/F,OAAO,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAE/F,wEAAwE;AACxE,eAAO,MAAM,8BAA8B,EAAE;IAC3C,SAAS,EAAE,kCAAkC,EAAE,CAAC;IAChD,SAAS,EAAE,kCAAkC,EAAE,CAAC;IAChD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAuB1B,CAAC"}

package/build/_modules/visual-gate/_collections/visual-gate-defaults.const.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_VisualGateDefaults_Const = void 0;
+/** The defaults of the visual gate (R1-72 d: "HU + EN, 1440 + 390"). */
+exports.DyE2E_VisualGateDefaults_Const = {
+    viewports: [
+        { name: 'desktop', width: 1440, height: 900 },
+        { name: 'mobile', width: 390, height: 844 },
+    ],
+    languages: [
+        { code: 'hu', locale: 'hu-HU' },
+        { code: 'en', locale: 'en-US' },
+    ],
+    /** Fewer visible characters than this ⇒ the page disappeared (a heading and a button already give more). */
+    minVisibleTextLength: 20,
+    /** Fewer visible elements than this ⇒ the page disappeared. */
+    minVisibleElementCount: 5,
+    /** Sub-pixel rounding: a document at most this much wider than the viewport is not a sideways scroll. */
+    overflowTolerancePx: 1,
+    /** The share of differing pixels the screenshot comparison tolerates (antialiasing, a moved caret). */
+    maxDiffPixelRatio: 0.02,
+    /**
+     * How long the setup waits for the TEST warning and the cookie bar. Measured (FAM, futdevpro 2026-09-21): the bar
+     * renders behind the app's language map or a 4 s fail-open, so a slow runner needs well over 4 s.
+     */
+    overlayTimeoutMs: 15_000,
+};
+//# sourceMappingURL=visual-gate-defaults.const.js.map

package/build/_modules/visual-gate/_collections/visual-gate-defaults.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-defaults.const.js","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_collections/visual-gate-defaults.const.ts"],"names":[],"mappings":";;;AAGA,wEAAwE;AAC3D,QAAA,8BAA8B,GAQvC;IACF,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;QAC7C,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE;KAC5C;IACD,SAAS,EAAE;QACT,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAC/B,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;KAChC;IACD,4GAA4G;IAC5G,oBAAoB,EAAE,EAAE;IACxB,+DAA+D;IAC/D,sBAAsB,EAAE,CAAC;IACzB,yGAAyG;IACzG,mBAAmB,EAAE,CAAC;IACtB,uGAAuG;IACvG,iBAAiB,EAAE,IAAI;IACvB;;;OAGG;IACH,gBAAgB,EAAE,MAAM;CACzB,CAAC"}

package/build/_modules/visual-gate/_collections/visual-gate.util.d.ts

@@ -0,0 +1,76 @@
+import { Page } from '@playwright/test';
+import { DyE2E_VisualGateCase_Interface } from '../_models/visual-gate-case.interface';
+import { DyE2E_VisualGateFinding_Interface } from '../_models/visual-gate-finding.interface';
+import { DyE2E_VisualGateLanguage_Interface } from '../_models/visual-gate-language.interface';
+import { DyE2E_VisualGateLayout_Interface } from '../_models/visual-gate-layout.interface';
+import { DyE2E_VisualGatePage_Interface } from '../_models/visual-gate-page.interface';
+import { DyE2E_VisualGateViewport_Interface } from '../_models/visual-gate-viewport.interface';
+/**
+ * The visual regression gate (R1-72 d; owner, 2026-11-02 21:39: the credit login "badly out of shape", "a review tool
+ * is needed"): the key pages, HU + EN, 1440 + 390, red in the CI when a page falls apart or disappears.
+ *
+ * @description Two checks per page, the cheap and certain one first: (1) a layout check in the browser — the TEST
+ * warning or the cookie bar still covers the page, the page shows (almost) nothing, or it is wider than the screen;
+ * (2) a screenshot comparison against the product's committed baseline (Playwright `toHaveScreenshot`; the first run,
+ * or `--update-snapshots`, writes it).
+ *
+ * ```ts
+ * import { DyE2E_BlockingOverlays_Util, DyE2E_VisualGate_Util } from '@futdevpro/dynamo-e2e/visual-gate';
+ *
+ * for (const gateCase of DyE2E_VisualGate_Util.cases({ pages: [ { name: 'home', path: '/' } ] })) {
+ *   test(`| visual: ${gateCase.id}`, async ({ browser }) => {
+ *     const { storageState } = await DyE2E_BlockingOverlays_Util.prepareStorageState({
+ *       browser, baseUrl: BASE_URL, locale: gateCase.language.locale,
+ *     });
+ *     const context = await browser.newContext({ storageState, locale: gateCase.language.locale,
+ *       viewport: { width: gateCase.viewport.width, height: gateCase.viewport.height } });
+ *     const page = await context.newPage();
+ *
+ *     await page.goto(BASE_URL + gateCase.page.path);
+ *     await DyE2E_VisualGate_Util.assertPage(page, gateCase);
+ *   });
+ * }
+ * ```
+ */
+export declare class DyE2E_VisualGate_Util {
+    /** Browser-side layout measurement: a function expression, evaluated through `page.evaluate` (DOM APIs only). */
+    static readonly measureLayoutScript: string;
+    /**
+     * The check matrix: every page in every language at every screen size.
+     *
+     * @returns one case per page × language × viewport, ids `<page>-<language>-<viewport>`
+     */
+    static cases(set: {
+        pages: DyE2E_VisualGatePage_Interface[];
+        languages?: DyE2E_VisualGateLanguage_Interface[];
+        viewports?: DyE2E_VisualGateViewport_Interface[];
+    }): DyE2E_VisualGateCase_Interface[];
+    /** Measures what the page shows (after the fonts are loaded). */
+    static measureLayout(page: Page): Promise<DyE2E_VisualGateLayout_Interface>;
+    /**
+     * Judges a measured layout.
+     *
+     * @returns `page-empty` (it disappeared) and / or `horizontal-overflow` (it fell apart); empty when healthy
+     */
+    static checkLayout(layout: DyE2E_VisualGateLayout_Interface, limits?: {
+        minVisibleTextLength?: number;
+        minVisibleElementCount?: number;
+        overflowTolerancePx?: number;
+    }): DyE2E_VisualGateFinding_Interface[];
+    /** The cheap checks of one page: overlays still covering it + the layout. */
+    static inspect(page: Page, limits?: {
+        minVisibleTextLength?: number;
+        minVisibleElementCount?: number;
+        overflowTolerancePx?: number;
+    }): Promise<DyE2E_VisualGateFinding_Interface[]>;
+    /**
+     * The gate for one case, inside a Playwright test: the cheap checks first (a finding fails the test with its
+     * reason), then the screenshot comparison against the baseline `<case id>.png`.
+     */
+    static assertPage(page: Page, gateCase: DyE2E_VisualGateCase_Interface, options?: {
+        maxDiffPixelRatio?: number;
+        minVisibleTextLength?: number;
+        overflowTolerancePx?: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=visual-gate.util.d.ts.map

package/build/_modules/visual-gate/_collections/visual-gate.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_collections/visual-gate.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAC/F,OAAO,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAI/F;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,qBAAqB;IAEhC,iHAAiH;IACjH,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAoCxC;IAEH;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;QAChB,KAAK,EAAE,8BAA8B,EAAE,CAAC;QACxC,SAAS,CAAC,EAAE,kCAAkC,EAAE,CAAC;QACjD,SAAS,CAAC,EAAE,kCAAkC,EAAE,CAAC;KAClD,GAAG,8BAA8B,EAAE;IAoBpC,iEAAiE;WACpD,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,gCAAgC,CAAC;IAMjF;;;;OAIG;IACH,MAAM,CAAC,WAAW,CAChB,MAAM,EAAE,gCAAgC,EACxC,MAAM,GAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5G,iCAAiC,EAAE;IAwBtC,6EAA6E;WAChE,OAAO,CAClB,IAAI,EAAE,IAAI,EACV,MAAM,GAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5G,OAAO,CAAC,iCAAiC,EAAE,CAAC;IAS/C;;;OAGG;WACU,UAAU,CACrB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,8BAA8B,EACxC,OAAO,GAAE;QAAE,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;KAAO,GACxG,OAAO,CAAC,IAAI,CAAC;CAgBjB"}

package/build/_modules/visual-gate/_collections/visual-gate.util.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_VisualGate_Util = void 0;
+const test_1 = require("@playwright/test");
+const blocking_overlays_util_1 = require("./blocking-overlays.util");
+const visual_gate_defaults_const_1 = require("./visual-gate-defaults.const");
+/**
+ * The visual regression gate (R1-72 d; owner, 2026-11-02 21:39: the credit login "badly out of shape", "a review tool
+ * is needed"): the key pages, HU + EN, 1440 + 390, red in the CI when a page falls apart or disappears.
+ *
+ * @description Two checks per page, the cheap and certain one first: (1) a layout check in the browser — the TEST
+ * warning or the cookie bar still covers the page, the page shows (almost) nothing, or it is wider than the screen;
+ * (2) a screenshot comparison against the product's committed baseline (Playwright `toHaveScreenshot`; the first run,
+ * or `--update-snapshots`, writes it).
+ *
+ * ```ts
+ * import { DyE2E_BlockingOverlays_Util, DyE2E_VisualGate_Util } from '@futdevpro/dynamo-e2e/visual-gate';
+ *
+ * for (const gateCase of DyE2E_VisualGate_Util.cases({ pages: [ { name: 'home', path: '/' } ] })) {
+ *   test(`| visual: ${gateCase.id}`, async ({ browser }) => {
+ *     const { storageState } = await DyE2E_BlockingOverlays_Util.prepareStorageState({
+ *       browser, baseUrl: BASE_URL, locale: gateCase.language.locale,
+ *     });
+ *     const context = await browser.newContext({ storageState, locale: gateCase.language.locale,
+ *       viewport: { width: gateCase.viewport.width, height: gateCase.viewport.height } });
+ *     const page = await context.newPage();
+ *
+ *     await page.goto(BASE_URL + gateCase.page.path);
+ *     await DyE2E_VisualGate_Util.assertPage(page, gateCase);
+ *   });
+ * }
+ * ```
+ */
+class DyE2E_VisualGate_Util {
+    /** Browser-side layout measurement: a function expression, evaluated through `page.evaluate` (DOM APIs only). */
+    static measureLayoutScript = `() => {
+    const root = document.documentElement;
+    const viewportWidth = root.clientWidth;
+    let visibleTextLength = 0;
+    let visibleElementCount = 0;
+    let widestOverflow = null;
+    let widestRight = viewportWidth;
+    for (const el of Array.from(document.body ? document.body.querySelectorAll('*') : [])) {
+      const style = getComputedStyle(el);
+      if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity) === 0) {
+        continue;
+      }
+      const rect = el.getBoundingClientRect();
+      if (rect.width < 1 || rect.height < 1) {
+        continue;
+      }
+      visibleElementCount++;
+      for (const node of Array.from(el.childNodes)) {
+        if (node.nodeType === 3) {
+          visibleTextLength += node.textContent.trim().length;
+        }
+      }
+      const right = rect.right + window.scrollX;
+      if (right > widestRight + 1 && style.position !== 'fixed') {
+        widestRight = right;
+        const cls = typeof el.className === 'string' ? el.className.trim().split(/\\s+/).slice(0, 2).join('.') : '';
+        widestOverflow = el.tagName.toLowerCase() + (cls ? '.' + cls : '') + ' (' + Math.round(right) + ' px)';
+      }
+    }
+    return {
+      viewportWidth: viewportWidth,
+      scrollWidth: root.scrollWidth,
+      widestOverflow: widestOverflow,
+      visibleTextLength: visibleTextLength,
+      visibleElementCount: visibleElementCount,
+    };
+  }`;
+    /**
+     * The check matrix: every page in every language at every screen size.
+     *
+     * @returns one case per page × language × viewport, ids `<page>-<language>-<viewport>`
+     */
+    static cases(set) {
+        const gateCases = [];
+        for (const page of set.pages) {
+            for (const language of set.languages ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.languages) {
+                for (const viewport of set.viewports ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.viewports) {
+                    const id = `${page.name}-${language.code}-${viewport.name}`;
+                    gateCases.push({ id: id, page: page, language: language, viewport: viewport, snapshotName: `${id}.png` });
+                }
+            }
+        }
+        if (new Set(gateCases.map((gateCase) => gateCase.id)).size
+            !== gateCases.length) {
+            throw new Error('[dynamo-e2e visual-gate] two pages, languages or viewports share a name');
+        }
+        return gateCases;
+    }
+    /** Measures what the page shows (after the fonts are loaded). */
+    static async measureLayout(page) {
+        await page.evaluate('document.fonts ? document.fonts.ready.then(() => true) : true');
+        return page.evaluate(`(${this.measureLayoutScript})()`);
+    }
+    /**
+     * Judges a measured layout.
+     *
+     * @returns `page-empty` (it disappeared) and / or `horizontal-overflow` (it fell apart); empty when healthy
+     */
+    static checkLayout(layout, limits = {}) {
+        const findings = [];
+        const minText = limits.minVisibleTextLength ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.minVisibleTextLength;
+        const minElements = limits.minVisibleElementCount ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.minVisibleElementCount;
+        const tolerance = limits.overflowTolerancePx ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.overflowTolerancePx;
+        if (layout.visibleTextLength < minText || layout.visibleElementCount < minElements) {
+            findings.push({
+                kind: 'page-empty',
+                message: `the page shows almost nothing: ${layout.visibleTextLength} characters, `
+                    + `${layout.visibleElementCount} elements (at least ${minText} / ${minElements})`,
+            });
+        }
+        if (layout.scrollWidth > layout.viewportWidth + tolerance) {
+            findings.push({
+                kind: 'horizontal-overflow',
+                message: `the page is ${layout.scrollWidth} px wide on a ${layout.viewportWidth} px screen`
+                    + (layout.widestOverflow ? `; widest: ${layout.widestOverflow}` : ''),
+            });
+        }
+        return findings;
+    }
+    /** The cheap checks of one page: overlays still covering it + the layout. */
+    static async inspect(page, limits = {}) {
+        const findings = (await blocking_overlays_util_1.DyE2E_BlockingOverlays_Util.findVisible(page))
+            .map((name) => ({
+            kind: 'blocking-overlay', message: `${name} covers the page (close it first: DyE2E_BlockingOverlays_Util)`,
+        }));
+        return findings.concat(this.checkLayout(await this.measureLayout(page), limits));
+    }
+    /**
+     * The gate for one case, inside a Playwright test: the cheap checks first (a finding fails the test with its
+     * reason), then the screenshot comparison against the baseline `<case id>.png`.
+     */
+    static async assertPage(page, gateCase, options = {}) {
+        const findings = await this.inspect(page, options);
+        if (findings.length) {
+            throw new Error(`[dynamo-e2e visual-gate] ${gateCase.id} (${page.url()}):\n`
+                + findings.map((finding) => `- ${finding.kind}: ${finding.message}`).join('\n'));
+        }
+        await (0, test_1.expect)(page).toHaveScreenshot(gateCase.snapshotName, {
+            fullPage: true,
+            animations: 'disabled',
+            caret: 'hide',
+            maxDiffPixelRatio: options.maxDiffPixelRatio ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.maxDiffPixelRatio,
+            mask: (gateCase.page.mask ?? []).map((selector) => page.locator(selector)),
+        });
+    }
+}
+exports.DyE2E_VisualGate_Util = DyE2E_VisualGate_Util;
+//# sourceMappingURL=visual-gate.util.js.map

package/build/_modules/visual-gate/_collections/visual-gate.util.js.map

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

package/build/_modules/visual-gate/_models/visual-gate-case.interface.d.ts

@@ -0,0 +1,14 @@
+import { DyE2E_VisualGateLanguage_Interface } from './visual-gate-language.interface';
+import { DyE2E_VisualGatePage_Interface } from './visual-gate-page.interface';
+import { DyE2E_VisualGateViewport_Interface } from './visual-gate-viewport.interface';
+/** One check of the visual gate: a page, in one language, at one screen size. */
+export interface DyE2E_VisualGateCase_Interface {
+    /** `<page>-<language>-<viewport>`, unique within the matrix. */
+    id: string;
+    page: DyE2E_VisualGatePage_Interface;
+    language: DyE2E_VisualGateLanguage_Interface;
+    viewport: DyE2E_VisualGateViewport_Interface;
+    /** The baseline file name of the screenshot comparison (`<id>.png`). */
+    snapshotName: string;
+}
+//# sourceMappingURL=visual-gate-case.interface.d.ts.map

package/build/_modules/visual-gate/_models/visual-gate-case.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-case.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_models/visual-gate-case.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAE,8BAA8B,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAEtF,iFAAiF;AACjF,MAAM,WAAW,8BAA8B;IAC7C,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,8BAA8B,CAAC;IACrC,QAAQ,EAAE,kCAAkC,CAAC;IAC7C,QAAQ,EAAE,kCAAkC,CAAC;IAC7C,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/build/_modules/visual-gate/_models/visual-gate-case.interface.js

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

package/build/_modules/visual-gate/_models/visual-gate-case.interface.js.map

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

package/build/_modules/visual-gate/_models/visual-gate-finding.interface.d.ts

@@ -0,0 +1,11 @@
+/** A reason the visual gate fails a page before (or instead of) the screenshot comparison. */
+export interface DyE2E_VisualGateFinding_Interface {
+    /**
+     * `blocking-overlay`: the TEST warning or the cookie bar covers the page (the screenshot would show them);
+     * `page-empty`: the page shows (almost) nothing — it disappeared; `horizontal-overflow`: the page is wider than the
+     * screen — it fell apart.
+     */
+    kind: 'blocking-overlay' | 'page-empty' | 'horizontal-overflow';
+    message: string;
+}
+//# sourceMappingURL=visual-gate-finding.interface.d.ts.map

package/build/_modules/visual-gate/_models/visual-gate-finding.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-finding.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_models/visual-gate-finding.interface.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,MAAM,WAAW,iCAAiC;IAChD;;;;OAIG;IACH,IAAI,EAAE,kBAAkB,GAAG,YAAY,GAAG,qBAAqB,CAAC;IAChE,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/build/_modules/visual-gate/_models/visual-gate-finding.interface.js

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

package/build/_modules/visual-gate/_models/visual-gate-finding.interface.js.map

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

package/build/_modules/visual-gate/_models/visual-gate-language.interface.d.ts

@@ -0,0 +1,8 @@
+/** A language of the visual gate: the page is opened in a browser of this locale. */
+export interface DyE2E_VisualGateLanguage_Interface {
+    /** Short code (`hu`, `en`) — part of the snapshot name. */
+    code: string;
+    /** The browser locale (`hu-HU`, `en-US`): the FDP language service follows it when nothing is stored. */
+    locale: string;
+}
+//# sourceMappingURL=visual-gate-language.interface.d.ts.map

package/build/_modules/visual-gate/_models/visual-gate-language.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-language.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_models/visual-gate-language.interface.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,WAAW,kCAAkC;IACjD,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,yGAAyG;IACzG,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/visual-gate/_models/visual-gate-language.interface.js

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

package/build/_modules/visual-gate/_models/visual-gate-language.interface.js.map

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

package/build/_modules/visual-gate/_models/visual-gate-layout.interface.d.ts

@@ -0,0 +1,14 @@
+/** What the page shows, measured in the browser (`DyE2E_VisualGate_Util.measureLayout`). */
+export interface DyE2E_VisualGateLayout_Interface {
+    /** The width of the viewport (the document element's client width), px. */
+    viewportWidth: number;
+    /** The width of the scrollable document, px: wider than the viewport ⇒ the page scrolls sideways. */
+    scrollWidth: number;
+    /** The widest element that sticks out of the viewport (tag + class), or `null`. */
+    widestOverflow: string | null;
+    /** The number of characters of the visible text. */
+    visibleTextLength: number;
+    /** The number of visible elements with a size. */
+    visibleElementCount: number;
+}
+//# sourceMappingURL=visual-gate-layout.interface.d.ts.map

package/build/_modules/visual-gate/_models/visual-gate-layout.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-layout.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_models/visual-gate-layout.interface.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,WAAW,gCAAgC;IAC/C,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,qGAAqG;IACrG,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oDAAoD;IACpD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;CAC7B"}

package/build/_modules/visual-gate/_models/visual-gate-layout.interface.js

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

package/build/_modules/visual-gate/_models/visual-gate-layout.interface.js.map

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

package/build/_modules/visual-gate/_models/visual-gate-page.interface.d.ts

@@ -0,0 +1,10 @@
+/** A key page of the product the visual gate checks (R1-72 d). */
+export interface DyE2E_VisualGatePage_Interface {
+    /** Short, file-name safe name (`home`, `login`) — part of the snapshot name. */
+    name: string;
+    /** The path from the base URL (`/`, `/login`). */
+    path: string;
+    /** Selectors of changing parts (a date, a version number) that the screenshot comparison masks. */
+    mask?: string[];
+}
+//# sourceMappingURL=visual-gate-page.interface.d.ts.map

package/build/_modules/visual-gate/_models/visual-gate-page.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-page.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_models/visual-gate-page.interface.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,8BAA8B;IAC7C,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/build/_modules/visual-gate/_models/visual-gate-page.interface.js

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

package/build/_modules/visual-gate/_models/visual-gate-page.interface.js.map

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

package/build/_modules/visual-gate/_models/visual-gate-viewport.interface.d.ts

@@ -0,0 +1,8 @@
+/** A screen size of the visual gate. */
+export interface DyE2E_VisualGateViewport_Interface {
+    /** Short name (`desktop`, `mobile`) — part of the snapshot name. */
+    name: string;
+    width: number;
+    height: number;
+}
+//# sourceMappingURL=visual-gate-viewport.interface.d.ts.map

package/build/_modules/visual-gate/_models/visual-gate-viewport.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-viewport.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_models/visual-gate-viewport.interface.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,WAAW,kCAAkC;IACjD,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/build/_modules/visual-gate/_models/visual-gate-viewport.interface.js

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

package/build/_modules/visual-gate/_models/visual-gate-viewport.interface.js.map

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

package/build/_modules/visual-gate/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@futdevpro/dynamo-e2e/visual-gate` — the visual regression gate (R1-72 d): close the TEST warning and the cookie
+ * bar, then check the key pages (HU + EN, 1440 + 390) — red when a page falls apart, disappears or changes.
+ * The `/vqa` layer collects evidence for a reviewer, `/ui-check` presses controls; this layer judges the look.
+ */
+export * from './_collections/blocking-overlays.util';
+export * from './_collections/visual-gate-defaults.const';
+export * from './_collections/visual-gate.util';
+export * from './_models/visual-gate-case.interface';
+export * from './_models/visual-gate-finding.interface';
+export * from './_models/visual-gate-language.interface';
+export * from './_models/visual-gate-layout.interface';
+export * from './_models/visual-gate-page.interface';
+export * from './_models/visual-gate-viewport.interface';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/visual-gate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/visual-gate/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,yCAAyC,CAAC;AACxD,cAAc,0CAA0C,CAAC;AACzD,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC"}

package/build/_modules/visual-gate/index.js

@@ -0,0 +1,31 @@
+"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/visual-gate` — the visual regression gate (R1-72 d): close the TEST warning and the cookie
+ * bar, then check the key pages (HU + EN, 1440 + 390) — red when a page falls apart, disappears or changes.
+ * The `/vqa` layer collects evidence for a reviewer, `/ui-check` presses controls; this layer judges the look.
+ */
+__exportStar(require("./_collections/blocking-overlays.util"), exports);
+__exportStar(require("./_collections/visual-gate-defaults.const"), exports);
+__exportStar(require("./_collections/visual-gate.util"), exports);
+__exportStar(require("./_models/visual-gate-case.interface"), exports);
+__exportStar(require("./_models/visual-gate-finding.interface"), exports);
+__exportStar(require("./_models/visual-gate-language.interface"), exports);
+__exportStar(require("./_models/visual-gate-layout.interface"), exports);
+__exportStar(require("./_models/visual-gate-page.interface"), exports);
+__exportStar(require("./_models/visual-gate-viewport.interface"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/visual-gate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/visual-gate/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,wEAAsD;AACtD,4EAA0D;AAC1D,kEAAgD;AAChD,uEAAqD;AACrD,0EAAwD;AACxD,2EAAyD;AACzD,yEAAuD;AACvD,uEAAqD;AACrD,2EAAyD"}

package/build/index.js

@@ -26,5 +26,5 @@ __exportStar(require("./_modules/game/index"), exports);
 __exportStar(require("./_modules/ui-check/index"), exports);
 __exportStar(require("./_modules/coverage/index"), exports);
 /** Package-version stamp — npm-publish-time runtime-érték. */
-exports.DYE2E_PACKAGE_VERSION = '01.18.38';
+exports.DYE2E_PACKAGE_VERSION = '01.18.39';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/dynamo-e2e",
-  "version": "01.18.38",
+  "version": "01.18.39",
   "description": "End-to-end testing engine for the Dynamo + FDP ecosystem — auto-generated form-coverage tests, viewport audit matrix, CWV diagnostics. Settings-POJO-first.",
   "DyBu_settings": {
     "packageType": "core-package",
@@ -102,6 +102,12 @@
       "types": "./build/_modules/ui-check/index.d.ts",
       "typings": "./build/_modules/ui-check/index.d.ts"
     },
+    "./visual-gate": {
+      "default": "./build/_modules/visual-gate/index.js",
+      "module": "./build/_modules/visual-gate/index.js",
+      "types": "./build/_modules/visual-gate/index.d.ts",
+      "typings": "./build/_modules/visual-gate/index.d.ts"
+    },
     "./game": {
       "default": "./build/_modules/game/index.js",
       "module": "./build/_modules/game/index.js",
@@ -132,6 +138,9 @@
       "ui-check": [
         "build/_modules/ui-check/index.d.ts"
       ],
+      "visual-gate": [
+        "build/_modules/visual-gate/index.d.ts"
+      ],
       "game": [
         "build/_modules/game/index.d.ts"
       ]