vitest-plugin-vis 4.1.0 → 4.2.0

package/dist/client/external/vitest/vitest_suite_proxy.mjs

@@ -0,0 +1,11 @@
+//#region src/client/external/vitest/vitest_suite_proxy.ts
+let vitestSuite;
+if (globalThis.__vitest_browser__) import("vitest/suite").then((m) => {
+	vitestSuite = m;
+});
+const getCurrentTest = () => vitestSuite?.getCurrentTest();
+const getCurrentSuite = () => vitestSuite?.getCurrentSuite();
+
+//#endregion
+export { getCurrentSuite, getCurrentTest };
+//# sourceMappingURL=vitest_suite_proxy.mjs.map

package/dist/client/external/vitest/vitest_suite_proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitest_suite_proxy.mjs","names":[],"sources":["../../../../src/client/external/vitest/vitest_suite_proxy.ts"],"sourcesContent":["import type { SnapshotTestMeta } from '../../../shared/types.ts'\n\nlet vitestSuite: Awaited<typeof import('vitest/suite')>\n\nif ((globalThis as any).__vitest_browser__) {\n\timport('vitest/suite').then((m) => {\n\t\tvitestSuite = m\n\t})\n}\n\nexport type CurrentTest = ReturnType<typeof vitestSuite.getCurrentTest> & SnapshotTestMeta\n\nexport const getCurrentTest = () => vitestSuite?.getCurrentTest() as CurrentTest\nexport const getCurrentSuite = () => vitestSuite?.getCurrentSuite()\n"],"mappings":";AAEA,IAAI;AAEJ,IAAK,WAAmB,mBACvB,QAAO,gBAAgB,MAAM,MAAM;AAClC,eAAc;EACb;AAKH,MAAa,uBAAuB,aAAa,gBAAgB;AACjE,MAAa,wBAAwB,aAAa,iBAAiB"}

package/dist/client/image/align_images.mjs

@@ -0,0 +1,14 @@
+import { getMaxSize } from "../../shared/get_max_size.mjs";
+import { isSameSize } from "../../shared/is_same_size.mjs";
+import { createImageResizer } from "../external/browser/image_resizer.mjs";
+
+//#region src/client/image/align_images.ts
+function alignImagesToSameSize(image1, image2) {
+	if (isSameSize(image1, image2)) return [image1, image2];
+	const resize = createImageResizer(getMaxSize(image1, image2));
+	return [resize(image1), resize(image2)];
+}
+
+//#endregion
+export { alignImagesToSameSize };
+//# sourceMappingURL=align_images.mjs.map

package/dist/client/image/align_images.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"align_images.mjs","names":[],"sources":["../../../src/client/image/align_images.ts"],"sourcesContent":["import { getMaxSize } from '../../shared/get_max_size.ts'\nimport { isSameSize } from '../../shared/is_same_size.ts'\nimport { createImageResizer } from '../external/browser/image_resizer.ts'\n\nexport function alignImagesToSameSize(image1: ImageData, image2: ImageData): [image1: ImageData, image2: ImageData] {\n\tif (isSameSize(image1, image2)) return [image1, image2] as const\n\n\tconst size = getMaxSize(image1, image2)\n\tconst resize = createImageResizer(size)\n\treturn [resize(image1), resize(image2)] as const\n}\n"],"mappings":";;;;;AAIA,SAAgB,sBAAsB,QAAmB,QAA2D;AACnH,KAAI,WAAW,QAAQ,OAAO,CAAE,QAAO,CAAC,QAAQ,OAAO;CAGvD,MAAM,SAAS,mBADF,WAAW,QAAQ,OAAO,CACA;AACvC,QAAO,CAAC,OAAO,OAAO,EAAE,OAAO,OAAO,CAAC"}

package/dist/client/page/_ctx.d.mts

@@ -0,0 +1,3 @@
+import "../external/vitest/vitest_suite_proxy.mjs";
+import { BrowserPage } from "vitest/browser";
+export { type BrowserPage };

package/dist/client/page/_ctx.mjs

@@ -0,0 +1,15 @@
+import { getCurrentTest } from "../external/vitest/vitest_suite_proxy.mjs";
+import { commands } from "vitest/browser";
+
+//#region src/client/page/_ctx.ts
+const ctx = {
+	commands,
+	getCurrentTest,
+	__test__reset() {
+		ctx.getCurrentTest = getCurrentTest;
+	}
+};
+
+//#endregion
+export { ctx };
+//# sourceMappingURL=_ctx.mjs.map

package/dist/client/page/_ctx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_ctx.mjs","names":[],"sources":["../../../src/client/page/_ctx.ts"],"sourcesContent":["import { type BrowserPage, commands } from 'vitest/browser'\nimport { getCurrentTest } from '../external/vitest/vitest_suite_proxy.ts'\n\nexport type { BrowserPage }\n\nexport const ctx = {\n\tcommands,\n\tgetCurrentTest,\n\t__test__reset() {\n\t\tctx.getCurrentTest = getCurrentTest\n\t},\n}\n"],"mappings":";;;;AAKA,MAAa,MAAM;CAClB;CACA;CACA,gBAAgB;AACf,MAAI,iBAAiB;;CAEtB"}

package/dist/client/page/augment.d.mts

@@ -0,0 +1,9 @@
+import { HasImageSnapshotAction } from "./has_image_snapshot.mjs";
+import { ToMatchImageSnapshotAction } from "./to_match_image_snapshot.mjs";
+
+//#region src/client/page/augment.d.ts
+declare module '@vitest/browser/context' {
+  interface BrowserPage extends HasImageSnapshotAction, ToMatchImageSnapshotAction {}
+}
+//# sourceMappingURL=augment.d.ts.map
+//# sourceMappingURL=augment.d.mts.map

package/dist/client/page/augment.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augment.d.mts","names":[],"sources":["../../../src/client/page/augment.ts"],"sourcesContent":[],"mappings":";;;;;gCAI+B,wBAAwB,4BAHuB"}

package/dist/client/page/extend.d.mts

@@ -0,0 +1 @@
+import "./augment.mjs";

package/dist/client/page/extend.mjs

