vitest-plugin-vis 2.3.3 → 2.4.1

package/esm/client/image_snapshot_matcher.d.ts

@@ -1,9 +1,9 @@
+import type { BrowserCommands } from '@vitest/browser/context';
 import type { ImageSnapshotNextIndexCommand } from '../commands.ts';
 import type { PrepareImageSnapshotComparisonCommand } from '../server/commands/prepare_image_snapshot_comparison.ts';
-import type { WriteImageSnapshotCommand } from '../server/commands/write_image_snapshot.ts';
 import type { ToMatchImageSnapshotOptions } from '../shared/types.ts';
 import type { CurrentTest } from './vitest_suite_proxy.ts';
-export declare function imageSnapshotMatcher(commands: PrepareImageSnapshotComparisonCommand & WriteImageSnapshotCommand & ImageSnapshotNextIndexCommand): (test: CurrentTest & {}, subject: any, options?: ToMatchImageSnapshotOptions<any>) => Promise<void>;
+export declare function imageSnapshotMatcher(commands: BrowserCommands & PrepareImageSnapshotComparisonCommand & ImageSnapshotNextIndexCommand): (test: CurrentTest & {}, subject: any, options?: ToMatchImageSnapshotOptions<any>) => Promise<void>;
 /**
  * @deprecated internalized. Use `matchImageSnapshot` directly instead.
  */

