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

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/dist/browserPage.js

@@ -1,4 +1,4 @@
-export class PlaywrightBrowserPageFactory {
+class PlaywrightBrowserPageFactory {
     _browser;
     async openPage(url) {
         if (!this._browser) {
@@ -36,4 +36,6 @@ class PlaywrightBrowserPage {
         await this._page.close();
     }
 }
-//# sourceMappingURL=browserPage.js.map
+
+export { PlaywrightBrowserPageFactory };
+//# sourceMappingURL=browserPage.js.map

package/dist/browserPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"browserPage.js","sourceRoot":"","sources":["../src/browserPage.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,4BAA4B;IAChC,QAAQ,CAA2C;IAE3D,KAAK,CAAC,QAAQ,CAAC,GAAW;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;QACnD,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;IAC3B,CAAC;CACD;AAED,MAAM,qBAAqB;IACG;IAA7B,YAA6B,KAAgC;QAAhC,UAAK,GAAL,KAAK,CAA2B;IAAG,CAAC;IAEjE,KAAK,CAAC,UAAU,CAAI,UAAkB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAe,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,iBAAyB;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,iBAAiB,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,0FAA0F;QAC1F,MAAM,MAAM,GAAG,MAAO,OAA8E,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjI,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,OAAO;QACZ,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACD"}
+{"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;;;;"}

package/dist/commands/acceptCommand.d.ts

@@ -2,8 +2,10 @@ import { Command } from 'clipanion';
 export declare class AcceptCommand extends Command {
     static paths: string[][];
     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;AAG5C,qBAAa,aAAc,SAAQ,OAAO;IACzC,OAAgB,KAAK,aAAgB;IAErC,OAAgB,KAAK,4BAMlB;IAEH,QAAQ,CAAC,MAAM,qBAAkG;IACjH,QAAQ,CAAC,IAAI,SAAqF;IAE5F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA0B9B"}
+{"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;CA8B9B"}

package/dist/commands/acceptCommand.js

@@ -1,18 +1,28 @@
 import { Command, Option } from 'clipanion';
+import * as path from 'node:path';
+import { ConsoleLogger, verbosityToLogLevel } from '../logger.js';
 import { FileSystemStorage } from '../storage.js';
-export class AcceptCommand extends Command {
-    static paths = [['accept']];
+import { resolveProject } from '../resolveProject.js';
+
+class AcceptCommand extends Command {
+    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() {
-        const storage = new FileSystemStorage(`${this.root}/.screenshots`);
+        const resolved = await resolveProject(this.project);
+        const projectDir = resolved.projectDir;
+        new ConsoleLogger('accept', this.context.stdout, verbosityToLogLevel(this.verbose));
+        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, '.') + '$');
@@ -31,4 +41,6 @@ export class AcceptCommand extends Command {
         this.context.stdout.write(`\nAccepted ${currentFiles.length} screenshot(s) as baseline.\n`);
     }
 }
-//# sourceMappingURL=acceptCommand.js.map
+
+export { AcceptCommand };
+//# sourceMappingURL=acceptCommand.js.map

package/dist/commands/acceptCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"acceptCommand.js","sourceRoot":"","sources":["../../src/commands/acceptCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,OAAO,aAAc,SAAQ,OAAO;IACzC,MAAM,CAAU,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAErC,MAAM,CAAU,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QACrC,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE;YACT,CAAC,YAAY,EAAE,WAAW,CAAC;YAC3B,CAAC,0BAA0B,EAAE,+BAA+B,CAAC;SAC7D;KACD,CAAC,CAAC;IAEM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC,CAAC;IACxG,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAElG,KAAK,CAAC,OAAO;QACZ,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,GAAG,IAAI,CAAC,IAAI,eAAe,CAAC,CAAC;QAEnE,IAAI,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,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,CAAC;YACF,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACjE,OAAO;QACR,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,OAAO,CAAC,KAAK,CAAC,YAAY,YAAY,EAAE,EAAE,IAAI,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,YAAY,IAAI,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,YAAY,CAAC,MAAM,+BAA+B,CAAC,CAAC;IAC7F,CAAC"}
+{"version":3,"file":"acceptCommand.js","sources":["../../src/commands/acceptCommand.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAMM,MAAO,aAAc,SAAQ,OAAO,CAAA;IACzC,OAAgB,KAAK,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC;AAE/C,IAAA,OAAgB,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AACrC,QAAA,WAAW,EAAE,2DAA2D;AACxE,QAAA,QAAQ,EAAE;YACT,CAAC,YAAY,EAAE,sBAAsB,CAAC;YACtC,CAAC,0BAA0B,EAAE,0CAA0C,CAAC;AACxE,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,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,oEAAoE,EAAE,CAAC;AAC7I,IAAA,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,cAAc,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;AAEpH,IAAA,MAAM,OAAO,GAAA;QACZ,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AACnD,QAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU;QACtB,IAAI,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;AAClG,QAAA,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;AAC3H,QAAA,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,cAAc,CAAC;QAErD,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;;;;;"}

package/dist/commands/compareCommand.d.ts

@@ -2,7 +2,12 @@ import { Command } from 'clipanion';
 export declare class CompareCommand extends Command {
     static paths: string[][];
     static usage: import("clipanion").Usage;
-    readonly root: string;
+    readonly verbose: number;
+    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;AAG5C,qBAAa,cAAe,SAAQ,OAAO;IAC1C,OAAgB,KAAK,aAAiB;IAEtC,OAAgB,KAAK,4BAKlB;IAEH,QAAQ,CAAC,IAAI,SAAqF;IAE5F,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAgEhC"}
+{"version":3,"file":"compareCommand.d.ts","sourceRoot":"","sources":["../../src/commands/compareCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAQ5C,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;CA+ChC"}

package/dist/commands/compareCommand.js

@@ -1,84 +1,62 @@
 import { Command, Option } from 'clipanion';
+import * as path from 'node:path';
+import { compareScreenshotsOnDisk, printComparisonToConsole, writeComparisonReport } from '../comparison.js';
+import { ConsoleLogger, verbosityToLogLevel } from '../logger.js';
 import { FileSystemStorage } from '../storage.js';
-export class CompareCommand extends Command {
-    static paths = [['compare']];
+import { resolveProject } from '../resolveProject.js';
+import { listPngFiles, matchGlob } from '../utils.js';
+
+class CompareCommand extends Command {
+    static paths = [['screenshot:compare']];
     static usage = Command.Usage({
-        description: 'Compare current screenshots against baseline',
+        description: 'Compare screenshot directories (file-level only)',
         examples: [
-            ['Compare default directories', '$0 compare'],
+            ['Compare default directories', '$0 screenshot:compare'],
+            ['Compare with custom paths', '$0 screenshot:compare --baseline ./golden --current ./actual'],
+            ['Generate report folder', '$0 screenshot:compare --report ./report'],
         ],
     });
-    root = Option.String('--root', process.cwd(), { description: 'Project root directory' });
+    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' });
+    project = Option.String('-p,--project', process.cwd(), { description: 'Project: a directory, vite config file, or component-explorer.json' });
+    baseline = Option.String('--baseline', '.screenshots/baseline', { description: 'Baseline screenshots directory' });
+    current = Option.String('--current', '.screenshots/current', { description: 'Current screenshots directory' });
+    report = Option.String('--report', { required: false, description: 'Output report folder (contains report.json, report.md, and changed screenshots)' });
     async execute() {
-        const storage = new FileSystemStorage(`${this.root}/.screenshots`);
-        const baselineFiles = await storage.list('baseline');
-        const currentFiles = await storage.list('current');
-        const baselineSet = new Set(baselineFiles.map(f => f.replace('baseline/', '')));
-        const currentSet = new Set(currentFiles.map(f => f.replace('current/', '')));
-        const added = [];
-        const removed = [];
-        const changed = [];
-        const unchanged = [];
-        for (const file of currentSet) {
-            if (!baselineSet.has(file)) {
-                added.push(file);
-            }
-            else {
-                const baselineData = await storage.read(`baseline/${file}`);
-                const currentData = await storage.read(`current/${file}`);
-                if (buffersEqual(baselineData, currentData)) {
-                    unchanged.push(file);
-                }
-                else {
-                    changed.push(file);
-                }
-            }
+        const resolved = await resolveProject(this.project);
+        const projectDir = resolved.projectDir;
+        new ConsoleLogger('compare', this.context.stdout, verbosityToLogLevel(this.verbose));
+        const baselineDir = path.isAbsolute(this.baseline) ? this.baseline : path.join(projectDir, this.baseline);
+        const currentDir = path.isAbsolute(this.current) ? this.current : path.join(projectDir, this.current);
+        const baselineStorage = new FileSystemStorage(baselineDir);
+        const currentStorage = new FileSystemStorage(currentDir);
+        // List all PNG files
+        let baselineFiles = await listPngFiles(baselineDir);
+        let currentFiles = await listPngFiles(currentDir);
+        // Apply filter if specified
+        if (this.filter) {
+            const filterFn = (file) => matchGlob(file.replace(/\.png$/, ''), this.filter);
+            baselineFiles = baselineFiles.filter(filterFn);
+            currentFiles = currentFiles.filter(filterFn);
         }
-        for (const file of baselineSet) {
-            if (!currentSet.has(file)) {
-                removed.push(file);
-            }
+        const result = await compareScreenshotsOnDisk({ list: async () => currentFiles, read: (id) => currentStorage.read(id), exists: (id) => currentStorage.exists(id) }, { list: async () => baselineFiles, read: (id) => baselineStorage.read(id), exists: (id) => baselineStorage.exists(id) }, currentFiles, baselineFiles);
+        printComparisonToConsole(result, this.context.stdout);
+        if (this.report) {
+            const reportDir = path.isAbsolute(this.report) ? this.report : path.join(process.cwd(), this.report);
+            await writeComparisonReport({
+                reportDir,
+                result,
+                baselinePath: this.baseline,
+                currentPath: this.current,
+                getBaselineData: (id) => baselineStorage.read(`${id}.png`),
+                getCurrentData: (id) => currentStorage.read(`${id}.png`),
+            });
+            this.context.stdout.write(`\nReport written to: ${this.report}/\n`);
         }
-        if (added.length > 0) {
-            this.context.stdout.write(`Added (${added.length}):\n`);
-            for (const f of added) {
-                this.context.stdout.write(`  + ${f}\n`);
-            }
-        }
-        if (removed.length > 0) {
-            this.context.stdout.write(`Removed (${removed.length}):\n`);
-            for (const f of removed) {
-                this.context.stdout.write(`  - ${f}\n`);
-            }
-        }
-        if (changed.length > 0) {
-            this.context.stdout.write(`Changed (${changed.length}):\n`);
-            for (const f of changed) {
-                this.context.stdout.write(`  ~ ${f}\n`);
-            }
-        }
-        if (unchanged.length > 0) {
-            this.context.stdout.write(`Unchanged (${unchanged.length}):\n`);
-            for (const f of unchanged) {
-                this.context.stdout.write(`  = ${f}\n`);
-            }
-        }
-        const hasDiffs = added.length > 0 || removed.length > 0 || changed.length > 0;
-        if (hasDiffs) {
-            this.context.stdout.write('\nDifferences found.\n');
-            return 1;
-        }
-        this.context.stdout.write('\nNo differences.\n');
-        return 0;
-    }
-}
-function buffersEqual(a, b) {
-    if (a.length !== b.length)
-        return false;
-    for (let i = 0; i < a.length; i++) {
-        if (a[i] !== b[i])
-            return false;
+        const hasDiffs = result.added.length > 0 || result.removed.length > 0 || result.changed.length > 0;
+        return hasDiffs ? 1 : 0;
     }
-    return true;
 }
-//# sourceMappingURL=compareCommand.js.map
+
+export { CompareCommand };
+//# sourceMappingURL=compareCommand.js.map

package/dist/commands/compareCommand.js.map

@@ -1 +1 @@
-{"version":3,"file":"compareCommand.js","sourceRoot":"","sources":["../../src/commands/compareCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,OAAO,cAAe,SAAQ,OAAO;IAC1C,MAAM,CAAU,KAAK,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtC,MAAM,CAAU,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QACrC,WAAW,EAAE,8CAA8C;QAC3D,QAAQ,EAAE;YACT,CAAC,6BAA6B,EAAE,YAAY,CAAC;SAC7C;KACD,CAAC,CAAC;IAEM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC,CAAC;IAElG,KAAK,CAAC,OAAO;QACZ,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,GAAG,IAAI,CAAC,IAAI,eAAe,CAAC,CAAC;QAEnE,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAE7E,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC/B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;iBAAM,CAAC;gBACP,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;gBAC5D,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;gBAC1D,IAAI,YAAY,CAAC,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC;oBAC7C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpB,CAAC;YACF,CAAC;QACF,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACF,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,MAAM,MAAM,CAAC,CAAC;YACxD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;QACpE,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;QACtE,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,OAAO,CAAC,MAAM,MAAM,CAAC,CAAC;YAC5D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;QACtE,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,SAAS,CAAC,MAAM,MAAM,CAAC,CAAC;YAChE,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAAC,CAAC;QACxE,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAE9E,IAAI,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACpD,OAAO,CAAC,CAAC;QACV,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACjD,OAAO,CAAC,CAAC;IACV,CAAC;;AAGF,SAAS,YAAY,CAAC,CAAa,EAAE,CAAa;IACjD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC"}
+{"version":3,"file":"compareCommand.js","sources":["../../src/commands/compareCommand.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;AAQM,MAAO,cAAe,SAAQ,OAAO,CAAA;IAC1C,OAAgB,KAAK,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC;AAEhD,IAAA,OAAgB,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AACrC,QAAA,WAAW,EAAE,kDAAkD;AAC/D,QAAA,QAAQ,EAAE;YACT,CAAC,6BAA6B,EAAE,uBAAuB,CAAC;YACxD,CAAC,2BAA2B,EAAE,8DAA8D,CAAC;YAC7F,CAAC,wBAAwB,EAAE,yCAAyC,CAAC;AACrE,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,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,WAAW,EAAE,oEAAoE,EAAE,CAAC;AAC7I,IAAA,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,uBAAuB,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE,CAAC;AAClH,IAAA,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,sBAAsB,EAAE,EAAE,WAAW,EAAE,+BAA+B,EAAE,CAAC;AAC9G,IAAA,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;AAEhK,IAAA,MAAM,OAAO,GAAA;QACZ,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AACnD,QAAA,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU;QACtB,IAAI,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC;AAEnG,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC;AACzG,QAAA,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC;AAErG,QAAA,MAAM,eAAe,GAAG,IAAI,iBAAiB,CAAC,WAAW,CAAC;AAC1D,QAAA,MAAM,cAAc,GAAG,IAAI,iBAAiB,CAAC,UAAU,CAAC;;AAGxD,QAAA,IAAI,aAAa,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC;AACnD,QAAA,IAAI,YAAY,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC;;AAGjD,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;YAChB,MAAM,QAAQ,GAAG,CAAC,IAAY,KAAK,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,MAAO,CAAC;AACtF,YAAA,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC;AAC9C,YAAA,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7C;AAEA,QAAA,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC5C,EAAE,IAAI,EAAE,YAAY,YAAY,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EACpH,EAAE,IAAI,EAAE,YAAY,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,EACvH,YAAY,EACZ,aAAa,CACb;QAED,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;AAErD,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AAChB,YAAA,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC;AACpG,YAAA,MAAM,qBAAqB,CAAC;gBAC3B,SAAS;gBACT,MAAM;gBACN,YAAY,EAAE,IAAI,CAAC,QAAQ;gBAC3B,WAAW,EAAE,IAAI,CAAC,OAAO;AACzB,gBAAA,eAAe,EAAE,CAAC,EAAE,KAAK,eAAe,CAAC,IAAI,CAAC,CAAA,EAAG,EAAE,MAAM,CAAC;AAC1D,gBAAA,cAAc,EAAE,CAAC,EAAE,KAAK,cAAc,CAAC,IAAI,CAAC,CAAA,EAAG,EAAE,MAAM,CAAC;AACxD,aAAA,CAAC;AACF,YAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA,qBAAA,EAAwB,IAAI,CAAC,MAAM,CAAA,GAAA,CAAK,CAAC;QACpE;QAEA,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAClG,OAAO,QAAQ,GAAG,CAAC,GAAG,CAAC;IACxB;;;;;"}

package/dist/commands/mcpCommand.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'clipanion';
+export declare class McpCommand extends Command {
+    static paths: string[][];
+    static usage: import("clipanion").Usage;
+    readonly project: string;
+    readonly noAutostart: boolean;
+    readonly noAutostartHint: string | undefined;
+    execute(): Promise<void>;
+}
+//# sourceMappingURL=mcpCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcpCommand.d.ts","sourceRoot":"","sources":["../../src/commands/mcpCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C,qBAAa,UAAW,SAAQ,OAAO;IACtC,OAAgB,KAAK,aAAa;IAElC,OAAgB,KAAK,4BAMlB;IAEH,QAAQ,CAAC,OAAO,SAA2I;IAC3J,QAAQ,CAAC,WAAW,UAAoH;IACxI,QAAQ,CAAC,eAAe,qBAAyI;IAE3J,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqC9B"}

package/dist/commands/mcpCommand.js

@@ -0,0 +1,58 @@
+import { Command, Option } from 'clipanion';
+import '../external/vscode-observables/observables/dist/observableInternal/index.js';
+import { observableValue } from '../external/vscode-observables/observables/dist/observableInternal/observables/observableValue.js';
+import '../external/vscode-observables/observables/dist/observableInternal/debugLocation.js';
+import '../external/vscode-observables/observables/dist/observableInternal/observables/derived.js';
+import '../external/vscode-observables/observables/dist/observableInternal/utils/utils.js';
+import '../external/vscode-observables/observables/dist/observableInternal/observables/observableFromEvent.js';
+import { ensureDaemon, tryConnect } from '../daemon/lifecycle.js';
+import { daemonPipeName } from '../daemon/pipeName.js';
+import { DaemonConnection, ComponentExplorerMcpServer } from '../mcp/McpServer.js';
+import { resolveProject } from '../resolveProject.js';
+
+class McpCommand extends Command {
+    static paths = [['mcp']];
+    static usage = Command.Usage({
+        description: 'Start an MCP server over stdio. Auto-starts a daemon if not already running.',
+        examples: [
+            ['Start MCP server', '$0 mcp --project config.json'],
+            ['Require existing daemon', '$0 mcp --project config.json --no-daemon-autostart'],
+        ],
+    });
+    project = Option.String('-p,--project,-c', { required: true, description: 'Project: a directory, vite config file, or component-explorer.json' });
+    noAutostart = Option.Boolean('--no-daemon-autostart', false, { description: 'Do not auto-start daemon; poll for it instead' });
+    noAutostartHint = Option.String('--no-daemon-hint', { description: 'Hint message shown when daemon is not running (used with --no-daemon-autostart)' });
+    async execute() {
+        const resolved = await resolveProject(this.project);
+        if (resolved.kind !== 'explorerConfig') {
+            this.context.stderr.write('Error: mcp requires a component-explorer.json config file.\n');
+            return;
+        }
+        const daemonObservable = observableValue('daemon', undefined);
+        const mcpClientName = `mcp-${new Date().toISOString().replace(/[-:]/g, '').replace(/\.\d+Z$/, '')}`;
+        let pollFn;
+        if (this.noAutostart) {
+            const pipeName = daemonPipeName(resolved.configPath);
+            pollFn = async () => {
+                const client = await tryConnect(pipeName, { clientName: mcpClientName });
+                daemonObservable.set(client ? new DaemonConnection(client) : undefined, undefined);
+            };
+            await pollFn();
+            setInterval(pollFn, 5000);
+        }
+        else {
+            const daemon = await ensureDaemon(resolved.configPath, { clientName: mcpClientName });
+            daemonObservable.set(new DaemonConnection(daemon), undefined);
+        }
+        // Create and connect the MCP server over stdio
+        await ComponentExplorerMcpServer.create(daemonObservable, {
+            pollFn,
+            noAutostartHint: this.noAutostartHint,
+        });
+        // Keep the process alive until the MCP connection closes
+        await new Promise(() => { });
+    }
+}
+
+export { McpCommand };
+//# sourceMappingURL=mcpCommand.js.map

package/dist/commands/mcpCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpCommand.js","sources":["../../src/commands/mcpCommand.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;;;;;;AAOM,MAAO,UAAW,SAAQ,OAAO,CAAA;IACtC,OAAgB,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAEjC,IAAA,OAAgB,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;AACrC,QAAA,WAAW,EAAE,8EAA8E;AAC3F,QAAA,QAAQ,EAAE;YACT,CAAC,kBAAkB,EAAE,8BAA8B,CAAC;YACpD,CAAC,yBAAyB,EAAE,oDAAoD,CAAC;AACjF,SAAA;AACD,KAAA,CAAC;AAEO,IAAA,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oEAAoE,EAAE,CAAC;AACjJ,IAAA,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC;AAC9H,IAAA,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC;AAEhK,IAAA,MAAM,OAAO,GAAA;QACZ,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;AACnD,QAAA,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE;YACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8DAA8D,CAAC;YACzF;QACD;QAEA,MAAM,gBAAgB,GAAG,eAAe,CACvC,QAAQ,EACR,SAAS,CACT;QAED,MAAM,aAAa,GAAG,CAAA,IAAA,EAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA,CAAE;AAEnG,QAAA,IAAI,MAAyC;AAC7C,QAAA,IAAI,IAAI,CAAC,WAAW,EAAE;YACrB,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC;YACpD,MAAM,GAAG,YAAW;AACnB,gBAAA,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;AACxE,gBAAA,gBAAgB,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,SAAS,CAAC;AACnF,YAAA,CAAC;YACD,MAAM,MAAM,EAAE;AACd,YAAA,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC;QAC1B;aAAO;AACN,YAAA,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;YACrF,gBAAgB,CAAC,GAAG,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;QAC9D;;QAGe,MAAM,0BAA0B,CAAC,MAAM,CAAC,gBAAgB,EAAE;YACxE,MAAM;YACN,eAAe,EAAE,IAAI,CAAC,eAAe;AACrC,SAAA;;QAGD,MAAM,IAAI,OAAO,CAAO,MAAK,EAAE,CAAC,CAAC;IAClC;;;;;"}

package/dist/commands/screenshotCommand.d.ts

@@ -2,9 +2,15 @@ import { Command } from 'clipanion';
 export declare class ScreenshotCommand extends Command {
     static paths: string[][];
     static usage: import("clipanion").Usage;
+    readonly verbose: number;
     readonly filter: string | undefined;
     readonly accept: boolean;
-    readonly root: string;
-    execute(): Promise<void>;
+    readonly project: string;
+    readonly target: string | undefined;
+    readonly compare: boolean;
+    readonly compareTarget: string | undefined;
+    readonly report: string | undefined;
+    execute(): Promise<number>;
+    private _runComparison;
 }
 //# sourceMappingURL=screenshotCommand.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"screenshotCommand.d.ts","sourceRoot":"","sources":["../../src/commands/screenshotCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAO5C,qBAAa,iBAAkB,SAAQ,OAAO;IAC7C,OAAgB,KAAK,aAAoB;IAEzC,OAAgB,KAAK,4BAOlB;IAEH,QAAQ,CAAC,MAAM,qBAAkG;IACjH,QAAQ,CAAC,MAAM,UAAuG;IACtH,QAAQ,CAAC,IAAI,SAAqF;IAE5F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAqC9B"}
+{"version":3,"file":"screenshotCommand.d.ts","sourceRoot":"","sources":["../../src/commands/screenshotCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAW5C,qBAAa,iBAAkB,SAAQ,OAAO;IAC7C,OAAgB,KAAK,aAAoB;IAEzC,OAAgB,KAAK,4BAOlB;IAEH,QAAQ,CAAC,OAAO,SAAsG;IACtH,QAAQ,CAAC,MAAM,qBAAkG;IACjH,QAAQ,CAAC,MAAM,UAAiI;IAChJ,QAAQ,CAAC,OAAO,SAAuI;IACvJ,QAAQ,CAAC,MAAM,qBAAsK;IACrL,QAAQ,CAAC,OAAO,UAA8F;IAC9G,QAAQ,CAAC,aAAa,qBAA+K;IACrM,QAAQ,CAAC,MAAM,qBAA4G;IAErH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;YAqElB,cAAc;CA+B5B"}