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

package/dist/server/httpServer.js

@@ -0,0 +1,114 @@
+import { nullLogger } from '../logger.js';
+import { spawnShellWithTree } from '../processTree.js';
+
+function createHttpServer(url, options) {
+    return HttpComponentExplorerServer.create(url, options);
+}
+class HttpComponentExplorerServer {
+    url;
+    _tree;
+    static async create(urlTemplate, options) {
+        let proc;
+        let vars = {};
+        if (options?.cmd) {
+            const log = options.logger ?? nullLogger;
+            log.debug(`Starting HTTP server: ${options.cmd}`);
+            log.debug(`HTTP server cwd: ${options.cwd ?? process.cwd()}`);
+            const tree = spawnShellWithTree(options.cmd, { cwd: options.cwd });
+            proc = tree;
+            tree.process.on('error', (e) => log.log(`HTTP server process error: ${e.message}`));
+            tree.process.on('exit', (code) => log.debug(`HTTP server process exited (code=${code})`));
+            if (options.wait?.stdout || options.wait?.stderr) {
+                vars = await waitForOutputPattern(tree.process, options.wait, log);
+            }
+            else {
+                tree.process.stdout?.on('data', (d) => log.trace(d.toString().trimEnd()));
+                tree.process.stderr?.on('data', (d) => log.trace(d.toString().trimEnd()));
+            }
+        }
+        const url = resolveUrlTemplate(urlTemplate, vars);
+        return new HttpComponentExplorerServer(url, proc);
+    }
+    constructor(url, _tree) {
+        this.url = url;
+        this._tree = _tree;
+    }
+    async dispose() {
+        const tree = this._tree;
+        const proc = tree?.process;
+        if (!tree || !proc || proc.killed || proc.pid === undefined) {
+            return;
+        }
+        proc.stdout?.destroy();
+        proc.stderr?.destroy();
+        const exitPromise = new Promise((resolve) => {
+            proc.on('exit', () => resolve());
+        });
+        tree.kill();
+        const timeout = new Promise((resolve) => setTimeout(resolve, 5_000));
+        await Promise.race([exitPromise, timeout]);
+    }
+}
+function resolveUrlTemplate(template, vars) {
+    return template.replace(/\$\{var:([^}]+)\}/g, (match, name) => {
+        if (!(name in vars)) {
+            throw new Error(`Unresolved variable \${var:${name}} in URL. Available: ${Object.keys(vars).join(', ') || '(none)'}`);
+        }
+        return vars[name];
+    });
+}
+const _stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '').replace(/\x1b\].*?\x07/g, '');
+function waitForOutputPattern(proc, wait, log) {
+    return new Promise((resolve, reject) => {
+        let resolved = false;
+        const vars = {};
+        let pendingCount = (wait.stdout ? 1 : 0) + (wait.stderr ? 1 : 0);
+        const buffers = { stdout: '', stderr: '' };
+        const tryResolve = () => {
+            if (resolved || pendingCount > 0) {
+                return;
+            }
+            resolved = true;
+            proc.stdout?.on('data', (d) => log.trace(d.toString().trimEnd()));
+            proc.stderr?.on('data', (d) => log.trace(d.toString().trimEnd()));
+            resolve(vars);
+        };
+        const makeHandler = (stream, pattern) => {
+            const handler = (d) => {
+                const text = d.toString();
+                log.trace(text.trimEnd());
+                buffers[stream] += _stripAnsi(text);
+                const m = pattern.exec(buffers[stream]);
+                if (m) {
+                    log.debug(`${stream} pattern matched: ${JSON.stringify(m.groups ?? {})}`);
+                    proc[stream]?.off('data', handler);
+                    Object.assign(vars, m.groups ?? {});
+                    pendingCount--;
+                    tryResolve();
+                }
+            };
+            return handler;
+        };
+        if (wait.stdout) {
+            proc.stdout?.on('data', makeHandler('stdout', wait.stdout));
+        }
+        else {
+            proc.stdout?.on('data', (d) => log.trace(d.toString().trimEnd()));
+        }
+        if (wait.stderr) {
+            proc.stderr?.on('data', makeHandler('stderr', wait.stderr));
+        }
+        else {
+            proc.stderr?.on('data', (d) => log.trace(d.toString().trimEnd()));
+        }
+        proc.on('exit', (code) => {
+            if (!resolved) {
+                const details = [wait.stdout ? `stdout buffer:\n${buffers.stdout}` : '', wait.stderr ? `stderr buffer:\n${buffers.stderr}` : ''].filter(Boolean).join('\n');
+                reject(new Error(`HTTP server process exited (code=${code}) before output matched wait patterns.\n${details}`));
+            }
+        });
+    });
+}
+
+export { createHttpServer };
+//# sourceMappingURL=httpServer.js.map

