@applitools/core 4.68.0 → 4.68.1

package/CHANGELOG.md

@@ -1,5 +1,155 @@
 # Changelog
 
+## [4.68.1](https://github.com/Applitools-Dev/sdk/compare/js/core@4.68.0...js/core@4.68.1) (2026-08-10)
+
+
+### Bug Fixes
+
+* apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+* omit the empty os from the figma reference env so the design baseline persists | AD-15527 ([#4067](https://github.com/Applitools-Dev/sdk/issues/4067)) ([8395814](https://github.com/Applitools-Dev/sdk/commit/8395814feb6b20eee1c1322dc1539aa4642663d8))
+* use an authoritative CSS viewport in classic mode | FLD-4814 ([#4047](https://github.com/Applitools-Dev/sdk/issues/4047)) ([c46497e](https://github.com/Applitools-Dev/sdk/commit/c46497e573fd7fd2da4913452239beea082b148f))
+
+
+### Dependencies
+
+* @applitools/utils bumped to 1.15.2
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+* @applitools/logger bumped to 2.3.1
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/dom-shared bumped to 1.2.3
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+* @applitools/dom-snapshot bumped to 4.17.9
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/socket bumped to 1.3.16
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/req bumped to 1.11.3
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/image bumped to 1.3.1
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/snippets bumped to 2.9.6
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/dom-capture bumped to 11.8.5
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/driver bumped to 1.26.8
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+  * use an authoritative CSS viewport in classic mode | FLD-4814 ([#4047](https://github.com/Applitools-Dev/sdk/issues/4047)) ([c46497e](https://github.com/Applitools-Dev/sdk/commit/c46497e573fd7fd2da4913452239beea082b148f))
+
+
+
+* @applitools/spec-driver-webdriver bumped to 1.6.8
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/spec-driver-selenium bumped to 1.8.8
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/spec-driver-playwright bumped to 1.9.8
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/spec-driver-puppeteer bumped to 1.8.8
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/screenshoter bumped to 3.12.28
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/nml-client bumped to 1.11.40
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/tunnel-client bumped to 1.12.3
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/ufg-client bumped to 1.23.1
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/core-base bumped to 1.38.1
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/ec-client bumped to 1.12.42
+  #### Bug Fixes
+
+  * apply the figma UFG environments rewrite to the renders | AD-15528 ([#4072](https://github.com/Applitools-Dev/sdk/issues/4072)) ([bd6b143](https://github.com/Applitools-Dev/sdk/commit/bd6b143f855750ae93701f8e44da6129ff7ae84c))
+
+
+
+* @applitools/test-server bumped to 1.4.7
+
+
 ## [4.68.0](https://github.com/Applitools-Dev/sdk/compare/js/core@4.67.2...js/core@4.68.0) (2026-08-05)
 
 

package/dist/check-and-close.js

@@ -26,10 +26,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.makeCheckAndClose = void 0;
 const driver_1 = require("@applitools/driver");
 const utils = __importStar(require("@applitools/utils"));
-function makeCheckAndClose({ type: defaultType = 'classic', eyes, target: defaultTarget, spec, logger: mainLogger, }) {
+function makeCheckAndClose({ type: defaultType = 'classic', eyes, target: defaultTarget, environments: openEnvironments, spec, logger: mainLogger, }) {
     return async function checkAndClose({ type = defaultType, target = defaultTarget, settings = {}, config, logger = mainLogger, } = {}) {
         logger = logger.extend(mainLogger, { tags: [`check-and-close-${type}-${utils.general.shortid()}`] });
+        // Same environments precedence as in check.ts.
+        const explicitEnvironments = settings != null && 'environments' in settings;
         settings = { ...config === null || config === void 0 ? void 0 : config.screenshot, ...config === null || config === void 0 ? void 0 : config.check, ...config === null || config === void 0 ? void 0 : config.close, ...settings };
+        if (type === 'ufg' && (openEnvironments === null || openEnvironments === void 0 ? void 0 : openEnvironments.length) && !explicitEnvironments) {
+            ;
+            settings.environments = openEnvironments;
+        }
         const driver = (0, driver_1.isDriver)(target, spec)
             ? await (0, driver_1.makeDriver)({ spec, driver: target, reset: target === defaultTarget, logger })
             : null;

package/dist/check.js

@@ -32,13 +32,20 @@ const defaults_1 = require("./automation/utils/defaults");
 const utils = __importStar(require("@applitools/utils"));
 const lang = __importStar(require("./lang"));
 const chalk_1 = __importDefault(require("chalk"));
-function makeCheck({ type: defaultType = 'classic', eyes, target: defaultTarget, spec, logger: mainLogger, }) {
+function makeCheck({ type: defaultType = 'classic', eyes, target: defaultTarget, environments: openEnvironments, spec, logger: mainLogger, }) {
     let stepIndex = 0;
     return async function check({ type = defaultType, target = defaultTarget, settings, config, logger = mainLogger, } = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
         var _t, _u, _v, _w, _x;
         logger = logger.extend(mainLogger, { tags: [`check-${type}-${utils.general.shortid()}`] });
+        // Open-time environments (possibly rewritten by the figma seam) win over the config's per-check
+        // re-send; environments passed explicitly to this call win over both.
+        const explicitEnvironments = settings != null && 'environments' in settings;
         settings = { ...config === null || config === void 0 ? void 0 : config.screenshot, ...config === null || config === void 0 ? void 0 : config.check, ...settings };
+        if (type === 'ufg' && (openEnvironments === null || openEnvironments === void 0 ? void 0 : openEnvironments.length) && !explicitEnvironments) {
+            ;
+            settings.environments = openEnvironments;
+        }
         (_a = settings.fully) !== null && _a !== void 0 ? _a : (settings.fully = !settings.region && (!settings.frames || settings.frames.length === 0));
         (_b = settings.waitBeforeCapture) !== null && _b !== void 0 ? _b : (settings.waitBeforeCapture = defaults_1.DEFAULT_WAIT_BEFORE_CAPTURE);
         (_c = settings.hideScrollbars) !== null && _c !== void 0 ? _c : (settings.hideScrollbars = true);

package/dist/classic/utils/extract-default-environments.js

@@ -34,8 +34,23 @@ async function extractDefaultEnvironments({ driver, settings, }) {
     try {
         const driverEnvironment = await driver.getEnvironment();
         const viewport = await driver.getViewport();
-        // scale layout viewport by visualViewport.scale to get visible CSS viewport (avoids double-scaling spec drivers that already return CSS pixels)
-        environment.viewportSize = utils.geometry.scale(viewport.viewportSize, viewport.viewportScale);
+        // The reported viewport is part of the baseline key: it must stay identical to the historical
+        // derivation (`layout viewport × visualViewport.scale`) for every viewport already reported
+        // correctly (FLD-4359). The framework-reported CSS viewport may substitute only to correct
+        // sub-pixel rounding noise in that derivation (FLD-4814): integral on both axes, within < 1px
+        // per axis, and viewportScale <= 1 — the residue bound the backward-compatibility proof depends
+        // on. The value must come from getCssViewportSize(), never getViewportSize(), whose fallback is
+        // the unscaled layout viewport. Full derivation, proof and history: llm-docs/CLASSIC.md →
+        // Reported viewport.
+        const derivedViewportSize = utils.geometry.scale(viewport.viewportSize, viewport.viewportScale);
+        const cssViewportSize = await driver.getCssViewportSize();
+        const corroboratesDerivedSize = !!cssViewportSize &&
+            viewport.viewportScale <= 1 &&
+            Number.isInteger(cssViewportSize.width) &&
+            Number.isInteger(cssViewportSize.height) &&
+            Math.abs(cssViewportSize.width - derivedViewportSize.width) < 1 &&
+            Math.abs(cssViewportSize.height - derivedViewportSize.height) < 1;
+        environment.viewportSize = corroboratesDerivedSize ? cssViewportSize : derivedViewportSize;
         environment.environmentId = utils.general.guid();
         if (driverEnvironment.isEC)
             environment.ecSessionId = (_a = (await driver.getSessionId())) !== null && _a !== void 0 ? _a : undefined;

package/dist/figma/figma.js

@@ -105,7 +105,7 @@ async function setFigmaBaselineFlow(figmaUrls, originalConfig, deps, mode = 'aut
         batch: originalConfig.batch,
         appName: originalConfig.appName,
         testName: originalConfig.testName,
-        environment: { hostingApp: 'Figma', os: '', viewportSize: figmaViewport },
+        environment: { hostingApp: 'Figma', viewportSize: figmaViewport },
         properties: (0, utils_1.figmaMetadataToProperties)(realResults[0].metadata, mode),
         baselineEnvName: figmaEnvName,
         saveNewTests: true,

package/dist/open-eyes.js

@@ -184,8 +184,8 @@ function makeOpenEyes({ type: defaultType = 'classic', clients, batch, removeDup
             var _a, _b;
             return ({
                 getTypedEyes,
-                check: (0, check_1.makeCheck)({ type, eyes, target: driver, spec, logger }),
-                checkAndClose: (0, check_and_close_1.makeCheckAndClose)({ type, eyes, target: driver, spec, logger }),
+                check: (0, check_1.makeCheck)({ type, eyes, target: driver, environments: settings.environments, spec, logger }),
+                checkAndClose: (0, check_and_close_1.makeCheckAndClose)({ type, eyes, target: driver, environments: settings.environments, spec, logger }),
                 close: (0, close_1.makeClose)({ eyes, environments: (_a = config === null || config === void 0 ? void 0 : config.check) === null || _a === void 0 ? void 0 : _a.environments, logger }),
                 abort: (0, abort_1.makeAbort)({ eyes, environments: (_b = config === null || config === void 0 ? void 0 : config.check) === null || _b === void 0 ? void 0 : _b.environments, logger }),
                 getResults: (0, get_eyes_results_1.makeGetEyesResults)({ eyes, logger }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@applitools/core",
-  "version": "4.68.0",
+  "version": "4.68.1",
   "homepage": "https://applitools.com",
   "bugs": {
     "url": "https://github.com/applitools/eyes.sdk.javascript1/issues"
@@ -61,20 +61,20 @@
     "setup:standalone": "sh -c 'yarn chromedriver --port=4444 --verbose &'"
   },
   "dependencies": {
-    "@applitools/core-base": "1.38.0",
-    "@applitools/dom-capture": "11.8.4",
-    "@applitools/dom-snapshot": "4.17.8",
-    "@applitools/driver": "1.26.7",
-    "@applitools/ec-client": "1.12.41",
-    "@applitools/image": "1.3.0",
-    "@applitools/logger": "2.3.0",
-    "@applitools/nml-client": "1.11.39",
-    "@applitools/req": "1.11.2",
-    "@applitools/screenshoter": "3.12.27",
-    "@applitools/snippets": "2.9.5",
-    "@applitools/socket": "1.3.15",
-    "@applitools/ufg-client": "1.23.0",
-    "@applitools/utils": "1.15.1",
+    "@applitools/core-base": "1.38.1",
+    "@applitools/dom-capture": "11.8.5",
+    "@applitools/dom-snapshot": "4.17.9",
+    "@applitools/driver": "1.26.8",
+    "@applitools/ec-client": "1.12.42",
+    "@applitools/image": "1.3.1",
+    "@applitools/logger": "2.3.1",
+    "@applitools/nml-client": "1.11.40",
+    "@applitools/req": "1.11.3",
+    "@applitools/screenshoter": "3.12.28",
+    "@applitools/snippets": "2.9.6",
+    "@applitools/socket": "1.3.16",
+    "@applitools/ufg-client": "1.23.1",
+    "@applitools/utils": "1.15.2",
     "abort-controller": "3.0.0",
     "chalk": "4.1.2",
     "node-fetch": "2.6.7",
@@ -84,13 +84,13 @@
   },
   "devDependencies": {
     "@applitools/bongo": "^5.10.0",
-    "@applitools/spec-driver-playwright": "^1.9.7",
-    "@applitools/spec-driver-puppeteer": "^1.8.7",
-    "@applitools/spec-driver-selenium": "^1.8.7",
-    "@applitools/spec-driver-webdriver": "^1.6.7",
-    "@applitools/test-server": "^1.4.6",
+    "@applitools/spec-driver-playwright": "^1.9.8",
+    "@applitools/spec-driver-puppeteer": "^1.8.8",
+    "@applitools/spec-driver-selenium": "^1.8.8",
+    "@applitools/spec-driver-webdriver": "^1.6.8",
+    "@applitools/test-server": "^1.4.7",
     "@applitools/test-utils": "^1.5.17",
-    "@applitools/tunnel-client": "^1.12.2",
+    "@applitools/tunnel-client": "^1.12.3",
     "@swc-node/register": "^1.6.8",
     "@types/mocha": "^10.0.7",
     "@types/node": "^12.20.55",

package/types/check-and-close.d.ts

@@ -1,14 +1,15 @@
-import type { Target, DriverTarget, Eyes, Config, CheckSettings, CloseSettings } from './types';
+import type { Target, DriverTarget, Eyes, Config, CheckSettings, CloseSettings, Environment } from './types';
 import { type Logger } from '@applitools/logger';
 import { type SpecType, type SpecDriver } from '@applitools/driver';
 type Options<TSpec extends SpecType, TType extends 'classic' | 'ufg'> = {
     type?: TType;
     eyes: Eyes<TSpec, TType>;
     target?: DriverTarget<TSpec>;
+    environments?: Environment[];
     spec?: SpecDriver<TSpec>;
     logger: Logger;
 };
-export declare function makeCheckAndClose<TSpec extends SpecType, TDefaultType extends 'classic' | 'ufg'>({ type: defaultType, eyes, target: defaultTarget, spec, logger: mainLogger, }: Options<TSpec, TDefaultType>): <TType extends "classic" | "ufg" = TDefaultType>({ type, target, settings, config, logger, }?: {
+export declare function makeCheckAndClose<TSpec extends SpecType, TDefaultType extends 'classic' | 'ufg'>({ type: defaultType, eyes, target: defaultTarget, environments: openEnvironments, spec, logger: mainLogger, }: Options<TSpec, TDefaultType>): <TType extends "classic" | "ufg" = TDefaultType>({ type, target, settings, config, logger, }?: {
     type?: TType | undefined;
     target?: Target<TSpec, TType> | undefined;
     settings?: (CheckSettings<TSpec, TDefaultType> & CloseSettings<TDefaultType> & CheckSettings<TSpec, TType> & CloseSettings<TType>) | undefined;

package/types/check.d.ts

@@ -1,14 +1,15 @@
-import type { Target, DriverTarget, Eyes, Config, CheckSettings } from './types';
+import type { Target, DriverTarget, Eyes, Config, CheckSettings, Environment } from './types';
 import { type Logger } from '@applitools/logger';
 import { type SpecType, type SpecDriver } from '@applitools/driver';
 type Options<TSpec extends SpecType, TType extends 'classic' | 'ufg'> = {
     type?: TType;
     eyes: Eyes<TSpec, TType>;
     target?: DriverTarget<TSpec>;
+    environments?: Environment[];
     spec?: SpecDriver<TSpec>;
     logger: Logger;
 };
-export declare function makeCheck<TSpec extends SpecType, TDefaultType extends 'classic' | 'ufg'>({ type: defaultType, eyes, target: defaultTarget, spec, logger: mainLogger, }: Options<TSpec, TDefaultType>): <TType extends "classic" | "ufg" = TDefaultType>({ type, target, settings, config, logger, }?: {
+export declare function makeCheck<TSpec extends SpecType, TDefaultType extends 'classic' | 'ufg'>({ type: defaultType, eyes, target: defaultTarget, environments: openEnvironments, spec, logger: mainLogger, }: Options<TSpec, TDefaultType>): <TType extends "classic" | "ufg" = TDefaultType>({ type, target, settings, config, logger, }?: {
     type?: TType | undefined;
     target?: Target<TSpec, TType> | undefined;
     settings?: CheckSettings<TSpec, TType> | undefined;