cssprobe-cli 0.2.21 → 0.2.23

package/README.md

@@ -130,6 +130,7 @@ cssprobe-cli inspect body --json | jq '.findings[] | {id, confidence, message}'
 | `open [url] --state <file>` | Open with saved cookies + localStorage |
 | `open [url] --viewport 1280x720` | Custom viewport size |
 | `close` | Close browser session |
+| `close --all` | Close all sessions across all workspaces |
 | `status` | Show session status |
 
 ### CSS Inspection

package/dist/browser/launcher.d.ts

@@ -1,4 +1,4 @@
-import { type Page } from 'playwright-core';
+import { type BrowserContext, type Page } from 'playwright-core';
 import type { Snapshot, CollectConfig } from '../engine/types';
 export interface LauncherOptions {
     browser?: string;
@@ -23,5 +23,7 @@ export declare class BrowserLauncher {
     navigate(url: string): Promise<void>;
     /** Get the current page object. */
     getPage(): Page | null;
+    /** Get the current browser context. */
+    getContext(): BrowserContext | null;
     close(): Promise<void>;
 }

package/dist/browser/launcher.js

@@ -129,6 +129,10 @@ class BrowserLauncher {
     getPage() {
         return this.page;
     }
+    /** Get the current browser context. */
+    getContext() {
+        return this.context;
+    }
     async close() {
         if (this.context)
             await this.context.close().catch(() => { });

package/dist/cli/commands.js

@@ -63,6 +63,9 @@ const close = (0, command_1.declareCommand)({
     name: 'close',
     category: 'core',
     description: 'Close the browser session',
+    options: z.object({
+        all: z.boolean().optional().describe('close all sessions across all workspaces'),
+    }),
 });
 const status = (0, command_1.declareCommand)({
     name: 'status',
@@ -167,6 +170,14 @@ const stateImport = (0, command_1.declareCommand)({
         merge: z.string().optional().describe('existing state file to merge into'),
     }),
 });
+const stateSave = (0, command_1.declareCommand)({
+    name: 'state-save',
+    category: 'core',
+    description: 'Save current browser session state (cookies + localStorage)',
+    options: z.object({
+        name: z.string().optional().describe('state file name (default: session)'),
+    }),
+});
 // ── config ──
 const configShow = (0, command_1.declareCommand)({
     name: 'config-show',
@@ -244,7 +255,7 @@ const commandsArray = [
     // browser
     resize, evalCmd, playwrightCmd, screenshot,
     // state
-    stateImport,
+    stateImport, stateSave,
     // config
     configShow, configSet, configList, configUse, configNew, configPath,
     // skill

package/dist/cli/program.js

@@ -43,7 +43,7 @@ async function program() {
             await handleOpen(command, rawArgs, output);
             return;
         case 'close':
-            await handleClose(output);
+            await handleClose(command, rawArgs, output);
             return;
         case 'status':
             await handleStatus(output);
@@ -51,6 +51,9 @@ async function program() {
         case 'state-import':
             await handleStateImport(command, rawArgs, output);
             return;
+        case 'state-save':
+            await handleStateSave(command, rawArgs, output);
+            return;
         case 'inspect':
         case 'tree':
         case 'layout':
@@ -172,19 +175,47 @@ async function waitForSession(timeoutMs) {
     }
     return undefined;
 }
-async function handleClose(output) {
+async function handleClose(command, args, output) {
     try {
-        const session = await (0, session_1.loadSession)();
-        if (!session) {
-            output.error('No active session. Run: cssprobe-cli open <url>');
-            return;
-        }
-        await session.stop();
-        if (output.json) {
-            console.log(JSON.stringify({ closed: true, sessionId: 'default' }, null, 2));
+        const cmdArgs = splitArgs(args);
+        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
+        if (parsed.all) {
+            const sessions = await (0, session_1.listAllSessions)();
+            if (sessions.length === 0) {
+                output.error('No active sessions found.');
+                return;
+            }
+            const results = [];
+            for (const session of sessions) {
+                try {
+                    await session.stop();
+                    results.push({ sessionId: session.name, closed: true });
+                }
+                catch (e) {
+                    results.push({ sessionId: session.name, closed: false, error: e.message });
+                }
+            }
+            if (output.json) {
+                console.log(JSON.stringify({ closed: results }, null, 2));
+            }
+            else {
+                const closedCount = results.filter(r => r.closed).length;
+                console.log(`Closed ${closedCount} session(s).`);
+            }
         }
         else {
-            console.log('Browser closed.');
+            const session = await (0, session_1.loadSession)();
+            if (!session) {
+                output.error('No active session. Run: cssprobe-cli open <url>');
+                return;
+            }
+            await session.stop();
+            if (output.json) {
+                console.log(JSON.stringify({ closed: true, sessionId: 'default' }, null, 2));
+            }
+            else {
+                console.log('Browser closed.');
+            }
         }
     }
     catch (e) {
@@ -464,4 +495,44 @@ async function handleStateImport(command, args, output) {
         output.error(e instanceof Error ? e.message : String(e));
     }
 }
+// ── state-save ──
+async function handleStateSave(command, args, output) {
+    try {
+        const session = await (0, session_1.loadSession)();
+        if (!session) {
+            output.error('No active session. Run: cssprobe-cli open <url>');
+            return;
+        }
+        const cmdArgs = splitArgs(args);
+        const parsed = (0, command_1.parseCommand)(command, cmdArgs);
+        const name = parsed.name || 'session';
+        const fileName = name.endsWith('.json') ? name : `${name}.json`;
+        const outPath = path_1.default.join(os_1.default.homedir(), '.cssprobe-cli', 'states', fileName);
+        // Ask daemon to save state
+        const result = await session.run({ _: ['state-save'] });
+        const state = JSON.parse(result.text);
+        const resolvedOut = path_1.default.resolve(outPath);
+        const dir = path_1.default.dirname(resolvedOut);
+        if (!fs_1.default.existsSync(dir))
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(resolvedOut, JSON.stringify(state, null, 2) + '\n');
+        if (output.json) {
+            console.log(JSON.stringify({
+                saved: resolvedOut,
+                cookies: state.cookies?.length || 0,
+                origins: state.origins?.length || 0,
+                usage: `cssprobe-cli open <url> --state ${resolvedOut}`,
+            }, null, 2));
+        }
+        else {
+            console.log(`State saved: ${resolvedOut}`);
+            console.log(`Cookies: ${state.cookies?.length || 0}`);
+            console.log(`Origins: ${state.origins?.length || 0}`);
+            console.log(`Usage: cssprobe-cli open <url> --state ${resolvedOut}`);
+        }
+    }
+    catch (e) {
+        output.error(e instanceof Error ? e.message : String(e));
+    }
+}
 //# sourceMappingURL=program.js.map

package/dist/daemon/daemon.js

@@ -200,6 +200,13 @@ async function executeCommand(launcher, args) {
             const result = await asyncFunction(page, browser);
             return { text: JSON.stringify(result, null, 2) };
         }
+        case 'state-save': {
+            const context = launcher.getContext();
+            if (!context)
+                throw new Error('Browser is not open. Run: cssprobe-cli open <url>');
+            const state = await context.storageState();
+            return { text: JSON.stringify(state) };
+        }
         default:
             throw new Error(`Unknown command: ${command}`);
     }

package/dist/daemon/session.d.ts

@@ -50,3 +50,4 @@ export declare function createClientInfo(): ClientInfo;
 export declare function loadSession(): Promise<Session | undefined>;
 export declare function saveSession(config: SessionConfig): Promise<void>;
 export declare function deleteSession(): Promise<void>;
+export declare function listAllSessions(): Promise<Session[]>;

package/dist/daemon/session.js

@@ -13,6 +13,7 @@ exports.createClientInfo = createClientInfo;
 exports.loadSession = loadSession;
 exports.saveSession = saveSession;
 exports.deleteSession = deleteSession;
+exports.listAllSessions = listAllSessions;
 const crypto_1 = __importDefault(require("crypto"));
 const fs_1 = __importDefault(require("fs"));
 const net_1 = __importDefault(require("net"));
@@ -229,4 +230,28 @@ async function deleteSession() {
     const sessionFile = path_1.default.join(clientInfo.daemonProfilesDir, 'default.session');
     await fs_1.default.promises.unlink(sessionFile).catch(() => { });
 }
+async function listAllSessions() {
+    const sessions = [];
+    const baseDir = path_1.default.dirname(createClientInfo().daemonProfilesDir);
+    try {
+        const entries = await fs_1.default.promises.readdir(baseDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const sessionFile = path_1.default.join(baseDir, entry.name, 'default.session');
+            try {
+                const data = await fs_1.default.promises.readFile(sessionFile, 'utf-8');
+                const config = JSON.parse(data);
+                sessions.push(new Session({ file: sessionFile, config, daemonDir: path_1.default.join(baseDir, entry.name) }));
+            }
+            catch {
+                // Skip invalid session files
+            }
+        }
+    }
+    catch {
+        // Base directory doesn't exist
+    }
+    return sessions;
+}
 //# sourceMappingURL=session.js.map

package/dist/engine/analyzer.js

@@ -200,9 +200,14 @@ function analyzeScroll(snapshot) {
             message = `${nodeLabel(n)} no overflow, no scroll needed`;
             level = 'info';
         }
+        else if (n.props.overflowY === 'visible') {
+            id = 'overflow-visible';
+            message = `${nodeLabel(n)} content visually overflows (${n.metrics.scrollHeight}>${n.metrics.clientHeight}) but overflow=visible means content is NOT clipped`;
+            level = 'info';
+        }
         else {
             id = 'overflow-clipped';
-            message = `${nodeLabel(n)} content overflows (${n.metrics.scrollHeight}>${n.metrics.clientHeight}) clipped by overflow=${n.props.overflowY} → height chain unconstrained (anchor issue)`;
+            message = `${nodeLabel(n)} content overflows (${n.metrics.scrollHeight}>${n.metrics.clientHeight}) clipped by overflow=${n.props.overflowY}`;
             level = 'warning';
         }
         findings.push(makeFinding({

package/dist/engine/renderers/dom-tree.js

@@ -7,7 +7,7 @@ function renderNode(node, indent) {
         return lines;
     const cls = node.classes.length ? `.${node.classes.join('.')}` : '';
     const id = node.id ? `#${node.id}` : '';
-    const repeat = node.repeat ? ` \u00D7${node.repeat}` : '';
+    const repeat = node.repeat ? ` \u00D7${node.repeat} (first shown, use :nth-child(N) for others)` : '';
     const m = node.metrics;
     const s = node.shape || {};
     const flag = [];

package/dist/help.json

@@ -1,5 +1,5 @@
 {
-  "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  state-import [file]         import cookies from netscape format file\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
+  "global": "Usage: cssprobe-cli <command> [args] [options]\n\n\nSession Management:\n  open [url]                  open browser in session mode (non-blocking)\n  close                       close the browser session\n  status                      show current session status\n  resize <width> <height>     resize the browser viewport\n  eval <expression>           evaluate javascript expression on the page (browser context)\n  playwright <call>           execute playwright api call (node.js context)\n  state-import [file]         import cookies from netscape format file\n  state-save                  save current browser session state (cookies + localstorage)\n\nCSS Inspection:\n  inspect <selector>          inspect the runtime css of a page element\n  tree <selector>             show dom tree structure\n  layout <selector>           show ascii layout diagram\n  findings <selector>         show only issues/warnings/errors\n  inject-css <css>            inject css into the current page\n\nExport:\n  screenshot                  take a screenshot of the current page\n\nConfiguration:\n  config-show                 show current configuration\n  config-set <key> <value>    set a configuration value\n  config-list                 list all profiles\n  config-use <name>           switch active profile\n  config-new <name>           create a new profile\n  config-path                 show configuration file path\n\nAgent Skills:\n  skill-install               install agent skill for cssprobe-cli\n  skill-uninstall             remove agent skill for cssprobe-cli\n\nGlobal options:\n  --help [command]            print help\n  --json                      output response as JSON\n  --raw                       output only the result value\n  --version                   print version\n  -p, --profile <name>        use named profile (or CSSPROBE_PROFILE env)",
   "commands": {
     "open": {
       "help": "cssprobe-cli open [url]\n\nOpen browser in session mode (non-blocking)\n\nArguments:\n  [url]                       url, file:// path, or local html file path\nOptions:\n  --browser                   browser engine (default chromium)\n  --headed                    show the browser window\n  --viewport                  viewport size as wxh (e.g. 1280x720)\n  --state                     path to saved state file (cookies + localstorage)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
@@ -14,8 +14,10 @@
       ]
     },
     "close": {
-      "help": "cssprobe-cli close \n\nClose the browser session\n\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
-      "flags": {},
+      "help": "cssprobe-cli close \n\nClose the browser session\n\nOptions:\n  --all                       close all sessions across all workspaces\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "all": "boolean"
+      },
       "args": []
     },
     "status": {
@@ -105,6 +107,13 @@
         "file"
       ]
     },
+    "state-save": {
+      "help": "cssprobe-cli state-save \n\nSave current browser session state (cookies + localStorage)\n\nOptions:\n  --name                      state file name (default: session)\n\nGlobal options:\n  --json                      output as JSON\n  --profile, -p <name>        use named profile",
+      "flags": {
+        "name": "string"
+      },
+      "args": []
+    },
     "config-show": {
       "help": "cssprobe-cli config-show \n\nShow current configuration\n\nOptions:\n  --profile                   profile name",
       "flags": {
@@ -167,6 +176,7 @@
   },
   "booleanOptions": [
     "headed",
+    "all",
     "json",
     "brief",
     "layout",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cssprobe-cli",
-  "version": "0.2.21",
+  "version": "0.2.23",
   "description": "Runtime CSS probe — inspect layout, colors, backgrounds, fonts and more in a live browser. AI agents and shell automation.",
   "keywords": [
     "css",