@@ -0,0 +1,13 @@
+import { hasImageSnapshot } from "./has_image_snapshot.mjs";
+import { toMatchImageSnapshot } from "./to_match_image_snapshot.mjs";
+import { page } from "vitest/browser";
+
+//#region src/client/page/extend.ts
+page.extend({
+	hasImageSnapshot,
+	toMatchImageSnapshot
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=extend.mjs.map

package/dist/client/page/extend.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend.mjs","names":[],"sources":["../../../src/client/page/extend.ts"],"sourcesContent":["import { page } from 'vitest/browser'\nimport './augment.ts'\nimport { hasImageSnapshot } from './has_image_snapshot.ts'\nimport { toMatchImageSnapshot } from './to_match_image_snapshot.ts'\n\npage.extend({ hasImageSnapshot, toMatchImageSnapshot })\n"],"mappings":";;;;;AAKA,KAAK,OAAO;CAAE;CAAkB;CAAsB,CAAC"}

package/dist/client/page/has_image_snapshot.d.mts

@@ -0,0 +1,13 @@
+import { ImageSnapshotKeyOptions } from "../../shared/types.mjs";
+import { BrowserPage } from "./_ctx.mjs";
+
+//#region src/client/page/has_image_snapshot.d.ts
+interface HasImageSnapshotAction {
+  /**
+   * Check if the snapshot image exists.
+   */
+  hasImageSnapshot(this: BrowserPage, options?: ImageSnapshotKeyOptions | undefined): Promise<boolean>;
+}
+//#endregion
+export { HasImageSnapshotAction };
+//# sourceMappingURL=has_image_snapshot.d.mts.map

package/dist/client/page/has_image_snapshot.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has_image_snapshot.d.mts","names":[],"sources":["../../../src/client/page/has_image_snapshot.ts"],"sourcesContent":[],"mappings":";;;;UAMiB,sBAAA;;AAAjB;;EAI+C,gBAAA,CAAA,IAAA,EAAvB,WAAuB,EAAA,OAAA,CAAA,EAAA,uBAAA,GAAA,SAAA,CAAA,EAAsC,OAAtC,CAAA,OAAA,CAAA"}

package/dist/client/page/has_image_snapshot.mjs

@@ -0,0 +1,15 @@
+import { hasImageSnapshotAction } from "../actions/has_image_snapshot_action.mjs";
+import { toTaskId } from "../task/task_id.mjs";
+import { ctx } from "./_ctx.mjs";
+
+//#region src/client/page/has_image_snapshot.ts
+function hasImageSnapshot(options) {
+	const test = ctx.getCurrentTest();
+	if (!test) throw new Error("`hasImageSnapshot()` must be called in a test.");
+	if (test.concurrent) throw new Error("`hasImageSnapshot()` cannot be called in a concurrent test because concurrent tests run at the same time in the same iframe and affect each other's environment. ");
+	return hasImageSnapshotAction(ctx.commands, toTaskId(test), options);
+}
+
+//#endregion
+export { hasImageSnapshot };
+//# sourceMappingURL=has_image_snapshot.mjs.map

package/dist/client/page/has_image_snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"has_image_snapshot.mjs","names":[],"sources":["../../../src/client/page/has_image_snapshot.ts"],"sourcesContent":["import type { ImageSnapshotKeyOptions } from '../../shared/types.ts'\nimport { hasImageSnapshotAction } from '../actions/has_image_snapshot_action.ts'\nimport { toTaskId } from '../task/task_id.ts'\nimport type { BrowserPage } from './_ctx.ts'\nimport { ctx } from './_ctx.ts'\n\nexport interface HasImageSnapshotAction {\n\t/**\n\t * Check if the snapshot image exists.\n\t */\n\thasImageSnapshot(this: BrowserPage, options?: ImageSnapshotKeyOptions | undefined): Promise<boolean>\n}\n\nexport function hasImageSnapshot(this: BrowserPage, options?: ImageSnapshotKeyOptions | undefined) {\n\tconst test = ctx.getCurrentTest()\n\tif (!test) {\n\t\tthrow new Error('`hasImageSnapshot()` must be called in a test.')\n\t}\n\n\tif (test.concurrent) {\n\t\tthrow new Error(\n\t\t\t'`hasImageSnapshot()` cannot be called in a concurrent test because ' +\n\t\t\t\t\"concurrent tests run at the same time in the same iframe and affect each other's environment. \",\n\t\t)\n\t}\n\treturn hasImageSnapshotAction(ctx.commands, toTaskId(test), options)\n}\n"],"mappings":";;;;;AAaA,SAAgB,iBAAoC,SAA+C;CAClG,MAAM,OAAO,IAAI,gBAAgB;AACjC,KAAI,CAAC,KACJ,OAAM,IAAI,MAAM,iDAAiD;AAGlE,KAAI,KAAK,WACR,OAAM,IAAI,MACT,oKAEA;AAEF,QAAO,uBAAuB,IAAI,UAAU,SAAS,KAAK,EAAE,QAAQ"}

package/dist/client/page/to_match_image_snapshot.d.mts

@@ -0,0 +1,9 @@
+import { ComparisonMethod, ToMatchPageImageSnapshotOptions } from "../../shared/types.mjs";
+
+//#region src/client/page/to_match_image_snapshot.d.ts
+interface ToMatchImageSnapshotAction {
+  toMatchImageSnapshot<M extends ComparisonMethod = 'pixel'>(options?: ToMatchPageImageSnapshotOptions<M> | undefined): Promise<void>;
+}
+//#endregion
+export { ToMatchImageSnapshotAction };
+//# sourceMappingURL=to_match_image_snapshot.d.mts.map

package/dist/client/page/to_match_image_snapshot.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_match_image_snapshot.d.mts","names":[],"sources":["../../../src/client/page/to_match_image_snapshot.ts"],"sourcesContent":[],"mappings":";;;UAKiB,0BAAA;iCACe,sCACpB,gCAAgC,iBACxC;AAHJ"}

package/dist/client/page/to_match_image_snapshot.mjs

@@ -0,0 +1,15 @@
+import { matchPageImageSnapshotAction } from "../actions/match_page_image_snapshot_action.mjs";
+import { toTaskId } from "../task/task_id.mjs";
+import { ctx } from "./_ctx.mjs";
+
+//#region src/client/page/to_match_image_snapshot.ts
+function toMatchImageSnapshot(options) {
+	const test = ctx.getCurrentTest();
+	if (!test) throw new Error("`toMatchImageSnapshot()` must be called in a test.");
+	if (test.concurrent) throw new Error("`toMatchImageSnapshot()` cannot be called in a concurrent test because concurrent tests run at the same time in the same iframe and affect each other's environment.");
+	return matchPageImageSnapshotAction(ctx.commands, toTaskId(test), options);
+}
+
+//#endregion
+export { toMatchImageSnapshot };
+//# sourceMappingURL=to_match_image_snapshot.mjs.map

package/dist/client/page/to_match_image_snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"to_match_image_snapshot.mjs","names":[],"sources":["../../../src/client/page/to_match_image_snapshot.ts"],"sourcesContent":["import type { ComparisonMethod, ToMatchPageImageSnapshotOptions } from '../../shared/types.ts'\nimport { matchPageImageSnapshotAction } from '../actions/match_page_image_snapshot_action.ts'\nimport { toTaskId } from '../task/task_id.ts'\nimport { ctx } from './_ctx.ts'\n\nexport interface ToMatchImageSnapshotAction {\n\ttoMatchImageSnapshot<M extends ComparisonMethod = 'pixel'>(\n\t\toptions?: ToMatchPageImageSnapshotOptions<M> | undefined,\n\t): Promise<void>\n}\n\nexport function toMatchImageSnapshot<M extends ComparisonMethod = 'pixel'>(\n\toptions?: ToMatchPageImageSnapshotOptions<M> | undefined,\n) {\n\tconst test = ctx.getCurrentTest()\n\tif (!test) {\n\t\tthrow new Error('`toMatchImageSnapshot()` must be called in a test.')\n\t}\n\n\tif (test.concurrent) {\n\t\tthrow new Error(\n\t\t\t'`toMatchImageSnapshot()` cannot be called in a concurrent test because ' +\n\t\t\t\t\"concurrent tests run at the same time in the same iframe and affect each other's environment.\",\n\t\t)\n\t}\n\n\treturn matchPageImageSnapshotAction(ctx.commands, toTaskId(test), options)\n}\n"],"mappings":";;;;;AAWA,SAAgB,qBACf,SACC;CACD,MAAM,OAAO,IAAI,gBAAgB;AACjC,KAAI,CAAC,KACJ,OAAM,IAAI,MAAM,qDAAqD;AAGtE,KAAI,KAAK,WACR,OAAM,IAAI,MACT,uKAEA;AAGF,QAAO,6BAA6B,IAAI,UAAU,SAAS,KAAK,EAAE,QAAQ"}

package/dist/client/snapshot/compare_image_snapshot.logic.mjs

