@vscode/component-explorer-cli 0.1.1-0 → 0.1.1-10

package/dist/comparison.d.ts

@@ -0,0 +1,60 @@
+import type { Writable } from 'node:stream';
+export interface CompareReportFixtureDetail {
+    readonly status: 'added' | 'removed' | 'changed' | 'unchanged';
+    readonly baselineHash?: string;
+    readonly currentHash?: string;
+    readonly baselineScreenshot?: string;
+    readonly currentScreenshot?: string;
+    readonly background?: 'light' | 'dark';
+}
+export interface CompareReport {
+    readonly timestamp: string;
+    readonly baseline: string;
+    readonly current: string;
+    readonly summary: {
+        readonly total: number;
+        readonly added: number;
+        readonly removed: number;
+        readonly changed: number;
+        readonly unchanged: number;
+    };
+    readonly fixtures: Record<string, CompareReportFixtureDetail>;
+}
+export interface ComparisonResult {
+    readonly added: string[];
+    readonly removed: string[];
+    readonly changed: string[];
+    readonly unchanged: string[];
+    readonly fixtures: Record<string, CompareReportFixtureDetail>;
+}
+export interface ScreenshotData {
+    readonly data: Uint8Array;
+    readonly background?: 'light' | 'dark';
+}
+export interface ComparisonStorage {
+    list(): Promise<string[]>;
+    read(id: string): Promise<Uint8Array>;
+    exists(id: string): Promise<boolean>;
+}
+/**
+ * Compare screenshots between current and baseline.
+ * @param currentScreenshots Map of fixture IDs to screenshot data (already captured)
+ * @param baselineStorage Storage to read baseline screenshots from
+ */
+export declare function compareScreenshotsInMemory(currentScreenshots: Map<string, ScreenshotData>, baselineStorage: ComparisonStorage): Promise<ComparisonResult>;
+/**
+ * Compare screenshots between two directories on disk.
+ */
+export declare function compareScreenshotsOnDisk(currentStorage: ComparisonStorage, baselineStorage: ComparisonStorage, currentFiles: string[], baselineFiles: string[]): Promise<ComparisonResult>;
+export declare function printComparisonToConsole(result: ComparisonResult, stdout: Writable): void;
+export interface WriteReportOptions {
+    readonly reportDir: string;
+    readonly result: ComparisonResult;
+    readonly baselinePath: string;
+    readonly currentPath: string;
+    readonly getBaselineData: (fixtureId: string) => Promise<Uint8Array>;
+    readonly getCurrentData: (fixtureId: string) => Promise<Uint8Array>;
+}
+export declare function writeComparisonReport(options: WriteReportOptions): Promise<void>;
+export declare function generateMarkdownReport(report: CompareReport): string;
+//# sourceMappingURL=comparison.d.ts.map

package/dist/comparison.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison.d.ts","sourceRoot":"","sources":["../src/comparison.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC/D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAC/C,kBAAkB,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,EAC/C,eAAe,EAAE,iBAAiB,GAChC,OAAO,CAAC,gBAAgB,CAAC,CA+B3B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC7C,cAAc,EAAE,iBAAiB,EACjC,eAAe,EAAE,iBAAiB,EAClC,YAAY,EAAE,MAAM,EAAE,EACtB,aAAa,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CA4BzF;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,QAAQ,CAAC,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACpE;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDtF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiFpE"}

package/dist/comparison.js

