@futdevpro/dynamo-e2e 1.18.38 → 1.18.40

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

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyE2E_VisualGateLook_Util = void 0;
+const visual_gate_defaults_const_1 = require("./visual-gate-defaults.const");
+/**
+ * The look checks of the visual gate (BFR-FUTDEVPRO-081, owner 2026-11-02 21:43: "we are going backwards while we
+ * prepare for the release"): four defects reached the futdevpro TEST that no functional test noticed — blue / green
+ * frames instead of the neutral grey, a page "not found", tiles fallen apart, an admin list in one line.
+ *
+ * @description Ported from futdevpro's own gate (`e2e/tests/ui-check/visual-regression-gate-feature.spec.ts`, 20 red
+ * on TEST 839, green on the fixed build), parameterised: the content area, the "not found" screen, the shared
+ * components skipped and the loud hue range are options with futdevpro's values as defaults. Every check is a
+ * browser-side script (DOM APIs only), so it measures the rendered page, not the source.
+ */
+class DyE2E_VisualGateLook_Util {
+    /**
+     * ① the content area: `{ isNotFound, isContentMissing, contentHeight }`. Argument: `{ contentSelector,
+     * notFoundSelector }`.
+     */
+    static contentScript = `(set) => {
+    const notFound = set.notFoundSelector ? document.querySelector(set.notFoundSelector) : null;
+    const content = document.querySelector(set.contentSelector);
+    return {
+      isNotFound: !!notFound && notFound.getBoundingClientRect().height > 0,
+      isContentMissing: !content,
+      contentHeight: content ? Math.round(content.getBoundingClientRect().height) : 0,
+    };
+  }`;
+    /**
+     * ③ the neutral look: the boxes of the content area with a saturated frame, background or gradient in the loud
+     * hue range. Argument: the resolved look options. Returns `<tag.class> frame|background|gradient <colour>` lines.
+     */
+    static loudColorsScript = `(set) => {
+    const root = document.querySelector(set.contentSelector);
+    const canvas = document.createElement('canvas');
+    canvas.width = 1;
+    canvas.height = 1;
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    // rgb() / rgba() directly; any other colour space (Tailwind 4 reports oklch) by its rendered sRGB pixel
+    const toRgba = (color) => {
+      const match = color.match(/^rgba?\\(([^)]+)\\)$/);
+      if (match) {
+        const parts = match[1].split(/[ ,/]+/).filter(Boolean).map(Number);
+        return [ parts[0], parts[1], parts[2], parts.length > 3 ? parts[3] : 1 ];
+      }
+      if (!ctx) { return null; }
+      ctx.clearRect(0, 0, 1, 1);
+      ctx.fillStyle = 'rgba(0, 0, 0, 0)';
+      ctx.fillStyle = color;
+      ctx.fillRect(0, 0, 1, 1);
+      const pixel = ctx.getImageData(0, 0, 1, 1).data;
+      return [ pixel[0], pixel[1], pixel[2], pixel[3] / 255 ];
+    };
+    const parse = (color) => {
+      const rgba = toRgba(color);
+      if (!rgba) { return null; }
+      const r = rgba[0] / 255;
+      const g = rgba[1] / 255;
+      const b = rgba[2] / 255;
+      const a = rgba[3];
+      const max = Math.max(r, g, b);
+      const min = Math.min(r, g, b);
+      const l = (max + min) / 2;
+      const d = max - min;
+      const s = d === 0 ? 0 : d / (1 - Math.abs(2 * l - 1));
+      let h = 0;
+      if (d !== 0) {
+        h = max === r ? 60 * (((g - b) / d) % 6) : max === g ? 60 * ((b - r) / d + 2) : 60 * ((r - g) / d + 4);
+      }
+      return { h: (h + 360) % 360, s: s, a: a };
+    };
+    const isLoud = (color) => {
+      const c = parse(color);
+      return !!c && c.a > set.loudMinAlpha && c.s > set.loudMinSaturation && c.h >= set.loudHueFrom
+        && c.h <= set.loudHueTo;
+    };
+    const found = [];
+    if (!root) { return found; }
+    for (const el of [ root ].concat(Array.from(root.querySelectorAll('*')))) {
+      if (el.closest(set.neutralSkipSelector)) { continue; }
+      const style = getComputedStyle(el);
+      const rect = el.getBoundingClientRect();
+      if (rect.width < 4 || rect.height < 4 || style.visibility === 'hidden' || style.display === 'none') {
+        continue;
+      }
+      const cls = typeof el.className === 'string' ? el.className.trim().split(/\\s+/).slice(0, 2).join('.') : '';
+      const name = el.tagName.toLowerCase() + (cls ? '.' + cls : '');
+      if (parseFloat(style.borderTopWidth) > 0 && style.borderTopStyle !== 'none' && isLoud(style.borderTopColor)) {
+        found.push(name + ' frame ' + style.borderTopColor);
+      }
+      if (isLoud(style.backgroundColor)) {
+        found.push(name + ' background ' + style.backgroundColor);
+      }
+      const isGradientAllowed = !!set.gradientAllowSelector && !!el.closest(set.gradientAllowSelector);
+      if (style.backgroundImage && style.backgroundImage !== 'none' && !isGradientAllowed) {
+        const colors = style.backgroundImage.match(/(?:rgba?|hsla?|oklch|oklab|lab|lch|color)\\([^)]+\\)/g) || [];
+        const loud = colors.find((color) => isLoud(color));
+        if (loud) {
+          found.push(name + ' gradient ' + loud);
+        }
+      }
+    }
+    return Array.from(new Set(found)).slice(0, set.maxFindings);
+  }`;
+    /**
+     * ⑤ ⑥ ⑦ on the whole page: a visible text off the screen, an icon showing its ligature word, a placeholder text.
+     * Argument: `{ placeholderPattern, maxFindings }`. Returns `{ kind, message }` findings.
+     */
+    static textProblemsScript = `(set) => {
+    const found = [];
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+    for (let node = walker.nextNode(); node; node = walker.nextNode()) {
+      const text = String(node.textContent).trim();
+      const parent = node.parentElement;
+      if (!text || !parent || parent.closest('mat-icon, [aria-hidden="true"], .cdk-visually-hidden')
+        || !parent.checkVisibility({ checkOpacity: true, checkVisibilityCSS: true })) {
+        continue;
+      }
+      const range = document.createRange();
+      range.selectNodeContents(node);
+      // a honeypot field stands far off the screen on purpose (-10000 px)
+      const out = Array.from(range.getClientRects()).find((rect) => rect.width > 0 && rect.left > -5000
+        && (rect.left < -1 || rect.right > window.innerWidth + 1));
+      if (out) {
+        found.push({ kind: 'text-off-screen', message: '"' + text.slice(0, 40) + '" <' + parent.tagName.toLowerCase()
+          + '> [' + Math.round(out.left) + ' … ' + Math.round(out.right) + ' px] on a ' + window.innerWidth
+          + ' px screen' });
+      }
+    }
+    for (const icon of Array.from(document.querySelectorAll('mat-icon'))) {
+      const word = String(icon.textContent).trim();
+      if (word.length < 3 || icon.querySelector('svg') || !icon.checkVisibility()) { continue; }
+      const range = document.createRange();
+      range.selectNodeContents(icon);
+      if (range.getBoundingClientRect().width > 2 * parseFloat(getComputedStyle(icon).fontSize)) {
+        found.push({ kind: 'raw-icon-word', message: 'the icon shows its word: "' + word + '"' });
+      }
+    }
+    if (set.placeholderPattern) {
+      const pattern = new RegExp('[^\\\\n]{0,30}' + set.placeholderPattern + '[^\\\\n]{0,30}', 'gi');
+      for (const line of document.body.innerText.match(pattern) || []) {
+        found.push({ kind: 'placeholder-text', message: 'visible placeholder: "' + line.trim() + '"' });
+      }
+    }
+    const seen = new Set();
+    return found.filter((finding) => !seen.has(finding.message) && seen.add(finding.message))
+      .slice(0, set.maxFindings);
+  }`;
+    /** ④ the font sizes of the headings and paragraphs of the content area. Argument: `{ contentSelector, tags }`. */
+    static fontSizesScript = `(set) => {
+    const root = document.querySelector(set.contentSelector);
+    const out = {};
+    for (const tag of set.tags) {
+      const sizes = Array.from(root ? root.querySelectorAll(tag) : [])
+        .filter((el) => el.getBoundingClientRect().height > 0)
+        .map((el) => getComputedStyle(el).fontSize);
+      out[tag] = Array.from(new Set(sizes)).sort();
+    }
+    return out;
+  }`;
+    /** The options with every default filled in. */
+    static resolve(options = {}) {
+        return {
+            contentSelector: options.contentSelector ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.contentSelector,
+            notFoundSelector: options.notFoundSelector ?? '',
+            minContentHeightPx: options.minContentHeightPx ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.minContentHeightPx,
+            neutralSkipSelector: options.neutralSkipSelector ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.neutralSkipSelector,
+            gradientAllowSelector: options.gradientAllowSelector ?? '',
+            loudHueFrom: options.loudHueFrom ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.loudHueFrom,
+            loudHueTo: options.loudHueTo ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.loudHueTo,
+            loudMinSaturation: options.loudMinSaturation ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.loudMinSaturation,
+            loudMinAlpha: options.loudMinAlpha ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.loudMinAlpha,
+            placeholderPattern: options.placeholderPattern === undefined
+                ? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.placeholderPattern : options.placeholderPattern,
+            isNeutralLookSkipped: options.isNeutralLookSkipped ?? false,
+            isTextCheckSkipped: options.isTextCheckSkipped ?? false,
+        };
+    }
+    /**
+     * The look checks of one page: ① the "not found" screen and the content area (when the product names them),
+     * ③ the neutral look, ⑤ ⑥ ⑦ the text.
+     *
+     * @returns the findings; empty when the page looks as it should
+     */
+    static async inspect(page, options = {}) {
+        const set = this.resolve(options);
+        const maxFindings = visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.maxFindingsPerCheck;
+        const findings = [];
+        const content = await page.evaluate(`(${this.contentScript})(${JSON.stringify(set)})`);
+        if (content.isNotFound) {
+            findings.push({ kind: 'not-found', message: `the "not found" screen is shown (${set.notFoundSelector})` });
+        }
+        if (options.contentSelector && content.isContentMissing) {
+            findings.push({ kind: 'content-empty', message: `the content area is missing (${set.contentSelector})` });
+        }
+        else if (options.contentSelector && content.contentHeight < set.minContentHeightPx) {
+            findings.push({
+                kind: 'content-empty',
+                message: `the content area is ${content.contentHeight} px high (at least ${set.minContentHeightPx})`,
+            });
+        }
+        if (!set.isNeutralLookSkipped) {
+            const loud = await page.evaluate(`(${this.loudColorsScript})(${JSON.stringify({ ...set, maxFindings: maxFindings })})`);
+            findings.push(...loud.map((line) => ({
+                kind: 'loud-color', message: `${line} instead of the neutral grey`,
+            })));
+        }
+        if (!set.isTextCheckSkipped) {
+            findings.push(...await page.evaluate(`(${this.textProblemsScript})(${JSON.stringify({ placeholderPattern: set.placeholderPattern, maxFindings: maxFindings })})`));
+        }
+        return findings;
+    }
+    /** ④ the font sizes of the headings and paragraphs in the content area (after the fonts are loaded). */
+    static async measureFontSizes(page, contentSelector) {
+        await page.evaluate('document.fonts ? document.fonts.ready.then(() => true) : true');
+        return page.evaluate(`(${this.fontSizesScript})(${JSON.stringify({
+            contentSelector: contentSelector ?? visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.contentSelector,
+            tags: visual_gate_defaults_const_1.DyE2E_VisualGateDefaults_Const.fontSizeTags,
+        })})`);
+    }
+    /**
+     * ④ judges the font sizes against the reference: a size the reference uses for a tag, missing here, is a finding
+     * ("the old font size dropped"). A size only here is not (a new heading may have its own).
+     */
+    static compareFontSizes(ours, reference) {
+        const findings = [];
+        for (const tag of Object.keys(reference)) {
+            const own = ours[tag] ?? [];
+            const missing = reference[tag].filter((size) => !own.includes(size));
+            if (missing.length) {
+                findings.push({
+                    kind: 'font-size-differs',
+                    message: `<${tag}> on the reference ${reference[tag].join(', ')}, here ${own.join(', ') || 'none'}`,
+                });
+            }
+        }
+        return findings;
+    }
+}
+exports.DyE2E_VisualGateLook_Util = DyE2E_VisualGateLook_Util;
+//# sourceMappingURL=visual-gate-look.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visual-gate-look.util.js","sourceRoot":"","sources":["../../../../src/_modules/visual-gate/_collections/visual-gate-look.util.ts"],"names":[],"mappings":";;;AAIA,6EAA8E;AAK9E;;;;;;;;;GASG;AACH,MAAa,yBAAyB;IAEpC;;;OAGG;IACH,MAAM,CAAU,aAAa,GAAW;;;;;;;;IAQtC,CAAC;IAEH;;;OAGG;IACH,MAAM,CAAU,gBAAgB,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuEzC,CAAC;IAEH;;;OAGG;IACH,MAAM,CAAU,kBAAkB,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAuC3C,CAAC;IAEH,kHAAkH;IAClH,MAAM,CAAU,eAAe,GAAW;;;;;;;;;;IAUxC,CAAC;IAEH,gDAAgD;IAChD,MAAM,CAAC,OAAO,CAAC,UAAiD,EAAE;QAChE,OAAO;YACL,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,2DAA8B,CAAC,eAAe;YAC1F,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE;YAChD,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,2DAA8B,CAAC,kBAAkB;YACnG,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,2DAA8B,CAAC,mBAAmB;YACtG,qBAAqB,EAAE,OAAO,CAAC,qBAAqB,IAAI,EAAE;YAC1D,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,2DAA8B,CAAC,WAAW;YAC9E,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,2DAA8B,CAAC,SAAS;YACxE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,2DAA8B,CAAC,iBAAiB;YAChG,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,2DAA8B,CAAC,YAAY;YACjF,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,KAAK,SAAS;gBAC1D,CAAC,CAAC,2DAA8B,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,CAAC,kBAAkB;YAClF,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,KAAK;YAC3D,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,KAAK;SACxD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAClB,IAAU,EACV,UAAiD,EAAE;QAEnD,MAAM,GAAG,GAAoD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnF,MAAM,WAAW,GAAW,2DAA8B,CAAC,mBAAmB,CAAC;QAC/E,MAAM,QAAQ,GAAwC,EAAE,CAAC;QACzD,MAAM,OAAO,GACX,MAAM,IAAI,CAAC,QAAQ,CACjB,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAClD,CAAC;QAEJ,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,oCAAoC,GAAG,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;QAC7G,CAAC;QACD,IAAI,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,gCAAgC,GAAG,CAAC,eAAe,GAAG,EAAE,CAAC,CAAC;QAC5G,CAAC;aAAM,IAAI,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,aAAa,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;YACrF,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,uBAAuB,OAAO,CAAC,aAAa,sBAAsB,GAAG,CAAC,kBAAkB,GAAG;aACrG,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,oBAAoB,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAa,MAAM,IAAI,CAAC,QAAQ,CACxC,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,GAAG,CACtF,CAAC;YAEF,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAY,EAAqC,EAAE,CAAC,CAAC;gBAC9E,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,8BAA8B;aACnE,CAAC,CAAC,CAAC,CAAC;QACP,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAsC,IAAI,IAAI,CAAC,kBAAkB,KACnG,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAClG,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,wGAAwG;IACxG,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAU,EAAE,eAAwB;QAChE,MAAM,IAAI,CAAC,QAAQ,CAAC,+DAA+D,CAAC,CAAC;QAErF,OAAO,IAAI,CAAC,QAAQ,CAAiC,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC,SAAS,CAAC;YAC/F,eAAe,EAAE,eAAe,IAAI,2DAA8B,CAAC,eAAe;YAClF,IAAI,EAAE,2DAA8B,CAAC,YAAY;SAClD,CAAC,GAAG,CAAC,CAAC;IACT,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CACrB,IAAoC,EACpC,SAAyC;QAEzC,MAAM,QAAQ,GAAwC,EAAE,CAAC;QAEzD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,MAAM,GAAG,GAAa,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACtC,MAAM,OAAO,GAAa,SAAS,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAY,EAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YAEhG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,mBAAmB;oBACzB,OAAO,EAAE,IAAI,GAAG,sBAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;iBACpG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;;AAzPH,8DA0PC"}

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