@@ -0,0 +1,14 @@
+//#region src/client/snapshot/compare_image_snapshot.logic.ts
+function prettifyOptions(options) {
+	if (!options) return "none";
+	return [
+		`failureThreshold: ${options.failureThreshold ?? 0} ${options.failureThresholdType ?? "pixels"}`,
+		options.timeout ? `timeout: ${options.timeout} ms` : "",
+		`comparisonMethod: ${options.comparisonMethod ?? "pixel"}`,
+		options.diffOptions ? `diffOptions: ${JSON.stringify(options.diffOptions)}` : ""
+	].filter(Boolean).join("\n                ");
+}
+
+//#endregion
+export { prettifyOptions };
+//# sourceMappingURL=compare_image_snapshot.logic.mjs.map

package/dist/client/snapshot/compare_image_snapshot.logic.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare_image_snapshot.logic.mjs","names":[],"sources":["../../../src/client/snapshot/compare_image_snapshot.logic.ts"],"sourcesContent":["import type { ToMatchImageSnapshotOptions } from '../../shared/types.ts'\n\nexport function prettifyOptions(options: ToMatchImageSnapshotOptions<any> | undefined) {\n\tif (!options) return 'none'\n\n\treturn [\n\t\t`failureThreshold: ${options.failureThreshold ?? 0} ${options.failureThresholdType ?? 'pixels'}`,\n\t\toptions.timeout ? `timeout: ${options.timeout} ms` : '',\n\t\t`comparisonMethod: ${options.comparisonMethod ?? 'pixel'}`,\n\t\toptions.diffOptions ? `diffOptions: ${JSON.stringify(options.diffOptions)}` : '',\n\t]\n\t\t.filter(Boolean)\n\t\t.join('\\n                ')\n}\n"],"mappings":";AAEA,SAAgB,gBAAgB,SAAuD;AACtF,KAAI,CAAC,QAAS,QAAO;AAErB,QAAO;EACN,qBAAqB,QAAQ,oBAAoB,EAAE,GAAG,QAAQ,wBAAwB;EACtF,QAAQ,UAAU,YAAY,QAAQ,QAAQ,OAAO;EACrD,qBAAqB,QAAQ,oBAAoB;EACjD,QAAQ,cAAc,gBAAgB,KAAK,UAAU,QAAQ,YAAY,KAAK;EAC9E,CACC,OAAO,QAAQ,CACf,KAAK,qBAAqB"}

package/dist/client/snapshot/compare_image_snapshot.mjs

@@ -0,0 +1,63 @@
+import { compareImage } from "../../shared/compare_image.mjs";
+import { toDataURL, toImageData } from "../external/browser/image_data.mjs";
+import { server } from "../external/vitest/vitest_browser_context_proxy.mjs";
+import { alignImagesToSameSize } from "../image/align_images.mjs";
+import { prettifyOptions } from "./compare_image_snapshot.logic.mjs";
+import { resolve } from "pathe";
+import dedent from "dedent";
+
+//#region src/client/snapshot/compare_image_snapshot.ts
+async function compareImageSnapshot(commands, taskId, info, options) {
+	options = {
+		...info,
+		...options
+	};
+	const resultImage = await toImageData(info.result);
+	if (!info.baseline) {
+		if (server.config.snapshotOptions.updateSnapshot === "all") {
+			await writeSnapshot(commands, resolve(info.projectRoot, info.baselinePath), resultImage);
+			return;
+		}
+		throw new Error(dedent`Snapshot \`${taskId}\` has no baseline image. Please review the new snapshot and update the baseline image.
+
+				Options:    ${prettifyOptions(options)}
+				Actual:     ${resolve(info.projectRoot, info.resultPath)}`);
+	}
+	const baselineImage = await toImageData(info.baseline);
+	const [baselineAlignedImage, resultAlignedImage] = alignImagesToSameSize(baselineImage, resultImage);
+	const { width, height } = baselineAlignedImage;
+	const diffImage = new ImageData(width, height);
+	const { pass, diffAmount } = compareImage(baselineAlignedImage.data, resultAlignedImage.data, diffImage.data, width, height, options);
+	if (pass) {
+		if (options?.expectToFail) throw new Error(dedent`Snapshot \`${taskId}\` matched but expected to fail.
+
+							Options:    ${prettifyOptions(options)}
+							Diff:       ${options.failureThresholdType === "percent" ? `${diffAmount}%` : `${diffAmount} pixels`}
+
+							Expected:   ${resolve(info.projectRoot, info.baselinePath)}
+							Actual:     ${resolve(info.projectRoot, info.resultPath)}`);
+		return;
+	}
+	if (server.config.snapshotOptions.updateSnapshot === "all" && !options?.expectToFail) {
+		await writeSnapshot(commands, resolve(info.projectRoot, info.baselinePath), resultImage);
+		return;
+	}
+	await writeSnapshot(commands, resolve(info.projectRoot, info.diffPath), diffImage);
+	throw new Error(dedent`Snapshot \`${taskId}\` mismatched
+
+					${options?.failureThreshold ? options?.failureThresholdType === "percent" ? `Expected image to match within ${options.failureThreshold}% but was differ by ${diffAmount}%.` : `Expected image to match within ${options.failureThreshold} pixels but was differ by ${diffAmount} pixels.` : `Expected image to match but was differ by ${options?.failureThresholdType === "percent" ? `${diffAmount}%` : `${diffAmount} pixels`}.`}${baselineImage.width !== resultImage.width || baselineImage.height !== resultImage.height ? `\nThe image size changed from ${baselineImage.width}x${baselineImage.height} to ${resultImage.width}x${resultImage.height}.` : ""}
+
+					Options:    ${prettifyOptions(options)}
+
+					Expected:   ${resolve(info.projectRoot, info.baselinePath)}
+					Actual:     ${resolve(info.projectRoot, info.resultPath)}
+					Difference: ${resolve(info.projectRoot, info.diffPath)}`);
+}
+async function writeSnapshot(commands, path, image) {
+	const content = (await toDataURL(image)).split(",")[1];
+	return commands.writeFile(path, content, { encoding: "base64" });
+}
+
+//#endregion
+export { compareImageSnapshot };
+//# sourceMappingURL=compare_image_snapshot.mjs.map