@@ -0,0 +1,250 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { contentHash } from './screenshotCache.js';
+import { writeFile } from './utils.js';
+
+/**
+ * Compare screenshots between current and baseline.
+ * @param currentScreenshots Map of fixture IDs to screenshot data (already captured)
+ * @param baselineStorage Storage to read baseline screenshots from
+ */
+async function compareScreenshotsInMemory(currentScreenshots, baselineStorage) {
+    const added = [];
+    const changed = [];
+    const unchanged = [];
+    const fixtures = {};
+    for (const [fixtureId, screenshot] of currentScreenshots) {
+        const currentHash = contentHash(screenshot.data);
+        if (await baselineStorage.exists(`${fixtureId}.png`)) {
+            const baselineData = await baselineStorage.read(`${fixtureId}.png`);
+            const baselineHash = contentHash(baselineData);
+            if (currentHash === baselineHash) {
+                unchanged.push(fixtureId);
+                fixtures[fixtureId] = { status: 'unchanged', baselineHash, currentHash, background: screenshot.background };
+            }
+            else {
+                changed.push(fixtureId);
+                fixtures[fixtureId] = { status: 'changed', baselineHash, currentHash, background: screenshot.background };
+            }
+        }
+        else {
+            added.push(fixtureId);
+            fixtures[fixtureId] = { status: 'added', currentHash, background: screenshot.background };
+        }
+    }
+    added.sort();
+    changed.sort();
+    unchanged.sort();
+    return { added, removed: [], changed, unchanged, fixtures };
+}
+/**
+ * Compare screenshots between two directories on disk.
+ */
+async function compareScreenshotsOnDisk(currentStorage, baselineStorage, currentFiles, baselineFiles) {
+    const baselineSet = new Set(baselineFiles);
+    const currentSet = new Set(currentFiles);
+    const added = [];
+    const removed = [];
+    const changed = [];
+    const unchanged = [];
+    const fixtures = {};
+    for (const file of currentSet) {
+        const fixtureId = file.replace(/\.png$/, '');
+        if (!baselineSet.has(file)) {
+            added.push(fixtureId);
+            const currentData = await currentStorage.read(file);
+            fixtures[fixtureId] = { status: 'added', currentHash: contentHash(currentData) };
+        }
+        else {
+            const baselineData = await baselineStorage.read(file);
+            const currentData = await currentStorage.read(file);
+            const baselineHash = contentHash(baselineData);
+            const currentHash = contentHash(currentData);
+            if (baselineHash === currentHash) {
+                unchanged.push(fixtureId);
+                fixtures[fixtureId] = { status: 'unchanged', baselineHash, currentHash };
+            }
+            else {
+                changed.push(fixtureId);
+                fixtures[fixtureId] = { status: 'changed', baselineHash, currentHash };
+            }
+        }
+    }
+    for (const file of baselineSet) {
+        const fixtureId = file.replace(/\.png$/, '');
+        if (!currentSet.has(file)) {
+            removed.push(fixtureId);
+            const baselineData = await baselineStorage.read(file);
+            fixtures[fixtureId] = { status: 'removed', baselineHash: contentHash(baselineData) };
+        }
+    }
+    added.sort();
+    removed.sort();
+    changed.sort();
+    unchanged.sort();
+    return { added, removed, changed, unchanged, fixtures };
+}
+function printComparisonToConsole(result, stdout) {
+    if (result.added.length > 0) {
+        stdout.write(`Added (${result.added.length}):\n`);
+        for (const f of result.added) {
+            stdout.write(`  + ${f}\n`);
+        }
+    }
+    if (result.removed.length > 0) {
+        stdout.write(`Removed (${result.removed.length}):\n`);
+        for (const f of result.removed) {
+            stdout.write(`  - ${f}\n`);
+        }
+    }
+    if (result.changed.length > 0) {
+        stdout.write(`Changed (${result.changed.length}):\n`);
+        for (const f of result.changed) {
+            stdout.write(`  ~ ${f}\n`);
+        }
+    }
+    const total = result.added.length + result.removed.length + result.changed.length + result.unchanged.length;
+    stdout.write(`\nSummary: ${total} fixtures`);
+    if (result.added.length > 0 || result.removed.length > 0 || result.changed.length > 0) {
+        const parts = [];
+        if (result.added.length > 0)
+            parts.push(`${result.added.length} added`);
+        if (result.removed.length > 0)
+            parts.push(`${result.removed.length} removed`);
+        if (result.changed.length > 0)
+            parts.push(`${result.changed.length} changed`);
+        if (result.unchanged.length > 0)
+            parts.push(`${result.unchanged.length} unchanged`);
+        stdout.write(` (${parts.join(', ')})\n`);
+    }
+    else {
+        stdout.write(' — no differences\n');
+    }
+}
+async function writeComparisonReport(options) {
+    const { reportDir, result, baselinePath, currentPath, getBaselineData, getCurrentData } = options;
+    await fs.mkdir(reportDir, { recursive: true });
+    const screenshotsRelDir = 'screenshots';
+    const fixturesWithPaths = { ...result.fixtures };
+    for (const id of result.changed) {
+        const relBase = `${screenshotsRelDir}/${id}/baseline.png`;
+        const relCurrent = `${screenshotsRelDir}/${id}/current.png`;
+        const baselineData = await getBaselineData(id);
+        const currentData = await getCurrentData(id);
+        await writeFile(path.join(reportDir, relBase), baselineData);
+        await writeFile(path.join(reportDir, relCurrent), currentData);
+        fixturesWithPaths[id] = { ...fixturesWithPaths[id], baselineScreenshot: relBase, currentScreenshot: relCurrent };
+    }
+    for (const id of result.added) {
+        const relCurrent = `${screenshotsRelDir}/${id}/current.png`;
+        const currentData = await getCurrentData(id);
+        await writeFile(path.join(reportDir, relCurrent), currentData);
+        fixturesWithPaths[id] = { ...fixturesWithPaths[id], currentScreenshot: relCurrent };
+    }
+    for (const id of result.removed) {
+        const relBase = `${screenshotsRelDir}/${id}/baseline.png`;
+        const baselineData = await getBaselineData(id);
+        await writeFile(path.join(reportDir, relBase), baselineData);
+        fixturesWithPaths[id] = { ...fixturesWithPaths[id], baselineScreenshot: relBase };
+    }
+    const hasDiffs = result.added.length + result.removed.length + result.changed.length > 0;
+    const report = {
+        timestamp: new Date().toISOString(),
+        baseline: baselinePath,
+        current: currentPath,
+        summary: {
+            total: result.added.length + result.removed.length + result.changed.length + result.unchanged.length,
+            added: result.added.length,
+            removed: result.removed.length,
+            changed: result.changed.length,
+            unchanged: result.unchanged.length,
+        },
+        fixtures: fixturesWithPaths,
+    };
+    await fs.writeFile(path.join(reportDir, 'report.json'), JSON.stringify(report, null, 2));
+    if (hasDiffs) {
+        const markdown = generateMarkdownReport(report);
+        await fs.writeFile(path.join(reportDir, 'report.md'), markdown);
+    }
+}
+function generateMarkdownReport(report) {
+    const lines = [];
+    const changed = Object.entries(report.fixtures).filter(([, d]) => d.status === 'changed').map(([id]) => id);
+    const added = Object.entries(report.fixtures).filter(([, d]) => d.status === 'added').map(([id]) => id);
+    const removed = Object.entries(report.fixtures).filter(([, d]) => d.status === 'removed').map(([id]) => id);
+    const unchanged = Object.entries(report.fixtures).filter(([, d]) => d.status === 'unchanged').map(([id]) => id);
+    lines.push('# Screenshot Comparison Report');
+    lines.push('');
+    lines.push(`**Generated:** ${report.timestamp}`);
+    lines.push(`**Baseline:** \`${report.baseline}\``);
+    lines.push(`**Current:** \`${report.current}\``);
+    lines.push('');
+    lines.push('## Summary');
+    lines.push('');
+    lines.push('| Status | Count |');
+    lines.push('|--------|-------|');
+    if (added.length > 0)
+        lines.push(`| Added | ${added.length} |`);
+    if (removed.length > 0)
+        lines.push(`| Removed | ${removed.length} |`);
+    if (changed.length > 0)
+        lines.push(`| Changed | ${changed.length} |`);
+    lines.push(`| Unchanged | ${unchanged.length} |`);
+    lines.push(`| **Total** | **${report.summary.total}** |`);
+    lines.push('');
+    if (changed.length > 0) {
+        lines.push('## Changed Fixtures');
+        lines.push('');
+        for (const id of changed) {
+            const detail = report.fixtures[id];
+            lines.push(`### \`${id}\``);
+            lines.push('');
+            lines.push('| Baseline | Current |');
+            lines.push('|----------|---------|');
+            const baseImg = detail.baselineScreenshot ? `![baseline](${detail.baselineScreenshot})` : '-';
+            const curImg = detail.currentScreenshot ? `![current](${detail.currentScreenshot})` : '-';
+            lines.push(`| ${baseImg} | ${curImg} |`);
+            lines.push('');
+        }
+    }
+    if (added.length > 0) {
+        lines.push('## Added Fixtures');
+        lines.push('');
+        for (const id of added) {
+            const detail = report.fixtures[id];
+            lines.push(`### \`${id}\``);
+            lines.push('');
+            if (detail.currentScreenshot) {
+                lines.push(`![current](${detail.currentScreenshot})`);
+            }
+            lines.push('');
+        }
+    }
+    if (removed.length > 0) {
+        lines.push('## Removed Fixtures');
+        lines.push('');
+        for (const id of removed) {
+            const detail = report.fixtures[id];
+            lines.push(`### \`${id}\``);
+            lines.push('');
+            if (detail.baselineScreenshot) {
+                lines.push(`![baseline](${detail.baselineScreenshot})`);
+            }
+            lines.push('');
+        }
+    }
+    if (unchanged.length > 0) {
+        lines.push('<details>');
+        lines.push(`<summary>Unchanged Fixtures (${unchanged.length})</summary>`);
+        lines.push('');
+        for (const id of unchanged) {
+            lines.push(`- \`${id}\``);
+        }
+        lines.push('');
+        lines.push('</details>');
+    }
+    return lines.join('\n');
+}
+
+export { compareScreenshotsInMemory, compareScreenshotsOnDisk, generateMarkdownReport, printComparisonToConsole, writeComparisonReport };
+//# sourceMappingURL=comparison.js.map

