cssprobe-cli 0.3.0 → 0.4.0

package/dist/scenario/schema.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suiteSchema = exports.caseSchema = exports.stepSchema = void 0;
+const z = __importStar(require("zod"));
+const waitUntil = z.enum(['domcontentloaded', 'load', 'networkidle']).optional();
+const matcherFields = {
+    eq: z.unknown().optional(),
+    ne: z.unknown().optional(),
+    match: z.string().optional(),
+    within: z.object({ expected: z.number(), tolerance: z.number() }).optional(),
+    min: z.number().optional(),
+    max: z.number().optional(),
+};
+const gotoStep = z.object({
+    do: z.literal('goto'),
+    url: z.string(),
+    waitUntil,
+    save: z.string().optional(),
+});
+const reloadStep = z.object({
+    do: z.literal('reload'),
+    waitUntil,
+    save: z.string().optional(),
+});
+const evalStep = z.object({
+    do: z.literal('eval'),
+    expression: z.string(),
+    frame: z.string().optional(),
+    save: z.string().optional(),
+});
+const sampleStep = z.object({
+    do: z.literal('sample'),
+    expression: z.string(),
+    interval: z.number().optional(),
+    duration: z.number().optional(),
+    key: z.string().optional(),
+    tailFrom: z.number().optional(),
+    ignoreErrors: z.boolean().optional(),
+    frame: z.string().optional(),
+    save: z.string().optional(),
+});
+const waitStableStep = z.object({
+    do: z.literal('waitStable'),
+    expression: z.string(),
+    tolerance: z.number().optional(),
+    window: z.number().optional(),
+    timeout: z.number().optional(),
+    interval: z.number().optional(),
+    frame: z.string().optional(),
+    save: z.string().optional(),
+});
+const clickStep = z.object({
+    do: z.literal('click'),
+    selector: z.string(),
+    nth: z.number().optional(),
+    timeout: z.number().optional(),
+});
+const waitForStep = z.object({
+    do: z.literal('waitFor'),
+    selector: z.string().optional(),
+    js: z.string().optional(),
+    networkIdle: z.boolean().optional(),
+    state: z.enum(['visible', 'hidden', 'attached', 'detached']).optional(),
+    timeout: z.number().optional(),
+});
+const screenshotStep = z.object({
+    do: z.literal('screenshot'),
+    path: z.string().optional(),
+    fullPage: z.boolean().optional(),
+});
+const assertStep = z.object({
+    do: z.literal('assert'),
+    label: z.string().optional(),
+    on: z.string().optional(),
+    path: z.string().optional(),
+    url: z.string().optional(),
+    globals: z.record(z.string(), z.string()).optional(),
+    absent: z.array(z.string()).optional(),
+    ...matcherFields,
+});
+exports.stepSchema = z.discriminatedUnion('do', [
+    gotoStep,
+    reloadStep,
+    evalStep,
+    sampleStep,
+    waitStableStep,
+    clickStep,
+    waitForStep,
+    screenshotStep,
+    assertStep,
+]);
+const viewportSchema = z.object({ width: z.number(), height: z.number() });
+exports.caseSchema = z.object({
+    name: z.string(),
+    url: z.string().optional(),
+    state: z.string().optional(),
+    frame: z.string().optional(),
+    steps: z.array(exports.stepSchema).min(1),
+});
+exports.suiteSchema = z.object({
+    name: z.string(),
+    defaults: z
+        .object({
+        url: z.string().optional(),
+        state: z.string().optional(),
+        frame: z.string().optional(),
+        viewport: viewportSchema.optional(),
+    })
+        .optional(),
+    cases: z.array(exports.caseSchema).min(1),
+});
+//# sourceMappingURL=schema.js.map

package/dist/utils/screenshot.d.ts

@@ -0,0 +1 @@
+export declare function saveScreenshotFile(dataUrl: string, out?: string): string;

package/dist/utils/screenshot.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveScreenshotFile = saveScreenshotFile;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+function saveScreenshotFile(dataUrl, out) {
+    const base64 = dataUrl.replace(/^data:image\/png;base64,/, '');
+    const buffer = Buffer.from(base64, 'base64');
+    const resolvedOut = out
+        ? path.resolve(out)
+        : (() => {
+            const dir = path.join(os.homedir(), '.cssprobe-cli', 'screenshots');
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            const ts = new Date().toISOString().replace(/[:.]/g, '-');
+            return path.join(dir, `screenshot-${ts}.png`);
+        })();
+    const dir = path.dirname(resolvedOut);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    fs.writeFileSync(resolvedOut, buffer);
+    return resolvedOut;
+}
+//# sourceMappingURL=screenshot.js.map

package/docs/guide/installation.md

@@ -215,7 +215,7 @@ confidence: DEFINITE 8 | INDEFINITE 0 | UNVERIFIABLE 1
 ## Common Failures Agents Face
 
 **"Browser not installed"**
-→ Run `npx playwright install chromium`.
+→ Run `cssprobe-cli doctor` first: it reports the expected vs installed Playwright revision and the exact install command. If a build is missing, run the printed command, usually `npx playwright install chromium`.
 
 **"File not found"**
 → Check the URL or file path. Local files need to exist on disk.

package/llms.txt

@@ -1,6 +1,6 @@
 # cssprobe-cli
 
-> Runtime CSS probe — inspect layout, scroll, colors, backgrounds, fonts in a live browser. Returns DOM tree, ASCII layout diagram and confidence-classified findings for humans and AI agents.
+> Runtime CSS probe — inspect layout, scroll, colors, backgrounds, fonts in a live browser. Returns DOM tree, ASCII layout diagram and confidence-classified findings for humans and AI agents. Interaction commands (click / hover / type / wait-for) drive the page; `sample` / `wait-stable` capture timeline regressions; `frames` targets iframes; `doctor` diagnoses browser installs; `run <file>` executes scripted multi-step flows with assertions and page-error capture; `scenario run <suite.json>` runs repeatable regression suites with artifacts and JUnit output.
 
 ## Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cssprobe-cli",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "mcpName": "io.github.mack-peng/cssprobe-cli",
   "description": "Runtime CSS probe — inspect layout, colors, backgrounds, fonts and more in a live browser. AI agents and shell automation.",
   "keywords": [