@@ -0,0 +1,84 @@
+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_VisualGateOptions_Interface } from '../_models/visual-gate-options.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 The cheap and certain checks 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) the look
+ * (BFR-FUTDEVPRO-081, `DyE2E_VisualGateLook_Util`) — the "not found" screen, an empty content area, green / cyan /
+ * blue instead of the neutral grey, a text off the screen, a raw icon word, a placeholder; (3) with a `referenceUrl`,
+ * the heading and paragraph sizes of production; then (4) a screenshot comparison against the product's committed
+ * baseline (Playwright `toHaveScreenshot`; the first run, or `--update-snapshots`, writes it; it can be skipped).
+ *
+ * ```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, {
+ *       contentSelector: 'main', referenceUrl: 'https://example.hu', testInfo: test.info(),
+ *     });
+ *   });
+ * }
+ * ```
+ */
+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 and the look. */
+    static inspect(page: Page, options?: DyE2E_VisualGateOptions_Interface): Promise<DyE2E_VisualGateFinding_Interface[]>;
+    /**
+     * ④ the same page on the reference deployment (production, read only), at the same screen size and in the same
+     * language: its heading and paragraph sizes must be here too.
+     *
+     * @returns the `font-size-differs` findings; with `testInfo`, the reference's full-page screenshot is attached
+     */
+    static compareWithReference(page: Page, gateCase: DyE2E_VisualGateCase_Interface, options: DyE2E_VisualGateOptions_Interface & {
+        referenceUrl: string;
+    }): Promise<DyE2E_VisualGateFinding_Interface[]>;
+    /**
+     * The gate for one case, inside a Playwright test: the cheap checks first, then (with a `referenceUrl`, on a page
+     * marked `isOnReference`) the font sizes of the reference — every finding fails the test with its reason —, then
+     * the screenshot comparison against the baseline `<case id>.png` (unless skipped). With `testInfo`, a full-page
+     * screenshot of the page goes into the report first, so a human sees it even when the case is red.
+     */
+    static assertPage(page: Page, gateCase: DyE2E_VisualGateCase_Interface, options?: DyE2E_VisualGateOptions_Interface): 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,EAA4C,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElF,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,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,8BAA8B,EAAE,MAAM,uCAAuC,CAAC;AACvF,OAAO,EAAE,kCAAkC,EAAE,MAAM,2CAA2C,CAAC;AAK/F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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,yFAAyF;WAC5E,OAAO,CAClB,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,iCAAiC,EAAE,CAAC;IAY/C;;;;;OAKG;WACU,oBAAoB,CAC/B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,8BAA8B,EACxC,OAAO,EAAE,iCAAiC,GAAG;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GACpE,OAAO,CAAC,iCAAiC,EAAE,CAAC;IAuC/C;;;;;OAKG;WACU,UAAU,CACrB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,8BAA8B,EACxC,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,IAAI,CAAC;CA6BjB"}

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

