Add Cucumber step definitions for Percy visual testing (#309)

* Add Cucumber step definitions for Percy visual testing

Add PercySteps class providing Gherkin step definitions for:
- Percy Snapshot (DOM): widths, min height, percy CSS, scope, layout mode,
  JavaScript, labels, test case, responsive capture
- Percy Screenshot (Automate): with options and regions
- Create Percy Region: ignore/consider/intelliignore by CSS, XPath,
  bounding box, with diff sensitivity and padding
- Data table support for arbitrary options

Cucumber dependency is provided scope - users bring their own version.
Includes unit tests for all step definitions.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Report Cucumber environment info in Percy build metadata

- Add setClientInfo/setEnvironmentInfo to Percy and Environment classes
- PercySteps sets client to "percy-cucumber-java-selenium/<version>"
  and environment to "cucumber-java/<version>; selenium-java"
- Add Percy.getSdkVersion() public static method

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add parity with Robot Framework: missing region and snapshot steps

- Add ignore/consider region with padding
- Add consider region with XPath (+ diff sensitivity)
- Add intelliignore region with XPath
- Add snapshot steps: Shadow DOM disabled, responsive capture, sync
- Add scopeOptions parsing in buildOptions helper

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add snapshot and screenshot tests for Cucumber PercySteps

The existing tests only covered lifecycle and region creation but never
invoked percy.snapshot() or percy.screenshot(). This adds tests for
every @when step method using a mocked Percy instance injected via
reflection, verifying that each Cucumber step correctly delegates to the
Percy SDK with the right name and options.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: neha-sanse

pom.xml

@@ -87,6 +87,19 @@
       <version>3.12.4</version>
       <scope>test</scope>
     </dependency>
+    <!-- Cucumber (optional - for BDD step definitions) -->
+    <dependency>
+      <groupId>io.cucumber</groupId>
+      <artifactId>cucumber-java</artifactId>
+      <version>7.15.0</version>
+      <scope>provided</scope>
+    </dependency>
+    <dependency>
+      <groupId>io.cucumber</groupId>
+      <artifactId>cucumber-junit-platform-engine</artifactId>
+      <version>7.15.0</version>
+      <scope>test</scope>
+    </dependency>
 
   </dependencies>
 

src/main/java/io/percy/selenium/Environment.java

@@ -13,15 +13,24 @@ class Environment {
   private final static String SDK_VERSION = "2.1.2";
   private final static String SDK_NAME = "percy-java-selenium";
 
+  private String clientInfoOverride;
+  private String environmentInfoOverride;
+
   Environment(WebDriver driver) {
     this.driver = driver;
   }
 
   public String getClientInfo() {
+    if (clientInfoOverride != null) {
+      return clientInfoOverride;
+    }
     return SDK_NAME + "/" + SDK_VERSION;
   }
 
   public String getEnvironmentInfo() {
+    if (environmentInfoOverride != null) {
+      return environmentInfoOverride;
+    }
     // If this is a wrapped driver, get the actual driver that this one wraps.
     WebDriver innerDriver = this.driver instanceof WrapsDriver ?
       ((WrapsDriver) this.driver).getWrappedDriver()
@@ -33,4 +42,16 @@ public String getEnvironmentInfo() {
     // We don't know this type of driver. Report its classname as environment info.
     return String.format("selenium-java; %s", driverName);
   }
+
+  void setClientInfo(String clientInfo) {
+    this.clientInfoOverride = clientInfo;
+  }
+
+  void setEnvironmentInfo(String environmentInfo) {
+    this.environmentInfoOverride = environmentInfo;
+  }
+
+  public static String getSdkVersion() {
+    return SDK_VERSION;
+  }
 }

src/main/java/io/percy/selenium/Percy.java

@@ -86,6 +86,27 @@ public Percy(WebDriver driver) {
         this.env = new Environment(driver);
     }
 
+    /**
+     * Override the client info reported to Percy.
+     * Used by framework wrappers (e.g., Cucumber) to identify themselves.
+     *
+     * @param clientInfo      Client identifier (e.g., "percy-cucumber-java-selenium/2.1.2")
+     * @param environmentInfo Environment details (e.g., "cucumber-java/7.15.0; selenium-java; ChromeDriver")
+     */
+    public void setClientInfo(String clientInfo, String environmentInfo) {
+        this.env.setClientInfo(clientInfo);
+        this.env.setEnvironmentInfo(environmentInfo);
+    }
+
+    /**
+     * Get the SDK version string.
+     *
+     * @return SDK version (e.g., "2.1.2")
+     */
+    public static String getSdkVersion() {
+        return Environment.getSdkVersion();
+    }
+
     /**
      * Creates a region configuration based on the provided parameters.
      *