package/dist/comparison.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comparison.js","sources":["../src/comparison.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/component-explorer-config.schema.json

@@ -0,0 +1,183 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "screenshotDir": {
+      "description": "Directory for storing screenshots (default: .screenshots)",
+      "type": "string"
+    },
+    "sessions": {
+      "minItems": 1,
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Unique session name"
+          },
+          "source": {
+            "anyOf": [
+              {
+                "type": "string",
+                "const": "current"
+              },
+              {
+                "type": "object",
+                "properties": {
+                  "worktree": {
+                    "type": "object",
+                    "properties": {
+                      "ref": {
+                        "type": "string",
+                        "description": "Git ref (branch, tag, or commit) to check out"
+                      },
+                      "name": {
+                        "description": "Directory name for the worktree (default: component-explorer-baseline)",
+                        "type": "string"
+                      },
+                      "install": {
+                        "anyOf": [
+                          {
+                            "type": "string",
+                            "const": "auto"
+                          },
+                          {
+                            "type": "string",
+                            "const": "npm"
+                          },
+                          {
+                            "type": "string",
+                            "const": "pnpm"
+                          },
+                          {
+                            "type": "string",
+                            "const": "yarn"
+                          },
+                          {
+                            "type": "object",
+                            "properties": {
+                              "command": {
+                                "type": "string",
+                                "description": "Custom install command to run in the worktree"
+                              }
+                            },
+                            "required": [
+                              "command"
+                            ],
+                            "additionalProperties": false
+                          },
+                          {
+                            "type": "boolean",
+                            "const": false
+                          }
+                        ],
+                        "description": "Dependency install strategy for the worktree"
+                      }
+                    },
+                    "required": [
+                      "ref"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Git worktree configuration for a baseline session"
+                  }
+                },
+                "required": [
+                  "worktree"
+                ],
+                "additionalProperties": false
+              }
+            ],
+            "description": "Session source: \"current\" for the working tree, or a worktree config for a baseline"
+          },
+          "viteConfig": {
+            "description": "Path to vite config file, relative to this config (overrides top-level viteConfig)",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name"
+        ],
+        "additionalProperties": false,
+        "description": "A component explorer session"
+      },
+      "description": "List of explorer sessions"
+    },
+    "compare": {
+      "type": "object",
+      "properties": {
+        "baseline": {
+          "type": "string",
+          "description": "Session name to use as the baseline for comparisons"
+        },
+        "current": {
+          "type": "string",
+          "description": "Session name to use as the current version for comparisons"
+        }
+      },
+      "required": [
+        "baseline",
+        "current"
+      ],
+      "additionalProperties": false,
+      "description": "Screenshot comparison configuration"
+    },
+    "viteConfig": {
+      "description": "Default vite config file path, relative to this config (default: vite.config.ts)",
+      "type": "string"
+    },
+    "vite": {
+      "type": "object",
+      "properties": {
+        "hmr": {
+          "type": "object",
+          "properties": {
+            "allowedPaths": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              },
+              "description": "Glob patterns for files that keep HMR; everything else triggers a full reload"
+            }
+          },
+          "required": [
+            "allowedPaths"
+          ],
+          "additionalProperties": false,
+          "description": "Vite HMR configuration"
+        }
+      },
+      "additionalProperties": false,
+      "description": "Vite configuration overrides"
+    },
+    "redirection": {
+      "type": "object",
+      "properties": {
+        "port": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 65535,
+          "description": "Port for the redirection HTTP server"
+        },
+        "host": {
+          "description": "Host to bind the redirection server to (default: localhost)",
+          "type": "string"
+        }
+      },
+      "required": [
+        "port"
+      ],
+      "additionalProperties": false,
+      "description": "HTTP redirection server that redirects to the session URL"
+    },
+    "$schema": {
+      "type": "string",
+      "description": "URL of the JSON Schema for this config file"
+    }
+  },
+  "required": [
+    "sessions"
+  ],
+  "additionalProperties": false,
+  "description": "Component Explorer configuration"
+}