@@ -0,0 +1,209 @@
+"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");
+const visual_gate_look_util_1 = require("./visual-gate-look.util");
+/**
+ * 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 The cheap and certain checks 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) the look
+ * (BFR-FUTDEVPRO-081, `DyE2E_VisualGateLook_Util`) — the "not found" screen, an empty content area, green / cyan /
+ * blue instead of the neutral grey, a text off the screen, a raw icon word, a placeholder; (3) with a `referenceUrl`,
+ * the heading and paragraph sizes of production; then (4) a screenshot comparison against the product's committed
+ * baseline (Playwright `toHaveScreenshot`; the first run, or `--update-snapshots`, writes it; it can be skipped).
+ *
+ * ```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, {
+ *       contentSelector: 'main', referenceUrl: 'https://example.hu', testInfo: test.info(),
+ *     });
+ *   });
+ * }
+ * ```
+ */
+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 and the look. */
+    static async inspect(page, options = {}) {
+        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), options), await visual_gate_look_util_1.DyE2E_VisualGateLook_Util.inspect(page, options));
+    }
+    /**
+     * ④ the same page on the reference deployment (production, read only), at the same screen size and in the same
+     * language: its heading and paragraph sizes must be here too.
+     *
+     * @returns the `font-size-differs` findings; with `testInfo`, the reference's full-page screenshot is attached
+     */
+    static async compareWithReference(page, gateCase, options) {
+        const browser = page.context().browser();
+        if (!browser) {
+            throw new Error('[dynamo-e2e visual-gate] the reference needs a browser (not a persistent context)');
+        }
+        const context = await browser.newContext({
+            ignoreHTTPSErrors: true,
+            locale: gateCase.language.locale,
+            viewport: { width: gateCase.viewport.width, height: gateCase.viewport.height },
+            storageState: options.referenceStorageState,
+        });
+        try {
+            const reference = await context.newPage();
+            await reference.goto(options.referenceUrl.replace(/\/$/u, '') + gateCase.page.path, { waitUntil: 'domcontentloaded', timeout: 45_000 });
+            if (!options.referenceStorageState) {
+                await blocking_overlays_util_1.DyE2E_BlockingOverlays_Util.acknowledge(reference);
+            }
+            await reference.waitForLoadState('networkidle', { timeout: 20_000 }).catch(() => undefined);
+            const theirs = await visual_gate_look_util_1.DyE2E_VisualGateLook_Util.measureFontSizes(reference, options.contentSelector);
+            if (options.testInfo) {
+                await options.testInfo.attach(`reference-${gateCase.id}.png`, {
+                    body: await reference.screenshot({ fullPage: true }), contentType: 'image/png',
+                });
+            }
+            return visual_gate_look_util_1.DyE2E_VisualGateLook_Util.compareFontSizes(await visual_gate_look_util_1.DyE2E_VisualGateLook_Util.measureFontSizes(page, options.contentSelector), theirs);
+        }
+        finally {
+            await context.close();
+        }
+    }
+    /**
+     * The gate for one case, inside a Playwright test: the cheap checks first, then (with a `referenceUrl`, on a page
+     * marked `isOnReference`) the font sizes of the reference — every finding fails the test with its reason —, then
+     * the screenshot comparison against the baseline `<case id>.png` (unless skipped). With `testInfo`, a full-page
+     * screenshot of the page goes into the report first, so a human sees it even when the case is red.
+     */
+    static async assertPage(page, gateCase, options = {}) {
+        if (options.testInfo) {
+            await options.testInfo.attach(`test-${gateCase.id}.png`, {
+                body: await page.screenshot({ fullPage: true }), contentType: 'image/png',
+            });
+        }
+        const findings = await this.inspect(page, options);
+        if (options.referenceUrl && gateCase.page.isOnReference) {
+            findings.push(...await this.compareWithReference(page, gateCase, {
+                ...options, referenceUrl: options.referenceUrl,
+            }));
+        }
+        if (findings.length) {
+            throw new Error(`[dynamo-e2e visual-gate] ${gateCase.id} (${page.url()}):\n`
+                + findings.map((finding) => `- ${finding.kind}: ${finding.message}`).join('\n'));
+        }
+        if (options.isScreenshotComparisonSkipped) {
+            return;
+        }
+        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,16 @@
+/** 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; `not-found`: the product's "not found" screen is shown; `content-empty`: the content area
+     * is missing or (almost) empty; `loud-color`: a box of the content area has a saturated green / cyan / blue frame,
+     * background or gradient instead of the systems' neutral grey; `font-size-differs`: a heading or paragraph size of
+     * the reference (production) is gone; `text-off-screen`: a visible text sticks out of the screen; `raw-icon-word`:
+     * an icon shows its ligature word instead of the sign; `placeholder-text`: "coming soon", "lorem ipsum", `TODO` …
+     * is visible.
+     */
+    kind: 'blocking-overlay' | 'page-empty' | 'horizontal-overflow' | 'not-found' | 'content-empty' | 'loud-color' | 'font-size-differs' | 'text-off-screen' | 'raw-icon-word' | 'placeholder-text';
+    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;;;;;;;;;OASG;IACH,IAAI,EAAE,kBAAkB,GAAG,YAAY,GAAG,qBAAqB,GAAG,WAAW,GAAG,eAAe,GAAG,YAAY,GAC1G,mBAAmB,GAAG,iBAAiB,GAAG,eAAe,GAAG,kBAAkB,CAAC;IACnF,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