@vscode/component-explorer-cli 0.1.1-2 → 0.1.1-20

package/LICENSE

@@ -0,0 +1,21 @@
+    MIT License
+
+    Copyright (c) Microsoft Corporation.
+
+    Permission is hereby granted, free of charge, to any person obtaining a copy
+    of this software and associated documentation files (the "Software"), to deal
+    in the Software without restriction, including without limitation the rights
+    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+    copies of the Software, and to permit persons to whom the Software is
+    furnished to do so, subject to the following conditions:
+
+    The above copyright notice and this permission notice shall be included in all
+    copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+    SOFTWARE

package/README.md

@@ -0,0 +1,177 @@
+# @vscode/component-explorer-cli
+
+Command-line tool for capturing, comparing, and managing component fixture screenshots.
+
+## Installation
+
+```bash
+npm install @vscode/component-explorer-cli
+```
+
+The binary is available as `component-explorer`.
+
+## Commands
+
+### `screenshot`
+
+Capture screenshots of all fixtures using a headless browser.
+
+```bash
+component-explorer screenshot [options]
+```
+
+| Option | Description |
+|---|---|
+| `-p, --project <path>` | Project: a directory, vite config file, or component-explorer.json (default: cwd) |
+| `--filter <pattern>` | Filter fixtures by glob pattern |
+| `--accept` | Write to baseline instead of current (mutually exclusive with `--target`) |
+| `--target <dir>` | Screenshot output directory (default: `.screenshots/current`, or `.screenshots/baseline` with `--accept`) |
+| `--compare` | Compare screenshots after capturing |
+| `--compare-target <dir>` | Directory to compare against (default: `.screenshots/baseline`, or `.screenshots/current` with `--accept`) |
+| `--report <dir>` | Output report folder with report.json, report.md, and changed screenshots (requires `--compare`) |
+| `-v, --verbose` | Increase log verbosity (`-v` debug, `-vv` trace) |
+
+```bash
+# Capture all fixtures
+component-explorer screenshot
+
+# Capture and accept as baseline
+component-explorer screenshot --accept
+
+# Capture, then compare against baseline
+component-explorer screenshot --compare
+
+# Filter by glob
+component-explorer screenshot --filter "Button/*"
+```
+
+### `screenshot:compare`
+
+Compare two screenshot directories (file-level hash comparison).
+
+```bash
+component-explorer screenshot:compare [options]
+```
+
+| Option | Description |
+|---|---|
+| `-p, --project <path>` | Project directory (default: cwd) |
+| `--baseline <dir>` | Baseline screenshots directory (default: `.screenshots/baseline`) |
+| `--current <dir>` | Current screenshots directory (default: `.screenshots/current`) |
+| `--filter <pattern>` | Filter fixtures by glob pattern |
+| `--report <dir>` | Output report folder (contains report.json, report.md, and changed screenshots) |
+| `-v, --verbose` | Increase log verbosity |
+
+Exits with code 1 if differences are found, 0 otherwise.
+
+```bash
+# Compare default directories
+component-explorer screenshot:compare
+
+# Compare with custom paths
+component-explorer screenshot:compare --baseline ./golden --current ./actual
+
+# Generate report folder
+component-explorer screenshot:compare --report ./report
+```
+
+### `screenshot:accept`
+
+Promote current screenshots to baseline by copying them from `.screenshots/current` to `.screenshots/baseline`.
+
+```bash
+component-explorer screenshot:accept [options]
+```
+
+| Option | Description |
+|---|---|
+| `-p, --project <path>` | Project directory (default: cwd) |
+| `--filter <pattern>` | Filter fixtures by glob pattern |
+| `--screenshot-dir <dir>` | Screenshots directory (default: `.screenshots`) |
+| `-v, --verbose` | Increase log verbosity |
+
+```bash
+# Accept all current screenshots as baseline
+component-explorer screenshot:accept
+
+# Accept specific fixtures
+component-explorer screenshot:accept --filter "Button/*"
+```
+
+### `watch`
+
+Watch for source changes and automatically re-capture/compare screenshots. Supports both simple mode (single project) and config mode (multiple sessions with git worktrees).
+
+```bash
+component-explorer watch [options]
+```
+
+| Option | Description |
+|---|---|
+| `-p, --project <path>` | Project: a directory, vite config file, or component-explorer.json (default: cwd) |
+| `-v, --verbose` | Increase log verbosity |
+
+In simple mode, starts a Vite dev server and re-captures screenshots on every HMR update. In config mode (when given a `component-explorer.json`), manages multiple sessions including git worktree-based baselines.
+
+```bash
+# Watch all fixtures
+component-explorer watch
+
+# Watch with config
+component-explorer watch -p component-explorer.json
+```
+
+### `serve`
+
+Start or attach to a Component Explorer daemon process. The daemon manages Vite servers and browser sessions in the background.
+
+```bash
+component-explorer serve -p <config> [options]
+```
+
+| Option | Description |
+|---|---|
+| `-p, --project, -c <path>` | **(required)** Path to a component-explorer.json config file |
+| `--background` | Spawn as a detached background process |
+| `--attach` | Attach to a running daemon and stream events |
+| `--kill` | Shut down a running daemon |
+| `-v, --verbose` | Increase log verbosity |
+
+Without flags, starts a foreground daemon. Combine `--background` and `--attach` to ensure a daemon is running and then stream its events.
+
+```bash
+# Start in foreground
+component-explorer serve -p config.json
+
+# Start in background
+component-explorer serve -p config.json --background
+
+# Attach to running daemon
+component-explorer serve -p config.json --attach
+
+# Ensure daemon + attach
+component-explorer serve -p config.json --background --attach
+
+# Kill running daemon
+component-explorer serve -p config.json --kill
+```
+
+### `mcp`
+
+Start a [Model Context Protocol](https://modelcontextprotocol.io/) server over stdio. Auto-starts a daemon if one is not already running.
+
+```bash
+component-explorer mcp -p <config>
+```
+
+| Option | Description |
+|---|---|
+| `-p, --project, -c <path>` | **(required)** Path to a component-explorer.json config file |
+
+```bash
+component-explorer mcp --project config.json
+```
+
+## Global Options
+
+All commands support `-v` / `--verbose` for increased log output. Use `-vv` for trace-level logging.

package/SECURITY.md

@@ -0,0 +1,14 @@
+<!-- BEGIN MICROSOFT SECURITY.MD V1.0.0 BLOCK -->
+
+## Security
+
+Microsoft takes the security of our software products and services seriously, which
+includes all source code repositories in our GitHub organizations.
+
+**Please do not report security vulnerabilities through public GitHub issues.**
+
+For security reporting information, locations, contact information, and policies,
+please review the latest guidance for Microsoft repositories at
+[https://aka.ms/SECURITY.md](https://aka.ms/SECURITY.md).
+
+<!-- END MICROSOFT SECURITY.MD BLOCK -->

package/dist/WorktreePool.d.ts

@@ -0,0 +1,22 @@
+export declare class WorktreeSlot {
+    readonly index: number;
+    readonly worktreePath: string;
+    private _assignedSession;
+    constructor(index: number, worktreePath: string);
+    get assignedSession(): string | undefined;
+    get isFree(): boolean;
+    assign(sessionName: string): void;
+    release(): void;
+    configDir(configDirRelToGitRoot: string): string;
+}
+export declare class WorktreePool {
+    readonly maxSlots: number;
+    private readonly _slots;
+    constructor(maxSlots: number, worktreeRoot: string);
+    allocate(sessionName: string): WorktreeSlot;
+    release(sessionName: string): void;
+    getSlot(sessionName: string): WorktreeSlot | undefined;
+    get freeSlotCount(): number;
+    get slots(): readonly WorktreeSlot[];
+}
+//# sourceMappingURL=WorktreePool.d.ts.map

package/dist/WorktreePool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorktreePool.d.ts","sourceRoot":"","sources":["../src/WorktreePool.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAIvB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM;IAJ9B,OAAO,CAAC,gBAAgB,CAAqB;gBAGnC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM;IAG9B,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAAkC;IAC3E,IAAI,MAAM,IAAI,OAAO,CAAgD;IAErE,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IACjC,OAAO,IAAI,IAAI;IAEf,SAAS,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM;CAGhD;AAED,qBAAa,YAAY;IAIvB,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAH1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;gBAGvC,QAAQ,EAAE,MAAM,EACzB,YAAY,EAAE,MAAM;IAOrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY;IAiB3C,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOlC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAItD,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,KAAK,IAAI,SAAS,YAAY,EAAE,CAEnC;CACD"}

package/dist/WorktreePool.js

@@ -0,0 +1,58 @@
+import * as path from 'node:path';
+
+class WorktreeSlot {
+    index;
+    worktreePath;
+    _assignedSession;
+    constructor(index, worktreePath) {
+        this.index = index;
+        this.worktreePath = worktreePath;
+    }
+    get assignedSession() { return this._assignedSession; }
+    get isFree() { return this._assignedSession === undefined; }
+    assign(sessionName) { this._assignedSession = sessionName; }
+    release() { this._assignedSession = undefined; }
+    configDir(configDirRelToGitRoot) {
+        return path.resolve(this.worktreePath, configDirRelToGitRoot);
+    }
+}
+class WorktreePool {
+    maxSlots;
+    _slots;
+    constructor(maxSlots, worktreeRoot) {
+        this.maxSlots = maxSlots;
+        this._slots = Array.from({ length: maxSlots }, (_, i) => new WorktreeSlot(i + 1, path.resolve(worktreeRoot, `component-explorer-${i + 1}`)));
+    }
+    allocate(sessionName) {
+        const existing = this._slots.find(s => s.assignedSession === sessionName);
+        if (existing) {
+            throw new Error(`Session "${sessionName}" already has a worktree slot allocated`);
+        }
+        const free = this._slots.find(s => s.isFree);
+        if (!free) {
+            const assigned = this._slots.map(s => `  slot ${s.index}: ${s.assignedSession}`).join('\n');
+            throw new Error(`No free worktree slots (max ${this.maxSlots}). ` +
+                `Close a session first.\nCurrently assigned:\n${assigned}`);
+        }
+        free.assign(sessionName);
+        return free;
+    }
+    release(sessionName) {
+        const slot = this._slots.find(s => s.assignedSession === sessionName);
+        if (slot) {
+            slot.release();
+        }
+    }
+    getSlot(sessionName) {
+        return this._slots.find(s => s.assignedSession === sessionName);
+    }
+    get freeSlotCount() {
+        return this._slots.filter(s => s.isFree).length;
+    }
+    get slots() {
+        return this._slots;
+    }
+}
+
+export { WorktreePool, WorktreeSlot };
+//# sourceMappingURL=WorktreePool.js.map

package/dist/WorktreePool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorktreePool.js","sources":["../src/WorktreePool.ts"],"sourcesContent":[null],"names":[],"mappings":";;MAEa,YAAY,CAAA;AAId,IAAA,KAAA;AACA,IAAA,YAAA;AAJF,IAAA,gBAAgB;IAExB,WAAA,CACU,KAAa,EACb,YAAoB,EAAA;QADpB,IAAA,CAAA,KAAK,GAAL,KAAK;QACL,IAAA,CAAA,YAAY,GAAZ,YAAY;IACnB;IAEH,IAAI,eAAe,KAAyB,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1E,IAAI,MAAM,GAAA,EAAc,OAAO,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC;IAEpE,MAAM,CAAC,WAAmB,EAAA,EAAU,IAAI,CAAC,gBAAgB,GAAG,WAAW,CAAC,CAAC;IACzE,OAAO,GAAA,EAAW,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAErD,IAAA,SAAS,CAAC,qBAA6B,EAAA;QACtC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,qBAAqB,CAAC;IAC9D;AACA;MAEY,YAAY,CAAA;AAId,IAAA,QAAA;AAHO,IAAA,MAAM;IAEvB,WAAA,CACU,QAAgB,EACzB,YAAoB,EAAA;QADX,IAAA,CAAA,QAAQ,GAAR,QAAQ;AAGjB,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KACnD,IAAI,YAAY,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAA,mBAAA,EAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAClF;IACF;AAEA,IAAA,QAAQ,CAAC,WAAmB,EAAA;AAC3B,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,KAAK,WAAW,CAAC;QACzE,IAAI,QAAQ,EAAE;AACb,YAAA,MAAM,IAAI,KAAK,CAAC,YAAY,WAAW,CAAA,uCAAA,CAAyC,CAAC;QAClF;AACA,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE;YACV,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA,OAAA,EAAU,CAAC,CAAC,KAAK,CAAA,EAAA,EAAK,CAAC,CAAC,eAAe,CAAA,CAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AAC3F,YAAA,MAAM,IAAI,KAAK,CACd,+BAA+B,IAAI,CAAC,QAAQ,CAAA,GAAA,CAAK;gBACjD,CAAA,6CAAA,EAAgD,QAAQ,CAAA,CAAE,CAC1D;QACF;AACA,QAAA,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;AACxB,QAAA,OAAO,IAAI;IACZ;AAEA,IAAA,OAAO,CAAC,WAAmB,EAAA;AAC1B,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,KAAK,WAAW,CAAC;QACrE,IAAI,IAAI,EAAE;YACT,IAAI,CAAC,OAAO,EAAE;QACf;IACD;AAEA,IAAA,OAAO,CAAC,WAAmB,EAAA;AAC1B,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,KAAK,WAAW,CAAC;IAChE;AAEA,IAAA,IAAI,aAAa,GAAA;AAChB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM;IAChD;AAEA,IAAA,IAAI,KAAK,GAAA;QACR,OAAO,IAAI,CAAC,MAAM;IACnB;AACA;;;;"}

package/dist/WorktreePool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorktreePool.test.d.ts.map

package/dist/WorktreePool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorktreePool.test.d.ts","sourceRoot":"","sources":["../src/WorktreePool.test.ts"],"names":[],"mappings":""}

package/dist/_virtual/_build-info.js

@@ -0,0 +1,4 @@
+var __buildInfo = {"version":"0.2.0","date":"2026-03-11T20:22:40.989Z"};
+
+export { __buildInfo as default };
+//# sourceMappingURL=_build-info.js.map

package/dist/_virtual/_build-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_build-info.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/browserPage.d.ts

@@ -1,3 +1,4 @@
+import { type ILogger } from './logger.js';
 export interface BrowserPageFactory {
     openPage(url: string): Promise<BrowserPage>;
     dispose(): Promise<void>;
@@ -8,7 +9,11 @@ export interface BrowserPage {
     dispose(): Promise<void>;
 }
 export declare class PlaywrightBrowserPageFactory implements BrowserPageFactory {
+    readonly headed: boolean;
+    readonly timeoutMs: number;
     private _browser;
+    private readonly _logger;
+    constructor(headed?: boolean, timeoutMs?: number, logger?: ILogger);
     openPage(url: string): Promise<BrowserPage>;
     dispose(): Promise<void>;
 }

package/dist/browserPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserPage.d.ts","sourceRoot":"","sources":["../src/browserPage.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC3B,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,UAAU,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,qBAAa,4BAA6B,YAAW,kBAAkB;IACtE,OAAO,CAAC,QAAQ,CAA2C;IAErD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAU3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}
+{"version":3,"file":"browserPage.d.ts","sourceRoot":"","sources":["../src/browserPage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,aAAa,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC3B,UAAU,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9C,UAAU,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,qBAAa,4BAA6B,YAAW,kBAAkB;IAI1D,QAAQ,CAAC,MAAM,EAAE,OAAO;IAAU,QAAQ,CAAC,SAAS,EAAE,MAAM;IAHxE,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEb,MAAM,GAAE,OAAe,EAAW,SAAS,GAAE,MAAe,EAAE,MAAM,CAAC,EAAE,OAAO;IAI7F,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA0B3C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI9B"}

package/dist/browserPage.js

@@ -1,12 +1,38 @@
+import { nullLogger } from './logger.js';
+
 class PlaywrightBrowserPageFactory {
+    headed;
+    timeoutMs;
     _browser;
+    _logger;
+    constructor(headed = false, timeoutMs = 30_000, logger) {
+        this.headed = headed;
+        this.timeoutMs = timeoutMs;
+        this._logger = logger ?? nullLogger;
+    }
     async openPage(url) {
         if (!this._browser) {
             const { chromium } = await import('playwright');
-            this._browser = await chromium.launch();
+            this._browser = await chromium.launch({ headless: !this.headed });
         }
         const page = await this._browser.newPage();
-        await page.goto(url, { waitUntil: 'networkidle' });
+        page.on('console', (msg) => {
+            const type = msg.type();
+            const text = msg.text();
+            if (type === 'error') {
+                this._logger.debug(`[browser] error: ${text}`);
+            }
+            else if (type === 'warning') {
+                this._logger.debug(`[browser] warn: ${text}`);
+            }
+            else {
+                this._logger.trace(`[browser] ${type}: ${text}`);
+            }
+        });
+        page.on('pageerror', (err) => {
+            this._logger.debug(`[browser] uncaught error: ${err.message}`);
+        });
+        await page.goto(url, { waitUntil: 'networkidle', timeout: this.timeoutMs });
         return new PlaywrightBrowserPage(page);
     }
     async dispose() {

package/dist/browserPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserPage.js","sources":["../src/browserPage.ts"],"sourcesContent":[null],"names":[],"mappings":"MAWa,4BAA4B,CAAA;AAChC,IAAA,QAAQ;IAEhB,MAAM,QAAQ,CAAC,GAAW,EAAA;AACzB,QAAA,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,OAAO,YAAY,CAAC;YAC/C,IAAI,CAAC,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE;QACxC;QACA,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;AAC1C,QAAA,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAClD,QAAA,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC;IACvC;AAEA,IAAA,MAAM,OAAO,GAAA;AACZ,QAAA,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE;AAC5B,QAAA,IAAI,CAAC,QAAQ,GAAG,SAAS;IAC1B;AACA;AAED,MAAM,qBAAqB,CAAA;AACG,IAAA,KAAA;AAA7B,IAAA,WAAA,CAA6B,KAAgC,EAAA;QAAhC,IAAA,CAAA,KAAK,GAAL,KAAK;IAA8B;IAEhE,MAAM,UAAU,CAAI,UAAkB,EAAA;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAe;IACrD;IAEA,MAAM,UAAU,CAAC,iBAAyB,EAAA;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC;AACjE,QAAA,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE;QAClC,IAAI,CAAC,OAAO,EAAE;AACb,YAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,iBAAiB,CAAA,CAAE,CAAC;QACjF;;AAEA,QAAA,MAAM,MAAM,GAAG,MAAO,OAA8E,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAChI,QAAA,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC;IAC9B;AAEA,IAAA,MAAM,OAAO,GAAA;AACZ,QAAA,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;IACzB;AACA;;;;"}
+{"version":3,"file":"browserPage.js","sources":["../src/browserPage.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/commands/acceptCommand.d.ts

@@ -4,7 +4,8 @@ export declare class AcceptCommand extends Command {
     static usage: import("clipanion").Usage;
     readonly verbose: number;
     readonly filter: string | undefined;
-    readonly root: string;
+    readonly project: string;
+    readonly screenshotDir: string;
     execute(): Promise<void>;
 }
 //# sourceMappingURL=acceptCommand.d.ts.map

package/dist/commands/acceptCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acceptCommand.d.ts","sourceRoot":"","sources":["../../src/commands/acceptCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,qBAAa,aAAc,SAAQ,OAAO;IACzC,OAAgB,KAAK,aAAgB;IAErC,OAAgB,KAAK,4BAMlB;IAEH,QAAQ,CAAC,OAAO,SAAsG;IACtH,QAAQ,CAAC,MAAM,qBAAkG;IACjH,QAAQ,CAAC,IAAI,SAAqF;IAE5F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA2B9B"}
+{"version":3,"file":"acceptCommand.d.ts","sourceRoot":"","sources":["../../src/commands/acceptCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAM5C,qBAAa,aAAc,SAAQ,OAAO;IACzC,OAAgB,KAAK,aAA2B;IAEhD,OAAgB,KAAK,4BAMlB;IAEH,QAAQ,CAAC,OAAO,SAAsG;IACtH,QAAQ,CAAC,MAAM,qBAAkG;IACjH,QAAQ,CAAC,OAAO,SAAuI;IACvJ,QAAQ,CAAC,aAAa,SAA+F;IAE/G,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA+B9B"}

package/dist/commands/acceptCommand.js

@@ -1,22 +1,29 @@
 import { Command, Option } from 'clipanion';
-import { ConsoleLogger, verbosityToLogLevel } from '../logger.js';
+import * as path from 'node:path';
+import { ConsoleLogger, verbosityToLogLevel, logBuildInfo } from '../logger.js';
 import { FileSystemStorage } from '../storage.js';
+import { resolveProject } from '../resolveProject.js';
 
 class AcceptCommand extends Command {
-    static paths = [['accept']];
+    static paths = [['screenshot:accept']];
     static usage = Command.Usage({
-        description: 'Promote current screenshots as baseline',
+        description: 'Promote current screenshots to baseline (file-level only)',
         examples: [
-            ['Accept all', '$0 accept'],
-            ['Accept specific fixtures', '$0 accept --filter "Button/*"'],
+            ['Accept all', '$0 screenshot:accept'],
+            ['Accept specific fixtures', '$0 screenshot:accept --filter "Button/*"'],
         ],
     });
     verbose = Option.Counter('-v,--verbose', 0, { description: 'Increase log verbosity (-v debug, -vv trace)' });
     filter = Option.String('--filter', { required: false, description: 'Filter fixtures by glob pattern' });
-    root = Option.String('--root', process.cwd(), { description: 'Project root directory' });
+    project = Option.String('-p,--project', process.cwd(), { description: 'Project: a directory, vite config file, or component-explorer.json' });
+    screenshotDir = Option.String('--screenshot-dir', '.screenshots', { description: 'Screenshots directory' });
     async execute() {
-        new ConsoleLogger('accept', this.context.stdout, verbosityToLogLevel(this.verbose));
-        const storage = new FileSystemStorage(`${this.root}/.screenshots`);
+        const resolved = await resolveProject(this.project);
+        const projectDir = resolved.projectDir;
+        const _logger = new ConsoleLogger('accept', this.context.stdout, verbosityToLogLevel(this.verbose));
+        logBuildInfo(_logger);
+        const screenshotPath = path.isAbsolute(this.screenshotDir) ? this.screenshotDir : path.join(projectDir, this.screenshotDir);
+        const storage = new FileSystemStorage(screenshotPath);
         let currentFiles = await storage.list('current');
         if (this.filter) {
             const regex = new RegExp('^current/' + this.filter.replace(/\*/g, '.*').replace(/\?/g, '.') + '$');

package/dist/commands/acceptCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"acceptCommand.js","sources":["../../src/commands/acceptCommand.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAIM,MAAO,aAAc,SAAQ,OAAO,CAAA;IACzC,OAAgB,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;AAEpC,IAAA,OAAgB,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AACrC,QAAA,WAAW,EAAE,yCAAyC;AACtD,QAAA,QAAQ,EAAE;YACT,CAAC,YAAY,EAAE,WAAW,CAAC;YAC3B,CAAC,0BAA0B,EAAE,+BAA+B,CAAC;AAC7D,SAAA;AACD,KAAA,CAAC;AAEO,IAAA,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;AAC5G,IAAA,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;AACvG,IAAA,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;AAEjG,IAAA,MAAM,OAAO,GAAA;QACI,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;QAClG,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,CAAA,EAAG,IAAI,CAAC,IAAI,CAAA,aAAA,CAAe,CAAC;QAElE,IAAI,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;AAEhD,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;YAChB,MAAM,KAAK,GAAG,IAAI,MAAM,CACvB,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,GAAG,CACxE;AACD,YAAA,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD;AAEA,QAAA,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC;YAChE;QACD;AAEA,QAAA,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE;YAChC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACrC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAA,SAAA,EAAY,YAAY,CAAA,CAAE,EAAE,IAAI,CAAC;YACrD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA,IAAA,EAAO,YAAY,CAAA,EAAA,CAAI,CAAC;QACnD;AAEA,QAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA,WAAA,EAAc,YAAY,CAAC,MAAM,CAAA,6BAAA,CAA+B,CAAC;IAC5F;;;;;"}
+{"version":3,"file":"acceptCommand.js","sources":["../../src/commands/acceptCommand.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/commands/checkStabilityCommand.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'clipanion';
+export declare class CheckStabilityCommand extends Command {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    readonly verbose: number;
+    readonly project: string;
+    readonly labelPattern: string | undefined;
+    readonly headed: boolean;
+    readonly timeout: string;
+    execute(): Promise<number>;
+}
+//# sourceMappingURL=checkStabilityCommand.d.ts.map

package/dist/commands/checkStabilityCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkStabilityCommand.d.ts","sourceRoot":"","sources":["../../src/commands/checkStabilityCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAQ5C,qBAAa,qBAAsB,SAAQ,OAAO;IACjD,OAAgB,KAAK,aAAyB;IAE9C,OAAgB,KAAK,4BAMlB;IAEH,QAAQ,CAAC,OAAO,SAAsG;IACtH,QAAQ,CAAC,OAAO,SAAuI;IACvJ,QAAQ,CAAC,YAAY,qBAA+I;IACpK,QAAQ,CAAC,MAAM,UAAwG;IACvH,QAAQ,CAAC,OAAO,SAA+G;IAEzH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAwEhC"}

package/dist/commands/checkStabilityCommand.js

@@ -0,0 +1,84 @@
+import { Command, Option } from 'clipanion';
+import { PlaywrightBrowserPageFactory } from '../browserPage.js';
+import { BrowserComponentExplorer } from '../componentExplorer.js';
+import { DefaultComponentExplorerHttpServerFactory } from '../httpServer.js';
+import { ConsoleLogger, verbosityToLogLevel, logBuildInfo } from '../logger.js';
+import { resolveProject, resolvedProjectToViteProjectRef } from '../resolveProject.js';
+import { contentHash } from '../screenshotCache.js';
+
+class CheckStabilityCommand extends Command {
+    static paths = [['check-stability']];
+    static usage = Command.Usage({
+        description: 'Check rendering stability of fixtures (outputs JSON)',
+        examples: [
+            ['Check all fixtures', '$0 check-stability'],
+            ['Filter by label', '$0 check-stability --label-pattern "theme:dark"'],
+        ],
+    });
+    verbose = Option.Counter('-v,--verbose', 0, { description: 'Increase log verbosity (-v debug, -vv trace)' });
+    project = Option.String('-p,--project', process.cwd(), { description: 'Project: a directory, vite config file, or component-explorer.json' });
+    labelPattern = Option.String('--label-pattern', { required: false, description: 'RegExp to filter fixtures by label (matched against inherited labels)' });
+    headed = Option.Boolean('--headed', false, { description: 'Show the browser window (useful for debugging)' });
+    timeout = Option.String('--timeout', '30000', { description: 'Navigation timeout in milliseconds (default: 30000)' });
+    async execute() {
+        const logger = new ConsoleLogger('check-stability', this.context.stderr, verbosityToLogLevel(this.verbose));
+        logBuildInfo(logger);
+        let labelRegex;
+        if (this.labelPattern) {
+            try {
+                labelRegex = new RegExp(this.labelPattern);
+            }
+            catch {
+                this.context.stderr.write(`Error: Invalid label pattern: ${this.labelPattern}\n`);
+                return 1;
+            }
+        }
+        const resolved = await resolveProject(this.project);
+        const viteProject = resolvedProjectToViteProjectRef(resolved);
+        const serverFactory = new DefaultComponentExplorerHttpServerFactory();
+        const browserFactory = new PlaywrightBrowserPageFactory(this.headed, Number(this.timeout));
+        let server;
+        let explorer;
+        try {
+            this.context.stderr.write('Starting Vite dev server...\n');
+            server = await serverFactory.createViteServer(viteProject, { logger });
+            this.context.stderr.write(`Server running at ${server.url}\n`);
+            explorer = new BrowserComponentExplorer(browserFactory, server, logger);
+            const allFixtures = await explorer.listFixtures();
+            const fixtures = labelRegex
+                ? allFixtures.filter(f => f.labels.some(l => labelRegex.test(l)))
+                : allFixtures;
+            this.context.stderr.write(`Found ${fixtures.length} fixture(s)${labelRegex ? ` (filtered from ${allFixtures.length})` : ''}\n`);
+            const results = [];
+            for (let i = 0; i < fixtures.length; i++) {
+                const fixture = fixtures[i];
+                this.context.stderr.write(`[${i + 1}/${fixtures.length}] Checking ${fixture.fixtureId}...`);
+                const result = await explorer.screenshotFixtureStabilityCheck(fixture.fixtureId);
+                const hashes = result.screenshots.map(s => contentHash(s.image));
+                const isStable = hashes[0] === hashes[1] && hashes[1] === hashes[2];
+                results.push({
+                    fixtureId: fixture.fixtureId,
+                    isStable,
+                    screenshots: result.screenshots.map((s, j) => ({ hash: hashes[j], delayMs: s.delayMs })),
+                });
+                this.context.stderr.write(` ${isStable ? 'stable' : 'UNSTABLE'}\n`);
+            }
+            const stable = results.filter(r => r.isStable).length;
+            const unstable = results.length - stable;
+            const output = {
+                fixtures: results,
+                summary: { total: results.length, stable, unstable },
+            };
+            this.context.stdout.write(JSON.stringify(output, null, 2) + '\n');
+            return unstable > 0 ? 1 : 0;
+        }
+        finally {
+            await explorer?.dispose();
+            await browserFactory.dispose();
+            await server?.dispose();
+        }
+    }
+}
+
+export { CheckStabilityCommand };
+//# sourceMappingURL=checkStabilityCommand.js.map

package/dist/commands/checkStabilityCommand.js.map

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

package/dist/commands/compareCommand.d.ts

@@ -3,7 +3,11 @@ export declare class CompareCommand extends Command {
     static paths: string[][];
     static usage: import("clipanion").Usage;
     readonly verbose: number;
-    readonly root: string;
+    readonly filter: string | undefined;
+    readonly project: string;
+    readonly baseline: string;
+    readonly current: string;
+    readonly report: string | undefined;
     execute(): Promise<number>;
 }
 //# sourceMappingURL=compareCommand.d.ts.map

package/dist/commands/compareCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compareCommand.d.ts","sourceRoot":"","sources":["../../src/commands/compareCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAI5C,qBAAa,cAAe,SAAQ,OAAO;IAC1C,OAAgB,KAAK,aAAiB;IAEtC,OAAgB,KAAK,4BAKlB;IAEH,QAAQ,CAAC,OAAO,SAAsG;IACtH,QAAQ,CAAC,IAAI,SAAqF;IAE5F,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAiEhC"}
+{"version":3,"file":"compareCommand.d.ts","sourceRoot":"","sources":["../../src/commands/compareCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAS5C,qBAAa,cAAe,SAAQ,OAAO;IAC1C,OAAgB,KAAK,aAA4B;IAEjD,OAAgB,KAAK,4BAOlB;IAEH,QAAQ,CAAC,OAAO,SAAsG;IACtH,QAAQ,CAAC,MAAM,qBAAkG;IACjH,QAAQ,CAAC,OAAO,SAAuI;IACvJ,QAAQ,CAAC,QAAQ,SAA2G;IAC5H,QAAQ,CAAC,OAAO,SAAwG;IACxH,QAAQ,CAAC,MAAM,qBAAkJ;IAE3J,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAoDhC"}