package/dist/client/snapshot/compare_image_snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare_image_snapshot.mjs","names":[],"sources":["../../../src/client/snapshot/compare_image_snapshot.ts"],"sourcesContent":["import dedent from 'dedent'\nimport { resolve } from 'pathe'\nimport type { BrowserCommands } from 'vitest/browser'\nimport type {\n\tImageSnapshotNextIndexCommand,\n\tPrepareImageSnapshotComparisonCommand,\n} from '../../shared/commands.types.ts'\nimport { compareImage } from '../../shared/compare_image.ts'\nimport type { ImageSnapshotComparisonInfo, ToMatchImageSnapshotOptions } from '../../shared/types.ts'\nimport { toDataURL, toImageData } from '../external/browser/image_data.ts'\nimport { server } from '../external/vitest/vitest_browser_context_proxy.ts'\nimport { alignImagesToSameSize } from '../image/align_images.ts'\nimport { prettifyOptions } from './compare_image_snapshot.logic.ts'\n\nexport async function compareImageSnapshot(\n\tcommands: BrowserCommands & PrepareImageSnapshotComparisonCommand & ImageSnapshotNextIndexCommand,\n\ttaskId: string,\n\tinfo: ImageSnapshotComparisonInfo,\n\toptions?: ToMatchImageSnapshotOptions<any>,\n) {\n\toptions = { ...info, ...options } as any\n\n\tconst resultImage = await toImageData(info.result)\n\n\tif (!info.baseline) {\n\t\tif (server.config.snapshotOptions.updateSnapshot === 'all') {\n\t\t\tawait writeSnapshot(commands, resolve(info.projectRoot, info.baselinePath), resultImage)\n\t\t\treturn\n\t\t}\n\t\tthrow new Error(\n\t\t\tdedent`Snapshot \\`${taskId}\\` has no baseline image. Please review the new snapshot and update the baseline image.\n\n\t\t\t\tOptions:    ${prettifyOptions(options)}\n\t\t\t\tActual:     ${resolve(info.projectRoot, info.resultPath)}`,\n\t\t)\n\t}\n\n\tconst baselineImage = await toImageData(info.baseline)\n\tconst [baselineAlignedImage, resultAlignedImage] = alignImagesToSameSize(baselineImage, resultImage)\n\tconst { width, height } = baselineAlignedImage\n\tconst diffImage = new ImageData(width, height)\n\tconst { pass, diffAmount } = compareImage(\n\t\tbaselineAlignedImage.data,\n\t\tresultAlignedImage.data,\n\t\tdiffImage.data,\n\t\twidth,\n\t\theight,\n\t\toptions,\n\t)\n\tif (pass) {\n\t\tif (options?.expectToFail) {\n\t\t\tthrow new Error(\n\t\t\t\tdedent`Snapshot \\`${taskId}\\` matched but expected to fail.\n\n\t\t\t\t\t\t\tOptions:    ${prettifyOptions(options)}\n\t\t\t\t\t\t\tDiff:       ${options.failureThresholdType === 'percent' ? `${diffAmount}%` : `${diffAmount} pixels`}\n\n\t\t\t\t\t\t\tExpected:   ${resolve(info.projectRoot, info.baselinePath)}\n\t\t\t\t\t\t\tActual:     ${resolve(info.projectRoot, info.resultPath)}`,\n\t\t\t)\n\t\t}\n\t\treturn\n\t}\n\tif (server.config.snapshotOptions.updateSnapshot === 'all' && !options?.expectToFail) {\n\t\tawait writeSnapshot(commands, resolve(info.projectRoot, info.baselinePath), resultImage)\n\t\treturn\n\t}\n\n\tawait writeSnapshot(commands, resolve(info.projectRoot, info.diffPath), diffImage)\n\n\tthrow new Error(\n\t\tdedent`Snapshot \\`${taskId}\\` mismatched\n\n\t\t\t\t\t${\n\t\t\t\t\t\toptions?.failureThreshold\n\t\t\t\t\t\t\t? options?.failureThresholdType === 'percent'\n\t\t\t\t\t\t\t\t? `Expected image to match within ${options.failureThreshold}% but was differ by ${diffAmount}%.`\n\t\t\t\t\t\t\t\t: `Expected image to match within ${options.failureThreshold} pixels but was differ by ${diffAmount} pixels.`\n\t\t\t\t\t\t\t: `Expected image to match but was differ by ${options?.failureThresholdType === 'percent' ? `${diffAmount}%` : `${diffAmount} pixels`}.`\n\t\t\t\t\t}${\n\t\t\t\t\t\tbaselineImage.width !== resultImage.width || baselineImage.height !== resultImage.height\n\t\t\t\t\t\t\t? `\\nThe image size changed from ${baselineImage.width}x${baselineImage.height} to ${resultImage.width}x${resultImage.height}.`\n\t\t\t\t\t\t\t: ''\n\t\t\t\t\t}\n\n\t\t\t\t\tOptions:    ${prettifyOptions(options)}\n\n\t\t\t\t\tExpected:   ${resolve(info.projectRoot, info.baselinePath)}\n\t\t\t\t\tActual:     ${resolve(info.projectRoot, info.resultPath)}\n\t\t\t\t\tDifference: ${resolve(info.projectRoot, info.diffPath)}`,\n\t)\n}\n\nasync function writeSnapshot(commands: BrowserCommands, path: string, image: ImageData) {\n\tconst content = (await toDataURL(image)).split(',')[1]!\n\treturn commands.writeFile(path, content, { encoding: 'base64' })\n}\n"],"mappings":";;;;;;;;;AAcA,eAAsB,qBACrB,UACA,QACA,MACA,SACC;AACD,WAAU;EAAE,GAAG;EAAM,GAAG;EAAS;CAEjC,MAAM,cAAc,MAAM,YAAY,KAAK,OAAO;AAElD,KAAI,CAAC,KAAK,UAAU;AACnB,MAAI,OAAO,OAAO,gBAAgB,mBAAmB,OAAO;AAC3D,SAAM,cAAc,UAAU,QAAQ,KAAK,aAAa,KAAK,aAAa,EAAE,YAAY;AACxF;;AAED,QAAM,IAAI,MACT,MAAM,cAAc,OAAO;;kBAEZ,gBAAgB,QAAQ,CAAC;kBACzB,QAAQ,KAAK,aAAa,KAAK,WAAW,GACzD;;CAGF,MAAM,gBAAgB,MAAM,YAAY,KAAK,SAAS;CACtD,MAAM,CAAC,sBAAsB,sBAAsB,sBAAsB,eAAe,YAAY;CACpG,MAAM,EAAE,OAAO,WAAW;CAC1B,MAAM,YAAY,IAAI,UAAU,OAAO,OAAO;CAC9C,MAAM,EAAE,MAAM,eAAe,aAC5B,qBAAqB,MACrB,mBAAmB,MACnB,UAAU,MACV,OACA,QACA,QACA;AACD,KAAI,MAAM;AACT,MAAI,SAAS,aACZ,OAAM,IAAI,MACT,MAAM,cAAc,OAAO;;qBAEV,gBAAgB,QAAQ,CAAC;qBACzB,QAAQ,yBAAyB,YAAY,GAAG,WAAW,KAAK,GAAG,WAAW,SAAS;;qBAEvF,QAAQ,KAAK,aAAa,KAAK,aAAa,CAAC;qBAC7C,QAAQ,KAAK,aAAa,KAAK,WAAW,GAC3D;AAEF;;AAED,KAAI,OAAO,OAAO,gBAAgB,mBAAmB,SAAS,CAAC,SAAS,cAAc;AACrF,QAAM,cAAc,UAAU,QAAQ,KAAK,aAAa,KAAK,aAAa,EAAE,YAAY;AACxF;;AAGD,OAAM,cAAc,UAAU,QAAQ,KAAK,aAAa,KAAK,SAAS,EAAE,UAAU;AAElF,OAAM,IAAI,MACT,MAAM,cAAc,OAAO;;OAGvB,SAAS,mBACN,SAAS,yBAAyB,YACjC,kCAAkC,QAAQ,iBAAiB,sBAAsB,WAAW,MAC5F,kCAAkC,QAAQ,iBAAiB,4BAA4B,WAAW,YACnG,6CAA6C,SAAS,yBAAyB,YAAY,GAAG,WAAW,KAAK,GAAG,WAAW,SAAS,KAExI,cAAc,UAAU,YAAY,SAAS,cAAc,WAAW,YAAY,SAC/E,iCAAiC,cAAc,MAAM,GAAG,cAAc,OAAO,MAAM,YAAY,MAAM,GAAG,YAAY,OAAO,KAC3H,GACH;;mBAEa,gBAAgB,QAAQ,CAAC;;mBAEzB,QAAQ,KAAK,aAAa,KAAK,aAAa,CAAC;mBAC7C,QAAQ,KAAK,aAAa,KAAK,WAAW,CAAC;mBAC3C,QAAQ,KAAK,aAAa,KAAK,SAAS,GACzD;;AAGF,eAAe,cAAc,UAA2B,MAAc,OAAkB;CACvF,MAAM,WAAW,MAAM,UAAU,MAAM,EAAE,MAAM,IAAI,CAAC;AACpD,QAAO,SAAS,UAAU,MAAM,SAAS,EAAE,UAAU,UAAU,CAAC"}