package/dist/componentExplorer.d.ts

@@ -5,6 +5,7 @@ export interface FixtureInfo {
     readonly fixtureId: string;
     readonly fixtureName: string;
     readonly groupPath: string[];
+    readonly background: 'light' | 'dark';
 }
 export type FixtureId = {
     readonly fixtureId: string;
@@ -20,9 +21,47 @@ export interface CoverageFileEntry {
     readonly coveredLines: readonly number[];
     readonly uncoveredLines: readonly number[];
 }
+/**
+ * Error captured during fixture rendering.
+ * Can be either an unhandled exception or a console error/warning.
+ */
+export type ErrorInfo = ExceptionError | ConsoleError;
+/**
+ * Unhandled exception thrown during render.
+ */
+export interface ExceptionError {
+    readonly kind: 'exception';
+    readonly message: string;
+    readonly stack?: string;
+}
+/**
+ * Console error or warning captured during render.
+ */
+export interface ConsoleError {
+    readonly kind: 'console';
+    readonly level: 'error' | 'warn';
+    readonly message: string;
+}
+/**
+ * Result of taking a screenshot, including any errors captured during rendering.
+ */
+export interface ScreenshotResult {
+    readonly image: Uint8Array;
+    readonly errors: ErrorInfo[];
+}
+export interface StabilityScreenshot {
+    readonly image: Uint8Array;
+    readonly delayMs: number;
+}
+export interface StabilityCheckResult {
+    readonly screenshots: readonly StabilityScreenshot[];
+    readonly errors: ErrorInfo[];
+}
 export interface ComponentExplorer {
     listFixtures(): Promise<FixtureInfo[]>;
-    screenshotFixture(fixtureId: string): Promise<Uint8Array>;
+    screenshotFixture(fixtureId: string): Promise<ScreenshotResult>;
+    screenshotFixtureStabilityCheck(fixtureId: string): Promise<StabilityCheckResult>;
+    evaluateJs(expression: string, fixtureId?: string): Promise<unknown>;
     codeCoverage(id: FixtureId | FixtureGroupId): Promise<CoverageData>;
     waitForUpdate(timeoutMs?: number): Promise<void>;
     dispose(): Promise<void>;
@@ -33,12 +72,15 @@ export declare class BrowserComponentExplorer implements ComponentExplorer {
     private readonly _logger;
     private _page;
     private _lastState;
+    private _screenshotMutex;
     constructor(_browserPageFactory: BrowserPageFactory, _server: ComponentExplorerHttpServer, _logger?: ILogger);
     private _ensureReady;
     private _waitForCliApi;
     private _getState;
     listFixtures(): Promise<FixtureInfo[]>;
-    screenshotFixture(fixtureId: string): Promise<Uint8Array>;
+    screenshotFixture(fixtureId: string): Promise<ScreenshotResult>;
+    screenshotFixtureStabilityCheck(fixtureId: string): Promise<StabilityCheckResult>;
+    evaluateJs(expression: string, fixtureId?: string): Promise<unknown>;
     codeCoverage(_id: FixtureId | FixtureGroupId): Promise<CoverageData>;
     waitForUpdate(timeoutMs?: number): Promise<void>;
     dispose(): Promise<void>;

package/dist/componentExplorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"componentExplorer.d.ts","sourceRoot":"","sources":["../src/componentExplorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,MAAM,SAAS,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IACjC,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACvC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,YAAY,CAAC,EAAE,EAAE,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACpE,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAOD,qBAAa,wBAAyB,YAAW,iBAAiB;IAKhE,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IANzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,UAAU,CAAuB;gBAGvB,mBAAmB,EAAE,kBAAkB,EACvC,OAAO,EAAE,2BAA2B,EACpC,OAAO,GAAE,OAAoB;YAGjC,YAAY;YAUZ,cAAc;YAed,SAAS;IAOjB,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKtC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IASzD,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC;IAIpE,aAAa,CAAC,SAAS,SAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}
+{"version":3,"file":"componentExplorer.d.ts","sourceRoot":"","sources":["../src/componentExplorer.ts"],"names":[],"mappings":"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"}