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

package/dist/componentExplorer.js

@@ -1,4 +1,5 @@
 import { nullLogger } from './logger.js';
+import { buildExplorerUrl } from './utils.js';
 
 class BrowserComponentExplorer {
     _browserPageFactory;
@@ -6,6 +7,7 @@ class BrowserComponentExplorer {
     _logger;
     _page;
     _lastState;
+    _screenshotMutex = Promise.resolve();
     constructor(_browserPageFactory, _server, _logger = nullLogger) {
         this._browserPageFactory = _browserPageFactory;
         this._server = _server;
@@ -13,15 +15,15 @@ class BrowserComponentExplorer {
     }
     async _ensureReady() {
         if (!this._page) {
-            const cliUrl = this._server.url + '/___explorer?mode=render';
-            this._logger.log(`Opening browser page: ${cliUrl}`);
+            const cliUrl = buildExplorerUrl({ baseUrl: this._server.url, rawRender: true });
+            this._logger.debug(`Opening browser page: ${cliUrl}`);
             this._page = await this._browserPageFactory.openPage(cliUrl);
             await this._waitForCliApi(this._page);
         }
         return this._page;
     }
     async _waitForCliApi(page) {
-        this._logger.log('Waiting for __componentExplorerCli__ to initialize...');
+        this._logger.trace('Polling for __componentExplorerCli__ to initialize...');
         await page.evaluateJs(`
 			new Promise(resolve => {
 				function check() {
@@ -32,7 +34,7 @@ class BrowserComponentExplorer {
 			})
 		`);
         this._lastState = await this._getState(page);
-        this._logger.log(`CLI API ready, sessionId=${this._lastState.sessionId}, version=${this._lastState.updateVersion}`);
+        this._logger.debug(`CLI API ready, sessionId=${this._lastState.sessionId}, version=${this._lastState.updateVersion}`);
     }
     async _getState(page) {
         return page.evaluateJs(`({
@@ -45,23 +47,103 @@ class BrowserComponentExplorer {
         return page.evaluateJs('window.__componentExplorerCli__.listFixtures()');
     }
     async screenshotFixture(fixtureId) {
-        const page = await this._ensureReady();
-        const escapedId = JSON.stringify(fixtureId);
-        const debugUrl = `${this._server.url}/___explorer?mode=render&fixture=${encodeURIComponent(fixtureId)}`;
-        this._logger.log(`Rendering fixture: ${debugUrl}`);
-        await page.evaluateJs(`window.__componentExplorerCli__.renderFixture(${escapedId})`);
-        return page.screenshot(`document.getElementById('root').lastElementChild`);
+        // Serialize screenshot calls — the single browser page can only render one fixture at a time
+        const prev = this._screenshotMutex;
+        let resolve;
+        this._screenshotMutex = new Promise(r => { resolve = r; });
+        this._logger.trace(`Screenshot mutex: waiting for ${fixtureId}`);
+        await prev;
+        this._logger.trace(`Screenshot mutex: acquired for ${fixtureId}`);
+        const startTime = Date.now();
+        try {
+            const page = await this._ensureReady();
+            const escapedId = JSON.stringify(fixtureId);
+            const debugUrl = buildExplorerUrl({ baseUrl: this._server.url, rawRender: true, fixtureId });
+            this._logger.debug(`Rendering fixture: ${debugUrl}`);
+            const renderResult = await page.evaluateJs(`window.__componentExplorerCli__.renderFixture(${escapedId})`);
+            const image = await page.screenshot(`document.getElementById('root').lastElementChild`);
+            this._logger.debug(`Screenshot done: ${fixtureId} (${Date.now() - startTime}ms)`);
+            return { image, errors: renderResult.errors };
+        }
+        finally {
+            this._logger.trace(`Screenshot mutex: released for ${fixtureId}`);
+            resolve();
+        }
+    }
+    async screenshotFixtureStabilityCheck(fixtureId) {
+        const prev = this._screenshotMutex;
+        let resolve;
+        this._screenshotMutex = new Promise(r => { resolve = r; });
+        this._logger.trace(`Screenshot mutex: waiting for stability check ${fixtureId}`);
+        await prev;
+        this._logger.trace(`Screenshot mutex: acquired for stability check ${fixtureId}`);
+        try {
+            const page = await this._ensureReady();
+            const escapedId = JSON.stringify(fixtureId);
+            const debugUrl = buildExplorerUrl({ baseUrl: this._server.url, rawRender: true, fixtureId });
+            this._logger.debug(`Stability check: ${debugUrl}`);
+            await page.evaluateJs(`window.__componentExplorerCli__.disposeCurrentFixture?.()`);
+            const startTime = Date.now();
+            const renderResult = await page.evaluateJs(`window.__componentExplorerCli__.renderFixture(${escapedId})`);
+            const domExpr = `document.getElementById('root').lastElementChild`;
+            const image0 = await page.screenshot(domExpr);
+            const delay0 = Date.now() - startTime;
+            this._logger.debug(`Stability screenshot 1/3 at ${delay0}ms`);
+            const elapsed1 = Date.now() - startTime;
+            if (elapsed1 < 500) {
+                await new Promise(r => setTimeout(r, 500 - elapsed1));
+            }
+            const image1 = await page.screenshot(domExpr);
+            const delay1 = Date.now() - startTime;
+            this._logger.debug(`Stability screenshot 2/3 at ${delay1}ms`);
+            const elapsed2 = Date.now() - startTime;
+            if (elapsed2 < 3000) {
+                await new Promise(r => setTimeout(r, 3000 - elapsed2));
+            }
+            const image2 = await page.screenshot(domExpr);
+            const delay2 = Date.now() - startTime;
+            this._logger.debug(`Stability check done: ${fixtureId} (${delay2}ms total)`);
+            return {
+                screenshots: [
+                    { image: image0, delayMs: delay0 },
+                    { image: image1, delayMs: delay1 },
+                    { image: image2, delayMs: delay2 },
+                ],
+                errors: renderResult.errors,
+            };
+        }
+        finally {
+            this._logger.trace(`Screenshot mutex: released for stability check ${fixtureId}`);
+            resolve();
+        }
+    }
+    async evaluateJs(expression, fixtureId) {
+        const prev = this._screenshotMutex;
+        let resolve;
+        this._screenshotMutex = new Promise(r => { resolve = r; });
+        await prev;
+        try {
+            this._logger.trace(`evaluateJs: expression length=${expression.length}${fixtureId ? `, fixtureId=${fixtureId}` : ''}`);
+            const page = await this._ensureReady();
+            if (fixtureId !== undefined) {
+                const escapedId = JSON.stringify(fixtureId);
+                await page.evaluateJs(`window.__componentExplorerCli__.renderFixture(${escapedId})`);
+            }
+            const result = await page.evaluateJs(expression);
+            this._logger.trace(`evaluateJs: result length=${JSON.stringify(result)?.length ?? 0}`);
+            return result;
+        }
+        finally {
+            resolve();
+        }
     }
     async codeCoverage(_id) {
         throw new Error('Code coverage not yet implemented');
     }
     async waitForUpdate(timeoutMs = 0) {
         const page = await this._ensureReady();
-        // Read the current state NOW, not from _lastState. This ensures any
-        // spurious version bumps that happened during prior operations (e.g.
-        // initial screenshot capture, Vite dependency optimization) are ignored.
         const prev = await this._getState(page);
-        this._logger.log(`Waiting for update (sessionId=${prev.sessionId}, version=${prev.updateVersion})...`);
+        this._logger.debug(`Waiting for update (sessionId=${prev.sessionId}, version=${prev.updateVersion})...`);
         const newState = await page.evaluateJs(`
 			new Promise((resolve, reject) => {
 				${timeoutMs > 0 ? `const timeout = setTimeout(() => reject(new Error('Timeout waiting for HMR update')), ${timeoutMs});` : ''}
@@ -85,10 +167,10 @@ class BrowserComponentExplorer {
 		`);
         const reloaded = newState.sessionId !== prev.sessionId;
         if (reloaded) {
-            this._logger.log(`Page reloaded: sessionId ${prev.sessionId} → ${newState.sessionId}`);
+            this._logger.debug(`Page reloaded: sessionId ${prev.sessionId} → ${newState.sessionId}`);
         }
         else {
-            this._logger.log(`HMR update: version ${prev.updateVersion} → ${newState.updateVersion}`);
+            this._logger.debug(`HMR update: version ${prev.updateVersion} → ${newState.updateVersion}`);
         }
         this._lastState = newState;
     }

package/dist/componentExplorer.js.map

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

package/dist/daemon/DaemonContext.d.ts

@@ -0,0 +1,4 @@
+export interface DaemonContext {
+    readonly clientName: string;
+}
+//# sourceMappingURL=DaemonContext.d.ts.map

package/dist/daemon/DaemonContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonContext.d.ts","sourceRoot":"","sources":["../../src/daemon/DaemonContext.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B"}

package/dist/daemon/DaemonService.d.ts

@@ -0,0 +1,188 @@
+import { type IDisposable, type IReader } from '@vscode/observables';
+import { AsyncStream } from '@hediet/simple-api';
+import { ExplorerSession } from '../explorerSession.js';
+import type { ResolvedWatchConfig } from '../watchConfig.js';
+import { type ILogger } from '../logger.js';
+import { type ApprovalStore } from './approvalStore.js';
+import type { DaemonContext } from './DaemonContext.js';
+export declare class ActivityTracker implements IDisposable {
+    private readonly _idleTimeoutMs;
+    private readonly _onIdle;
+    private readonly _logger;
+    private _lastActivityTime;
+    private _idleCheckInterval;
+    private _autorunDisposable;
+    private _disposed;
+    private _started;
+    private _activeCount;
+    constructor(_idleTimeoutMs: number, _onIdle: () => void, _logger: ILogger);
+    setActive(value: boolean): void;
+    reportActivity(): void;
+    start(): void;
+    dispose(): void;
+}
+export type DaemonEvent = {
+    readonly type: 'source-change';
+    readonly sessionName: string;
+    readonly sourceTreeId: string;
+} | {
+    readonly type: 'ref-change';
+    readonly sessionName: string;
+    readonly newCommit: string;
+} | {
+    readonly type: 'log';
+    readonly level: 'info' | 'debug' | 'trace';
+    readonly message: string;
+};
+export type SessionInfo = {
+    readonly name: string;
+    readonly sourceKind: 'current' | 'worktree';
+    readonly isLoading: true;
+} | {
+    readonly name: string;
+    readonly sourceKind: 'current' | 'worktree';
+    readonly isLoading?: false;
+    readonly serverUrl: string;
+    readonly sourceTreeId: string;
+};
+export declare class SourceTreeChangedError extends Error {
+    constructor(sessionName: string);
+}
+export type DaemonApiType = DaemonService['api']['TMethods'];
+export declare class DaemonService {
+    private readonly _config;
+    private readonly _pipeName;
+    private readonly _logger;
+    private readonly _browserFactory;
+    private readonly _serverFactory;
+    private readonly _sessions;
+    private readonly _sessionConfigs;
+    private readonly _resolvers;
+    private readonly _eventListenerCount;
+    private readonly _eventListeners;
+    private _shutdownRequested;
+    private _shutdownResolvers;
+    private readonly _activityTracker;
+    readonly approvals: ApprovalStore;
+    readonly api: import("@hediet/simple-api").ApiImplementation<import("@hediet/simple-api").MapMethods<{
+        fixtures: import("@hediet/simple-api").ApiImplementation<import("@hediet/simple-api").MapMethods<{
+            list: import("@hediet/simple-api").IMethod<{
+                sessionName: string;
+                sourceTreeId: string;
+            }, import("../componentExplorer.js").FixtureInfo[], DaemonContext>;
+        }>, DaemonContext>;
+        screenshots: import("@hediet/simple-api").ApiImplementation<import("@hediet/simple-api").MapMethods<{
+            take: import("@hediet/simple-api").IMethod<{
+                fixtureId: string;
+                sourceTreeId: string;
+                sessionName: string;
+                includeImage?: boolean | undefined;
+                stabilityCheck?: boolean | undefined;
+            }, {
+                hash: string;
+                sourceTreeId: string;
+                image: string | undefined;
+                errors: import("../componentExplorer.js").ErrorInfo[] | undefined;
+                isStable: boolean;
+                stabilityScreenshots: {
+                    hash: string;
+                    delayMs: number;
+                    image: string | undefined;
+                }[];
+            } | {
+                hash: string;
+                sourceTreeId: string;
+                image: string | undefined;
+                errors: import("../componentExplorer.js").ErrorInfo[] | undefined;
+                isStable?: undefined;
+                stabilityScreenshots?: undefined;
+            }, DaemonContext>;
+            takeBatch: import("@hediet/simple-api").IMethod<{
+                fixtureIds: string[];
+                sourceTreeId: string;
+                sessionName: string;
+                includeImages?: boolean | undefined;
+            }, {
+                sourceTreeId: string;
+                screenshots: {
+                    fixtureId: string;
+                    hash: string;
+                    image: string | undefined;
+                    errors: import("../componentExplorer.js").ErrorInfo[] | undefined;
+                }[];
+            }, DaemonContext>;
+            compare: import("@hediet/simple-api").IMethod<{
+                fixtureId: string;
+                baselineSessionName: string;
+                baselineSourceTreeId: string;
+                currentSessionName: string;
+                currentSourceTreeId: string;
+                includeImages?: boolean | undefined;
+            }, {
+                match: boolean;
+                baselineHash: string;
+                currentHash: string;
+                baselineImage: string | undefined;
+                currentImage: string | undefined;
+                baselineErrors: import("../componentExplorer.js").ErrorInfo[] | undefined;
+                currentErrors: import("../componentExplorer.js").ErrorInfo[] | undefined;
+                approval: import("./approvalStore.js").ApprovalInfo | undefined;
+            }, DaemonContext>;
+        }>, DaemonContext>;
+        approvals: import("@hediet/simple-api").ApiImplementation<import("@hediet/simple-api").MapMethods<{
+            approve: import("@hediet/simple-api").IMethod<{
+                fixtureId: string;
+                originalHash: string;
+                modifiedHash: string;
+                comment: string;
+            }, void, DaemonContext>;
+            revoke: import("@hediet/simple-api").IMethod<{
+                fixtureId: string;
+                originalHash: string;
+                modifiedHash: string;
+            }, void, DaemonContext>;
+            list: import("@hediet/simple-api").IMethod<{
+                fixtureId?: string | undefined;
+            }, import("./approvalStore.js").ApprovalInfo[], DaemonContext>;
+            lookup: import("@hediet/simple-api").IMethod<{
+                fixtureId: string;
+                originalHash: string;
+                modifiedHash: string;
+            }, import("./approvalStore.js").ApprovalInfo | null, DaemonContext>;
+        }>, DaemonContext>;
+        evaluate: import("@hediet/simple-api").IMethod<{
+            sessionName: string;
+            sourceTreeId: string;
+            expression: string;
+            fixtureId?: string | undefined;
+        }, {
+            result: unknown;
+        }, DaemonContext>;
+        events: import("@hediet/simple-api").IMethod<Record<string, never>, AsyncStream<DaemonEvent>, DaemonContext>;
+        sessions: import("@hediet/simple-api").IMethod<Record<string, never>, SessionInfo[], DaemonContext>;
+        shutdown: import("@hediet/simple-api").IMethod<Record<string, never>, void, DaemonContext>;
+    }>, DaemonContext>;
+    private constructor();
+    static create(config: ResolvedWatchConfig, logger: ILogger, pipeName?: string, options?: {
+        idleTimeoutMs?: number;
+    }): Promise<DaemonService>;
+    private _buildApi;
+    getSession(name: string): ExplorerSession;
+    getSessionInfos(reader?: IReader): SessionInfo[];
+    waitForSession(sessionName: string | undefined): Promise<SessionInfo & {
+        isLoading?: false;
+    }>;
+    getSourceTreeId(sessionName: string): string;
+    assertSourceTreeId(sessionName: string, expected: string): void;
+    eventStream(): AsyncIterable<DaemonEvent>;
+    runEventLoop(): Promise<void>;
+    private _sourceChangeDisposables;
+    private _startSourceChangeWatchers;
+    private _handleRefChange;
+    requestShutdown(): void;
+    dispose(): Promise<void>;
+    /** @internal — also called by EventStreamLogger */
+    _emit(event: DaemonEvent): void;
+    private _setupSession;
+}
+//# sourceMappingURL=DaemonService.d.ts.map

package/dist/daemon/DaemonService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DaemonService.d.ts","sourceRoot":"","sources":["../../src/daemon/DaemonService.ts"],"names":[],"mappings":"AACA,OAAO,EAAmD,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEtH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAyB,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAIpF,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,oBAAoB,CAAC;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMxD,qBAAa,eAAgB,YAAW,WAAW;IASjD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVzB,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,kBAAkB,CAA6C;IACvE,OAAO,CAAC,kBAAkB,CAA0B;IACpD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAK;gBAGP,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,EAAE,OAAO;IAGlC,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAS/B,cAAc,IAAI,IAAI;IAItB,KAAK,IAAI,IAAI;IAmBb,OAAO,IAAI,IAAI;CAQf;AAMD,MAAM,MAAM,WAAW,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/F;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzF;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG,MAAM,MAAM,WAAW,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CAAE,GAChG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjK,qBAAa,sBAAuB,SAAQ,KAAK;gBACpC,WAAW,EAAE,MAAM;CAI/B;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,CAAC;AAM7D,qBAAa,aAAa;IAexB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAlBhC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyC;IACpE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAoC;IACxE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,kBAAkB,CAAyB;IAEnD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAkB;IAEnD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAAC;IAEb,OAAO;WAkBM,MAAM,CAClB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAClC,OAAO,CAAC,aAAa,CAAC;IAuBzB,OAAO,CAAC,SAAS;IA8NjB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe;IAQzC,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE;IAehD,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG;QAAE,SAAS,CAAC,EAAE,KAAK,CAAA;KAAE,CAAC;IAS7F,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAI5C,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS/D,WAAW,IAAI,aAAa,CAAC,WAAW,CAAC;IAoEnC,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC,OAAO,CAAC,wBAAwB,CAAqB;IAErD,OAAO,CAAC,0BAA0B;YA4BpB,gBAAgB;IA+C9B,eAAe,IAAI,IAAI;IAQjB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,mDAAmD;IACnD,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;YAMjB,aAAa;CAmD3B"}