package/dist/client/snapshot/should_take_snapshot.mjs

@@ -0,0 +1,10 @@
+import { hasRenderContent } from "../external/browser/has_render_content.mjs";
+
+//#region src/client/snapshot/should_take_snapshot.ts
+function shouldTakeSnapshot(meta) {
+	return hasRenderContent() && meta?.enable;
+}
+
+//#endregion
+export { shouldTakeSnapshot };
+//# sourceMappingURL=should_take_snapshot.mjs.map

package/dist/client/snapshot/should_take_snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"should_take_snapshot.mjs","names":[],"sources":["../../../src/client/snapshot/should_take_snapshot.ts"],"sourcesContent":["import type { SnapshotMeta } from '../../auto_snapshots/snapshot_meta.ts'\nimport { hasRenderContent } from '../external/browser/has_render_content.ts'\n\nexport function shouldTakeSnapshot(meta: SnapshotMeta<any> | undefined) {\n\treturn hasRenderContent() && meta?.enable\n}\n"],"mappings":";;;AAGA,SAAgB,mBAAmB,MAAqC;AACvE,QAAO,kBAAkB,IAAI,MAAM"}

package/dist/client/suite/_ctx.mjs

@@ -0,0 +1,13 @@
+import { getCurrentTest } from "../external/vitest/vitest_suite_proxy.mjs";
+
+//#region src/client/suite/_ctx.ts
+const ctx = {
+	getCurrentTest,
+	__test__reset() {
+		ctx.getCurrentTest = getCurrentTest;
+	}
+};
+
+//#endregion
+export { ctx };
+//# sourceMappingURL=_ctx.mjs.map

package/dist/client/suite/_ctx.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"_ctx.mjs","names":[],"sources":["../../../src/client/suite/_ctx.ts"],"sourcesContent":["import { getCurrentTest } from '../external/vitest/vitest_suite_proxy.ts'\n\nexport const ctx = {\n\tgetCurrentTest,\n\t__test__reset() {\n\t\tctx.getCurrentTest = getCurrentTest\n\t},\n}\n"],"mappings":";;;AAEA,MAAa,MAAM;CAClB;CACA,gBAAgB;AACf,MAAI,iBAAiB;;CAEtB"}

package/dist/client/suite/auto_snapshot_matcher.d.mts

@@ -0,0 +1,12 @@
+import { SnapshotMeta } from "../../auto_snapshots/snapshot_meta.mjs";
+import { ComparisonMethod } from "../../shared/types.mjs";
+import { SetupVisSuiteCommand } from "../../shared/commands.types.mjs";
+
+//#region src/client/suite/auto_snapshot_matcher.d.ts
+declare function autoSnapshotMatcher<GM extends Record<string, any> | unknown = unknown>(commands: SetupVisSuiteCommand, expect: any): {
+  setup(): Promise<void>;
+  createMatcher<C extends ComparisonMethod, M extends Record<string, any> | unknown = unknown>(themes: Record<string, boolean | ((options: SnapshotMeta<C> & M & GM) => Promise<boolean> | Promise<void> | boolean | void)>): () => Promise<void>;
+};
+//#endregion
+export { autoSnapshotMatcher };
+//# sourceMappingURL=auto_snapshot_matcher.d.mts.map

package/dist/client/suite/auto_snapshot_matcher.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_snapshot_matcher.d.mts","names":[],"sources":["../../../src/client/suite/auto_snapshot_matcher.ts"],"sourcesContent":[],"mappings":";;;;;iBASgB,+BAA+B,mDACpC;;EADK,aAAA,CAAA,UAUU,gBAVS,EAAA,UAUmB,MAVnB,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,OAAA,GAAA,OAAA,CAAA,CAAA,MAAA,EAWxB,MAXwB,CAAA,MAAA,EAAA,OAAA,GAAA,CAAA,CAAA,OAAA,EAaV,YAbU,CAaG,CAbH,CAAA,GAaQ,CAbR,GAaY,EAbZ,EAAA,GAamB,OAbnB,CAAA,OAAA,CAAA,GAasC,OAbtC,CAAA,IAAA,CAAA,GAAA,OAAA,GAAA,IAAA,CAAA,CAAA,CAAA,EAAA,GAAA,GAc/B,OAd+B,CAAA,IAAA,CAAA;CAAY"}

package/dist/client/suite/auto_snapshot_matcher.mjs

