feat(browser): provide project reference in ToMatchScreenshotResolvePath (#10138)

Co-authored-by: Vladimir <sleuths.slews0s@icloud.com>

Author: macarie

docs/config/browser/expect.md

@@ -118,6 +118,10 @@ receives an object with the following properties:
   The value provided to [`attachmentsDir`](/config/attachmentsdir), if none is
   provided, its default value.
 
+- `project: TestProject` <Version type="experimental">4.1.6</Version> <Experimental />
+
+  The [`TestProject`](/api/advanced/test-project) the test belongs to.
+
 For example, to group screenshots by browser:
 
 ```ts

packages/browser/src/node/commands/screenshotMatcher/utils.ts

@@ -143,6 +143,7 @@ export function resolveOptions(
     testFileName: basename(context.testPath),
     testName: sanitize(testName, false),
     browserName: context.project.config.browser.name,
+    project: context.project,
   } satisfies Parameters<GlobalOptions['resolveDiffPath']>[0]
 
   return {

packages/vitest/src/node/types/browser.ts

@@ -478,6 +478,12 @@ type ToMatchScreenshotResolvePath = (data: {
    * if none is provided, its default value.
    */
   attachmentsDir: string
+  /**
+   * The {@linkcode https://vitest.dev/api/advanced/test-project|TestProject} the test belongs to.
+   *
+   * @experimental
+   */
+  project: TestProject
 }) => string
 
 export interface ToMatchScreenshotOptions {