package/dist/server/httpServer.js.map

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

package/dist/server/httpServer.test.d.ts.map

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

package/dist/server/serverConfig.d.ts

@@ -0,0 +1,42 @@
+import type { ComponentExplorerHttpServer } from './types.js';
+import type { ILogger } from '../logger.js';
+import { ViteProjectRef } from '../viteProjectRef.js';
+export declare abstract class ResolvedServerConfig {
+    abstract readonly kind: 'vite' | 'http';
+    abstract createServer(ctx: ServerContext): Promise<ComponentExplorerHttpServer>;
+}
+export interface ServerContext {
+    readonly logger: ILogger;
+    readonly daemonConfig?: {
+        readonly pipeName: string;
+        readonly sessionName: string;
+        readonly daemonApiVersion: string;
+        readonly pluginProtocolVersion: string;
+    };
+}
+export interface ResolvedViteHmrConfig {
+    readonly allowedPaths: readonly string[];
+}
+export declare class ViteServerConfig extends ResolvedServerConfig {
+    readonly viteProject: ViteProjectRef;
+    readonly hmr: ResolvedViteHmrConfig | undefined;
+    private readonly _resolveViteFrom?;
+    readonly kind = "vite";
+    constructor(viteProject: ViteProjectRef, hmr: ResolvedViteHmrConfig | undefined, _resolveViteFrom?: string | undefined);
+    forWorktree(repoRoot: string, worktreePath: string, configDir: string): ViteServerConfig;
+    createServer(ctx: ServerContext): Promise<ComponentExplorerHttpServer>;
+}
+export interface ResolvedHttpWaitConfig {
+    readonly stdout?: RegExp;
+    readonly stderr?: RegExp;
+}
+export declare class HttpServerConfig extends ResolvedServerConfig {
+    readonly url: string;
+    readonly cmd: string | undefined;
+    readonly cwd: string;
+    readonly wait: ResolvedHttpWaitConfig | undefined;
+    readonly kind = "http";
+    constructor(url: string, cmd: string | undefined, cwd: string, wait: ResolvedHttpWaitConfig | undefined);
+    createServer(ctx: ServerContext): Promise<ComponentExplorerHttpServer>;
+}
+//# sourceMappingURL=serverConfig.d.ts.map

package/dist/server/serverConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverConfig.d.ts","sourceRoot":"","sources":["../../src/server/serverConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,8BAAsB,oBAAoB;IACzC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAC/E;AAED,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE;QACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;KAC1C,CAAC;CACL;AAED,MAAM,WAAW,qBAAqB;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,qBAAa,gBAAiB,SAAQ,oBAAoB;IAIxD,QAAQ,CAAC,WAAW,EAAE,cAAc;IACpC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,SAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IALnC,QAAQ,CAAC,IAAI,UAAU;gBAGb,WAAW,EAAE,cAAc,EAC3B,GAAG,EAAE,qBAAqB,GAAG,SAAS,EAC9B,gBAAgB,CAAC,EAAE,MAAM,YAAA;IAK3C,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,gBAAgB;IASlF,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAQ5E;AAED,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,qBAAa,gBAAiB,SAAQ,oBAAoB;IAIxD,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,SAAS;IANlD,QAAQ,CAAC,IAAI,UAAU;gBAGb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,sBAAsB,GAAG,SAAS;IAK5C,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAQ5E"}

package/dist/server/serverConfig.js