package/esm/client/image_snapshot_matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image_snapshot_matcher.d.ts","sourceRoot":"","sources":["../../src/client/image_snapshot_matcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,yDAAyD,CAAA;AACpH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAA;AAG3F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAOrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,qCAAqC,GAAG,yBAAyB,GAAG,6BAA6B,UAGpG,WAAW,GAAG,EAAE,WACb,GAAG,YACF,2BAA2B,CAAC,GAAG,CAAC,mBAqE3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,GAAG,OAOrD"}
+{"version":3,"file":"image_snapshot_matcher.d.ts","sourceRoot":"","sources":["../../src/client/image_snapshot_matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAG9D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,yDAAyD,CAAA;AAGpH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAA;AAOrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,eAAe,GAAG,qCAAqC,GAAG,6BAA6B,UAG1F,WAAW,GAAG,EAAE,WACb,GAAG,YACF,2BAA2B,CAAC,GAAG,CAAC,mBAqE3C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,GAAG,OAOrD"}

package/esm/client/image_snapshot_matcher.js

@@ -37,10 +37,10 @@ export function imageSnapshotMatcher(commands) {
             return;
         }
         if (server.config.snapshotOptions.updateSnapshot === 'all' && !options?.expectToFail) {
-            await writeSnapshot(commands, info.baselinePath, resultImage);
+            await writeSnapshot(commands, resolve(info.projectRoot, info.baselinePath), resultImage);
             return;
         }
-        await writeSnapshot(commands, info.diffPath, diffImage);
+        await writeSnapshot(commands, resolve(info.projectRoot, info.diffPath), diffImage);
         throw new Error(dedent `Snapshot \`${taskId}\` mismatched
 
 					${options?.failureThreshold
@@ -70,7 +70,7 @@ export function parseImageSnapshotSubject(subject) {
 }
 async function writeSnapshot(commands, path, image) {
     const content = (await toDataURL(image)).split(',')[1];
-    return commands.writeImageSnapshot(path, content);
+    return commands.writeFile(path, content, { encoding: 'base64' });
 }
 async function parseImageSnapshotOptions(commands, taskId, isAutoSnapshot, options) {
     const index = await commands.imageSnapshotNextIndex(taskId);

package/esm/client/snapshot_options.js

@@ -13,7 +13,7 @@ export function setAutoSnapshotOptions(...args) {
 }
 function parseArgs(args) {
     return args.length === 1
-        ? [ctx.getCurrentTest() ?? ctx.getCurrentSuite().tasks?.[0]?.file, parseMeta(args[0])]
+        ? [ctx.getCurrentTest() ?? ctx.getCurrentSuite()?.tasks?.[0]?.file, parseMeta(args[0])]
         : [args[0], parseMeta(args[1])];
 }
 function parseMeta(meta) {

package/esm/commands.d.ts

@@ -1,7 +1,6 @@
 export * from './server/commands/has_image_snapshot.ts';
 export * from './server/commands/image_snapshot_next_index.ts';
 export * from './server/commands/match_image_snapshot.ts';
-export * from './server/commands/setup_vis_suite.ts';
 export * from './server/commands/prepare_image_snapshot_comparison.ts';
-export * from './server/commands/write_image_snapshot.ts';
+export * from './server/commands/setup_vis_suite.ts';
 //# sourceMappingURL=commands.d.ts.map

package/esm/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAA;AACvD,cAAc,gDAAgD,CAAA;AAC9D,cAAc,2CAA2C,CAAA;AACzD,cAAc,sCAAsC,CAAA;AACpD,cAAc,wDAAwD,CAAA;AACtE,cAAc,2CAA2C,CAAA"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAA;AACvD,cAAc,gDAAgD,CAAA;AAC9D,cAAc,2CAA2C,CAAA;AACzD,cAAc,wDAAwD,CAAA;AACtE,cAAc,sCAAsC,CAAA"}

package/esm/commands.js

@@ -1,6 +1,5 @@
 export * from "./server/commands/has_image_snapshot.js";
 export * from "./server/commands/image_snapshot_next_index.js";
 export * from "./server/commands/match_image_snapshot.js";
-export * from "./server/commands/setup_vis_suite.js";
 export * from "./server/commands/prepare_image_snapshot_comparison.js";
-export * from "./server/commands/write_image_snapshot.js";
+export * from "./server/commands/setup_vis_suite.js";

package/esm/config/types.d.ts

@@ -22,11 +22,11 @@ export type VisOptions<M extends ComparisonMethod = 'pixel'> = ImageSnapshotTime
      */
     snapshotRootDir?: string | ((context: {
         ci: boolean;
-        browserName: string;
+        browserName?: string | undefined;
         providerName: string;
         platform: string;
-        screenshotFailures: boolean | undefined;
-        screenshotDirectory: string | undefined;
+        screenshotFailures?: boolean | undefined;
+        screenshotDirectory?: string | undefined;
     }) => string) | undefined;
     /**
      * Customize the snapshot subpath.

package/esm/config/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAEhC,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,gBAAgB,GAAG,OAAO,IAAI,2BAA2B,GACzF,sBAAsB,GACtB,2BAA2B,CAAC,CAAC,CAAC,GAC9B,mBAAmB,GAAG;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC1D;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;;;OAIG;IACH,eAAe,CAAC,EACb,MAAM,GACN,CAAC,CAAC,OAAO,EAAE;QACX,EAAE,EAAE,OAAO,CAAA;QACX,WAAW,EAAE,MAAM,CAAA;QACnB,YAAY,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAA;QACvC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;KACtC,KAAK,MAAM,CAAC,GACb,SAAS,CAAA;IACZ;;;;;;;;;;;;;;;;;;;OAmBG;IACH,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;CACtD,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/config/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,sBAAsB,EACtB,2BAA2B,EAC3B,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAEhC,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,gBAAgB,GAAG,OAAO,IAAI,2BAA2B,GACzF,sBAAsB,GACtB,2BAA2B,CAAC,CAAC,CAAC,GAC9B,mBAAmB,GAAG;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC1D;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;;;OAIG;IACH,eAAe,CAAC,EACb,MAAM,GACN,CAAC,CAAC,OAAO,EAAE;QACX,EAAE,EAAE,OAAO,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAChC,YAAY,EAAE,MAAM,CAAA;QACpB,QAAQ,EAAE,MAAM,CAAA;QAChB,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;QACxC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KACvC,KAAK,MAAM,CAAC,GACb,SAAS,CAAA;IACZ;;;;;;;;;;;;;;;;;;;OAmBG;IACH,wBAAwB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAA;CACtD,CAAA"}

package/esm/config/vis.d.ts

@@ -18,7 +18,6 @@ export declare function vis<M extends ComparisonMethod = 'pixel'>(options?: VisO
                     hasImageSnapshot: import("vitest/node").BrowserCommand<[taskId: string, snapshotId: string | undefined, isAutoSnapshot: boolean]>;
                     matchImageSnapshot: import("vitest/node").BrowserCommand<[taskId: string, subject: string, isAutoSnapshot: boolean, options?: import("../commands.ts").MatchImageSnapshotOptions | undefined]>;
                     prepareImageSnapshotComparison: import("vitest/node").BrowserCommand<[taskId: string, snapshotId: string, isAutoSnapshot: boolean, options?: import("../commands.ts").MatchImageSnapshotOptions | undefined]>;
-                    writeImageSnapshot: import("vitest/node").BrowserCommand<[relativeFilePath: string, imageBase64: string]>;
                 };
             };
             setupFiles: string[];

package/esm/config/vis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vis.d.ts","sourceRoot":"","sources":["../../src/config/vis.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,gBAAgB,GAAG,OAAO,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAA6B;;;;;sBAWxE,MAAM;;;;;;;;;;;;;EAQzC"}
+{"version":3,"file":"vis.d.ts","sourceRoot":"","sources":["../../src/config/vis.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,gBAAgB,GAAG,OAAO,EAAE,OAAO,GAAE,UAAU,CAAC,CAAC,CAA6B;;;;;sBAWxE,MAAM;;;;;;;;;;;;EAQzC"}

package/esm/server/commands/browser_command_context.d.ts

@@ -4,7 +4,7 @@ export declare function getProjectName(context: {
         vite: {
             config: {
                 test?: {
-                    name: string;
+                    name?: string | undefined;
                 };
             };
         };

package/esm/server/commands/browser_command_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser_command_context.d.ts","sourceRoot":"","sources":["../../../src/server/commands/browser_command_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE;gBAAE,IAAI,CAAC,EAAE;oBAAE,IAAI,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,sBAErG;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,wCAE3E"}
+{"version":3,"file":"browser_command_context.d.ts","sourceRoot":"","sources":["../../../src/server/commands/browser_command_context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAExD,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE;gBAAE,IAAI,CAAC,EAAE;oBAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,sBAElH;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,qBAAqB,wCAE3E"}

package/esm/server/commands/extend.d.ts

@@ -3,9 +3,8 @@ import { type ImageSnapshotNextIndexCommand } from './image_snapshot_next_index.
 import { type MatchImageSnapshotCommand } from './match_image_snapshot.ts';
 import { type PrepareImageSnapshotComparisonCommand } from './prepare_image_snapshot_comparison.ts';
 import { type SetupVisSuiteCommand } from './setup_vis_suite.ts';
-import { type WriteImageSnapshotCommand } from './write_image_snapshot.ts';
 declare module '@vitest/browser/context' {
-    interface BrowserCommands extends SetupVisSuiteCommand, ImageSnapshotNextIndexCommand, HasImageSnapshotCommand, PrepareImageSnapshotComparisonCommand, WriteImageSnapshotCommand, MatchImageSnapshotCommand {
+    interface BrowserCommands extends SetupVisSuiteCommand, ImageSnapshotNextIndexCommand, HasImageSnapshotCommand, PrepareImageSnapshotComparisonCommand, MatchImageSnapshotCommand {
     }
 }
 export declare const commands: {
@@ -14,6 +13,5 @@ export declare const commands: {
     hasImageSnapshot: import("vitest/node").BrowserCommand<[taskId: string, snapshotId: string | undefined, isAutoSnapshot: boolean]>;
     matchImageSnapshot: import("vitest/node").BrowserCommand<[taskId: string, subject: string, isAutoSnapshot: boolean, options?: import("./match_image_snapshot.ts").MatchImageSnapshotOptions | undefined]>;
     prepareImageSnapshotComparison: import("vitest/node").BrowserCommand<[taskId: string, snapshotId: string, isAutoSnapshot: boolean, options?: import("./match_image_snapshot.ts").MatchImageSnapshotOptions | undefined]>;
-    writeImageSnapshot: import("vitest/node").BrowserCommand<[relativeFilePath: string, imageBase64: string]>;
 };
 //# sourceMappingURL=extend.d.ts.map

package/esm/server/commands/extend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../src/server/commands/extend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,yBAAyB,CAAA;AACxF,OAAO,EAAE,KAAK,6BAA6B,EAA0B,MAAM,gCAAgC,CAAA;AAC3G,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,2BAA2B,CAAA;AAC9F,OAAO,EACN,KAAK,qCAAqC,EAE1C,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,sBAAsB,CAAA;AAC/E,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,2BAA2B,CAAA;AAE9F,OAAO,QAAQ,yBAAyB,CAAC;IACxC,UAAU,eACT,SAAQ,oBAAoB,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,qCAAqC,EACrC,yBAAyB,EACzB,yBAAyB;KAAG;CAC9B;AAED,eAAO,MAAM,QAAQ;;;;;;;CAOpB,CAAA"}
+{"version":3,"file":"extend.d.ts","sourceRoot":"","sources":["../../../src/server/commands/extend.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,uBAAuB,EAAoB,MAAM,yBAAyB,CAAA;AACxF,OAAO,EAAE,KAAK,6BAA6B,EAA0B,MAAM,gCAAgC,CAAA;AAC3G,OAAO,EAAE,KAAK,yBAAyB,EAAsB,MAAM,2BAA2B,CAAA;AAC9F,OAAO,EACN,KAAK,qCAAqC,EAE1C,MAAM,wCAAwC,CAAA;AAC/C,OAAO,EAAE,KAAK,oBAAoB,EAAiB,MAAM,sBAAsB,CAAA;AAE/E,OAAO,QAAQ,yBAAyB,CAAC;IACxC,UAAU,eACT,SAAQ,oBAAoB,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,qCAAqC,EACrC,yBAAyB;KAAG;CAC9B;AAED,eAAO,MAAM,QAAQ;;;;;;CAMpB,CAAA"}

package/esm/server/commands/extend.js

@@ -3,12 +3,10 @@ import { imageSnapshotNextIndex } from "./image_snapshot_next_index.js";
 import { matchImageSnapshot } from "./match_image_snapshot.js";
 import { prepareImageSnapshotComparison, } from "./prepare_image_snapshot_comparison.js";
 import { setupVisSuite } from "./setup_vis_suite.js";
-import { writeImageSnapshot } from "./write_image_snapshot.js";
 export const commands = {
     setupVisSuite,
     imageSnapshotNextIndex,
     hasImageSnapshot,
     matchImageSnapshot,
     prepareImageSnapshotComparison,
-    writeImageSnapshot,
 };

package/esm/server/commands/image_snapshot_next_index.js

@@ -2,5 +2,5 @@ import { visContext } from "../vis_context.js";
 import { assertTestPathDefined } from "./_assertions.js";
 export const imageSnapshotNextIndex = async (context, taskId) => {
     assertTestPathDefined(context, 'imageSnapshotNextIndex');
-    return visContext.getTaskCount(context.testPath, taskId);
+    return visContext.getTaskCount(context, taskId);
 };

package/esm/server/commands/match_image_snapshot.js

@@ -15,7 +15,7 @@ export const matchImageSnapshot = async (context, taskId, subject, isAutoSnapsho
     if (!options)
         options = {};
     options.timeout = options.timeout ?? 30000;
-    const info = visContext.getSnapshotInfo(context, taskId, isAutoSnapshot, options);
+    const info = await visContext.getSnapshotInfo(context, taskId, isAutoSnapshot, options);
     const baselineBuffer = await file.tryReadFile(info.baselinePath);
     if (!baselineBuffer) {
         if (isBase64String(subject)) {

package/esm/server/commands/prepare_image_snapshot_comparison.d.ts

@@ -2,11 +2,29 @@ import type { BrowserCommand } from 'vitest/node';
 import type { FailureThresholdOptions, ImageSnapshotTimeoutOptions, PixelComparisonOptions, SsimComparisonOptions } from '../../shared/types.ts';
 import type { MatchImageSnapshotOptions } from './match_image_snapshot.ts';
 type ImageSnapshotComparisonInfo = {
+    /**
+     * Path to the project root.
+     */
     projectRoot: string;
+    /**
+     * Path to the baseline image relative to the project root.
+     */
     baselinePath: string;
+    /**
+     * Path to the result image relative to the project root.
+     */
     resultPath: string;
+    /**
+     * Path to the diff image relative to the project root.
+     */
     diffPath: string;
+    /**
+     * Base64 encoded baseline image.
+     */
     baseline: string;
+    /**
+     * Base64 encoded result image.
+     */
     result: string;
 } & ImageSnapshotTimeoutOptions & FailureThresholdOptions & (SsimComparisonOptions | PixelComparisonOptions);
 export interface PrepareImageSnapshotComparisonCommand {

package/esm/server/commands/prepare_image_snapshot_comparison.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prepare_image_snapshot_comparison.d.ts","sourceRoot":"","sources":["../../../src/server/commands/prepare_image_snapshot_comparison.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,KAAK,EACX,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,MAAM,uBAAuB,CAAA;AAK9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAE1E,KAAK,2BAA2B,GAAG;IAClC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACd,GAAG,2BAA2B,GAC9B,uBAAuB,GACvB,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,CAAA;AAEjD,MAAM,WAAW,qCAAqC;IACrD,8BAA8B,EAAE,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS,KAC3C,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAAA;CACrD;AAED,eAAO,MAAM,8BAA8B,EAAE,cAAc,CAC1D;IAAC,MAAM,EAAE,MAAM;IAAE,UAAU,EAAE,MAAM;IAAE,cAAc,EAAE,OAAO;IAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS;CAAC,CAyB9G,CAAA"}
+{"version":3,"file":"prepare_image_snapshot_comparison.d.ts","sourceRoot":"","sources":["../../../src/server/commands/prepare_image_snapshot_comparison.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,KAAK,EACX,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACtB,qBAAqB,EACrB,MAAM,uBAAuB,CAAA;AAK9B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAE1E,KAAK,2BAA2B,GAAG;IAClC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACd,GAAG,2BAA2B,GAC9B,uBAAuB,GACvB,CAAC,qBAAqB,GAAG,sBAAsB,CAAC,CAAA;AAEjD,MAAM,WAAW,qCAAqC;IACrD,8BAA8B,EAAE,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,OAAO,EACvB,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS,KAC3C,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC,CAAA;CACrD;AAED,eAAO,MAAM,8BAA8B,EAAE,cAAc,CAC1D;IAAC,MAAM,EAAE,MAAM;IAAE,UAAU,EAAE,MAAM;IAAE,cAAc,EAAE,OAAO;IAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,SAAS;CAAC,CA0B9G,CAAA"}

package/esm/server/commands/prepare_image_snapshot_comparison.js

@@ -1,3 +1,4 @@
+import { resolve } from 'pathe';
 import { isBase64String } from "../../shared/base64.js";
 import { file } from "../file.js";
 import { takeSnapshot, takeSnapshotByBrowser, writeSnapshot } from "../snapshot.js";
@@ -9,21 +10,22 @@ export const prepareImageSnapshotComparison = async (context, taskId, subject, i
     if (!options)
         options = {};
     options.timeout = options.timeout ?? 30000;
-    const info = visContext.getSnapshotInfo(context, taskId, isAutoSnapshot, options);
-    const baselineBuffer = await file.tryReadFile(info.baselinePath);
+    const projectRoot = context.project.config.root;
+    const info = await visContext.getSnapshotInfo(context, taskId, isAutoSnapshot, options);
+    const baselineBuffer = await file.tryReadFile(resolve(projectRoot, info.baselinePath));
     if (!baselineBuffer) {
         if (isBase64String(subject)) {
-            await writeSnapshot(info.baselinePath, subject);
+            await writeSnapshot(resolve(projectRoot, info.baselinePath), subject);
         }
         else {
-            await takeSnapshotByBrowser(context, info.baselinePath, subject, options);
+            await takeSnapshotByBrowser(context, resolve(projectRoot, info.baselinePath), subject, options);
         }
         return;
     }
-    const resultBuffer = await takeSnapshot(context, info.resultPath, subject, options);
+    const resultBuffer = await takeSnapshot(context, resolve(projectRoot, info.resultPath), subject, options);
     return {
         ...info,
-        projectRoot: context.project.config.root,
+        projectRoot,
         baseline: baselineBuffer.toString('base64'),
         result: resultBuffer.toString('base64'),
     };

package/esm/server/snapshot_path.js

@@ -12,8 +12,8 @@ export function resolveSnapshotRootDir(suite, options) {
         browserName: suite.provider.browserName,
         providerName: suite.provider.name,
         platform: process.platform,
-        screenshotFailures: suite.provider.options.screenshotFailures,
-        screenshotDirectory: suite.provider.options.screenshotDirectory,
+        screenshotFailures: suite.provider.options?.screenshotFailures,
+        screenshotDirectory: suite.provider.options?.screenshotDirectory,
     });
 }
 function getSnapshotRootDir(snapshotRootDir, platform = process.platform) {

package/esm/server/vis_context.d.ts

@@ -2,26 +2,24 @@ export declare const visContext: {
     setOptions<M extends "pixel" | "ssim">(projectName: string | undefined, options?: import("../config.ts").VisOptions<M>): void;
     __test__getOptions(projectName: string): import("../config.ts").VisOptions<any> | undefined;
     __test__reset(): void;
-    __test__getState(): import("./vis_context.types.ts").VisState;
-    setupSuite(context: import("./vis_context.types.ts").PartialBrowserCommandContext): Promise<import("type-plus").Pick._<import("./vis_context.types.ts").VisState, "subjectDataTestId">>;
+    __test__getState(context: import("./vis_context.types.ts").PartialBrowserCommandContext): Promise<import("./vis_context.types.ts").VisProjectState>;
+    setupSuite(context: import("./vis_context.types.ts").PartialBrowserCommandContext): Promise<import("type-plus").Pick._<import("./vis_context.types.ts").VisProjectState, "subjectDataTestId">>;
     getSnapshotInfo(browserContext: import("./vis_context.types.ts").PartialBrowserCommandContext, name: string, isAutoSnapshot: boolean, options?: {
         snapshotFileId?: string | undefined;
-    }): {
+    }): Promise<{
         baselinePath: string;
         resultPath: string;
         diffPath: string;
         timeout?: number | undefined | undefined;
-        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
-        failureThreshold?: number | undefined | undefined;
         comparisonMethod: any;
         diffOptions?: Partial<import("ssim.js").Options> | undefined;
+        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
+        failureThreshold?: number | undefined | undefined;
     } | {
         baselinePath: string;
         resultPath: string;
         diffPath: string;
         timeout?: number | undefined | undefined;
-        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
-        failureThreshold?: number | undefined | undefined;
         comparisonMethod?: any;
         diffOptions?: {
             threshold?: number | undefined;
@@ -32,8 +30,10 @@ export declare const visContext: {
             diffColorAlt?: [number, number, number] | undefined;
             diffMask?: boolean | undefined;
         } | undefined;
-    };
-    getTaskCount(testPath: string, taskId: string): number;
+        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
+        failureThreshold?: number | undefined | undefined;
+    }>;
+    getTaskCount(browserContext: import("./vis_context.types.ts").PartialBrowserCommandContext, taskId: string): Promise<number>;
     hasImageSnapshot(browserContext: import("./vis_context.types.ts").PartialBrowserCommandContext, taskId: string, snapshotFileId: string | undefined, isAutoSnapshot: boolean): Promise<boolean>;
     getSnapshotFilename(browserContext: import("./vis_context.types.ts").PartialBrowserCommandContext, info: {
         taskId: string;
@@ -41,7 +41,8 @@ export declare const visContext: {
             count: number;
         };
     }, snapshotFileId: string | undefined, isAutoSnapshot: boolean): string;
-    getSuiteInfo(testPath: string, taskId: string): {
+    getSuiteInfo(browserContext: import("./vis_context.types.ts").PartialBrowserCommandContext, taskId: string): Promise<{
+        projectRoot: string;
         suiteId: string;
         taskId: string;
         baselineDir: string;
@@ -50,6 +51,6 @@ export declare const visContext: {
         task: {
             count: number;
         };
-    };
+    }>;
 };
 //# sourceMappingURL=vis_context.d.ts.map

package/esm/server/vis_context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vis_context.d.ts","sourceRoot":"","sources":["../../src/server/vis_context.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;;;sBAC8wD,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAD1vD,CAAA"}
+{"version":3,"file":"vis_context.d.ts","sourceRoot":"","sources":["../../src/server/vis_context.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;;;sBACs3D,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CADl2D,CAAA"}

package/esm/server/vis_context.logic.d.ts

@@ -1,34 +1,32 @@
 import type { VisOptions } from '../config/types.ts';
-import type { PartialBrowserCommandContext, VisState } from './vis_context.types.ts';
+import type { PartialBrowserCommandContext, VisProjectState } from './vis_context.types.ts';
 export declare function createVisContext(): {
     setOptions<M extends "pixel" | "ssim">(projectName: string | undefined, options?: VisOptions<M>): void;
     __test__getOptions(projectName: string): VisOptions<any> | undefined;
     __test__reset(): void;
-    __test__getState(): VisState;
+    __test__getState(context: PartialBrowserCommandContext): Promise<VisProjectState>;
     /**
      * Setup suite is called on each test file's beforeAll hook.
      * Test files include vitest test files and storybook story files.
      * It needs to make sure there is no race condition between the test files.
      */
-    setupSuite(context: PartialBrowserCommandContext): Promise<import("type-plus").Pick._<VisState, "subjectDataTestId">>;
+    setupSuite(context: PartialBrowserCommandContext): Promise<import("type-plus").Pick._<VisProjectState, "subjectDataTestId">>;
     getSnapshotInfo(browserContext: PartialBrowserCommandContext, name: string, isAutoSnapshot: boolean, options?: {
         snapshotFileId?: string | undefined;
-    }): {
+    }): Promise<{
         baselinePath: string;
         resultPath: string;
         diffPath: string;
         timeout?: number | undefined | undefined;
-        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
-        failureThreshold?: number | undefined | undefined;
         comparisonMethod: any;
         diffOptions?: Partial<import("ssim.js").Options> | undefined;
+        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
+        failureThreshold?: number | undefined | undefined;
     } | {
         baselinePath: string;
         resultPath: string;
         diffPath: string;
         timeout?: number | undefined | undefined;
-        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
-        failureThreshold?: number | undefined | undefined;
         comparisonMethod?: any;
         diffOptions?: {
             threshold?: number | undefined;
@@ -39,8 +37,10 @@ export declare function createVisContext(): {
             diffColorAlt?: [number, number, number] | undefined;
             diffMask?: boolean | undefined;
         } | undefined;
-    };
-    getTaskCount(testPath: string, taskId: string): number;
+        failureThresholdType?: "pixel" | "percent" | undefined | undefined;
+        failureThreshold?: number | undefined | undefined;
+    }>;
+    getTaskCount(browserContext: PartialBrowserCommandContext, taskId: string): Promise<number>;
     hasImageSnapshot(browserContext: PartialBrowserCommandContext, taskId: string, snapshotFileId: string | undefined, isAutoSnapshot: boolean): Promise<boolean>;
     getSnapshotFilename(browserContext: PartialBrowserCommandContext, info: {
         taskId: string;
@@ -48,7 +48,8 @@ export declare function createVisContext(): {
             count: number;
         };
     }, snapshotFileId: string | undefined, isAutoSnapshot: boolean): string;
-    getSuiteInfo(testPath: string, taskId: string): {
+    getSuiteInfo(browserContext: PartialBrowserCommandContext, taskId: string): Promise<{
+        projectRoot: string;
         suiteId: string;
         taskId: string;
         baselineDir: string;
@@ -57,9 +58,9 @@ export declare function createVisContext(): {
         task: {
             count: number;
         };
-    };
+    }>;
 };
-export declare function createSuite(state: VisState, testPath: string, options: Pick<VisOptions, 'customizeSnapshotSubpath'>): {
+export declare function createSuite(state: VisProjectState, testPath: string, options: Pick<VisOptions, 'customizeSnapshotSubpath'>): {
     suiteId: string;
     suite: {
         baselineDir: string;
@@ -68,5 +69,5 @@ export declare function createSuite(state: VisState, testPath: string, options:
         tasks: {};
     };
 };
-export declare function getSuiteId(state: VisState, testPath: string, options: Pick<VisOptions, 'customizeSnapshotSubpath'>): string;
+export declare function getSuiteId(state: VisProjectState, testPath: string, options: Pick<VisOptions, 'customizeSnapshotSubpath'>): string;
 //# sourceMappingURL=vis_context.logic.d.ts.map

package/esm/server/vis_context.logic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vis_context.logic.d.ts","sourceRoot":"","sources":["../../src/server/vis_context.logic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAMpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEpF,wBAAgB,gBAAgB;eAMnB,CAAC,SAAS,OAAO,GAAG,MAAM,eAAe,MAAM,GAAG,SAAS,YAAW,UAAU,CAAC,CAAC,CAAC;oCAG9D,MAAM;;;IAStC;;;;OAIG;wBACuB,4BAA4B;oCAcrC,4BAA4B,QACtC,MAAM,kBACI,OAAO,YACb;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA+B3B,MAAM,UAAU,MAAM;qCAI5B,4BAA4B,UACpC,MAAM,kBACE,MAAM,GAAG,SAAS,kBAClB,OAAO;wCAQP,4BAA4B,QACtC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,kBACjC,MAAM,GAAG,SAAS,kBAClB,OAAO;2BAWD,MAAM,UAAU,MAAM;;;;;;;;;;EAe9C;AAyBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,0BAA0B,CAAC;;;;;;;;EAWnH;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,0BAA0B,CAAC,UAElH"}
+{"version":3,"file":"vis_context.logic.d.ts","sourceRoot":"","sources":["../../src/server/vis_context.logic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAMpD,OAAO,KAAK,EAAE,4BAA4B,EAAE,eAAe,EAAY,MAAM,wBAAwB,CAAA;AAErG,wBAAgB,gBAAgB;eAKnB,CAAC,SAAS,OAAO,GAAG,MAAM,eAAe,MAAM,GAAG,SAAS,YAAW,UAAU,CAAC,CAAC,CAAC;oCAG9D,MAAM;;8BAOZ,4BAA4B;IAGtD;;;;OAIG;wBACuB,4BAA4B;oCAgBrC,4BAA4B,QACtC,MAAM,kBACI,OAAO,YACb;QAAE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA+Bf,4BAA4B,UAAU,MAAM;qCAI9D,4BAA4B,UACpC,MAAM,kBACE,MAAM,GAAG,SAAS,kBAClB,OAAO;wCAaP,4BAA4B,QACtC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,kBACjC,MAAM,GAAG,SAAS,kBAClB,OAAO;iCAWW,4BAA4B,UAAU,MAAM;;;;;;;;;;;EAmBhF;AAyBD,wBAAgB,WAAW,CAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,0BAA0B,CAAC;;;;;;;;EAYrD;AAED,wBAAgB,UAAU,CACzB,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,0BAA0B,CAAC,UAGrD"}

package/esm/server/vis_context.logic.js

@@ -1,4 +1,4 @@
-import { join, relative } from 'pathe';
+import { join, relative, resolve } from 'pathe';
 import { pick } from 'type-plus';
 import { BASELINE_DIR, DIFF_DIR, RESULT_DIR } from "../shared/constants.js";
 import { getProjectName } from "./commands/browser_command_context.js";
@@ -7,8 +7,7 @@ import { getSnapshotSubpath, resolveSnapshotRootDir } from "./snapshot_path.js";
 import { ctx } from "./vis_context.ctx.js";
 export function createVisContext() {
     let visOptionsRecord = {};
-    let state;
-    let globalStateReady;
+    let state = {};
     const context = {
         setOptions(projectName, options = {}) {
             visOptionsRecord[projectName ?? '__default'] = options;
@@ -18,9 +17,10 @@ export function createVisContext() {
         },
         __test__reset() {
             visOptionsRecord = {};
+            state = {};
         },
-        __test__getState() {
-            return state;
+        __test__getState(context) {
+            return state[getProjectId(context)];
         },
         /**
          * Setup suite is called on each test file's beforeAll hook.
@@ -28,20 +28,18 @@ export function createVisContext() {
          * It needs to make sure there is no race condition between the test files.
          */
         async setupSuite(context) {
-            if (!globalStateReady) {
-                globalStateReady = setupState(context, getVisOptions(visOptionsRecord, context) ?? {});
-                state = await globalStateReady;
+            const projectId = getProjectId(context);
+            if (!state[projectId]) {
+                state[projectId] = setupState(context, getVisOptions(visOptionsRecord, context) ?? {});
             }
-            else {
-                await globalStateReady;
-            }
-            const { suiteId, suite } = createSuite(state, context.testPath, visOptionsRecord);
-            state.suites[suiteId] = suite;
+            const projectState = await state[projectId];
+            const { suiteId, suite } = createSuite(projectState, context.testPath, visOptionsRecord);
+            projectState.suites[suiteId] = suite;
             await Promise.allSettled([ctx.rimraf(suite.diffDir), ctx.rimraf(suite.resultDir)]);
-            return pick(state, 'subjectDataTestId');
+            return pick(projectState, 'subjectDataTestId');
         },
-        getSnapshotInfo(browserContext, name, isAutoSnapshot, options) {
-            const suiteInfo = context.getSuiteInfo(browserContext.testPath, name);
+        async getSnapshotInfo(browserContext, name, isAutoSnapshot, options) {
+            const suiteInfo = await context.getSuiteInfo(browserContext, name);
             const snapshotFilename = context.getSnapshotFilename(browserContext, suiteInfo, options?.snapshotFileId, isAutoSnapshot);
             const { baselineDir, resultDir, diffDir, task } = suiteInfo;
             task.count = task.count + 1;
@@ -55,12 +53,12 @@ export function createVisContext() {
                 diffPath,
             };
         },
-        getTaskCount(testPath, taskId) {
-            return context.getSuiteInfo(testPath, taskId).task.count;
+        async getTaskCount(browserContext, taskId) {
+            return (await context.getSuiteInfo(browserContext, taskId)).task.count;
         },
-        hasImageSnapshot(browserContext, taskId, snapshotFileId, isAutoSnapshot) {
-            const info = context.getSuiteInfo(browserContext.testPath, taskId);
-            return file.existFile(join(info.baselineDir, context.getSnapshotFilename(browserContext, info, snapshotFileId, isAutoSnapshot)));
+        async hasImageSnapshot(browserContext, taskId, snapshotFileId, isAutoSnapshot) {
+            const info = await context.getSuiteInfo(browserContext, taskId);
+            return file.existFile(resolve(info.projectRoot, info.baselineDir, context.getSnapshotFilename(browserContext, info, snapshotFileId, isAutoSnapshot)));
         },
         getSnapshotFilename(browserContext, info, snapshotFileId, isAutoSnapshot) {
             if (snapshotFileId)
@@ -72,11 +70,14 @@ export function createVisContext() {
                 isAutoSnapshot,
             })}.png`;
         },
-        getSuiteInfo(testPath, taskId) {
-            const suiteId = getSuiteId(state, testPath, visOptionsRecord);
-            const suite = state.suites[suiteId];
+        async getSuiteInfo(browserContext, taskId) {
+            const projectId = getProjectId(browserContext);
+            const projectState = await state[projectId];
+            const suiteId = getSuiteId(projectState, browserContext.testPath, visOptionsRecord);
+            const suite = projectState.suites[suiteId];
             const task = (suite.tasks[taskId] = suite.tasks[taskId] ?? { count: 1 });
             return {
+                projectRoot: projectState.projectRoot,
                 suiteId,
                 taskId,
                 baselineDir: suite.baselineDir,
@@ -88,18 +89,18 @@ export function createVisContext() {
     };
     return context;
 }
-async function setupState(suite, visOptions) {
-    const snapshotRootDir = resolveSnapshotRootDir(suite, visOptions);
-    const projectPath = suite.project.config.root;
+async function setupState(browserContext, visOptions) {
+    const snapshotRootDir = resolveSnapshotRootDir(browserContext, visOptions);
+    const projectRoot = getProjectRoot(browserContext);
     const state = {
-        projectPath,
-        testTimeout: suite.project.config.testTimeout,
-        hookTimeout: suite.project.config.hookTimeout,
+        projectRoot,
+        testTimeout: browserContext.project.config.testTimeout,
+        hookTimeout: browserContext.project.config.hookTimeout,
         snapshotRootDir,
         snapshotBaselineDir: join(snapshotRootDir, BASELINE_DIR),
         snapshotResultDir: join(snapshotRootDir, RESULT_DIR),
         snapshotDiffDir: join(snapshotRootDir, DIFF_DIR),
-        snapshotRootPath: join(projectPath, snapshotRootDir),
+        snapshotRootPath: join(projectRoot, snapshotRootDir),
         subjectDataTestId: visOptions.subjectDataTestId,
         suites: {},
     };
@@ -119,8 +120,14 @@ export function createSuite(state, testPath, options) {
     };
 }
 export function getSuiteId(state, testPath, options) {
-    return getSnapshotSubpath(relative(state.projectPath, testPath), options);
+    return getSnapshotSubpath(relative(state.projectRoot, testPath), options);
 }
 function getVisOptions(visOptionsRecord, context) {
     return visOptionsRecord[getProjectName(context) ?? '__default'];
 }
+function getProjectRoot(context) {
+    return context.project.config.root;
+}
+function getProjectId(context) {
+    return `${context.project.config.root}/${context.project.config.name}`;
+}

package/esm/server/vis_context.types.d.ts

@@ -1,5 +1,8 @@
 export type VisState = {
-    projectPath: string;
+    [projectPath: string]: Promise<VisProjectState>;
+};
+export type VisProjectState = {
+    projectRoot: string;
     testTimeout: number;
     hookTimeout: number;
     snapshotRootDir: string;
@@ -20,6 +23,7 @@ export type VisState = {
 export type PartialBrowserCommandContext = {
     project: {
         config: {
+            name: string;
             root: string;
             snapshotOptions: {
                 updateSnapshot: 'all' | 'new' | 'none';
@@ -30,18 +34,18 @@ export type PartialBrowserCommandContext = {
         vite: {
             config: {
                 test?: {
-                    name: string;
+                    name?: string | undefined;
                 };
             };
         };
     };
     provider: {
         name: string;
-        browserName: string;
-        options: {
-            headless: boolean | undefined;
-            screenshotFailures: boolean | undefined;
-            screenshotDirectory: string | undefined;
+        browserName?: string | undefined;
+        options?: {
+            headless?: boolean | undefined;
+            screenshotFailures?: boolean | undefined;
+            screenshotDirectory?: string | undefined;
         };
     };
     testPath: string;

package/esm/server/vis_context.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vis_context.types.d.ts","sourceRoot":"","sources":["../../src/server/vis_context.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACtB,WAAW,EAAE,MAAM,CAAA;IAEnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,EAAE,MAAM,CACb,MAAM,EACN;QACC,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CACZ,MAAM,EACN;YACC,KAAK,EAAE,MAAM,CAAA;SACb,CACD,CAAA;KACD,CACD,CAAA;CACD,CAAA;AACD,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE;QACR,MAAM,EAAE;YACP,IAAI,EAAE,MAAM,CAAA;YACZ,eAAe,EAAE;gBAChB,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;aACtC,CAAA;YACD,WAAW,EAAE,MAAM,CAAA;YACnB,WAAW,EAAE,MAAM,CAAA;SACnB,CAAA;QACD,IAAI,EAAE;YACL,MAAM,EAAE;gBACP,IAAI,CAAC,EAAE;oBACN,IAAI,EAAE,MAAM,CAAA;iBACZ,CAAA;aACD,CAAA;SACD,CAAA;KACD,CAAA;IACD,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE;YACR,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;YAC7B,kBAAkB,EAAE,OAAO,GAAG,SAAS,CAAA;YACvC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAA;SACvC,CAAA;KACD,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;CAChB,CAAA"}
+{"version":3,"file":"vis_context.types.d.ts","sourceRoot":"","sources":["../../src/server/vis_context.types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACtB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;CAC/C,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,iBAAiB,EAAE,MAAM,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;IACxB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,MAAM,EAAE,MAAM,CACb,MAAM,EACN;QACC,WAAW,EAAE,MAAM,CAAA;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,OAAO,EAAE,MAAM,CAAA;QACf,KAAK,EAAE,MAAM,CACZ,MAAM,EACN;YACC,KAAK,EAAE,MAAM,CAAA;SACb,CACD,CAAA;KACD,CACD,CAAA;CACD,CAAA;AAED,MAAM,MAAM,4BAA4B,GAAG;IAC1C,OAAO,EAAE;QACR,MAAM,EAAE;YACP,IAAI,EAAE,MAAM,CAAA;YACZ,IAAI,EAAE,MAAM,CAAA;YACZ,eAAe,EAAE;gBAChB,cAAc,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;aACtC,CAAA;YACD,WAAW,EAAE,MAAM,CAAA;YACnB,WAAW,EAAE,MAAM,CAAA;SACnB,CAAA;QACD,IAAI,EAAE;YACL,MAAM,EAAE;gBACP,IAAI,CAAC,EAAE;oBACN,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;iBACzB,CAAA;aACD,CAAA;SACD,CAAA;KACD,CAAA;IACD,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAChC,OAAO,CAAC,EAAE;YACT,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;YAC9B,kBAAkB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;YACxC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SACxC,CAAA;KACD,CAAA;IACD,QAAQ,EAAE,MAAM,CAAA;CAChB,CAAA"}

package/esm/setup/vis.d.ts

@@ -1,5 +1,5 @@
 /**
  * Visual test configuration on the client side.
  */
-export declare const vis: import("./create_vis.ts").VisClientConfigurator<import("../index.ts").SnapshotMeta<import("../index.ts").ComparisonMethod>>;
+export declare const vis: import("./create_vis.ts").VisClientConfigurator<import("../client.ts").SnapshotMeta<import("../client.ts").ComparisonMethod>>;
 //# sourceMappingURL=vis.d.ts.map

package/esm/setup/vis.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vis.d.ts","sourceRoot":"","sources":["../../src/setup/vis.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,GAAG,6HAAsB,CAAA"}
+{"version":3,"file":"vis.d.ts","sourceRoot":"","sources":["../../src/setup/vis.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,eAAO,MAAM,GAAG,+HAAsB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vitest-plugin-vis",
-  "version": "2.3.3",
+  "version": "2.4.1",
   "description": "Vitest visual testing plugin",
   "keywords": [
     "image-snapshot",
@@ -58,6 +58,9 @@
     },
     "./package.json": "./package.json"
   },
+  "imports": {
+    "#vitest-plugin-vis/config": "./src/config.ts"
+  },
   "types": "./esm/index.d.ts",
   "files": [
     "esm",
@@ -80,10 +83,10 @@
     "@types/is-ci": "^3.0.4",
     "@types/pngjs": "^6.0.5",
     "@types/react": "^19.0.2",
-    "@vitest/browser": "^3.0.6",
-    "@vitest/coverage-istanbul": "^3.0.6",
-    "@vitest/coverage-v8": "^3.0.6",
-    "@vitest/expect": "^3.0.6",
+    "@vitest/browser": "^3.0.8",
+    "@vitest/coverage-istanbul": "^3.0.8",
+    "@vitest/coverage-v8": "^3.0.8",
+    "@vitest/expect": "^3.0.8",
     "cross-env": "^7.0.3",
     "never-fail": "^1.1.4",
     "npm-run-all2": "^7.0.2",
@@ -92,9 +95,8 @@
     "react-dom": "^19.0.0",
     "typescript": "^5.7.2",
     "vite": "^6.0.9",
-    "vitest": "^3.0.6",
-    "vitest-browser-react": "^0.1.0",
-    "webdriverio": "latest"
+    "vitest": "^3.0.8",
+    "vitest-browser-react": "^0.1.0"
   },
   "peerDependencies": {
     "@vitest/browser": "^2 || ^3",
@@ -107,6 +109,7 @@
     "build": "tsc",
     "build:watch": "tsc -w",
     "clean": "rimraf coverage esm *.tsbuildinfo vitest.*.timestamp*",
+    "clean:vis:local": "rimraf __vis__/local",
     "cov": "cross-env COVERAGE=true vitest run --coverage",
     "coverage": "cross-env COVERAGE=true vitest run --coverage",
     "dev": "run-p build:watch w",

package/src/client/image_snapshot_matcher.ts

@@ -1,8 +1,8 @@
+import type { BrowserCommands } from '@vitest/browser/context'
 import dedent from 'dedent'
 import { resolve } from 'pathe'
 import type { ImageSnapshotNextIndexCommand } from '../commands.ts'
 import type { PrepareImageSnapshotComparisonCommand } from '../server/commands/prepare_image_snapshot_comparison.ts'
-import type { WriteImageSnapshotCommand } from '../server/commands/write_image_snapshot.ts'
 import { isBase64String } from '../shared/base64.ts'
 import { compareImage } from '../shared/compare_image.ts'
 import type { ToMatchImageSnapshotOptions } from '../shared/types.ts'
@@ -15,7 +15,7 @@ import { server } from './vitest_browser_context_proxy.ts'
 import type { CurrentTest } from './vitest_suite_proxy.ts'
 
 export function imageSnapshotMatcher(
-	commands: PrepareImageSnapshotComparisonCommand & WriteImageSnapshotCommand & ImageSnapshotNextIndexCommand,
+	commands: BrowserCommands & PrepareImageSnapshotComparisonCommand & ImageSnapshotNextIndexCommand,
 ) {
 	return async function matchImageSnapshot(
 		test: CurrentTest & {},
@@ -65,11 +65,11 @@ export function imageSnapshotMatcher(
 			return
 		}
 		if (server.config.snapshotOptions.updateSnapshot === 'all' && !options?.expectToFail) {
-			await writeSnapshot(commands, info.baselinePath, resultImage)
+			await writeSnapshot(commands, resolve(info.projectRoot, info.baselinePath), resultImage)
 			return
 		}
 
-		await writeSnapshot(commands, info.diffPath, diffImage)
+		await writeSnapshot(commands, resolve(info.projectRoot, info.diffPath), diffImage)
 
 		throw new Error(
 			dedent`Snapshot \`${taskId}\` mismatched
@@ -103,9 +103,9 @@ export function parseImageSnapshotSubject(subject: any) {
 	)
 }
 
-async function writeSnapshot(commands: WriteImageSnapshotCommand, path: string, image: ImageData) {
+async function writeSnapshot(commands: BrowserCommands, path: string, image: ImageData) {
 	const content = (await toDataURL(image)).split(',')[1]!
-	return commands.writeImageSnapshot(path, content)
+	return commands.writeFile(path, content, { encoding: 'base64' })
 }
 
 async function parseImageSnapshotOptions(

package/src/client/snapshot_options.ts

@@ -51,7 +51,7 @@ function parseArgs<M extends ComparisonMethod>(
 	args: [task: MetaTask, meta: SnapshotMeta<M> | boolean] | [meta: boolean | SnapshotMeta<M>],
 ): [MetaTask | undefined, SnapshotMeta<M>] {
 	return args.length === 1
-		? [ctx.getCurrentTest() ?? (ctx.getCurrentSuite().tasks?.[0] as any)?.file, parseMeta(args[0])]
+		? [ctx.getCurrentTest() ?? (ctx.getCurrentSuite()?.tasks?.[0] as any)?.file, parseMeta(args[0])]
 		: [args[0], parseMeta(args[1])]
 }
 

package/src/commands.ts

@@ -1,6 +1,5 @@
 export * from './server/commands/has_image_snapshot.ts'
 export * from './server/commands/image_snapshot_next_index.ts'
 export * from './server/commands/match_image_snapshot.ts'
-export * from './server/commands/setup_vis_suite.ts'
 export * from './server/commands/prepare_image_snapshot_comparison.ts'
-export * from './server/commands/write_image_snapshot.ts'
+export * from './server/commands/setup_vis_suite.ts'

package/src/config/types.ts

@@ -35,11 +35,11 @@ export type VisOptions<M extends ComparisonMethod = 'pixel'> = ImageSnapshotTime
 			| string
 			| ((context: {
 					ci: boolean
-					browserName: string
+					browserName?: string | undefined
 					providerName: string
 					platform: string
-					screenshotFailures: boolean | undefined
-					screenshotDirectory: string | undefined
+					screenshotFailures?: boolean | undefined
+					screenshotDirectory?: string | undefined
 			  }) => string)
 			| undefined
 		/**

package/src/server/commands/browser_command_context.ts

@@ -1,6 +1,6 @@
 import type { BrowserCommandContext } from 'vitest/node'
 
-export function getProjectName(context: { project: { vite: { config: { test?: { name: string } } } } }) {
+export function getProjectName(context: { project: { vite: { config: { test?: { name?: string | undefined } } } } }) {
 	return context.project.vite.config.test?.name
 }
 

package/src/server/commands/extend.ts

@@ -6,7 +6,6 @@ import {
 	prepareImageSnapshotComparison,
 } from './prepare_image_snapshot_comparison.ts'
 import { type SetupVisSuiteCommand, setupVisSuite } from './setup_vis_suite.ts'
-import { type WriteImageSnapshotCommand, writeImageSnapshot } from './write_image_snapshot.ts'
 
 declare module '@vitest/browser/context' {
 	interface BrowserCommands
@@ -14,7 +13,6 @@ declare module '@vitest/browser/context' {
 			ImageSnapshotNextIndexCommand,
 			HasImageSnapshotCommand,
 			PrepareImageSnapshotComparisonCommand,
-			WriteImageSnapshotCommand,
 			MatchImageSnapshotCommand {}
 }
 
@@ -24,5 +22,4 @@ export const commands = {
 	hasImageSnapshot,
 	matchImageSnapshot,
 	prepareImageSnapshotComparison,
-	writeImageSnapshot,
 }

package/src/server/commands/image_snapshot_next_index.ts

@@ -12,5 +12,5 @@ export interface ImageSnapshotNextIndexCommand {
 export const imageSnapshotNextIndex: BrowserCommand<[taskId: string]> = async (context, taskId) => {
 	assertTestPathDefined(context, 'imageSnapshotNextIndex')
 
-	return visContext.getTaskCount(context.testPath, taskId)
+	return visContext.getTaskCount(context, taskId)
 }

package/src/server/commands/match_image_snapshot.ts

@@ -43,7 +43,7 @@ export const matchImageSnapshot: BrowserCommand<
 	if (!options) options = {}
 	options.timeout = options.timeout ?? 30000
 
-	const info = visContext.getSnapshotInfo(context as any, taskId, isAutoSnapshot, options)
+	const info = await visContext.getSnapshotInfo(context as any, taskId, isAutoSnapshot, options)
 	const baselineBuffer = await file.tryReadFile(info.baselinePath)
 	if (!baselineBuffer) {
 		if (isBase64String(subject)) {

package/src/server/commands/prepare_image_snapshot_comparison.ts

@@ -1,3 +1,4 @@
+import { resolve } from 'pathe'
 import type { BrowserCommand } from 'vitest/node'
 import { isBase64String } from '../../shared/base64.ts'
 import type {
@@ -13,11 +14,29 @@ import { assertTestPathDefined } from './_assertions.ts'
 import type { MatchImageSnapshotOptions } from './match_image_snapshot.ts'
 
 type ImageSnapshotComparisonInfo = {
+	/**
+	 * Path to the project root.
+	 */
 	projectRoot: string
+	/**
+	 * Path to the baseline image relative to the project root.
+	 */
 	baselinePath: string
+	/**
+	 * Path to the result image relative to the project root.
+	 */
 	resultPath: string
+	/**
+	 * Path to the diff image relative to the project root.
+	 */
 	diffPath: string
+	/**
+	 * Base64 encoded baseline image.
+	 */
 	baseline: string
+	/**
+	 * Base64 encoded result image.
+	 */
 	result: string
 } & ImageSnapshotTimeoutOptions &
 	FailureThresholdOptions &
@@ -40,21 +59,22 @@ export const prepareImageSnapshotComparison: BrowserCommand<
 	if (!options) options = {}
 	options.timeout = options.timeout ?? 30000
 
-	const info = visContext.getSnapshotInfo(context as any, taskId, isAutoSnapshot, options)
-	const baselineBuffer = await file.tryReadFile(info.baselinePath)
+	const projectRoot = context.project.config.root
+	const info = await visContext.getSnapshotInfo(context as any, taskId, isAutoSnapshot, options)
+	const baselineBuffer = await file.tryReadFile(resolve(projectRoot, info.baselinePath))
 	if (!baselineBuffer) {
 		if (isBase64String(subject)) {
-			await writeSnapshot(info.baselinePath, subject)
+			await writeSnapshot(resolve(projectRoot, info.baselinePath), subject)
 		} else {
-			await takeSnapshotByBrowser(context, info.baselinePath, subject, options)
+			await takeSnapshotByBrowser(context, resolve(projectRoot, info.baselinePath), subject, options)
 		}
 		return
 	}
 
-	const resultBuffer = await takeSnapshot(context, info.resultPath, subject, options)
+	const resultBuffer = await takeSnapshot(context, resolve(projectRoot, info.resultPath), subject, options)
 	return {
 		...info,
-		projectRoot: context.project.config.root,
+		projectRoot,
 		baseline: baselineBuffer.toString('base64'),
 		result: resultBuffer.toString('base64'),
 	}

package/src/server/snapshot_path.ts

@@ -13,8 +13,8 @@ export function resolveSnapshotRootDir(suite: PartialBrowserCommandContext, opti
 		browserName: suite.provider.browserName,
 		providerName: suite.provider.name,
 		platform: process.platform,
-		screenshotFailures: suite.provider.options.screenshotFailures,
-		screenshotDirectory: suite.provider.options.screenshotDirectory,
+		screenshotFailures: suite.provider.options?.screenshotFailures,
+		screenshotDirectory: suite.provider.options?.screenshotDirectory,
 	})
 }
 

package/src/server/vis_context.logic.ts

@@ -1,4 +1,4 @@
-import { join, relative } from 'pathe'
+import { join, relative, resolve } from 'pathe'
 import { pick } from 'type-plus'
 import type { VisOptions } from '../config/types.ts'
 import { BASELINE_DIR, DIFF_DIR, RESULT_DIR } from '../shared/constants.ts'
@@ -6,12 +6,11 @@ import { getProjectName } from './commands/browser_command_context.ts'
 import { file } from './file.ts'
 import { getSnapshotSubpath, resolveSnapshotRootDir } from './snapshot_path.ts'
 import { ctx } from './vis_context.ctx.ts'
-import type { PartialBrowserCommandContext, VisState } from './vis_context.types.ts'
+import type { PartialBrowserCommandContext, VisProjectState, VisState } from './vis_context.types.ts'
 
 export function createVisContext() {
 	let visOptionsRecord: Record<string, VisOptions<any>> = {}
-	let state: VisState
-	let globalStateReady: Promise<VisState>
+	let state: VisState = {}
 
 	const context = {
 		setOptions<M extends 'pixel' | 'ssim'>(projectName: string | undefined, options: VisOptions<M> = {} as any) {
@@ -21,10 +20,11 @@ export function createVisContext() {
 			return visOptionsRecord[projectName]
 		},
 		__test__reset() {
-			visOptionsRecord = {} as any
+			visOptionsRecord = {}
+			state = {}
 		},
-		__test__getState() {
-			return state
+		__test__getState(context: PartialBrowserCommandContext) {
+			return state[getProjectId(context)]!
 		},
 		/**
 		 * Setup suite is called on each test file's beforeAll hook.
@@ -32,25 +32,27 @@ export function createVisContext() {
 		 * It needs to make sure there is no race condition between the test files.
 		 */
 		async setupSuite(context: PartialBrowserCommandContext) {
-			if (!globalStateReady) {
-				globalStateReady = setupState(context, getVisOptions(visOptionsRecord, context) ?? {})
-				state = await globalStateReady
-			} else {
-				await globalStateReady
+			const projectId = getProjectId(context)
+
+			if (!state[projectId]) {
+				state[projectId] = setupState(context, getVisOptions(visOptionsRecord, context) ?? {})
 			}
 
-			const { suiteId, suite } = createSuite(state, context.testPath, visOptionsRecord)
-			state.suites[suiteId] = suite
+			const projectState = await state[projectId]
+
+			const { suiteId, suite } = createSuite(projectState, context.testPath, visOptionsRecord)
+			projectState.suites[suiteId] = suite
+
 			await Promise.allSettled([ctx.rimraf(suite.diffDir), ctx.rimraf(suite.resultDir)])
-			return pick(state, 'subjectDataTestId')
+			return pick(projectState, 'subjectDataTestId')
 		},
-		getSnapshotInfo(
+		async getSnapshotInfo(
 			browserContext: PartialBrowserCommandContext,
 			name: string,
 			isAutoSnapshot: boolean,
 			options?: { snapshotFileId?: string | undefined },
 		) {
-			const suiteInfo = context.getSuiteInfo(browserContext.testPath, name)
+			const suiteInfo = await context.getSuiteInfo(browserContext, name)
 			const snapshotFilename = context.getSnapshotFilename(
 				browserContext,
 				suiteInfo,
@@ -79,18 +81,23 @@ export function createVisContext() {
 				diffPath,
 			}
 		},
-		getTaskCount(testPath: string, taskId: string) {
-			return context.getSuiteInfo(testPath, taskId).task.count
+		async getTaskCount(browserContext: PartialBrowserCommandContext, taskId: string) {
+			return (await context.getSuiteInfo(browserContext, taskId)).task.count
 		},
-		hasImageSnapshot(
+		async hasImageSnapshot(
 			browserContext: PartialBrowserCommandContext,
 			taskId: string,
 			snapshotFileId: string | undefined,
 			isAutoSnapshot: boolean,
 		) {
-			const info = context.getSuiteInfo(browserContext.testPath, taskId)
+			const info = await context.getSuiteInfo(browserContext, taskId)
+
 			return file.existFile(
-				join(info.baselineDir, context.getSnapshotFilename(browserContext, info, snapshotFileId, isAutoSnapshot)),
+				resolve(
+					info.projectRoot,
+					info.baselineDir,
+					context.getSnapshotFilename(browserContext, info, snapshotFileId, isAutoSnapshot),
+				),
 			)
 		},
 		getSnapshotFilename(
@@ -108,11 +115,15 @@ export function createVisContext() {
 				isAutoSnapshot,
 			})}.png`
 		},
-		getSuiteInfo(testPath: string, taskId: string) {
-			const suiteId = getSuiteId(state, testPath, visOptionsRecord)
-			const suite = state.suites[suiteId]!
+		async getSuiteInfo(browserContext: PartialBrowserCommandContext, taskId: string) {
+			const projectId = getProjectId(browserContext)
+			const projectState = await state[projectId]!
+
+			const suiteId = getSuiteId(projectState, browserContext.testPath, visOptionsRecord)
+			const suite = projectState.suites[suiteId]!
 			const task = (suite.tasks[taskId] = suite.tasks[taskId] ?? { count: 1 })
 			return {
+				projectRoot: projectState.projectRoot,
 				suiteId,
 				taskId,
 				baselineDir: suite.baselineDir,
@@ -126,21 +137,21 @@ export function createVisContext() {
 }
 
 async function setupState(
-	suite: PartialBrowserCommandContext,
+	browserContext: PartialBrowserCommandContext,
 	visOptions: Pick<VisOptions, 'snapshotRootDir' | 'platform' | 'subjectDataTestId'>,
 ) {
-	const snapshotRootDir = resolveSnapshotRootDir(suite, visOptions)
-	const projectPath = suite.project.config.root
+	const snapshotRootDir = resolveSnapshotRootDir(browserContext, visOptions)
+	const projectRoot = getProjectRoot(browserContext)
 
 	const state = {
-		projectPath,
-		testTimeout: suite.project.config.testTimeout,
-		hookTimeout: suite.project.config.hookTimeout,
+		projectRoot,
+		testTimeout: browserContext.project.config.testTimeout,
+		hookTimeout: browserContext.project.config.hookTimeout,
 		snapshotRootDir,
 		snapshotBaselineDir: join(snapshotRootDir, BASELINE_DIR),
 		snapshotResultDir: join(snapshotRootDir, RESULT_DIR),
 		snapshotDiffDir: join(snapshotRootDir, DIFF_DIR),
-		snapshotRootPath: join(projectPath, snapshotRootDir),
+		snapshotRootPath: join(projectRoot, snapshotRootDir),
 		subjectDataTestId: visOptions.subjectDataTestId,
 		suites: {},
 	}
@@ -148,7 +159,11 @@ async function setupState(
 	return state
 }
 
-export function createSuite(state: VisState, testPath: string, options: Pick<VisOptions, 'customizeSnapshotSubpath'>) {
+export function createSuite(
+	state: VisProjectState,
+	testPath: string,
+	options: Pick<VisOptions, 'customizeSnapshotSubpath'>,
+) {
 	const suiteId = getSuiteId(state, testPath, options)
 	return {
 		suiteId,
@@ -161,10 +176,22 @@ export function createSuite(state: VisState, testPath: string, options: Pick<Vis
 	}
 }
 
-export function getSuiteId(state: VisState, testPath: string, options: Pick<VisOptions, 'customizeSnapshotSubpath'>) {
-	return getSnapshotSubpath(relative(state.projectPath, testPath), options)
+export function getSuiteId(
+	state: VisProjectState,
+	testPath: string,
+	options: Pick<VisOptions, 'customizeSnapshotSubpath'>,
+) {
+	return getSnapshotSubpath(relative(state.projectRoot, testPath), options)
 }
 
 function getVisOptions(visOptionsRecord: Record<string, VisOptions<any>>, context: PartialBrowserCommandContext) {
 	return visOptionsRecord[getProjectName(context) ?? '__default']!
 }
+
+function getProjectRoot(context: PartialBrowserCommandContext) {
+	return context.project.config.root
+}
+
+function getProjectId(context: PartialBrowserCommandContext) {
+	return `${context.project.config.root}/${context.project.config.name}`
+}

package/src/server/vis_context.types.ts

@@ -1,6 +1,9 @@
 export type VisState = {
-	projectPath: string
-	// platform: string
+	[projectPath: string]: Promise<VisProjectState>
+}
+
+export type VisProjectState = {
+	projectRoot: string
 	testTimeout: number
 	hookTimeout: number
 	snapshotRootDir: string
@@ -24,9 +27,11 @@ export type VisState = {
 		}
 	>
 }
+
 export type PartialBrowserCommandContext = {
 	project: {
 		config: {
+			name: string
 			root: string
 			snapshotOptions: {
 				updateSnapshot: 'all' | 'new' | 'none'
@@ -37,18 +42,18 @@ export type PartialBrowserCommandContext = {
 		vite: {
 			config: {
 				test?: {
-					name: string
+					name?: string | undefined
 				}
 			}
 		}
 	}
 	provider: {
 		name: string
-		browserName: string
-		options: {
-			headless: boolean | undefined
-			screenshotFailures: boolean | undefined
-			screenshotDirectory: string | undefined
+		browserName?: string | undefined
+		options?: {
+			headless?: boolean | undefined
+			screenshotFailures?: boolean | undefined
+			screenshotDirectory?: string | undefined
 		}
 	}
 	testPath: string

package/esm/server/commands/write_image_snapshot.d.ts

@@ -1,12 +0,0 @@
-import type { BrowserCommand } from 'vitest/node';
-export interface WriteImageSnapshotCommand {
-    /**
-     * Writes the image snapshot to the file system.
-     * @param relativeFilePath The file path to write the image snapshot to.
-     * It is relative to the project root.
-     * @param imageBase64 The base64 encoded image.
-     */
-    writeImageSnapshot(relativeFilePath: string, imageBase64: string): Promise<void>;
-}
-export declare const writeImageSnapshot: BrowserCommand<[relativeFilePath: string, imageBase64: string]>;
-//# sourceMappingURL=write_image_snapshot.d.ts.map

package/esm/server/commands/write_image_snapshot.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"write_image_snapshot.d.ts","sourceRoot":"","sources":["../../../src/server/commands/write_image_snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD,MAAM,WAAW,yBAAyB;IACzC;;;;;OAKG;IACH,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChF;AAED,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAS9F,CAAA"}

package/esm/server/commands/write_image_snapshot.js

@@ -1,9 +0,0 @@
-import { mkdirp } from 'mkdirp';
-import { dirname, isAbsolute } from 'pathe';
-import { file } from "../file.js";
-import { assertIsRelativePath } from "./_assertions.js";
-export const writeImageSnapshot = async (_, relativeFilePath, imageBase64) => {
-    assertIsRelativePath(relativeFilePath, 'relativeFilePath');
-    await mkdirp(dirname(relativeFilePath));
-    await file.writeFile(relativeFilePath, imageBase64, { encoding: 'base64' });
-};

package/src/server/commands/write_image_snapshot.ts

@@ -1,26 +0,0 @@
-import { mkdirp } from 'mkdirp'
-import { dirname, isAbsolute } from 'pathe'
-import type { BrowserCommand } from 'vitest/node'
-import { file } from '../file.ts'
-import { assertIsRelativePath } from './_assertions.ts'
-
-export interface WriteImageSnapshotCommand {
-	/**
-	 * Writes the image snapshot to the file system.
-	 * @param relativeFilePath The file path to write the image snapshot to.
-	 * It is relative to the project root.
-	 * @param imageBase64 The base64 encoded image.
-	 */
-	writeImageSnapshot(relativeFilePath: string, imageBase64: string): Promise<void>
-}
-
-export const writeImageSnapshot: BrowserCommand<[relativeFilePath: string, imageBase64: string]> = async (
-	_,
-	relativeFilePath,
-	imageBase64,
-) => {
-	assertIsRelativePath(relativeFilePath, 'relativeFilePath')
-
-	await mkdirp(dirname(relativeFilePath))
-	await file.writeFile(relativeFilePath, imageBase64, { encoding: 'base64' })
-}