@percy/sdk-utils 1.32.0-beta.9 → 1.32.1

package/dist/bundle.js

@@ -326,6 +326,38 @@
       }
     }
 
+    function isPlainObject(value) {
+      return !!value && typeof value === 'object' && !Array.isArray(value);
+    }
+
+    // Recursively merge `override` onto `base`. Plain (non-array) objects are merged
+    // key-by-key so overriding one nested key keeps the base's sibling keys; arrays,
+    // scalars, null and functions from `override` replace the base value wholesale.
+    function deepMerge(base, override) {
+      const result = {
+        ...base
+      };
+      for (const key of Object.keys(override)) {
+        const baseVal = base[key];
+        const overrideVal = override[key];
+        result[key] = isPlainObject(baseVal) && isPlainObject(overrideVal) ? deepMerge(baseVal, overrideVal) : overrideVal;
+      }
+      return result;
+    }
+
+    // Merges .percy.yml config snapshot options with per-snapshot options.
+    // Per-snapshot options take priority over config options.
+    //
+    // The merge is deep: nested objects (e.g. `discovery`) are merged recursively so
+    // a per-snapshot override of one nested key does not drop the config's sibling
+    // nested keys. At the leaves, per-snapshot values win; arrays are replaced, not
+    // concatenated.
+    function mergeSnapshotOptions(options = {}) {
+      var _percy$config;
+      const configOptions = (info === null || info === void 0 || (_percy$config = info.config) === null || _percy$config === void 0 ? void 0 : _percy$config.snapshot) || {};
+      return deepMerge(configOptions, options);
+    }
+
     // Returns the readiness config for a snapshot.
     // Shallow-merge of global .percy.yml config with per-snapshot overrides:
     // per-snapshot keys win, unspecified keys are inherited from the global config.
@@ -481,6 +513,7 @@
       captureAutomateScreenshot: captureAutomateScreenshot,
       postBuildEvents: postBuildEvents,
       getResponsiveWidths: getResponsiveWidths,
+      mergeSnapshotOptions: mergeSnapshotOptions,
       DEFAULT_MAX_IFRAME_DEPTH: DEFAULT_MAX_IFRAME_DEPTH,
       HARD_MAX_IFRAME_DEPTH: HARD_MAX_IFRAME_DEPTH,
       clampIframeDepth: clampIframeDepth,
@@ -503,6 +536,7 @@
     exports.isPercyEnabled = isPercyEnabled;
     exports.isReadinessDisabled = isReadinessDisabled;
     exports.logger = logger;
+    exports.mergeSnapshotOptions = mergeSnapshotOptions;
     exports.percy = info;
     exports.postBuildEvents = postBuildEvents;
     exports.postComparison = postComparison;

package/dist/index.js

@@ -54,6 +54,12 @@ Object.defineProperty(exports, "logger", {
     return _logger.default;
   }
 });
+Object.defineProperty(exports, "mergeSnapshotOptions", {
+  enumerable: true,
+  get: function () {
+    return _mergeSnapshotOptions.default;
+  }
+});
 Object.defineProperty(exports, "percy", {
   enumerable: true,
   get: function () {
@@ -114,6 +120,7 @@ var _postBuildEvent = _interopRequireDefault(require("./post-build-event.js"));
 var _flushSnapshots = _interopRequireDefault(require("./flush-snapshots.js"));
 var _postScreenshot = _interopRequireDefault(require("./post-screenshot.js"));
 var _getResponsiveWidths = _interopRequireDefault(require("./get-responsive-widths.js"));
+var _mergeSnapshotOptions = _interopRequireDefault(require("./merge-snapshot-options.js"));
 var _serializeDom = require("./serialize-dom.js");
 var _default = _interopRequireWildcard(require("./index.js"));
 exports.default = _default;

package/dist/merge-snapshot-options.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+exports.mergeSnapshotOptions = mergeSnapshotOptions;
+var _percyInfo = _interopRequireDefault(require("./percy-info.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function isPlainObject(value) {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+// Recursively merge `override` onto `base`. Plain (non-array) objects are merged
+// key-by-key so overriding one nested key keeps the base's sibling keys; arrays,
+// scalars, null and functions from `override` replace the base value wholesale.
+function deepMerge(base, override) {
+  const result = {
+    ...base
+  };
+  for (const key of Object.keys(override)) {
+    const baseVal = base[key];
+    const overrideVal = override[key];
+    result[key] = isPlainObject(baseVal) && isPlainObject(overrideVal) ? deepMerge(baseVal, overrideVal) : overrideVal;
+  }
+  return result;
+}
+
+// Merges .percy.yml config snapshot options with per-snapshot options.
+// Per-snapshot options take priority over config options.
+//
+// The merge is deep: nested objects (e.g. `discovery`) are merged recursively so
+// a per-snapshot override of one nested key does not drop the config's sibling
+// nested keys. At the leaves, per-snapshot values win; arrays are replaced, not
+// concatenated.
+function mergeSnapshotOptions(options = {}) {
+  var _percy$config;
+  const configOptions = (_percyInfo.default === null || _percyInfo.default === void 0 || (_percy$config = _percyInfo.default.config) === null || _percy$config === void 0 ? void 0 : _percy$config.snapshot) || {};
+  return deepMerge(configOptions, options);
+}
+var _default = exports.default = mergeSnapshotOptions;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percy/sdk-utils",
-  "version": "1.32.0-beta.9",
+  "version": "1.32.1",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   },
   "publishConfig": {
     "access": "public",
-    "tag": "beta"
+    "tag": "latest"
   },
   "engines": {
     "node": ">=14"
@@ -54,5 +54,5 @@
   "dependencies": {
     "pac-proxy-agent": "^7.0.2"
   },
-  "gitHead": "cc176ec0fa5e36551db037a14186ea8b7cd07ff6"
+  "gitHead": "a6c8730bc89f5ba6a562b2afe317d534fb66d6eb"
 }