@@ -0,0 +1,60 @@
+import * as path from 'node:path';
+import { createHttpServer } from './httpServer.js';
+import { createViteServer } from './viteServer.js';
+import { ViteProjectRef } from '../viteProjectRef.js';
+
+class ResolvedServerConfig {
+}
+class ViteServerConfig extends ResolvedServerConfig {
+    viteProject;
+    hmr;
+    _resolveViteFrom;
+    kind = 'vite';
+    constructor(viteProject, hmr, _resolveViteFrom) {
+        super();
+        this.viteProject = viteProject;
+        this.hmr = hmr;
+        this._resolveViteFrom = _resolveViteFrom;
+    }
+    forWorktree(repoRoot, worktreePath, configDir) {
+        const configDirRelToGitRoot = path.relative(repoRoot, configDir);
+        const worktreeConfigDir = path.resolve(worktreePath, configDirRelToGitRoot);
+        const defaultViteConfig = path.basename(this.viteProject.configFile ?? 'vite.config.ts');
+        const viteConfigPath = path.resolve(worktreeConfigDir, defaultViteConfig);
+        const viteProject = ViteProjectRef.fromViteConfigPath(viteConfigPath);
+        return new ViteServerConfig(viteProject, this.hmr, this.viteProject.configFile);
+    }
+    async createServer(ctx) {
+        return createViteServer(this.viteProject, {
+            logger: ctx.logger,
+            resolveViteFrom: this._resolveViteFrom,
+            hmrAllowedPaths: this.hmr?.allowedPaths,
+            daemonConfig: ctx.daemonConfig,
+        });
+    }
+}
+class HttpServerConfig extends ResolvedServerConfig {
+    url;
+    cmd;
+    cwd;
+    wait;
+    kind = 'http';
+    constructor(url, cmd, cwd, wait) {
+        super();
+        this.url = url;
+        this.cmd = cmd;
+        this.cwd = cwd;
+        this.wait = wait;
+    }
+    async createServer(ctx) {
+        return createHttpServer(this.url, {
+            cmd: this.cmd,
+            cwd: this.cwd,
+            wait: this.wait,
+            logger: ctx.logger,
+        });
+    }
+}
+
+export { HttpServerConfig, ResolvedServerConfig, ViteServerConfig };
+//# sourceMappingURL=serverConfig.js.map

package/dist/server/serverConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serverConfig.js","sources":["../../src/server/serverConfig.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;MAOsB,oBAAoB,CAAA;AAGzC;AAgBK,MAAO,gBAAiB,SAAQ,oBAAoB,CAAA;AAI/C,IAAA,WAAA;AACA,IAAA,GAAA;AACQ,IAAA,gBAAA;IALT,IAAI,GAAG,MAAM;AAEtB,IAAA,WAAA,CACU,WAA2B,EAC3B,GAAsC,EAC9B,gBAAyB,EAAA;AAE1C,QAAA,KAAK,EAAE;QAJE,IAAA,CAAA,WAAW,GAAX,WAAW;QACX,IAAA,CAAA,GAAG,GAAH,GAAG;QACK,IAAA,CAAA,gBAAgB,GAAhB,gBAAgB;IAGlC;AAEA,IAAA,WAAW,CAAC,QAAgB,EAAE,YAAoB,EAAE,SAAiB,EAAA;QACpE,MAAM,qBAAqB,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;QAChE,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,qBAAqB,CAAC;AAC3E,QAAA,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,gBAAgB,CAAC;QACxF,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;QACzE,MAAM,WAAW,GAAG,cAAc,CAAC,kBAAkB,CAAC,cAAc,CAAC;AACrE,QAAA,OAAO,IAAI,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC;IAChF;IAEA,MAAM,YAAY,CAAC,GAAkB,EAAA;AACpC,QAAA,OAAO,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE;YACzC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,eAAe,EAAE,IAAI,CAAC,gBAAgB;AACtC,YAAA,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY;YACvC,YAAY,EAAE,GAAG,CAAC,YAAY;AAC9B,SAAA,CAAC;IACH;AACA;AAOK,MAAO,gBAAiB,SAAQ,oBAAoB,CAAA;AAI/C,IAAA,GAAA;AACA,IAAA,GAAA;AACA,IAAA,GAAA;AACA,IAAA,IAAA;IAND,IAAI,GAAG,MAAM;AAEtB,IAAA,WAAA,CACU,GAAW,EACX,GAAuB,EACvB,GAAW,EACX,IAAwC,EAAA;AAEjD,QAAA,KAAK,EAAE;QALE,IAAA,CAAA,GAAG,GAAH,GAAG;QACH,IAAA,CAAA,GAAG,GAAH,GAAG;QACH,IAAA,CAAA,GAAG,GAAH,GAAG;QACH,IAAA,CAAA,IAAI,GAAJ,IAAI;IAGd;IAEA,MAAM,YAAY,CAAC,GAAkB,EAAA;AACpC,QAAA,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,EAAE;YACjC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,GAAG,CAAC,MAAM;AAClB,SAAA,CAAC;IACH;AACA;;;;"}

package/dist/server/types.d.ts

@@ -0,0 +1,6 @@
+export interface ComponentExplorerHttpServer {
+    readonly url: string;
+    readonly onSourceChange?: (callback: () => void) => void;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;IACzD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}