@@ -0,0 +1,50 @@
+import { extractAutoSnapshotOptions } from "../../auto_snapshots/_extract_auto_snapshot_options.mjs";
+import { shouldTakeSnapshot } from "../snapshot/should_take_snapshot.mjs";
+import { toTaskId } from "../task/task_id.mjs";
+import { ctx } from "./_ctx.mjs";
+import dedent from "dedent";
+
+//#region src/client/suite/auto_snapshot_matcher.ts
+function autoSnapshotMatcher(commands, expect) {
+	let subject;
+	return {
+		async setup() {
+			subject = (await commands.setupVisSuite()).subject;
+		},
+		createMatcher(themes) {
+			return async function matchImageSnapshot() {
+				const test = ctx.getCurrentTest();
+				const meta = extractAutoSnapshotOptions(test);
+				if (!shouldTakeSnapshot(meta)) return;
+				const errors = [];
+				for (const themeId in themes) try {
+					await new Promise((a) => setTimeout(a, 10));
+					const theme = themes[themeId];
+					if ((typeof theme === "function" ? await theme(meta) : theme) === false) continue;
+					await expect(getSubject(meta?.subject ?? subject)).toMatchImageSnapshot({
+						...meta,
+						snapshotKey: meta?.snapshotKey ?? themeId
+					});
+				} catch (error) {
+					errors.push([themeId, error]);
+				}
+				if (errors.length > 0) {
+					if (errors.length === 1) throw errors[0][1];
+					const taskId = toTaskId(test);
+					throw new AggregateError(errors, dedent`Snapshot \`${taskId}\` mismatched
+
+					${errors.map(([themeId, error]) => {
+						return `Theme \`${themeId}\` failed: ${error.message}`;
+					}).join("\n\n")}`);
+				}
+			};
+		}
+	};
+}
+function getSubject(selectors) {
+	return selectors ? document.querySelector(selectors) ?? document.body : document.body;
+}
+
+//#endregion
+export { autoSnapshotMatcher };
+//# sourceMappingURL=auto_snapshot_matcher.mjs.map

package/dist/client/suite/auto_snapshot_matcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto_snapshot_matcher.mjs","names":[],"sources":["../../../src/client/suite/auto_snapshot_matcher.ts"],"sourcesContent":["import dedent from 'dedent'\nimport { extractAutoSnapshotOptions } from '../../auto_snapshots/_extract_auto_snapshot_options.ts'\nimport type { SnapshotMeta } from '../../auto_snapshots/snapshot_meta.ts'\nimport type { SetupVisSuiteCommand } from '../../shared/commands.types.ts'\nimport type { ComparisonMethod } from '../../shared/types.ts'\nimport { shouldTakeSnapshot } from '../snapshot/should_take_snapshot.ts'\nimport { toTaskId } from '../task/task_id.ts'\nimport { ctx } from './_ctx.ts'\n\nexport function autoSnapshotMatcher<GM extends Record<string, any> | unknown = unknown>(\n\tcommands: SetupVisSuiteCommand,\n\texpect: any,\n) {\n\tlet subject: string | undefined\n\n\treturn {\n\t\tasync setup() {\n\t\t\tsubject = (await commands.setupVisSuite()).subject\n\t\t},\n\t\tcreateMatcher<C extends ComparisonMethod, M extends Record<string, any> | unknown = unknown>(\n\t\t\tthemes: Record<\n\t\t\t\tstring,\n\t\t\t\tboolean | ((options: SnapshotMeta<C> & M & GM) => Promise<boolean> | Promise<void> | boolean | void)\n\t\t\t>,\n\t\t) {\n\t\t\treturn async function matchImageSnapshot() {\n\t\t\t\tconst test = ctx.getCurrentTest()\n\n\t\t\t\tconst meta = extractAutoSnapshotOptions(test)\n\t\t\t\tif (!shouldTakeSnapshot(meta)) return\n\t\t\t\tconst errors: Array<[string, Error]> = []\n\t\t\t\tfor (const themeId in themes) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tawait new Promise((a) => setTimeout(a, 10))\n\t\t\t\t\t\tconst theme = themes[themeId]\n\t\t\t\t\t\tconst r = typeof theme === 'function' ? await theme(meta! as any) : theme\n\t\t\t\t\t\tif (r === false) continue\n\t\t\t\t\t\tawait expect(getSubject(meta?.subject ?? subject)).toMatchImageSnapshot({\n\t\t\t\t\t\t\t...meta,\n\t\t\t\t\t\t\tsnapshotKey: meta?.snapshotKey ?? themeId,\n\t\t\t\t\t\t})\n\t\t\t\t\t} catch (error) {\n\t\t\t\t\t\terrors.push([themeId, error as Error])\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tif (errors.length > 0) {\n\t\t\t\t\tif (errors.length === 1) throw errors[0]![1]\n\t\t\t\t\tconst taskId = toTaskId(test!)\n\t\t\t\t\tthrow new AggregateError(\n\t\t\t\t\t\terrors,\n\t\t\t\t\t\tdedent`Snapshot \\`${taskId}\\` mismatched\n\n\t\t\t\t\t${errors\n\t\t\t\t\t\t.map(([themeId, error]) => {\n\t\t\t\t\t\t\treturn `Theme \\`${themeId}\\` failed: ${error.message}`\n\t\t\t\t\t\t})\n\t\t\t\t\t\t.join('\\n\\n')}`,\n\t\t\t\t\t)\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t}\n}\n\nfunction getSubject(selectors: string | undefined) {\n\treturn selectors ? (document.querySelector(selectors) ?? document.body) : document.body\n}\n"],"mappings":";;;;;;;AASA,SAAgB,oBACf,UACA,QACC;CACD,IAAI;AAEJ,QAAO;EACN,MAAM,QAAQ;AACb,cAAW,MAAM,SAAS,eAAe,EAAE;;EAE5C,cACC,QAIC;AACD,UAAO,eAAe,qBAAqB;IAC1C,MAAM,OAAO,IAAI,gBAAgB;IAEjC,MAAM,OAAO,2BAA2B,KAAK;AAC7C,QAAI,CAAC,mBAAmB,KAAK,CAAE;IAC/B,MAAM,SAAiC,EAAE;AACzC,SAAK,MAAM,WAAW,OACrB,KAAI;AACH,WAAM,IAAI,SAAS,MAAM,WAAW,GAAG,GAAG,CAAC;KAC3C,MAAM,QAAQ,OAAO;AAErB,UADU,OAAO,UAAU,aAAa,MAAM,MAAM,KAAa,GAAG,WAC1D,MAAO;AACjB,WAAM,OAAO,WAAW,MAAM,WAAW,QAAQ,CAAC,CAAC,qBAAqB;MACvE,GAAG;MACH,aAAa,MAAM,eAAe;MAClC,CAAC;aACM,OAAO;AACf,YAAO,KAAK,CAAC,SAAS,MAAe,CAAC;;AAGxC,QAAI,OAAO,SAAS,GAAG;AACtB,SAAI,OAAO,WAAW,EAAG,OAAM,OAAO,GAAI;KAC1C,MAAM,SAAS,SAAS,KAAM;AAC9B,WAAM,IAAI,eACT,QACA,MAAM,cAAc,OAAO;;OAE1B,OACA,KAAK,CAAC,SAAS,WAAW;AAC1B,aAAO,WAAW,QAAQ,aAAa,MAAM;OAC5C,CACD,KAAK,OAAO,GACb;;;;EAIJ;;AAGF,SAAS,WAAW,WAA+B;AAClD,QAAO,YAAa,SAAS,cAAc,UAAU,IAAI,SAAS,OAAQ,SAAS"}

package/dist/client/task/task_id.d.mts

@@ -0,0 +1,9 @@
+//#region src/client/task/task_id.d.ts
+type Task = {
+  name: string;
+  suite?: Task | undefined;
+};
+declare function toTaskId(task: Task): string;
+//#endregion
+export { toTaskId };
+//# sourceMappingURL=task_id.d.mts.map

package/dist/client/task/task_id.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_id.d.mts","names":[],"sources":["../../../src/client/task/task_id.ts"],"sourcesContent":[],"mappings":";KAAK,IAAA;EAAA,IAAA,EAAA,MAAI;EAKO,KAAA,CAAA,EAHP,IAGe,GAAA,SAAO;;iBAAf,QAAA,OAAe"}

package/dist/client/task/task_id.mjs

@@ -0,0 +1,15 @@
+//#region src/client/task/task_id.ts
+function toTaskId(task) {
+	const l = [];
+	let t = task;
+	while (t?.suite) {
+		l.unshift(t.suite.name.replace(/[^a-z0-9]/gi, "-").toLowerCase());
+		t = t.suite;
+	}
+	l.push(task.name.replace(/[^a-z0-9]/gi, "-").toLowerCase());
+	return l.join("/");
+}
+
+//#endregion
+export { toTaskId };
+//# sourceMappingURL=task_id.mjs.map

package/dist/client/task/task_id.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"task_id.mjs","names":[],"sources":["../../../src/client/task/task_id.ts"],"sourcesContent":["type Task = {\n\tname: string\n\tsuite?: Task | undefined\n}\n\nexport function toTaskId(task: Task) {\n\tconst l: any[] = []\n\tlet t = task\n\twhile (t?.suite) {\n\t\tl.unshift(t.suite.name.replace(/[^a-z0-9]/gi, '-').toLowerCase())\n\t\tt = t.suite\n\t}\n\n\tl.push(task.name.replace(/[^a-z0-9]/gi, '-').toLowerCase())\n\treturn l.join('/')\n}\n"],"mappings":";AAKA,SAAgB,SAAS,MAAY;CACpC,MAAM,IAAW,EAAE;CACnB,IAAI,IAAI;AACR,QAAO,GAAG,OAAO;AAChB,IAAE,QAAQ,EAAE,MAAM,KAAK,QAAQ,eAAe,IAAI,CAAC,aAAa,CAAC;AACjE,MAAI,EAAE;;AAGP,GAAE,KAAK,KAAK,KAAK,QAAQ,eAAe,IAAI,CAAC,aAAa,CAAC;AAC3D,QAAO,EAAE,KAAK,IAAI"}

package/dist/client-api.d.mts

@@ -1,44 +1,13 @@
-import { C as SNAPSHOT_ROOT_DIR, S as RESULT_DIR, _ as ToMatchImageSnapshotOptions, a as ImageSnapshotComparisonInfo, b as DIFF_DIR, c as ImageSnapshotTimeoutOptions, d as PixelComparisonOptions, f as PixelDiffOptions, g as SsimDiffOptions, h as SsimComparisonOptions, i as ImageSnapshotCompareOptions, l as MatchImageSnapshotOptions, m as SnapshotTestMeta, n as ComparisonMethod, o as ImageSnapshotKeyOptions, p as SetupVisOptions, r as FailureThresholdOptions, s as ImageSnapshotSubjectOptions, t as Awaitable, u as PageImageSnapshotOptions, v as ToMatchPageImageSnapshotOptions, w as SnapshotMeta, x as NAME, y as BASELINE_DIR } from "./types-CEmjj-A9.mjs";
-import "./types-DJYCbyT8.mjs";
-import { a as PrepareImageSnapshotComparisonCommand, i as LoadImageSnapshotResultsCommand, n as ImageSnapshotNextIndexCommand, o as PreparePageImageSnapshotComparisonCommand, r as ImageSnapshotResult, s as SetupVisSuiteCommand, t as HasImageSnapshotCommand } from "./commands.types-BVhcnnHw.mjs";
-import { t as ImageSnapshotMatcher } from "./to_match_image_snapshot.types--tTmHoRA.mjs";
-import { n as setAutoSnapshotOptions, t as MetaTask } from "./auto_snapshot_options-BMRtKmod.mjs";
-import { BrowserCommands } from "vitest/browser";
-import { SyncExpectationResult } from "@vitest/expect";
-
-//#region src/server/commands/augment.d.ts
-declare module 'vitest/browser' {
-  interface BrowserCommands extends SetupVisSuiteCommand, ImageSnapshotNextIndexCommand, HasImageSnapshotCommand, PreparePageImageSnapshotComparisonCommand, PrepareImageSnapshotComparisonCommand, LoadImageSnapshotResultsCommand {}
-}
-//# sourceMappingURL=augment.d.ts.map
-//#endregion
-//#region src/client/actions/has_image_snapshot_action.d.ts
-declare function hasImageSnapshotAction(commands: ImageSnapshotNextIndexCommand & HasImageSnapshotCommand, taskId: string, options?: ImageSnapshotKeyOptions | undefined): Promise<boolean>;
-//#endregion
-//#region src/client/actions/load_image_snapshot_results_action.d.ts
-declare function loadImageSnapshotResultsAction(commands: LoadImageSnapshotResultsCommand, taskId: string): Promise<ImageSnapshotResult[]>;
-//#endregion
-//#region src/client/actions/match_image_snapshot_action.d.ts
-declare function matchImageSnapshotAction(commands: BrowserCommands & PrepareImageSnapshotComparisonCommand & ImageSnapshotNextIndexCommand, taskId: string, subject: any, options?: ToMatchImageSnapshotOptions<any>): Promise<void>;
-//#endregion
-//#region src/client/actions/match_page_image_snapshot_action.d.ts
-declare function matchPageImageSnapshotAction(commands: BrowserCommands & PrepareImageSnapshotComparisonCommand & ImageSnapshotNextIndexCommand, taskId: string, options?: ToMatchImageSnapshotOptions<any>): Promise<void>;
-//#endregion
-//#region src/client/expect/expectation_result.d.ts
-declare const success: SyncExpectationResult;
-//#endregion
-//#region src/client/suite/auto_snapshot_matcher.d.ts
-declare function autoSnapshotMatcher<GM extends Record<string, any> | unknown = unknown>(commands: SetupVisSuiteCommand, expect: any): {
-  setup(): Promise<void>;
-  createMatcher<C extends ComparisonMethod, M extends Record<string, any> | unknown = unknown>(themes: Record<string, boolean | ((options: SnapshotMeta<C> & M & GM) => Promise<boolean> | Promise<void> | boolean | void)>): () => Promise<void>;
-};
-//#endregion
-//#region src/client/task/task_id.d.ts
-type Task = {
-  name: string;
-  suite?: Task | undefined;
-};
-declare function toTaskId(task: Task): string;
-//#endregion
-export { Awaitable, BASELINE_DIR, ComparisonMethod, DIFF_DIR, FailureThresholdOptions, ImageSnapshotCompareOptions, ImageSnapshotComparisonInfo, ImageSnapshotKeyOptions, ImageSnapshotMatcher, ImageSnapshotSubjectOptions, ImageSnapshotTimeoutOptions, MatchImageSnapshotOptions, type MetaTask, NAME, PageImageSnapshotOptions, PixelComparisonOptions, PixelDiffOptions, RESULT_DIR, SNAPSHOT_ROOT_DIR, SetupVisOptions, SnapshotTestMeta, SsimComparisonOptions, SsimDiffOptions, ToMatchImageSnapshotOptions, ToMatchPageImageSnapshotOptions, autoSnapshotMatcher, hasImageSnapshotAction, loadImageSnapshotResultsAction, matchImageSnapshotAction, matchPageImageSnapshotAction, setAutoSnapshotOptions, success, toTaskId };
-//# sourceMappingURL=client-api.d.mts.map
+import { BASELINE_DIR, DIFF_DIR, NAME, RESULT_DIR, SNAPSHOT_ROOT_DIR } from "./shared/constants.mjs";
+import { Awaitable, ComparisonMethod, FailureThresholdOptions, ImageSnapshotCompareOptions, ImageSnapshotComparisonInfo, ImageSnapshotKeyOptions, ImageSnapshotSubjectOptions, ImageSnapshotTimeoutOptions, MatchImageSnapshotOptions, PageImageSnapshotOptions, PixelComparisonOptions, PixelDiffOptions, SetupVisOptions, SnapshotTestMeta, SsimComparisonOptions, SsimDiffOptions, ToMatchImageSnapshotOptions, ToMatchPageImageSnapshotOptions } from "./shared/types.mjs";
+import "./server/commands/augment.mjs";
+import { MetaTask, setAutoSnapshotOptions } from "./auto_snapshots/auto_snapshot_options.mjs";
+import { hasImageSnapshotAction } from "./client/actions/has_image_snapshot_action.mjs";
+import { loadImageSnapshotResultsAction } from "./client/actions/load_image_snapshot_results_action.mjs";
+import { matchImageSnapshotAction } from "./client/actions/match_image_snapshot_action.mjs";
+import { matchPageImageSnapshotAction } from "./client/actions/match_page_image_snapshot_action.mjs";
+import { success } from "./client/expect/expectation_result.mjs";
+import { ImageSnapshotMatcher } from "./client/expect/to_match_image_snapshot.types.mjs";
+import { autoSnapshotMatcher } from "./client/suite/auto_snapshot_matcher.mjs";
+import { toTaskId } from "./client/task/task_id.mjs";
+export { Awaitable, BASELINE_DIR, ComparisonMethod, DIFF_DIR, FailureThresholdOptions, ImageSnapshotCompareOptions, ImageSnapshotComparisonInfo, ImageSnapshotKeyOptions, ImageSnapshotMatcher, ImageSnapshotSubjectOptions, ImageSnapshotTimeoutOptions, MatchImageSnapshotOptions, MetaTask, NAME, PageImageSnapshotOptions, PixelComparisonOptions, PixelDiffOptions, RESULT_DIR, SNAPSHOT_ROOT_DIR, SetupVisOptions, SnapshotTestMeta, SsimComparisonOptions, SsimDiffOptions, ToMatchImageSnapshotOptions, ToMatchPageImageSnapshotOptions, autoSnapshotMatcher, hasImageSnapshotAction, loadImageSnapshotResultsAction, matchImageSnapshotAction, matchPageImageSnapshotAction, setAutoSnapshotOptions, success, toTaskId };

package/dist/client-api.mjs

@@ -1,14 +1,11 @@
-import "./asserts--HSSlgPD.mjs";
-import { a as SNAPSHOT_ROOT_DIR, i as RESULT_DIR, n as DIFF_DIR, r as NAME, t as BASELINE_DIR } from "./constants-CTBaz8Ml.mjs";
-import { n as setAutoSnapshotOptions } from "./auto_snapshot_options-DUOTpF2N.mjs";
-import "./base64-CHSENEAO.mjs";
-import { a as matchImageSnapshotAction, i as matchPageImageSnapshotAction, n as toTaskId, o as hasImageSnapshotAction, r as success, t as autoSnapshotMatcher } from "./auto_snapshot_matcher-C0y6mAeS.mjs";
+import { BASELINE_DIR, DIFF_DIR, NAME, RESULT_DIR, SNAPSHOT_ROOT_DIR } from "./shared/constants.mjs";
+import { setAutoSnapshotOptions } from "./auto_snapshots/auto_snapshot_options.mjs";
+import { hasImageSnapshotAction } from "./client/actions/has_image_snapshot_action.mjs";
+import { loadImageSnapshotResultsAction } from "./client/actions/load_image_snapshot_results_action.mjs";
+import { matchImageSnapshotAction } from "./client/actions/match_image_snapshot_action.mjs";
+import { matchPageImageSnapshotAction } from "./client/actions/match_page_image_snapshot_action.mjs";
+import { success } from "./client/expect/expectation_result.mjs";
+import { toTaskId } from "./client/task/task_id.mjs";
+import { autoSnapshotMatcher } from "./client/suite/auto_snapshot_matcher.mjs";
 
-//#region src/client/actions/load_image_snapshot_results_action.ts
-function loadImageSnapshotResultsAction(commands, taskId) {
-	return commands.loadImageSnapshotResults(taskId);
-}
-
-//#endregion
-export { BASELINE_DIR, DIFF_DIR, NAME, RESULT_DIR, SNAPSHOT_ROOT_DIR, autoSnapshotMatcher, hasImageSnapshotAction, loadImageSnapshotResultsAction, matchImageSnapshotAction, matchPageImageSnapshotAction, setAutoSnapshotOptions, success, toTaskId };
-//# sourceMappingURL=client-api.mjs.map
+export { BASELINE_DIR, DIFF_DIR, NAME, RESULT_DIR, SNAPSHOT_ROOT_DIR, autoSnapshotMatcher, hasImageSnapshotAction, loadImageSnapshotResultsAction, matchImageSnapshotAction, matchPageImageSnapshotAction, setAutoSnapshotOptions, success, toTaskId };

package/dist/{types-DJYCbyT8.d.mts → config/types.d.mts}

@@ -1,4 +1,4 @@
-import { c as ImageSnapshotTimeoutOptions, f as PixelDiffOptions, g as SsimDiffOptions, n as ComparisonMethod, o as ImageSnapshotKeyOptions, r as FailureThresholdOptions, s as ImageSnapshotSubjectOptions } from "./types-CEmjj-A9.mjs";
+import { ComparisonMethod, FailureThresholdOptions, ImageSnapshotKeyOptions, ImageSnapshotSubjectOptions, ImageSnapshotTimeoutOptions, PixelComparisonOptions, PixelDiffOptions, SsimComparisonOptions, SsimDiffOptions } from "../shared/types.mjs";
 
 //#region src/config/types.d.ts
 type VisOptions<M extends ComparisonMethod = 'pixel'> = (M extends 'ssim' ? {
@@ -17,21 +17,20 @@ type VisOptions<M extends ComparisonMethod = 'pixel'> = (M extends 'ssim' ? {
   /**
    * Loads the `test.setupFiles` of the specified preset.
    *
-   * Note:
-   * - 'enable` is deprecated. Use `manual` for the same effect.
-   * - 'none` is deprecated. Use `custom` for the same effect.
-   *
    * @default 'auto'
-   *
+   * @deprecated 'enable' is deprecated. Use `manual` for the same effect.
+   * @deprecated 'none' is deprecated. Use `custom` for the same effect.
    */
   preset?: 'enable' | 'manual' | 'auto' | 'custom' | 'none' | undefined;
   /**
    * The snapshot folder relative to the root of the project.
    *
-   * Default: `{projectRoot}/__vis__/{platform}`
+   * @default "({ ci, platform }) => `__vis__/${ci ? platform : 'local'}`"
    */
   snapshotRootDir?: string | ((context: {
     ci: boolean;
+    rootDir: string;
+    projectName?: string | undefined;
     browserName?: string | undefined;
     providerName: string;
     platform: string;
@@ -59,5 +58,5 @@ type VisOptions<M extends ComparisonMethod = 'pixel'> = (M extends 'ssim' ? {
   }) => string) | undefined;
 };
 //#endregion
-export { VisOptions as t };
-//# sourceMappingURL=types-DJYCbyT8.d.mts.map
+export { VisOptions };
+//# sourceMappingURL=types.d.mts.map

package/dist/config/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/config/types.ts"],"sourcesContent":[],"mappings":";;;KAcY,qBAAqB,+BAA+B;EAApD,gBAAU,EAED,CAFC;EAAW;;;EAMR,WAAA,CAAA,EAAR,OAAQ,CAAA,eAAA,CAAA,GAAA,SAAA;CAAR,GAAA;EAGK,gBAAA,CAAA,EAAA,CAAA,GAAA,SAAA;EAIL;;;EAIhB,WAAA,CAAA,EAJgB,gBAIhB,GAAA,SAAA;CACA,CAAA,GAHA,uBAGA,GAFA,2BAEA,GADA,uBACA,GAAA,2BAAA,GAAA;EAA2B"}

package/dist/config/vis.d.mts

@@ -0,0 +1,27 @@
+import { ComparisonMethod } from "../shared/types.mjs";
+import { VisOptions } from "./types.mjs";
+import * as vite0 from "vite";
+
+//#region src/config/vis.d.ts
+
+/**
+ * Create a Vite plugin for visual testing.
+ *
+ * If options are not provided, the plugin will use the default options,
+ * which enables the `auto` preset.
+ */
+declare function vis<M extends ComparisonMethod = 'pixel'>(options?: VisOptions<M>): {
+  name: string;
+  config(this: unknown, userConfig: vite0.UserConfig): {
+    test: {
+      browser: {
+        name: undefined;
+        commands: any;
+      };
+      setupFiles: string[];
+    };
+  };
+};
+//#endregion
+export { vis };
+//# sourceMappingURL=vis.d.mts.map

package/dist/config/vis.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vis.d.mts","names":[],"sources":["../../src/config/vis.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAaA;;;AAAmE,iBAAnD,GAAmD,CAAA,UAArC,gBAAqC,GAAA,OAAA,CAAA,CAAA,OAAA,CAAA,EAAA,UAAA,CAAW,CAAX,CAAA,CAAA,EAAA;EAAU,IAGvD,EAAA,MAAA;EAAA,MAAA,CAAA,IAAA,EAAA,OAAA,EAAA,UAAA,EAHuD,KAAA,CAGvD,UAAA,CAAA,EAAA"}