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

package/dist/server/httpServer.js

@@ -0,0 +1,110 @@
+import { nullLogger } from '../logger.js';
+import { spawnShellWithTree } from '../processTree.js';
+
+function createHttpServer(urlTemplate, options) {
+    return HttpComponentExplorerServer.create(urlTemplate, 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();
+        // Gracefully terminate the tree, escalating to a forceful kill if needed.
+        await tree.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}`));
+            }
+        });
+    });
+}
+
+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":";;;AAiBM,SAAU,gBAAgB,CAAC,WAAmB,EAAE,OAA2B,EAAA;IAChF,OAAO,2BAA2B,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC;AAChE;AAEA,MAAM,2BAA2B,CAAA;AAyBtB,IAAA,GAAA;AACQ,IAAA,KAAA;AAzBlB,IAAA,aAAa,MAAM,CAAC,WAAmB,EAAE,OAA2B,EAAA;AACnE,QAAA,IAAI,IAA6B;QACjC,IAAI,IAAI,GAA2B,EAAE;AACrC,QAAA,IAAI,OAAO,EAAE,GAAG,EAAE;AACjB,YAAA,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU;YACxC,GAAG,CAAC,KAAK,CAAC,CAAA,sBAAA,EAAyB,OAAO,CAAC,GAAG,CAAA,CAAE,CAAC;AACjD,YAAA,GAAG,CAAC,KAAK,CAAC,CAAA,iBAAA,EAAoB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA,CAAE,CAAC;AAC7D,YAAA,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;YAClE,IAAI,GAAG,IAAI;YACX,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAA,2BAAA,EAA8B,CAAC,CAAC,OAAO,CAAA,CAAE,CAAC,CAAC;YACnF,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,KAAK,GAAG,CAAC,KAAK,CAAC,oCAAoC,IAAI,CAAA,CAAA,CAAG,CAAC,CAAC;AAEzF,YAAA,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE;AACjD,gBAAA,IAAI,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;YACnE;iBAAO;gBACN,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;gBACjF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF;QACD;QACA,MAAM,GAAG,GAAG,kBAAkB,CAAC,WAAW,EAAE,IAAI,CAAC;AACjD,QAAA,OAAO,IAAI,2BAA2B,CAAC,GAAG,EAAE,IAAI,CAAC;IAClD;IAEA,WAAA,CACU,GAAW,EACH,KAA8B,EAAA;QADtC,IAAA,CAAA,GAAG,GAAH,GAAG;QACK,IAAA,CAAA,KAAK,GAAL,KAAK;IACnB;AAEJ,IAAA,MAAM,OAAO,GAAA;AACZ,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK;AACvB,QAAA,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO;AAC1B,QAAA,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE;YAAE;QAAQ;AAEvE,QAAA,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE;AACtB,QAAA,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE;;AAGtB,QAAA,MAAM,IAAI,CAAC,IAAI,EAAE;IAClB;AACA;AAED,SAAS,kBAAkB,CAAC,QAAgB,EAAE,IAA4B,EAAA;IACzE,OAAO,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,IAAY,KAAI;AACrE,QAAA,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,CAAA,2BAAA,EAA8B,IAAI,CAAA,qBAAA,EAAwB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAA,CAAE,CAAC;QACtH;AACA,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC;AAClB,IAAA,CAAC,CAAC;AACH;AAEA,MAAM,UAAU,GAAG,CAAC,CAAS,KAAK,CAAC,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;AAEvG,SAAS,oBAAoB,CAC5B,IAAkB,EAClB,IAA4D,EAC5D,GAAY,EAAA;IAEZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,KAAI;QACtC,IAAI,QAAQ,GAAG,KAAK;QACpB,MAAM,IAAI,GAA2B,EAAE;AACvC,QAAA,IAAI,YAAY,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE;QAE1C,MAAM,UAAU,GAAG,MAAK;AACvB,YAAA,IAAI,QAAQ,IAAI,YAAY,GAAG,CAAC,EAAE;gBAAE;YAAQ;YAC5C,QAAQ,GAAG,IAAI;YACf,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC;AACd,QAAA,CAAC;AAED,QAAA,MAAM,WAAW,GAAG,CAAC,MAA2B,EAAE,OAAe,KAAI;AACpE,YAAA,MAAM,OAAO,GAAG,CAAC,CAAS,KAAI;AAC7B,gBAAA,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE;gBACzB,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACzB,OAAO,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC;gBACnC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACvC,IAAI,CAAC,EAAE;AACN,oBAAA,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA,kBAAA,EAAqB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAA,CAAE,CAAC;oBACzE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;oBAClC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;AACnC,oBAAA,YAAY,EAAE;AACd,oBAAA,UAAU,EAAE;gBACb;AACD,YAAA,CAAC;AACD,YAAA,OAAO,OAAO;AACf,QAAA,CAAC;AAED,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AAChB,YAAA,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D;aAAO;YACN,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E;AAEA,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AAChB,YAAA,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D;aAAO;YACN,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E;QAEA,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,KAAI;YACxB,IAAI,CAAC,QAAQ,EAAE;gBACd,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAA,gBAAA,EAAmB,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,GAAG,mBAAmB,OAAO,CAAC,MAAM,CAAA,CAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3J,MAAM,CAAC,IAAI,KAAK,CAAC,CAAA,iCAAA,EAAoC,IAAI,CAAA,wCAAA,EAA2C,OAAO,CAAA,CAAE,CAAC,CAAC;YAChH;AACD,QAAA,CAAC,CAAC;AACH,IAAA,CAAC,CAAC;AACH;;;;"}

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,59 @@
+import type { ComponentExplorerHttpServer } from './types.js';
+import type { ILogger } from '../logger.js';
+import { AbsolutePath } from '../path.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;
+    };
+    /**
+     * If set and the server is a Vite server, vite-plugin-istanbul is injected
+     * to instrument JS sources matching the given globs. The instrumented code
+     * exposes coverage on `window.__coverage__`. No-op for HTTP servers.
+     */
+    readonly istanbulCoverage?: {
+        readonly include: readonly string[];
+        readonly exclude: readonly string[];
+    };
+    /**
+     * If true and the server is a Vite server, a small post-transform plugin
+     * appends `/*# sourceURL=<id> *\/` to the CSS payload of each `.css`
+     * module so that Vite's HMR-injected `<style>` tags become visible to
+     * Playwright's CSS coverage (which silently skips anonymous stylesheets).
+     * No-op for HTTP servers.
+     */
+    readonly cssSourceUrl?: boolean;
+}
+export interface ResolvedViteHmrConfig {
+    readonly allowedPaths: readonly string[];
+}
+export declare class ViteServerConfig extends ResolvedServerConfig {
+    readonly viteProject: ViteProjectRef;
+    readonly hmr: ResolvedViteHmrConfig | undefined;
+    readonly kind = "vite";
+    constructor(viteProject: ViteProjectRef, hmr: ResolvedViteHmrConfig | undefined);
+    forWorktree(repoRoot: AbsolutePath, worktreePath: AbsolutePath, _configDir: AbsolutePath): ViteServerConfig;
+    createServer(ctx: ServerContext): Promise<ComponentExplorerHttpServer>;
+}
+export interface ResolvedHttpWaitConfig {
+    readonly stdout?: RegExp;
+    readonly stderr?: RegExp;
+}
+export declare class HttpServerConfig extends ResolvedServerConfig {
+    readonly urlTemplate: string;
+    readonly cmd: string | undefined;
+    readonly cwd: AbsolutePath;
+    readonly wait: ResolvedHttpWaitConfig | undefined;
+    readonly kind = "http";
+    constructor(urlTemplate: string, cmd: string | undefined, cwd: AbsolutePath, 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":"AAEA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,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;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,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;IACF;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,qBAAa,gBAAiB,SAAQ,oBAAoB;IAIxD,QAAQ,CAAC,WAAW,EAAE,cAAc;IACpC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,SAAS;IAJhD,QAAQ,CAAC,IAAI,UAAU;gBAGb,WAAW,EAAE,cAAc,EAC3B,GAAG,EAAE,qBAAqB,GAAG,SAAS;IAKhD,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,GAAG,gBAAgB;IAKrG,YAAY,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAS5E;AAED,MAAM,WAAW,sBAAsB;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gBAAiB,SAAQ,oBAAoB;IAIxD,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS;IAChC,QAAQ,CAAC,GAAG,EAAE,YAAY;IAC1B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,SAAS;IANlD,QAAQ,CAAC,IAAI,UAAU;gBAGb,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,YAAY,EACjB,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,53 @@
+import { createHttpServer } from './httpServer.js';
+import { createViteServer } from './viteServer.js';
+
+class ResolvedServerConfig {
+}
+class ViteServerConfig extends ResolvedServerConfig {
+    viteProject;
+    hmr;
+    kind = 'vite';
+    constructor(viteProject, hmr) {
+        super();
+        this.viteProject = viteProject;
+        this.hmr = hmr;
+    }
+    forWorktree(repoRoot, worktreePath, _configDir) {
+        const newViteProject = this.viteProject.rebase(repoRoot, worktreePath);
+        return new ViteServerConfig(newViteProject, this.hmr);
+    }
+    async createServer(ctx) {
+        return createViteServer(this.viteProject, {
+            logger: ctx.logger,
+            hmrAllowedPaths: this.hmr?.allowedPaths,
+            daemonConfig: ctx.daemonConfig,
+            istanbulCoverage: ctx.istanbulCoverage,
+            cssSourceUrl: ctx.cssSourceUrl,
+        });
+    }
+}
+class HttpServerConfig extends ResolvedServerConfig {
+    urlTemplate;
+    cmd;
+    cwd;
+    wait;
+    kind = 'http';
+    constructor(urlTemplate, cmd, cwd, wait) {
+        super();
+        this.urlTemplate = urlTemplate;
+        this.cmd = cmd;
+        this.cwd = cwd;
+        this.wait = wait;
+    }
+    async createServer(ctx) {
+        return createHttpServer(this.urlTemplate, {
+            cmd: this.cmd,
+            cwd: this.cwd.value,
+            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;AAiCK,MAAO,gBAAiB,SAAQ,oBAAoB,CAAA;AAI/C,IAAA,WAAA;AACA,IAAA,GAAA;IAJD,IAAI,GAAG,MAAM;IAEtB,WAAA,CACU,WAA2B,EAC3B,GAAsC,EAAA;AAE/C,QAAA,KAAK,EAAE;QAHE,IAAA,CAAA,WAAW,GAAX,WAAW;QACX,IAAA,CAAA,GAAG,GAAH,GAAG;IAGb;AAEA,IAAA,WAAW,CAAC,QAAsB,EAAE,YAA0B,EAAE,UAAwB,EAAA;AACvF,QAAA,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC;QACtE,OAAO,IAAI,gBAAgB,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC;IACtD;IAEA,MAAM,YAAY,CAAC,GAAkB,EAAA;AACpC,QAAA,OAAO,gBAAgB,CAAC,IAAI,CAAC,WAAW,EAAE;YACzC,MAAM,EAAE,GAAG,CAAC,MAAM;AAClB,YAAA,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,YAAY;YACvC,YAAY,EAAE,GAAG,CAAC,YAAY;YAC9B,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,YAAY,EAAE,GAAG,CAAC,YAAY;AAC9B,SAAA,CAAC;IACH;AACA;AAOK,MAAO,gBAAiB,SAAQ,oBAAoB,CAAA;AAI/C,IAAA,WAAA;AACA,IAAA,GAAA;AACA,IAAA,GAAA;AACA,IAAA,IAAA;IAND,IAAI,GAAG,MAAM;AAEtB,IAAA,WAAA,CACU,WAAmB,EACnB,GAAuB,EACvB,GAAiB,EACjB,IAAwC,EAAA;AAEjD,QAAA,KAAK,EAAE;QALE,IAAA,CAAA,WAAW,GAAX,WAAW;QACX,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,WAAW,EAAE;YACzC,GAAG,EAAE,IAAI,CAAC,GAAG;AACb,YAAA,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK;YACnB,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,31 @@
+import { type ILogger } from '../logger.js';
+import { ViteProjectRef } from '../viteProjectRef.js';
+import type { ComponentExplorerHttpServer } from './types.js';
+export interface ViteServerOptions {
+    readonly resolveViteFromPath?: string;
+    readonly logger?: ILogger;
+    readonly hmrAllowedPaths?: readonly string[];
+    readonly daemonConfig?: {
+        readonly pipeName: string;
+        readonly sessionName: string;
+        readonly daemonApiVersion: string;
+        readonly pluginProtocolVersion: string;
+    };
+    /**
+     * If set, vite-plugin-istanbul is injected to instrument matching files.
+     * After fixture render, JS coverage is exposed on `window.__coverage__`.
+     */
+    readonly istanbulCoverage?: {
+        readonly include: readonly string[];
+        readonly exclude: readonly string[];
+    };
+    /**
+     * If true, a tiny post-transform plugin appends `/*# sourceURL=<id> *\/` to
+     * the CSS payload that Vite injects via `<style>` tags. This makes those
+     * stylesheets visible to Playwright's CSS coverage (which silently skips
+     * stylesheets without a sourceURL — see Playwright `crCoverage.ts`).
+     */
+    readonly cssSourceUrl?: boolean;
+}
+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,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,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;IACF;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;QACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC;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,120 +1,14 @@
-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;
         const hmrAllowedPaths = options?.hmrAllowedPaths;
         const daemonConfig = options?.daemonConfig;
         // Import Vite from the target project's node_modules, not ours.
@@ -129,10 +23,9 @@ class ViteComponentExplorerHttpServer {
         // We always use createRequire because import.meta.resolve's second
         // argument is ignored in some Node.js versions (it resolves from
         // the calling file instead of the specified parentUrl).
-        const resolveFrom = resolveViteFrom ?? project.configFile ?? project.cwd;
+        const resolveFrom = (project.configFile ?? project.cwd).value;
         const parentUrl = pathToFileURL(resolveFrom).href;
         log.debug(`Resolving vite from: ${resolveFrom} (parentUrl: ${parentUrl})`);
-        log.debug(`  resolveViteFrom=${resolveViteFrom}`);
         log.debug(`  project.configFile=${project.configFile}`);
         log.debug(`  project.cwd=${project.cwd}`);
         let viteUrl;
@@ -162,7 +55,7 @@ class ViteComponentExplorerHttpServer {
         // takes precedence over the config file, which would break configs
         // that set their own `root` (e.g. `root: '../..'`).
         const prevCwd = process.cwd();
-        process.chdir(project.cwd);
+        process.chdir(project.cwd.value);
         const plugins = [];
         if (daemonConfig) {
             plugins.push({
@@ -186,10 +79,29 @@ class ViteComponentExplorerHttpServer {
                 },
             });
         }
+        if (options?.istanbulCoverage) {
+            // vite-plugin-istanbul is dynamically imported from the CLI's own
+            // node_modules. The plugin is consumed by the user's Vite instance
+            // (resolved separately above) but the plugin source itself is portable.
+            log.debug(`Injecting vite-plugin-istanbul (include=${options.istanbulCoverage.include.join(',')}, exclude=${options.istanbulCoverage.exclude.join(',')})`);
+            const istanbulMod = await import('vite-plugin-istanbul');
+            const istanbulPlugin = istanbulMod.default({
+                include: [...options.istanbulCoverage.include],
+                exclude: [...options.istanbulCoverage.exclude],
+                extension: ['.js', '.ts', '.jsx', '.tsx', '.mjs', '.cjs'],
+                requireEnv: false,
+                forceBuildInstrument: false,
+            });
+            plugins.push(istanbulPlugin);
+        }
+        if (options?.cssSourceUrl) {
+            log.debug('Injecting CSS sourceURL plugin (for Playwright CSS coverage)');
+            plugins.push(createCssSourceUrlPlugin(log));
+        }
         let server;
         try {
             server = await createServer({
-                configFile: project.configFile,
+                configFile: project.configFile?.value,
                 server: { port: 0, strictPort: false },
                 customLogger,
                 clearScreen: false,
@@ -208,6 +120,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();
     }
@@ -221,6 +138,70 @@ function globToRegExp(glob) {
         .replace(/\?/g, '.');
     return new RegExp(`(?:^|/)${escaped}$`);
 }
+const CSS_EXT_RE = /\.(css|scss|sass|less|styl|stylus|pcss|postcss|sss)(\?|$)/;
+/**
+ * Vite's CSS transform emits JS like:
+ *
+ *     import { updateStyle as __vite__updateStyle, ... } from "/@vite/client"
+ *     const __vite__id = "/abs/path/foo.css"
+ *     const __vite__css = "...css text..."
+ *     __vite__updateStyle(__vite__id, __vite__css)
+ *
+ * `__vite__updateStyle` creates a `<style>` tag with `data-vite-dev-id` but
+ * does NOT add a `/*# sourceURL=… *\/` annotation, so Chrome treats the
+ * stylesheet as anonymous. Playwright's CSS coverage drops anonymous
+ * stylesheets in `crCoverage.ts`, making such CSS invisible to coverage.
+ *
+ * This plugin appends `\n/*# sourceURL=<id> *\/` to the CSS string literal
+ * inside the transformed module, so DevTools (and Playwright) attribute the
+ * `<style>` tag back to the source file.
+ */
+function createCssSourceUrlPlugin(log) {
+    let projectRoot = '';
+    return {
+        name: 'component-explorer-css-source-url',
+        enforce: 'post',
+        configResolved(config) {
+            projectRoot = config.root;
+        },
+        transform(code, id) {
+            if (!CSS_EXT_RE.test(id)) {
+                return;
+            }
+            if (!code.includes('__vite__updateStyle')) {
+                return;
+            }
+            // Match: const __vite__css = "..."
+            // The CSS payload is JSON-encoded by Vite (so all newlines are \n,
+            // quotes escaped). We re-decode → append annotation → re-encode.
+            const re = /(const\s+__vite__css\s*=\s*)("(?:[^"\\]|\\.)*")/;
+            const match = re.exec(code);
+            if (!match) {
+                log.trace(`css-source-url: no __vite__css literal in ${id}`);
+                return;
+            }
+            const cleanId = id.split('?')[0];
+            const relUrl = projectRoot
+                ? '/' + cleanId.slice(projectRoot.length).replace(/^[\\/]+/, '').replace(/\\/g, '/')
+                : cleanId;
+            let css;
+            try {
+                css = JSON.parse(match[2]);
+            }
+            catch {
+                return;
+            }
+            // Idempotent: don't double-annotate on HMR re-transforms.
+            if (css.includes('# sourceURL=')) {
+                return;
+            }
+            const annotated = css + `\n/*# sourceURL=${relUrl} */\n`;
+            const newLiteral = JSON.stringify(annotated);
+            const patched = code.slice(0, match.index) + match[1] + newLiteral + code.slice(match.index + match[0].length);
+            return { code: patched, map: null };
+        },
+    };
+}
 
-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":"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"}

package/dist/storage.d.ts

@@ -1,3 +1,4 @@
+import { AbsolutePath } from './path.js';
 export interface Storage {
     write(filePath: string, data: Uint8Array): Promise<void>;
     read(filePath: string): Promise<Uint8Array>;
@@ -7,7 +8,7 @@ export interface Storage {
 }
 export declare class FileSystemStorage implements Storage {
     private readonly _rootDir;
-    constructor(_rootDir: string);
+    constructor(_rootDir: AbsolutePath);
     private _resolve;
     write(filePath: string, data: Uint8Array): Promise<void>;
     read(filePath: string): Promise<Uint8Array>;

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,OAAO;IACvB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,qBAAa,iBAAkB,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,MAAM;IAE7C,OAAO,CAAC,QAAQ;IAIV,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBvC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7C"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,WAAW,OAAO;IACvB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,qBAAa,iBAAkB,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAEnD,OAAO,CAAC,QAAQ;IAIV,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxD,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBvC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7C"}

package/dist/storage.js

@@ -7,7 +7,7 @@ class FileSystemStorage {
         this._rootDir = _rootDir;
     }
     _resolve(filePath) {
-        return path.join(this._rootDir, ...filePath.split('/'));
+        return path.join(this._rootDir.value, ...filePath.split('/'));
     }
     async write(filePath, data) {
         const fullPath = this._resolve(filePath);

package/dist/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sources":["../src/storage.ts"],"sourcesContent":[null],"names":[],"mappings":";;;MAWa,iBAAiB,CAAA;AACA,IAAA,QAAA;AAA7B,IAAA,WAAA,CAA6B,QAAgB,EAAA;QAAhB,IAAA,CAAA,QAAQ,GAAR,QAAQ;IAAW;AAExC,IAAA,QAAQ,CAAC,QAAgB,EAAA;AAChC,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACxD;AAEA,IAAA,MAAM,KAAK,CAAC,QAAgB,EAAE,IAAgB,EAAA;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;AACxC,QAAA,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC;IACnC;IAEA,MAAM,IAAI,CAAC,QAAgB,EAAA;AAC1B,QAAA,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE;IAEA,MAAM,MAAM,CAAC,QAAgB,EAAA;AAC5B,QAAA,IAAI;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxC,YAAA,OAAO,IAAI;QACZ;AAAE,QAAA,MAAM;AACP,YAAA,OAAO,KAAK;QACb;IACD;IAEA,MAAM,IAAI,CAAC,MAAc,EAAA;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;AACjC,QAAA,IAAI;AACH,YAAA,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAa,EAAE;AAC5B,YAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;gBACvC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;AACrC,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;oBAClB,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7D;YACD;AACA,YAAA,OAAO,OAAO;QACf;AAAE,QAAA,MAAM;AACP,YAAA,OAAO,EAAE;QACV;IACD;IAEA,MAAM,MAAM,CAAC,QAAgB,EAAA;AAC5B,QAAA,IAAI;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC;AAAE,QAAA,MAAM;;QAER;IACD;AACA;;;;"}
+{"version":3,"file":"storage.js","sources":["../src/storage.ts"],"sourcesContent":[null],"names":[],"mappings":";;;MAYa,iBAAiB,CAAA;AACA,IAAA,QAAA;AAA7B,IAAA,WAAA,CAA6B,QAAsB,EAAA;QAAtB,IAAA,CAAA,QAAQ,GAAR,QAAQ;IAAkB;AAE/C,IAAA,QAAQ,CAAC,QAAgB,EAAA;AAChC,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9D;AAEA,IAAA,MAAM,KAAK,CAAC,QAAgB,EAAE,IAAgB,EAAA;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;AACxC,QAAA,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC3D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC;IACnC;IAEA,MAAM,IAAI,CAAC,QAAgB,EAAA;AAC1B,QAAA,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE;IAEA,MAAM,MAAM,CAAC,QAAgB,EAAA;AAC5B,QAAA,IAAI;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACxC,YAAA,OAAO,IAAI;QACZ;AAAE,QAAA,MAAM;AACP,YAAA,OAAO,KAAK;QACb;IACD;IAEA,MAAM,IAAI,CAAC,MAAc,EAAA;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;AACjC,QAAA,IAAI;AACH,YAAA,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;YAC1D,MAAM,OAAO,GAAa,EAAE;AAC5B,YAAA,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE;gBAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;gBACvC,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;AACrC,gBAAA,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE;oBAClB,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC7D;YACD;AACA,YAAA,OAAO,OAAO;QACf;AAAE,QAAA,MAAM;AACP,YAAA,OAAO,EAAE;QACV;IACD;IAEA,MAAM,MAAM,CAAC,QAAgB,EAAA;AAC5B,QAAA,IAAI;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACzC;AAAE,QAAA,MAAM;;QAER;IACD;AACA;;;;"}

package/dist/utils.d.ts

@@ -1,31 +1,9 @@
-export type ExplorerMode = 'headless' | 'embedded';
-export interface ExplorerQueryParams {
-    readonly mode?: ExplorerMode;
-    readonly fixture?: string;
-    readonly file?: string;
-    readonly report?: string;
-}
+import { AbsolutePath } from './path.js';
 /**
  * The default route path for the Component Explorer.
  * Must match the default in vite-plugin.
  */
 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) */
-    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>`
- */
-export declare function buildExplorerUrl(options: ExplorerUrlOptions): string;
-export declare function writeFile(filePath: string, data: Uint8Array): Promise<void>;
-export declare function matchGlob(fixtureId: string, pattern: string): boolean;
-export declare function listPngFiles(dir: string): Promise<string[]>;
+export declare function writeFile(filePath: AbsolutePath, data: Uint8Array): Promise<void>;
+export declare function listPngFiles(dir: AbsolutePath): Promise<string[]>;
 //# sourceMappingURL=utils.d.ts.map