@futdevpro/dynamo-e2e 1.18.37 → 1.18.39

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.37';
+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.37",
+  "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"
       ]