package/dist/server/viteServer.d.ts

@@ -0,0 +1,16 @@
+import { type ILogger } from '../logger.js';
+import { ViteProjectRef } from '../viteProjectRef.js';
+import type { ComponentExplorerHttpServer } from './types.js';
+export interface ViteServerOptions {
+    readonly resolveViteFrom?: string;
+    readonly logger?: ILogger;
+    readonly hmrAllowedPaths?: readonly string[];
+    readonly daemonConfig?: {
+        readonly pipeName: string;
+        readonly sessionName: string;
+        readonly daemonApiVersion: string;
+        readonly pluginProtocolVersion: string;
+    };
+}
+export declare function createViteServer(project: ViteProjectRef, options?: ViteServerOptions): Promise<ComponentExplorerHttpServer>;
+//# sourceMappingURL=viteServer.d.ts.map

package/dist/server/viteServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viteServer.d.ts","sourceRoot":"","sources":["../../src/server/viteServer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAc,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAE9D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE;QACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;KACvC,CAAC;CACF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAE3H"}

package/dist/{httpServer.js → server/viteServer.js}

@@ -1,117 +1,12 @@
-import { nullLogger } from './logger.js';
+import { nullLogger } from '../logger.js';
 
-class DefaultComponentExplorerHttpServerFactory {
-    async createViteServer(project, options) {
-        return ViteComponentExplorerHttpServer.create(project, options);
-    }
-    async createHttpServer(url, options) {
-        return HttpComponentExplorerServer.create(url, options);
-    }
-}
-class HttpComponentExplorerServer {
-    url;
-    _process;
-    static async create(urlTemplate, options) {
-        let proc;
-        let vars = {};
-        if (options?.cmd) {
-            const log = options.logger ?? nullLogger;
-            log.debug(`Starting HTTP server: ${options.cmd}`);
-            log.debug(`HTTP server cwd: ${options.cwd ?? process.cwd()}`);
-            const { spawn } = await import('node:child_process');
-            proc = spawn(options.cmd, { shell: true, stdio: 'pipe', cwd: options.cwd });
-            proc.on('error', (e) => log.log(`HTTP server process error: ${e.message}`));
-            proc.on('exit', (code) => log.debug(`HTTP server process exited (code=${code})`));
-            if (options.wait?.stdout || options.wait?.stderr) {
-                vars = await waitForOutputPattern(proc, options.wait, log);
-            }
-            else {
-                proc.stdout?.on('data', (d) => log.trace(d.toString().trimEnd()));
-                proc.stderr?.on('data', (d) => log.trace(d.toString().trimEnd()));
-            }
-        }
-        const url = resolveUrlTemplate(urlTemplate, vars);
-        return new HttpComponentExplorerServer(url, proc);
-    }
-    constructor(url, _process) {
-        this.url = url;
-        this._process = _process;
-    }
-    async dispose() {
-        if (this._process && !this._process.killed) {
-            this._process.kill();
-        }
-    }
-}
-function resolveUrlTemplate(template, vars) {
-    return template.replace(/\$\{var:([^}]+)\}/g, (match, name) => {
-        if (!(name in vars)) {
-            throw new Error(`Unresolved variable \${var:${name}} in URL. Available: ${Object.keys(vars).join(', ') || '(none)'}`);
-        }
-        return vars[name];
-    });
-}
-const _stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*[a-zA-Z]/g, '').replace(/\x1b\].*?\x07/g, '');
-function waitForOutputPattern(proc, wait, log) {
-    return new Promise((resolve, reject) => {
-        let resolved = false;
-        const vars = {};
-        let pendingCount = (wait.stdout ? 1 : 0) + (wait.stderr ? 1 : 0);
-        const buffers = { stdout: '', stderr: '' };
-        const tryResolve = () => {
-            if (resolved || pendingCount > 0) {
-                return;
-            }
-            resolved = true;
-            proc.stdout?.on('data', (d) => log.trace(d.toString().trimEnd()));
-            proc.stderr?.on('data', (d) => log.trace(d.toString().trimEnd()));
-            resolve(vars);
-        };
-        const makeHandler = (stream, pattern) => {
-            const handler = (d) => {
-                const text = d.toString();
-                log.trace(text.trimEnd());
-                buffers[stream] += _stripAnsi(text);
-                const m = pattern.exec(buffers[stream]);
-                if (m) {
-                    log.debug(`${stream} pattern matched: ${JSON.stringify(m.groups ?? {})}`);
-                    proc[stream]?.off('data', handler);
-                    Object.assign(vars, m.groups ?? {});
-                    pendingCount--;
-                    tryResolve();
-                }
-            };
-            return handler;
-        };
-        if (wait.stdout) {
-            proc.stdout?.on('data', makeHandler('stdout', wait.stdout));
-        }
-        else {
-            proc.stdout?.on('data', (d) => log.trace(d.toString().trimEnd()));
-        }
-        if (wait.stderr) {
-            proc.stderr?.on('data', makeHandler('stderr', wait.stderr));
-        }
-        else {
-            proc.stderr?.on('data', (d) => log.trace(d.toString().trimEnd()));
-        }
-        proc.on('exit', (code) => {
-            if (!resolved) {
-                const details = [wait.stdout ? `stdout buffer:\n${buffers.stdout}` : '', wait.stderr ? `stderr buffer:\n${buffers.stderr}` : ''].filter(Boolean).join('\n');
-                reject(new Error(`HTTP server process exited (code=${code}) before output matched wait patterns.\n${details}`));
-            }
-        });
-    });
+function createViteServer(project, options) {
+    return ViteComponentExplorerHttpServer.create(project, options);
 }
 class ViteComponentExplorerHttpServer {
     _server;
     url;
     onSourceChange;
-    constructor(_server, url, onSourceChange) {
-        this._server = _server;
-        this.url = url;
-        this.onSourceChange = onSourceChange;
-    }
     static async create(project, options) {
         const log = options?.logger ?? nullLogger;
         const resolveViteFrom = options?.resolveViteFrom;
@@ -208,6 +103,11 @@ class ViteComponentExplorerHttpServer {
         };
         return new ViteComponentExplorerHttpServer(server, url.replace(/\/$/, ''), onSourceChange);
     }
+    constructor(_server, url, onSourceChange) {
+        this._server = _server;
+        this.url = url;
+        this.onSourceChange = onSourceChange;
+    }
     async dispose() {
         await this._server.close();
     }
@@ -222,5 +122,5 @@ function globToRegExp(glob) {
     return new RegExp(`(?:^|/)${escaped}$`);
 }
 
-export { DefaultComponentExplorerHttpServerFactory };
-//# sourceMappingURL=httpServer.js.map
+export { createViteServer };
+//# sourceMappingURL=viteServer.js.map

package/dist/server/viteServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viteServer.js","sources":["../../src/server/viteServer.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAgBM,SAAU,gBAAgB,CAAC,OAAuB,EAAE,OAA2B,EAAA;IACpF,OAAO,+BAA+B,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC;AAChE;AAEA,MAAM,+BAA+B,CAAA;AAyGlB,IAAA,OAAA;AACR,IAAA,GAAA;AACA,IAAA,cAAA;AA1GV,IAAA,aAAa,MAAM,CAAC,OAAuB,EAAE,OAA2B,EAAA;AACvE,QAAA,MAAM,GAAG,GAAG,OAAO,EAAE,MAAM,IAAI,UAAU;AACzC,QAAA,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe;AAChD,QAAA,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe;AAChD,QAAA,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY;;;;;;QAM1C,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,OAAO,UAAU,CAAC;QAClD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,OAAO,aAAa,CAAC;;;;;;QAMrD,MAAM,WAAW,GAAG,eAAe,IAAI,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG;QACxE,MAAM,SAAS,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI;QACjD,GAAG,CAAC,KAAK,CAAC,CAAA,qBAAA,EAAwB,WAAW,CAAA,aAAA,EAAgB,SAAS,CAAA,CAAA,CAAG,CAAC;AAC1E,QAAA,GAAG,CAAC,KAAK,CAAC,qBAAqB,eAAe,CAAA,CAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,CAAA,qBAAA,EAAwB,OAAO,CAAC,UAAU,CAAA,CAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,CAAA,cAAA,EAAiB,OAAO,CAAC,GAAG,CAAA,CAAE,CAAC;AACzC,QAAA,IAAI,OAAe;AACnB,QAAA,IAAI;AACH,YAAA,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QACvE;QAAE,OAAO,CAAC,EAAE;YACX,GAAG,CAAC,GAAG,CAAC,CAAA,sCAAA,EAAyC,SAAS,CAAA,EAAA,EAAK,CAAC,CAAA,CAAE,CAAC;AACnE,YAAA,MAAM,CAAC;QACR;AACA,QAAA,GAAG,CAAC,KAAK,CAAC,kBAAkB,OAAO,CAAA,CAAE,CAAC;QACtC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,0BAA0B,OAAO,CAA0B;;;QAI1F,MAAM,SAAS,GAAG,CAAC,CAAS,KAAK,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;AACtG,QAAA,MAAM,YAAY,GAA0B;AAC3C,YAAA,IAAI,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACxC,YAAA,IAAI,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AACnD,YAAA,QAAQ,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,UAAU,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AACvD,YAAA,KAAK,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,WAAW,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;AACrD,YAAA,WAAW,EAAE,MAAK,EAAE,CAAC;AACrB,YAAA,cAAc,EAAE,MAAM,KAAK;AAC3B,YAAA,SAAS,EAAE,KAAK;SAChB;;;;;AAMD,QAAA,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE;AAC7B,QAAA,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAE1B,MAAM,OAAO,GAA4B,EAAE;QAC3C,IAAI,YAAY,EAAE;YACjB,OAAO,CAAC,IAAI,CAAC;AACZ,gBAAA,IAAI,EAAE,kCAAkC;AACxC,gBAAA,OAAO,EAAE,KAAK;AACd,gBAAA,eAAe,CAAC,MAAM,EAAA;AACpB,oBAAA,MAA6C,CAAC,qBAAqB,GAAG,YAAY;gBACpF,CAAC;AACD,aAAA,CAAC;QACH;QAEA,IAAI,eAAe,EAAE;YACpB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC;AACZ,gBAAA,IAAI,EAAE,+BAA+B;AACrC,gBAAA,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,EAAA;AAClC,oBAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE;AACxC,wBAAA,GAAG,CAAC,KAAK,CAAC,oBAAoB,IAAI,CAAA,CAAE,CAAC;wBACrC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;AAClC,wBAAA,OAAO,EAAE;oBACV;gBACD,CAAC;AACD,aAAA,CAAC;QACH;AAEA,QAAA,IAAI,MAAoC;AACxC,QAAA,IAAI;YACH,MAAM,GAAG,MAAM,YAAY,CAAC;gBAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE;gBACtC,YAAY;AACZ,gBAAA,WAAW,EAAE,KAAK;gBAClB,OAAO;AACP,aAAA,CAAC;AACF,YAAA,MAAM,MAAM,CAAC,MAAM,EAAE;QACtB;gBAAU;AACT,YAAA,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;QACvB;AAEA,QAAA,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY;AACxC,QAAA,MAAM,GAAG,GAAG,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,oBAAqB,MAAM,CAAC,UAAU,EAAE,OAAO,EAAuB,EAAE,IAAI,EAAE;AACpH,QAAA,GAAG,CAAC,KAAK,CAAC,wBAAwB,GAAG,CAAA,CAAE,CAAC;AAExC,QAAA,MAAM,cAAc,GAAG,CAAC,QAAoB,KAAI;YAC/C,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC;AACtC,QAAA,CAAC;AAED,QAAA,OAAO,IAAI,+BAA+B,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,cAAc,CAAC;IAC3F;AAEA,IAAA,WAAA,CACkB,OAAqC,EAC7C,GAAW,EACX,cAA8C,EAAA;QAFtC,IAAA,CAAA,OAAO,GAAP,OAAO;QACf,IAAA,CAAA,GAAG,GAAH,GAAG;QACH,IAAA,CAAA,cAAc,GAAd,cAAc;IACpB;AAEJ,IAAA,MAAM,OAAO,GAAA;AACZ,QAAA,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;IAC3B;AACA;AAED;AACA,SAAS,YAAY,CAAC,IAAY,EAAA;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM;AACtD,SAAA,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;AACrB,SAAA,OAAO,CAAC,KAAK,EAAE,OAAO;AACtB,SAAA,OAAO,CAAC,IAAI,EAAE,IAAI;AAClB,SAAA,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;AACrB,IAAA,OAAO,IAAI,MAAM,CAAC,UAAU,OAAO,CAAA,CAAA,CAAG,CAAC;AACxC;;;;"}

package/dist/utils.d.ts

@@ -13,16 +13,21 @@ export declare const EXPLORER_ROUTE = "/___explorer";
 export interface ExplorerUrlOptions {
     /** Base URL of the server (e.g. 'http://localhost:5173') */
     readonly baseUrl: string;
-    /** Use raw render mode instead of the full Explorer UI */
-    readonly rawRender?: boolean;
-    /** Specific fixture to render (only relevant in raw render mode) */
+    /**
+     * Explicit mode for the explorer URL:
+     * - 'headless': for API/screenshot operations (no UI)
+     * - 'embedded': single fixture view for user inspection
+     * - undefined: full Explorer UI
+     */
+    readonly mode?: 'headless' | 'embedded';
+    /** Specific fixture to render (required for 'headless' and 'embedded' modes) */
     readonly fixtureId?: string;
 }
 /**
  * Builds a URL for the Component Explorer.
- * - Default: Explorer UI at `/___explorer`
- * - rawRender: `/___explorer?mode=render`
- * - rawRender + fixtureId: `/___explorer?mode=render&fixture=<id>`
+ * - Default: Explorer UI at `/___explorer` (with optional `fixture=<id>` to pre-select)
+ * - mode='embedded': `/___explorer?mode=embedded&fixture=<id>` (user-facing single fixture view)
+ * - mode='headless': `/___explorer?mode=headless&fixture=<id>` (API/screenshot operations)
  */
 export declare function buildExplorerUrl(options: ExplorerUrlOptions): string;
 export declare function writeFile(filePath: string, data: Uint8Array): Promise<void>;

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,oEAAoE;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAUpE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKrE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAajE"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,UAAU,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACxC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAWpE;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjF;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKrE;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAajE"}

package/dist/utils.js

@@ -8,15 +8,16 @@ import * as path from 'node:path';
 const EXPLORER_ROUTE = '/___explorer';
 /**
  * Builds a URL for the Component Explorer.
- * - Default: Explorer UI at `/___explorer`
- * - rawRender: `/___explorer?mode=render`
- * - rawRender + fixtureId: `/___explorer?mode=render&fixture=<id>`
+ * - Default: Explorer UI at `/___explorer` (with optional `fixture=<id>` to pre-select)
+ * - mode='embedded': `/___explorer?mode=embedded&fixture=<id>` (user-facing single fixture view)
+ * - mode='headless': `/___explorer?mode=headless&fixture=<id>` (API/screenshot operations)
  */
 function buildExplorerUrl(options) {
     const base = `${options.baseUrl}${EXPLORER_ROUTE}`;
-    const query = options.rawRender
-        ? { mode: 'headless', fixture: options.fixtureId }
-        : {};
+    const query = {
+        mode: options.mode,
+        fixture: options.fixtureId,
+    };
     const params = new URLSearchParams(Object.entries(query).filter((entry) => entry[1] !== undefined));
     const queryString = params.toString();
     return queryString ? `${base}?${queryString}` : base;

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sources":["../src/utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAYA;;;AAGG;AACI,MAAM,cAAc,GAAG;AAW9B;;;;;AAKG;AACG,SAAU,gBAAgB,CAAC,OAA2B,EAAA;IAC3D,MAAM,IAAI,GAAG,CAAA,EAAG,OAAO,CAAC,OAAO,CAAA,EAAG,cAAc,CAAA,CAAE;AAClD,IAAA,MAAM,KAAK,GAAwB,OAAO,CAAC;UACxC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS;UAC9C,EAAE;IACL,MAAM,MAAM,GAAG,IAAI,eAAe,CACjC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAgC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAC1F;AACD,IAAA,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE;AACrC,IAAA,OAAO,WAAW,GAAG,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,WAAW,CAAA,CAAE,GAAG,IAAI;AACrD;AAEO,eAAe,SAAS,CAAC,QAAgB,EAAE,IAAgB,EAAA;AACjE,IAAA,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC;AACnC;AAEM,SAAU,SAAS,CAAC,SAAiB,EAAE,OAAe,EAAA;IAC3D,MAAM,KAAK,GAAG,IAAI,MAAM,CACvB,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,GAAG,CAC5D;AACD,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;AAC7B;AAEO,eAAe,YAAY,CAAC,GAAW,EAAA;AAC7C,IAAA,IAAI;AACH,QAAA,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAa,EAAE;AAC5B,QAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;AAC5B,YAAA,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC3B,gBAAA,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9C;QACD;AACA,QAAA,OAAO,OAAO;IACf;AAAE,IAAA,MAAM;AACP,QAAA,OAAO,EAAE;IACV;AACD;;;;"}
+{"version":3,"file":"utils.js","sources":["../src/utils.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAYA;;;AAGG;AACI,MAAM,cAAc,GAAG;AAgB9B;;;;;AAKG;AACG,SAAU,gBAAgB,CAAC,OAA2B,EAAA;IAC3D,MAAM,IAAI,GAAG,CAAA,EAAG,OAAO,CAAC,OAAO,CAAA,EAAG,cAAc,CAAA,CAAE;AAClD,IAAA,MAAM,KAAK,GAAwB;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,SAAS;KAC1B;IACD,MAAM,MAAM,GAAG,IAAI,eAAe,CACjC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,KAAgC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAC1F;AACD,IAAA,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,EAAE;AACrC,IAAA,OAAO,WAAW,GAAG,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,WAAW,CAAA,CAAE,GAAG,IAAI;AACrD;AAEO,eAAe,SAAS,CAAC,QAAgB,EAAE,IAAgB,EAAA;AACjE,IAAA,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC;AACnC;AAEM,SAAU,SAAS,CAAC,SAAiB,EAAE,OAAe,EAAA;IAC3D,MAAM,KAAK,GAAG,IAAI,MAAM,CACvB,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,GAAG,CAC5D;AACD,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;AAC7B;AAEO,eAAe,YAAY,CAAC,GAAW,EAAA;AAC7C,IAAA,IAAI;AACH,QAAA,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAa,EAAE;AAC5B,QAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;AAC5B,YAAA,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE;AAC3B,gBAAA,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9C;QACD;AACA,QAAA,OAAO,OAAO;IACf;AAAE,IAAA,MAAM;AACP,QAAA,OAAO,EAAE;IACV;AACD;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vscode/component-explorer-cli",
-  "version": "0.2.1-1",
+  "version": "0.2.1-10",
   "type": "module",
   "repository": {
     "type": "git",
@@ -26,11 +26,20 @@
       "import": "./dist/daemon/DaemonService.js",
       "types": "./dist/daemon/DaemonService.d.ts"
     },
+    "./daemon-client": {
+      "import": "./dist/daemon/client.js",
+      "types": "./dist/daemon/client.d.ts"
+    },
     "./explorer-types": {
       "import": "./dist/utils.js",
       "types": "./dist/utils.d.ts"
     },
-    "./config-schema.json": "./dist/component-explorer-config.schema.json"
+    "./render-manifest": {
+      "import": "./dist/renderManifest.js",
+      "types": "./dist/renderManifest.d.ts"
+    },
+    "./config-schema.json": "./dist/component-explorer-config.schema.json",
+    "./manifest.schema.json": "./dist/manifest.schema.json"
   },
   "files": [
     "dist",
@@ -39,16 +48,15 @@
     "SECURITY.md"
   ],
   "scripts": {
-    "build": "rollup -c && node --experimental-strip-types scripts/generate-json-schema.ts",
+    "build": "rollup -c && tsx scripts/generate-json-schema.ts",
     "dev": "rollup -c -w",
     "test": "vitest --run",
-    "generate-schema": "node --experimental-strip-types scripts/generate-json-schema.ts"
+    "generate-schema": "tsx scripts/generate-json-schema.ts"
   },
   "dependencies": {
-    "@hediet/semver": "^0.2.2",
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "clipanion": "^4.0.0-rc.4",
-    "express": "^5.0.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "clipanion": "4.0.0-rc.4",
+    "express": "^5.2.1",
     "zod": "^4.3.6"
   },
   "peerDependencies": {
@@ -59,17 +67,20 @@
     "@hediet/simple-api": "workspace:*",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-typescript": "^12.3.0",
-    "@types/express": "^5.0.0",
-    "@types/node": "^20.0.0",
-    "@vitejs/plugin-react": "^4.3.0",
-    "@vscode/component-explorer-vite-plugin": "workspace:*",
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.19.39",
+    "@vitejs/plugin-react": "^4.7.0",
+    "@vscode/component-explorer-common": "workspace:*",
     "@vscode/observables": "workspace:*",
-    "playwright": "^1.40.0",
-    "react": "^18.3.0",
-    "react-dom": "^18.3.0",
-    "rollup": "^4.59.0",
-    "typescript": "^5.4.0",
-    "vite": "^6.0.0",
-    "vitest": "^1.3.0"
+    "@vscode/screenshot-service": "workspace:*",
+    "playwright": "^1.59.1",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "rollup": "^4.60.1",
+    "semver": "workspace:*",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^6.4.2",
+    "vitest": "^1.6.1"
   }
 }

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

@@ -1 +0,0 @@
-{"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;IAC3H,QAAQ,CAAC,MAAM,UAAwG;IACvH,QAAQ,CAAC,OAAO,SAA+G;IAEzH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;YA+ElB,cAAc;CA+B5B"}