cssprobe-cli 0.2.12 → 0.2.14

package/dist/daemonEntry.js

@@ -1,1468 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __commonJS = (cb, mod) => function __require() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// package.json
-var require_package = __commonJS({
-  "package.json"(exports2, module2) {
-    module2.exports = {
-      name: "cssprobe-cli",
-      version: "0.2.12",
-      description: "Runtime CSS probe \u2014 inspect layout, colors, backgrounds, fonts and more in a live browser. AI agents and shell automation.",
-      keywords: [
-        "css",
-        "inspect",
-        "layout",
-        "dom",
-        "forensics",
-        "debug",
-        "browser",
-        "agent",
-        "automation"
-      ],
-      homepage: "https://github.com/mack-peng/cssprobe-cli#readme",
-      repository: "github:mack-peng/cssprobe-cli",
-      license: "MIT",
-      author: "strikingly",
-      main: "dist/index.js",
-      bin: {
-        "cssprobe-cli": "./bin/cssprobe-cli.js"
-      },
-      files: [
-        "bin",
-        "dist",
-        "docs",
-        "README.md",
-        "LICENSE",
-        "AGENTS.md"
-      ],
-      engines: {
-        node: ">=18"
-      },
-      scripts: {
-        build: "node scripts/build.js",
-        typecheck: "tsc --noEmit",
-        test: "npx tsx --test tests/*.test.ts",
-        prepublishOnly: "npm run build"
-      },
-      dependencies: {
-        "playwright-core": "^1.48.0",
-        zod: "^3.23.0"
-      },
-      devDependencies: {
-        "@types/node": "^22.0.0",
-        esbuild: "^0.24.0",
-        tsx: "^4.23.0",
-        typescript: "^5.5.0"
-      }
-    };
-  }
-});
-
-// src/daemon/daemon.ts
-var import_fs2 = __toESM(require("fs"));
-var import_net = __toESM(require("net"));
-var import_path2 = __toESM(require("path"));
-
-// src/utils/socketConnection.ts
-var SocketConnection = class {
-  _socket;
-  _pendingBuffers = [];
-  onclose;
-  onmessage;
-  constructor(socket) {
-    this._socket = socket;
-    socket.on("data", (buffer) => this._onData(buffer));
-    socket.on("close", () => {
-      this.onclose?.();
-    });
-    socket.on("error", (e) => console.error(`error: ${e.message}`));
-  }
-  async send(message) {
-    await new Promise((resolve, reject) => {
-      this._socket.write(`${JSON.stringify(message)}
-`, (error) => {
-        if (error)
-          reject(error);
-        else
-          resolve(void 0);
-      });
-    });
-  }
-  close() {
-    this._socket.destroy();
-  }
-  _onData(buffer) {
-    let end = buffer.indexOf("\n");
-    if (end === -1) {
-      this._pendingBuffers.push(buffer);
-      return;
-    }
-    this._pendingBuffers.push(buffer.slice(0, end));
-    const message = Buffer.concat(this._pendingBuffers).toString();
-    this._dispatchMessage(message);
-    let start = end + 1;
-    end = buffer.indexOf("\n", start);
-    while (end !== -1) {
-      const message2 = buffer.toString(void 0, start, end);
-      this._dispatchMessage(message2);
-      start = end + 1;
-      end = buffer.indexOf("\n", start);
-    }
-    this._pendingBuffers = [buffer.slice(start)];
-  }
-  _dispatchMessage(message) {
-    try {
-      this.onmessage?.(JSON.parse(message));
-    } catch (e) {
-      console.error("failed to dispatch message", e);
-    }
-  }
-};
-
-// src/browser/launcher.ts
-var import_fs = __toESM(require("fs"));
-var import_path = __toESM(require("path"));
-var import_os = __toESM(require("os"));
-var import_playwright_core = require("playwright-core");
-var COLLECTOR_BUNDLE_PATH = import_path.default.join(__dirname, "..", "collector-bundle.js");
-var bundleContent = null;
-function loadBundle() {
-  if (bundleContent !== null) return bundleContent;
-  if (!import_fs.default.existsSync(COLLECTOR_BUNDLE_PATH)) {
-    throw new Error(
-      `collector bundle not found at ${COLLECTOR_BUNDLE_PATH}. Run "npm run build" first.`
-    );
-  }
-  bundleContent = import_fs.default.readFileSync(COLLECTOR_BUNDLE_PATH, "utf-8");
-  return bundleContent;
-}
-function findBrowserExecutable(engine) {
-  const cacheDir = import_path.default.join(import_os.default.homedir(), "Library", "Caches", "ms-playwright");
-  if (!import_fs.default.existsSync(cacheDir)) return null;
-  const platform = process.platform;
-  if (engine === "chromium") {
-    const dirs = import_fs.default.readdirSync(cacheDir).filter((d) => d.startsWith("chromium-")).sort((a, b) => {
-      const na = parseInt(a.split("-")[1]) || 0;
-      const nb = parseInt(b.split("-")[1]) || 0;
-      return nb - na;
-    });
-    for (const dir of dirs) {
-      if (platform === "darwin") {
-        const app = import_path.default.join(cacheDir, dir, "chrome-mac-arm64", "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing");
-        if (import_fs.default.existsSync(app)) return app;
-        const appIntel = import_path.default.join(cacheDir, dir, "chrome-mac", "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing");
-        if (import_fs.default.existsSync(appIntel)) return appIntel;
-      } else if (platform === "linux") {
-        const bin = import_path.default.join(cacheDir, dir, "chrome-linux", "chrome");
-        if (import_fs.default.existsSync(bin)) return bin;
-      }
-    }
-  }
-  return null;
-}
-var BrowserLauncher = class {
-  constructor(options2 = {}) {
-    this.options = options2;
-  }
-  browser = null;
-  context = null;
-  page = null;
-  async open(url) {
-    const engine = this.options.browser || "chromium";
-    const factory = engine === "firefox" ? import_playwright_core.firefox : engine === "webkit" ? import_playwright_core.webkit : import_playwright_core.chromium;
-    const launchOptions = { headless: !this.options.headed };
-    const execPath = findBrowserExecutable(engine);
-    if (execPath) {
-      launchOptions.executablePath = execPath;
-    }
-    this.browser = await factory.launch(launchOptions);
-    const vp = this.options.viewport || { width: 1280, height: 720 };
-    const contextOptions = { viewport: vp };
-    if (this.options.state && import_fs.default.existsSync(this.options.state)) {
-      contextOptions.storageState = this.options.state;
-    }
-    this.context = await this.browser.newContext(contextOptions);
-    this.page = await this.context.newPage();
-    if (url.startsWith("http://") || url.startsWith("https://")) {
-      await this.page.goto(url, { waitUntil: "domcontentloaded", timeout: 6e4 });
-    } else if (url.startsWith("file://")) {
-      await this.page.goto(url, { waitUntil: "load", timeout: 3e4 });
-    } else {
-      const resolved = import_path.default.resolve(url);
-      if (!import_fs.default.existsSync(resolved)) {
-        throw new Error(`File not found: ${resolved}`);
-      }
-      await this.page.goto(`file://${resolved}`, { waitUntil: "load", timeout: 3e4 });
-    }
-  }
-  async collect(cfg) {
-    if (!this.page) throw new Error("Browser not opened. Call open() first.");
-    const bundle = loadBundle();
-    await this.page.addScriptTag({ content: bundle });
-    const snapshot = await this.page.evaluate((config) => {
-      return window.__cssprobe_cli.collect(config);
-    }, cfg);
-    return snapshot;
-  }
-  /** Measure the DOM tree depth from a root selector to the deepest leaf. */
-  async measureDepth(selector) {
-    if (!this.page) throw new Error("Browser not opened. Call open() first.");
-    return this.page.evaluate((sel) => {
-      const root = document.querySelector(sel);
-      if (!root) return 0;
-      let maxDepth = 0;
-      const walk = (el, depth) => {
-        if (depth > maxDepth) maxDepth = depth;
-        for (const child of Array.from(el.children)) walk(child, depth + 1);
-      };
-      walk(root, 0);
-      return maxDepth;
-    }, selector);
-  }
-  /** Wait for user to interact with the page. Press Enter to continue. */
-  async waitForUser() {
-    console.error("");
-    console.error("  Browser is open. Perform your actions (login, click buttons, open dialogs, etc.).");
-    console.error("  Press Enter here when ready to inspect...");
-    console.error("");
-    await new Promise((resolve) => {
-      process.stdin.once("data", () => resolve());
-    });
-  }
-  /** Navigate to a new URL in the existing page. */
-  async navigate(url) {
-    if (!this.page) throw new Error("Browser not opened. Call open() first.");
-    if (url.startsWith("http://") || url.startsWith("https://")) {
-      await this.page.goto(url, { waitUntil: "domcontentloaded", timeout: 6e4 });
-    } else if (url.startsWith("file://")) {
-      await this.page.goto(url, { waitUntil: "load", timeout: 3e4 });
-    } else {
-      const resolved = import_path.default.resolve(url);
-      if (!import_fs.default.existsSync(resolved)) throw new Error(`File not found: ${resolved}`);
-      await this.page.goto(`file://${resolved}`, { waitUntil: "load", timeout: 3e4 });
-    }
-  }
-  /** Scan the page for likely root elements (modals, dialogs, scroll containers). */
-  async autoDetectRoot() {
-    if (!this.page) throw new Error("Browser not opened. Call open() first.");
-    return this.page.evaluate(() => {
-      const candidates = [];
-      const seen = /* @__PURE__ */ new Set();
-      function addSelector(sel, score) {
-        if (seen.has(sel)) return;
-        seen.add(sel);
-        candidates.push({ selector: sel, score });
-      }
-      for (const el of Array.from(document.querySelectorAll('.s-kit-modal, [class*="dialog"], [class*="modal"], [class*="popup"]'))) {
-        const cls = (el.getAttribute("class") || "").split(/\s+/).filter(Boolean).join(".");
-        if (cls) addSelector(`.${cls.split(/\s+/)[0]}`, 10);
-      }
-      for (const el of Array.from(document.querySelectorAll("*"))) {
-        const cs = getComputedStyle(el);
-        if ((cs.overflowY === "auto" || cs.overflowY === "scroll") && el.scrollHeight > el.clientHeight + 1 && el.clientHeight > 100) {
-          const tag = el.tagName.toLowerCase();
-          const id = el.id ? `#${el.id}` : "";
-          const cls = (el.getAttribute("class") || "").split(/\s+/).filter(Boolean).slice(0, 2).join(".");
-          const sel = id || (cls ? `${tag}.${cls}` : tag);
-          addSelector(sel, 5);
-        }
-      }
-      for (const el of Array.from(document.querySelectorAll('section, [class*="section"], main, [role="main"]'))) {
-        const tag = el.tagName.toLowerCase();
-        const cls = (el.getAttribute("class") || "").split(/\s+/).filter(Boolean).slice(0, 2).join(".");
-        const sel = cls ? `${tag}.${cls}` : tag;
-        addSelector(sel, 3);
-      }
-      return candidates.sort((a, b) => b.score - a.score).slice(0, 5).map((c) => c.selector);
-    });
-  }
-  /**
-   * Interactive login flow: opens browser in headed mode, navigates to URL,
-   * waits for user to complete login, then saves storage state.
-   * Returns the path to the saved state file.
-   */
-  async loginAndSave(url, statePath) {
-    const engine = this.options.browser || "chromium";
-    const factory = engine === "firefox" ? import_playwright_core.firefox : engine === "webkit" ? import_playwright_core.webkit : import_playwright_core.chromium;
-    const execPath = findBrowserExecutable(engine);
-    const launchOptions = { headless: false };
-    if (execPath) launchOptions.executablePath = execPath;
-    this.browser = await factory.launch(launchOptions);
-    const vp = this.options.viewport || { width: 1280, height: 720 };
-    this.context = await this.browser.newContext({ viewport: vp });
-    this.page = await this.context.newPage();
-    if (url.startsWith("http://") || url.startsWith("https://")) {
-      await this.page.goto(url, { waitUntil: "domcontentloaded", timeout: 6e4 });
-    } else {
-      throw new Error("--login only works with http/https URLs");
-    }
-    console.error("");
-    console.error("  Browser opened. Please complete the login manually.");
-    console.error("  The browser will detect when you navigate away from the login page,");
-    console.error("  or you can press Enter here when done.");
-    console.error("");
-    await Promise.race([
-      this.page.waitForURL("**/*", { timeout: 3e5 }).catch(() => {
-      }),
-      new Promise((resolve) => {
-        process.stdin.once("data", () => resolve());
-      })
-    ]);
-    await this.page.waitForTimeout(1e3);
-    const resolvedPath = import_path.default.resolve(statePath);
-    const dir = import_path.default.dirname(resolvedPath);
-    if (!import_fs.default.existsSync(dir)) import_fs.default.mkdirSync(dir, { recursive: true });
-    await this.context.storageState({ path: resolvedPath });
-    console.error(`  State saved to: ${resolvedPath}`);
-    return resolvedPath;
-  }
-  /** Get the current page object. */
-  getPage() {
-    return this.page;
-  }
-  async close() {
-    if (this.context) await this.context.close().catch(() => {
-    });
-    if (this.browser) await this.browser.close().catch(() => {
-    });
-    this.context = null;
-    this.browser = null;
-    this.page = null;
-  }
-};
-
-// src/engine/analyzer.ts
-function declaredFor(node, prop) {
-  const arr = node.declared && node.declared[prop];
-  if (!arr || arr.length === 0) return null;
-  return arr.find((d) => d.selector === "inline") || arr[0];
-}
-function confidenceFor(node, props) {
-  let sawAccessible = false;
-  let sawPercent = false;
-  for (const prop of props) {
-    const d = declaredFor(node, prop);
-    if (!d) continue;
-    if (!d.accessible) return "UNVERIFIABLE";
-    sawAccessible = true;
-    if (d.value.endsWith("%")) sawPercent = true;
-  }
-  if (!sawAccessible) return "UNVERIFIABLE";
-  return sawPercent ? "INDEFINITE" : "DEFINITE";
-}
-function evDeclared(d) {
-  return {
-    type: "declared",
-    property: "height",
-    value: d.value,
-    source: `${d.selector} (${d.href || "inline"})`,
-    accessible: d.accessible
-  };
-}
-function evComputed(node, prop) {
-  return {
-    type: "computed",
-    property: prop,
-    value: node.props[prop] ?? ""
-  };
-}
-var ABS_UNIT = /^(0|[1-9]\d*)(\.\d+)?(px|pt|cm|mm|in|vh|vw|vmin|vmax|rem|em)$/;
-function nodeLabel(n) {
-  const cls = (n.classes || []).join(".");
-  return `${n.tag}.${cls}`;
-}
-function makeFinding(partial) {
-  return {
-    id: partial.id,
-    level: partial.level,
-    message: partial.message,
-    confidence: partial.confidence ?? "UNVERIFIABLE",
-    evidence: partial.evidence ?? [],
-    ...partial.location ? { location: partial.location } : {}
-  };
-}
-function allAncestorsContentSized(ancestors) {
-  return ancestors.length > 0 && ancestors.every((a) => a.shape.heightStrategy === "content");
-}
-function walkTree(root) {
-  const scrollNodes = [];
-  const constraintNodes = [];
-  const flexPairs = [];
-  const cbNodes = [];
-  const walk = (n, parent) => {
-    if (!n) return;
-    if (n.flags.hasScrollY || n.props.overflowY === "auto" || n.props.overflowY === "scroll") {
-      scrollNodes.push(n);
-    }
-    const parentHealthy = parent && parent.metrics.clientHeight > 0;
-    if (n.flags.overflowsParent && !(n.props.overflowY === "auto" || n.props.overflowY === "scroll") && parentHealthy) {
-      constraintNodes.push(n);
-    }
-    if (parent && (parent.props.display === "flex" || parent.props.display === "inline-flex")) {
-      flexPairs.push({ parent, child: n });
-    }
-    if (n.containingBlockModifiers && n.containingBlockModifiers.length > 0) {
-      cbNodes.push(n);
-    }
-    for (const child of n.children) walk(child, n);
-  };
-  walk(root, null);
-  if (root && root.flags.overflowsParent && !(root.props.overflowY === "auto" || root.props.overflowY === "scroll")) {
-    constraintNodes.push(root);
-  }
-  return { scrollNodes, constraintNodes, flexPairs, cbNodes };
-}
-function analyzeAnchors(snapshot) {
-  const findings = [];
-  const ancestors = snapshot.ancestors;
-  const anchorInfo = ancestors.map((a) => {
-    const dh = declaredFor(a, "height");
-    const mh = declaredFor(a, "max-height");
-    return {
-      node: a,
-      heightDeclared: dh,
-      maxHeightDeclared: mh,
-      computedHeight: a.props.height,
-      hasAbsolute: !!(dh && ABS_UNIT.test(dh.value)),
-      hasPercent: !!(dh && dh.value.endsWith("%"))
-    };
-  });
-  const anchored = anchorInfo.find((x) => x.hasAbsolute);
-  const message = anchored ? `chain has absolute-unit height at ${anchored.node.label}: ${anchored.heightDeclared.value}` : "all heights are % or missing \u2192 chain depends on containing block runtime resolution (may resolve to auto)";
-  const anchorConf = anchored ? confidenceFor(anchored.node, ["height"]) : (() => {
-    const confs = anchorInfo.map((x) => x.heightDeclared ? x.heightDeclared.accessible ? x.hasPercent ? "INDEFINITE" : "DEFINITE" : "UNVERIFIABLE" : "UNVERIFIABLE");
-    return confs.includes("UNVERIFIABLE") ? "UNVERIFIABLE" : confs.includes("INDEFINITE") ? "INDEFINITE" : "DEFINITE";
-  })();
-  findings.push(makeFinding({
-    id: anchored ? "anchor-present" : "anchor-missing",
-    level: anchored ? "info" : "warning",
-    message,
-    confidence: anchorConf,
-    evidence: anchorInfo.slice(0, 6).flatMap((x) => {
-      const ev = [];
-      if (x.heightDeclared) ev.push({ type: "declared", property: "height", value: x.heightDeclared.value, source: `${x.heightDeclared.selector} (${x.heightDeclared.href || "inline"})`, accessible: x.heightDeclared.accessible });
-      ev.push({ type: "computed", property: "height", value: x.computedHeight });
-      return ev;
-    }),
-    location: anchored ? anchored.node.label : ancestors[ancestors.length - 1]?.label
-  }));
-  const maxOnly = anchorInfo.filter((x) => !x.heightDeclared && x.maxHeightDeclared);
-  if (maxOnly.length) {
-    const evs = maxOnly.slice(0, 3).flatMap((x) => x.maxHeightDeclared ? [evDeclared(x.maxHeightDeclared)] : []);
-    findings.push(makeFinding({
-      id: "max-height-only",
-      level: "warning",
-      message: `these nodes only declare max-height (cap, not anchor) \u2192 % children still resolve to auto: ${maxOnly.map((x) => x.node.label).join(", ")}`,
-      confidence: "DEFINITE",
-      evidence: evs,
-      location: maxOnly[0].node.label
-    }));
-  }
-  return findings;
-}
-function analyzeScroll(snapshot) {
-  const findings = [];
-  const { scrollNodes, constraintNodes } = walkTree(snapshot.tree);
-  for (const n of constraintNodes.slice(0, 8)) {
-    findings.push(makeFinding({
-      id: "constraint-candidate",
-      level: "warning",
-      message: `${nodeLabel(n)} overflows parent but is not a scroll container \u2192 constraint candidate (flex child min-height:auto or parent height unconstrained)`,
-      confidence: "DEFINITE",
-      evidence: [
-        evComputed(n, "overflowY"),
-        { type: "computed", property: "scrollHeight", value: String(n.metrics.scrollHeight) },
-        { type: "computed", property: "clientHeight", value: String(n.metrics.clientHeight) }
-      ],
-      location: nodeLabel(n)
-    }));
-  }
-  for (const n of scrollNodes) {
-    const isScrollDeclared = n.props.overflowY === "auto" || n.props.overflowY === "scroll";
-    const conf = "DEFINITE";
-    let id;
-    let message;
-    let level;
-    if (n.metrics.clientHeight === 0) {
-      id = "scroll-collapsed";
-      message = `${nodeLabel(n)} height collapsed to 0 \u2192 overflow-y:${n.props.overflowY} has no viewport \u2192 height chain unconstrained (anchor issue)`;
-      level = "error";
-    } else if (n.flags.scrollable) {
-      id = "scrollable";
-      message = `${nodeLabel(n)} scrollable (scrollHeight ${n.metrics.scrollHeight} > clientHeight ${n.metrics.clientHeight})`;
-      level = "info";
-    } else if (!n.flags.hasScrollY && isScrollDeclared && Math.abs(n.metrics.offsetHeight - n.metrics.scrollHeight) <= 1) {
-      id = "scroll-content-sized";
-      message = `${nodeLabel(n)} content-sized (${n.metrics.offsetHeight}px, scrollHeight==clientHeight) \u2192 overflow-y:auto never triggers \u2192 height chain unconstrained (anchor issue)`;
-      level = "warning";
-    } else if (!n.flags.hasScrollY) {
-      id = "no-overflow";
-      message = `${nodeLabel(n)} no overflow, no scroll needed`;
-      level = "info";
-    } else {
-      id = "overflow-clipped";
-      message = `${nodeLabel(n)} content overflows (${n.metrics.scrollHeight}>${n.metrics.clientHeight}) clipped by overflow=${n.props.overflowY} \u2192 height chain unconstrained (anchor issue)`;
-      level = "warning";
-    }
-    findings.push(makeFinding({
-      id,
-      level,
-      message,
-      confidence: conf,
-      evidence: [
-        evComputed(n, "overflowY"),
-        { type: "computed", property: "scrollHeight", value: String(n.metrics.scrollHeight) },
-        { type: "computed", property: "clientHeight", value: String(n.metrics.clientHeight) }
-      ],
-      location: nodeLabel(n)
-    }));
-  }
-  return findings;
-}
-function analyzeFlex(snapshot) {
-  const findings = [];
-  const { flexPairs } = walkTree(snapshot.tree);
-  if (flexPairs.length === 0) {
-    findings.push(makeFinding({
-      id: "no-flex",
-      level: "info",
-      message: "no flex parent-child relationships found in the tree",
-      confidence: "DEFINITE"
-    }));
-    return findings;
-  }
-  for (const { parent, child } of flexPairs.slice(0, 10)) {
-    const pLabel = nodeLabel(parent);
-    const cLabel = nodeLabel(child);
-    const pDir = parent.props.flexDirection || "row";
-    const cMinH = parent.props.minHeight;
-    const cMinW = child.props.minWidth;
-    const cFlexGrow = child.props.flexGrow;
-    const cFlexShrink = child.props.flexShrink;
-    if (pDir === "column") {
-      if ((cMinH === "auto" || cMinH === "0px") && child.metrics.scrollHeight > child.metrics.clientHeight + 1) {
-        findings.push(makeFinding({
-          id: "flex-col-overflow",
-          level: "warning",
-          message: `${cLabel} is flex-col child with min-height:${cMinH} \u2192 content (${child.metrics.scrollHeight}px) may overflow parent (${parent.metrics.clientHeight}px)`,
-          confidence: "DEFINITE",
-          evidence: [
-            evComputed(parent, "display"),
-            evComputed(parent, "flexDirection"),
-            evComputed(child, "minHeight"),
-            { type: "computed", property: "scrollHeight", value: String(child.metrics.scrollHeight) },
-            { type: "computed", property: "clientHeight", value: String(child.metrics.clientHeight) }
-          ],
-          location: cLabel
-        }));
-      }
-      if (cFlexGrow === "0" && cFlexShrink === "0" && cMinH === "auto") {
-        findings.push(makeFinding({
-          id: "flex-zero-auto",
-          level: "info",
-          message: `${cLabel}: flex:0 0 auto in ${pLabel}(column) \u2192 height is content-driven, not constrained by flex`,
-          confidence: "DEFINITE",
-          evidence: [evComputed(child, "flexGrow"), evComputed(child, "flexShrink"), evComputed(child, "minHeight")],
-          location: cLabel
-        }));
-      }
-    } else {
-      if ((cMinW === "auto" || cMinW === "0px") && child.metrics.scrollWidth > child.metrics.clientWidth + 1) {
-        findings.push(makeFinding({
-          id: "flex-row-overflow",
-          level: "warning",
-          message: `${cLabel} is flex-row child with min-width:${cMinW} \u2192 content (${child.metrics.scrollWidth}px) may overflow parent`,
-          confidence: "DEFINITE",
-          evidence: [evComputed(parent, "display"), evComputed(child, "minWidth"), evComputed(child, "overflowX")],
-          location: cLabel
-        }));
-      }
-    }
-  }
-  return findings;
-}
-function analyzeContainingBlock(snapshot) {
-  const findings = [];
-  const { cbNodes } = walkTree(snapshot.tree);
-  const ancestorsWithCB = snapshot.ancestors.filter((a) => a.containingBlockModifiers.length > 0);
-  const allCB = [
-    ...cbNodes.slice(0, 5).map((n) => ({ label: nodeLabel(n), mods: n.containingBlockModifiers, node: n })),
-    ...ancestorsWithCB.map((a) => ({ label: a.label, mods: a.containingBlockModifiers, node: a }))
-  ];
-  if (allCB.length === 0) {
-    findings.push(makeFinding({
-      id: "no-cb",
-      level: "info",
-      message: "no containing block modifiers found in the tree",
-      confidence: "DEFINITE"
-    }));
-    return findings;
-  }
-  const hasFixed = snapshot.ancestors.some((a) => a.shape.role === "fixed") || snapshot.tree && snapshot.tree.props.position === "fixed";
-  for (const cb of allCB.slice(0, 5)) {
-    const isRootFixed = cb.node.props.position === "fixed";
-    findings.push(makeFinding({
-      id: "cb-modifier",
-      level: isRootFixed ? "error" : "info",
-      message: `${cb.label}: CB modifiers: ${cb.mods.join(", ")}${isRootFixed ? " \u2192 fixed/absolute descendants resolve % against this ancestor (containing block hijack)" : ""}`,
-      confidence: "DEFINITE",
-      evidence: cb.mods.map((m) => ({ type: "declared", property: m.split(":")[0].trim(), value: m.split(":").slice(1).join(":").trim(), accessible: true })),
-      location: cb.label
-    }));
-  }
-  if (hasFixed && snapshot.ancestors.every((a) => a.shape.heightStrategy === "content")) {
-    findings.push(makeFinding({
-      id: "fixed-no-anchor",
-      level: "error",
-      message: "fixed ancestor + no height anchor \u2192 children % resolve to auto \u2192 content-sized overflow",
-      confidence: "DEFINITE"
-    }));
-  }
-  return findings;
-}
-function detectPatterns(snapshot) {
-  const findings = [];
-  const ancestors = snapshot.ancestors;
-  const { scrollNodes } = walkTree(snapshot.tree);
-  const anchored = ancestors.some((a) => {
-    const dh = declaredFor(a, "height");
-    return !!(dh && ABS_UNIT.test(dh.value));
-  });
-  const hasFlexCol = ancestors.some((a) => a.shape.role === "flex-col");
-  const hasFixed = ancestors.some((a) => a.shape.role === "fixed");
-  const scrollableExists = scrollNodes.some((n) => n.flags.scrollable);
-  if (hasFixed && !anchored) {
-    findings.push(makeFinding({
-      id: "pattern-fixed-no-anchor",
-      level: "info",
-      message: "Pattern: fixed ancestor + no height anchor \u2192 children % resolve to auto \u2192 content-sized overflow",
-      confidence: "DEFINITE"
-    }));
-  }
-  if (hasFlexCol) {
-    const fc = ancestors.find((a) => a.shape.role === "flex-col");
-    findings.push(makeFinding({
-      id: "pattern-flex-col",
-      level: "info",
-      message: `Pattern: flex-col at ${fc.label} \u2192 children height governed by flex-grow/shrink/min-height`,
-      confidence: "DEFINITE"
-    }));
-  }
-  if (scrollableExists && !anchored) {
-    findings.push(makeFinding({
-      id: "pattern-scroll-no-anchor",
-      level: "info",
-      message: "Pattern: scroll container exists but no height anchor above \u2192 overflow:auto never triggers (content-sized)",
-      confidence: "DEFINITE"
-    }));
-  }
-  if (allAncestorsContentSized(ancestors)) {
-    findings.push(makeFinding({
-      id: "pattern-content-sized",
-      level: "info",
-      message: "Pattern: all ancestors are content-sized \u2192 height entirely depends on content, no constraints propagate",
-      confidence: "DEFINITE"
-    }));
-  }
-  return findings;
-}
-function analyze(snapshot) {
-  const findings = [
-    ...analyzeAnchors(snapshot),
-    ...analyzeScroll(snapshot),
-    ...analyzeFlex(snapshot),
-    ...analyzeContainingBlock(snapshot),
-    ...detectPatterns(snapshot)
-  ];
-  return findings;
-}
-
-// src/engine/renderers/utils.ts
-function nodeLabel2(node) {
-  const cls = node.classes.length ? `.${node.classes.join(".")}` : "";
-  const id = node.id ? `#${node.id}` : "";
-  return `${node.tag}${id}${cls}`;
-}
-function smartLabel(node, maxLen) {
-  const full = nodeLabel2(node);
-  if (full.length <= maxLen) return full;
-  const id = node.id ? `#${node.id}` : "";
-  const firstCls = node.classes.length > 0 ? `.${node.classes[0]}` : "";
-  const short = `${node.tag}${id}${firstCls}`;
-  if (short.length <= maxLen) return short;
-  const tagId = `${node.tag}${id}`;
-  if (tagId.length <= maxLen) return tagId;
-  if (node.tag.length <= maxLen) return node.tag;
-  return node.tag.slice(0, Math.max(maxLen - 3, 1)) + "...";
-}
-function isMultiColumn(node) {
-  const display = node.props.display;
-  return node.shape?.role === "flex-row" || display === "flex" && node.props.flexDirection !== "column" || display === "grid" || display === "inline-grid";
-}
-var BOX = { tl: "\u250C", tr: "\u2510", bl: "\u2514", br: "\u2518", h: "\u2500", v: "\u2502" };
-var CONF_BADGE = {
-  DEFINITE: "DEFINITE",
-  INDEFINITE: "INDEFINITE",
-  UNVERIFIABLE: "UNVERIFIABLE"
-};
-function confidenceSummary(findings) {
-  const counts = findings.reduce((acc, f) => {
-    acc[f.confidence] = (acc[f.confidence] || 0) + 1;
-    return acc;
-  }, {});
-  const parts = [
-    `DEFINITE ${counts.DEFINITE || 0}`,
-    `INDEFINITE ${counts.INDEFINITE || 0}`,
-    `UNVERIFIABLE ${counts.UNVERIFIABLE || 0}`
-  ];
-  return parts.join(" | ");
-}
-
-// src/engine/renderers/dom-tree.ts
-function renderNode(node, indent) {
-  const lines = [];
-  if (!node) return lines;
-  const cls = node.classes.length ? `.${node.classes.join(".")}` : "";
-  const id = node.id ? `#${node.id}` : "";
-  const repeat = node.repeat ? ` \xD7${node.repeat}` : "";
-  const m = node.metrics;
-  const s = node.shape || {};
-  const flag = [];
-  if (node.flags.overflowsViewport) flag.push("\u26A0viewport-overflow");
-  if (node.flags.overflowsParent) flag.push("\u26A0parent-overflow");
-  if (m.clientHeight === 0 && m.offsetHeight === 0) flag.push("\u26A0collapsed(0px)");
-  if (node.flags.scrollable) flag.push("\u2714scrollable");
-  if (node.flags.hasScrollY && !node.flags.scrollable) {
-    flag.push(`\u26A0overflow(${m.scrollHeight}>${m.clientHeight})but-overflow=${node.props.overflowY}`);
-  }
-  if (node.containingBlockModifiers.length) {
-    flag.push(`CB:${node.containingBlockModifiers.join(" ")}`);
-  }
-  const styleHint = node.inlineStyle ? ` style="${node.inlineStyle}"` : "";
-  const h = node.props.height;
-  const heightStr = h === "auto" ? `auto\u2192${m.offsetHeight}px` : `${h}`;
-  const w = node.props.width;
-  const widthStr = w === "auto" ? `auto\u2192${m.clientWidth}px` : `${w}`;
-  const mhStr = node.declared && node.declared["max-height"] ? ` maxH:${node.declared["max-height"].map((x) => x.value).join(";")}` : "";
-  const shapeStr = s.role ? `[${s.role}${s.scrollTag ? " " + s.scrollTag : ""} h:${s.heightStrategy} w:${s.widthStrategy}]` : "";
-  lines.push(
-    `${"  ".repeat(indent)}<${node.tag}${id}${cls}${styleHint}${repeat}> ${shapeStr} [${node.props.position},${node.props.display},h:${heightStr},w:${widthStr}${mhStr}] rect(${m.rect.width}\xD7${m.rect.height}) bottom=${m.rectBottom} scroll=${m.clientHeight}/${m.scrollHeight}` + (flag.length ? ` ${flag.join(" ")}` : "") + (node.text ? ` \u300C${node.text.slice(0, 30)}\u300D` : "")
-  );
-  for (const child of node.children) {
-    lines.push(...renderNode(child, indent + 1));
-  }
-  return lines;
-}
-
-// src/engine/renderers/ancestors.ts
-function renderAncestors(chain) {
-  return chain.map((a) => {
-    const dh = a.declared && a.declared.height ? a.declared.height.map((x) => `${x.selector}\u2192${x.value}`).join("; ") : "auto";
-    const dw = a.declared && a.declared.width ? a.declared.width.map((x) => `${x.selector}\u2192${x.value}`).join("; ") : "auto";
-    const mh = a.declared && a.declared["max-height"] ? a.declared["max-height"].map((x) => `${x.selector}\u2192${x.value}`).join("; ") : null;
-    const maxPart = mh ? ` max-height:${mh}` : "";
-    const s = a.shape || {};
-    const shapeStr = s.role ? `[${s.role}${s.scrollTag ? " " + s.scrollTag : ""} h:${s.heightStrategy} w:${s.widthStrategy}]` : "";
-    return `${a.label} ${shapeStr} [${a.props.position},${a.props.display}] h:${dh}${maxPart} w:${dw} \u2192 ${a.metrics.clientWidth}\xD7${a.metrics.offsetHeight}` + (a.containingBlockModifiers.length ? ` CB:${a.containingBlockModifiers.join(" ")}` : "") + (a.inlineStyle ? ` style="${a.inlineStyle}"` : "");
-  });
-}
-
-// src/engine/renderers/sketch.ts
-function buildSketchTree(node, issueLabels) {
-  if (!node) return null;
-  const label = nodeLabel2(node);
-  const s = node.shape || {};
-  const shapeStr = s.role ? `[${s.role} h:${s.heightStrategy} w:${s.widthStrategy}]` : "";
-  const flags = [];
-  if (node.flags.overflowsParent) flags.push("\u26A0parent-overflow");
-  if (node.flags.overflowsViewport) flags.push("\u26A0viewport-overflow");
-  if (node.metrics.clientHeight === 0 && node.metrics.offsetHeight === 0) flags.push("\u26A0collapsed");
-  if (node.flags.scrollable) flags.push("\u2714scrollable");
-  if (node.containingBlockModifiers.length) flags.push(`CB:${node.containingBlockModifiers.join(" ")}`);
-  const hasIssue = issueLabels.has(label) || flags.length > 0;
-  const children = [];
-  let omitted = 0;
-  for (const child of node.children) {
-    const sketchChild = buildSketchTree(child, issueLabels);
-    if (!sketchChild) continue;
-    if (sketchChild.hasIssue || hasDescendantIssue(sketchChild)) {
-      children.push(sketchChild);
-    } else {
-      omitted++;
-    }
-  }
-  return { label, shape: shapeStr, flags, children, hasIssue, omitted };
-}
-function hasDescendantIssue(node) {
-  if (node.hasIssue) return true;
-  return node.children.some((c) => hasDescendantIssue(c));
-}
-function renderSketchNode(node, prefix, isLast) {
-  const lines = [];
-  const connector = isLast ? "\u2514\u2500 " : "\u251C\u2500 ";
-  const flagStr = node.flags.length ? ` ${node.flags.join(" ")}` : "";
-  const issueMark = node.hasIssue && node.flags.length === 0 ? " \u26A0" : "";
-  lines.push(`${prefix}${connector}${node.label} ${node.shape}${flagStr}${issueMark}`);
-  const childPrefix = prefix + (isLast ? "   " : "\u2502  ");
-  const totalChildren = node.children.length + (node.omitted > 0 ? 1 : 0);
-  for (let i = 0; i < node.children.length; i++) {
-    lines.push(...renderSketchNode(node.children[i], childPrefix, i === totalChildren - 1));
-  }
-  if (node.omitted > 0) {
-    const omConnector = "\u2514\u2500 ";
-    lines.push(`${childPrefix}${omConnector}... (${node.omitted} subtrees omitted)`);
-  }
-  return lines;
-}
-function renderSketch(tree, findings) {
-  if (!tree) return ["(empty tree)"];
-  const issueLabels = /* @__PURE__ */ new Set();
-  for (const f of findings) {
-    if (f.level === "warning" || f.level === "error") {
-      if (f.location) issueLabels.add(f.location);
-    }
-  }
-  const sketchRoot = buildSketchTree(tree, issueLabels);
-  if (!sketchRoot) return ["(empty tree)"];
-  if (!hasDescendantIssue(sketchRoot) && !sketchRoot.hasIssue) {
-    return [`${sketchRoot.label} ${sketchRoot.shape} (no issues found in tree)`];
-  }
-  return renderSketchNode(sketchRoot, "", true);
-}
-
-// src/engine/renderers/layout.ts
-function renderLayout(snapshot, findings) {
-  if (!snapshot.tree) return ["(empty tree)"];
-  const vpW = snapshot.viewport.width;
-  const termWidth = Math.min(Math.max(process.stdout?.columns || 80, 60), 120);
-  const indentUnit = 2;
-  const maxDepth = 8;
-  const boxPad = 4;
-  const issueLocations = /* @__PURE__ */ new Set();
-  for (const f of findings) {
-    if (f.location && (f.level === "warning" || f.level === "error")) issueLocations.add(f.location);
-  }
-  function boxCharW(nodeW, depth) {
-    const usedIndent = depth * indentUnit;
-    const available = termWidth - usedIndent - boxPad;
-    const ratio = nodeW / vpW;
-    return Math.max(Math.round(available * ratio), 14);
-  }
-  const lines = [];
-  function renderBox(node, charW, depth, flat = false) {
-    const m = node.metrics.rect;
-    const dimStr = `${Math.round(m.width)}\xD7${Math.round(m.height)}`;
-    const innerW = Math.max(charW - 2, 1);
-    const label = smartLabel(node, innerW - 4);
-    const hasIssue = issueLocations.has(label);
-    const issueMark = hasIssue ? " \u26A0" : "";
-    const repeat = node.repeat && node.repeat > 1 ? node.repeat : 1;
-    const boxLines = [];
-    if (innerW < 3) {
-      boxLines.push(`${BOX.v} ${label.slice(0, Math.max(charW - 3, 0))}... ${dimStr}`);
-      return boxLines;
-    }
-    const labelPart = ` ${label}${repeat > 1 ? ` \xD7${repeat}` : ""} `;
-    const dimPart = ` ${dimStr} `;
-    const topFillLen = Math.max(0, innerW - labelPart.length - dimPart.length);
-    boxLines.push(`${BOX.tl}${BOX.h}${labelPart}${BOX.h.repeat(topFillLen)}${BOX.tr}${dimPart}${issueMark}`);
-    const children = node.children.filter((c) => !(c.metrics.rect.width < 1 && c.metrics.rect.height < 1));
-    if (children.length === 0) {
-      boxLines.push(`${BOX.v}${" ".repeat(innerW)}${BOX.v}`);
-    } else if (flat) {
-      for (const child of children) {
-        const childLabel = nodeLabel2(child);
-        const childRepeat = child.repeat && child.repeat > 1 ? ` \xD7${child.repeat}` : "";
-        const childDim = `${Math.round(child.metrics.rect.width)}\xD7${Math.round(child.metrics.rect.height)}`;
-        const childLine = ` ${childLabel}${childRepeat} ${childDim} `;
-        if (childLine.length <= innerW) {
-          boxLines.push(`${BOX.v}${childLine}${" ".repeat(innerW - childLine.length)}${BOX.v}`);
-        } else {
-          boxLines.push(`${BOX.v}${childLine.slice(0, innerW)}${BOX.v}`);
-        }
-      }
-    } else if (isMultiColumn(node)) {
-      const expandedCount = children.reduce((sum, c) => sum + (c.repeat && c.repeat > 1 ? c.repeat : 1), 0);
-      if (expandedCount > 1) {
-        const isGrid = node.props.display === "grid" || node.props.display === "inline-grid";
-        const childLines = renderFlexChildren(children, innerW, depth + 1, m.width, isGrid);
-        for (const cl of childLines) {
-          boxLines.push(`${BOX.v}${cl}${BOX.v}`);
-        }
-      } else {
-        for (const child of children) {
-          const childBox = renderBox(child, Math.min(boxCharW(child.metrics.rect.width, depth + 1), innerW - 2), depth + 1);
-          for (const cl of childBox) {
-            const line = ` ${cl}`;
-            if (line.length <= innerW + 1) {
-              boxLines.push(`${BOX.v}${line}${" ".repeat(Math.max(0, innerW - line.length + 1))}${BOX.v}`);
-            } else {
-              boxLines.push(`${BOX.v}${line.slice(0, innerW)}${BOX.v}`);
-            }
-          }
-        }
-      }
-    } else {
-      for (const child of children) {
-        const childBox = renderBox(child, Math.min(boxCharW(child.metrics.rect.width, depth + 1), innerW - 2), depth + 1);
-        for (const cl of childBox) {
-          const line = ` ${cl}`;
-          if (line.length <= innerW + 1) {
-            boxLines.push(`${BOX.v}${line}${" ".repeat(Math.max(0, innerW - line.length + 1))}${BOX.v}`);
-          } else {
-            boxLines.push(`${BOX.v}${line.slice(0, innerW)}${BOX.v}`);
-          }
-        }
-      }
-    }
-    boxLines.push(`${BOX.bl}${BOX.h.repeat(innerW)}${BOX.br}`);
-    return boxLines;
-  }
-  function renderFlexChildren(children, availW, depth, parentPxW, isGrid) {
-    const expanded = [];
-    for (const child of children) {
-      const repeat = child.repeat && child.repeat > 1 ? child.repeat : 1;
-      for (let r = 0; r < repeat; r++) {
-        expanded.push({ ...child, repeat: 1, children: child.children });
-      }
-    }
-    let rows;
-    if (isGrid && expanded.length > 1) {
-      const childW = expanded[0].metrics.rect.width;
-      const cols = Math.max(1, Math.floor(parentPxW / childW));
-      rows = [];
-      for (let i = 0; i < expanded.length; i += cols) {
-        rows.push(expanded.slice(i, i + cols));
-      }
-    } else {
-      rows = [expanded];
-    }
-    const allResult = [];
-    for (const row of rows) {
-      const gap = 1;
-      const totalGaps = (row.length - 1) * gap;
-      const minPerChild = 10;
-      const usableW = Math.max(availW - totalGaps, row.length * minPerChild);
-      const childWidths = [];
-      let totalUsed = 0;
-      for (let i = 0; i < row.length; i++) {
-        const ratio = row[i].metrics.rect.width / parentPxW;
-        const w = Math.max(Math.round(usableW * ratio), minPerChild);
-        childWidths.push(w);
-        totalUsed += w;
-      }
-      if (childWidths.length > 0 && usableW > totalUsed) {
-        childWidths[childWidths.length - 1] += usableW - totalUsed;
-      }
-      const childBoxes = [];
-      let maxLines = 0;
-      for (let i = 0; i < row.length; i++) {
-        const box = renderBox(row[i], childWidths[i], depth, true);
-        childBoxes.push(box);
-        if (box.length > maxLines) maxLines = box.length;
-      }
-      for (let lineIdx = 0; lineIdx < maxLines; lineIdx++) {
-        let merged = "";
-        for (let i = 0; i < childBoxes.length; i++) {
-          const w = childWidths[i];
-          if (i > 0) merged += " ";
-          if (lineIdx < childBoxes[i].length) {
-            const line = childBoxes[i][lineIdx];
-            if (line.length < w) {
-              merged += line + " ".repeat(w - line.length);
-            } else {
-              merged += line.slice(0, w);
-            }
-          } else {
-            merged += " ".repeat(w);
-          }
-        }
-        allResult.push(merged);
-      }
-    }
-    return allResult;
-  }
-  function renderEl(node, depth, parentW) {
-    if (depth > maxDepth) {
-      lines.push("  ".repeat(depth) + "... (depth limit)");
-      return;
-    }
-    const m = node.metrics.rect;
-    if (m.width < 1 && m.height < 1 && node.children.length > 0) {
-      for (const child of node.children) renderEl(child, depth, parentW);
-      return;
-    }
-    if (m.width < 1 && m.height < 1) return;
-    const charW = boxCharW(m.width, depth);
-    const indent = "  ".repeat(depth);
-    const box = renderBox(node, charW, depth);
-    for (const line of box) {
-      lines.push(`${indent}${line}`);
-    }
-  }
-  renderEl(snapshot.tree, 0, vpW);
-  const scaleStr = `${Math.round(vpW / termWidth)}px/char`;
-  const result = [];
-  result.push(`## Layout (${vpW}\xD7${snapshot.viewport.height} viewport, scale: ${scaleStr})`);
-  result.push("```");
-  result.push(...lines);
-  result.push("```");
-  return result;
-}
-
-// src/engine/renderers/findings.ts
-function renderFindings(findings) {
-  const lines = [];
-  lines.push("## Findings");
-  if (findings.length === 0) {
-    lines.push("- \u65E0\u5F02\u5E38\u53D1\u73B0");
-    return lines;
-  }
-  for (const f of findings) {
-    const badge = `[${CONF_BADGE[f.confidence]}]`;
-    const loc = f.location ? ` @ ${f.location}` : "";
-    lines.push(`- ${f.level === "error" ? "\u26A0" : f.level === "warning" ? "\u26A0" : "\u2714"} ${f.message} ${badge}${loc}`);
-    for (const ev of f.evidence.slice(0, 3)) {
-      if (ev.type === "computed") {
-        lines.push(`    - computed ${ev.property}: ${ev.value}`);
-      } else if (ev.type === "declared") {
-        lines.push(`    - declared ${ev.property}: ${ev.value} (${ev.source || "?"})${ev.accessible ? "" : " [inaccessible]"}`);
-      }
-    }
-  }
-  return lines;
-}
-function renderBriefFindings(findings) {
-  const lines = [];
-  lines.push("## Findings");
-  const important = findings.filter((f) => f.level === "warning" || f.level === "error");
-  if (important.length === 0) {
-    lines.push("- No warnings or errors");
-    return lines;
-  }
-  for (const f of important) {
-    const badge = `[${CONF_BADGE[f.confidence]}]`;
-    const loc = f.location ? ` @ ${f.location}` : "";
-    const icon = f.level === "error" ? "\u26A0" : "\u26A0";
-    lines.push(`- ${icon} ${f.message} ${badge}${loc}`);
-  }
-  return lines;
-}
-
-// src/engine/renderer.ts
-function renderMarkdown(snapshot, findings, brief = false, layout = false) {
-  const lines = [];
-  const vp = snapshot.viewport ? `${snapshot.viewport.width}\xD7${snapshot.viewport.height}` : "unknown";
-  lines.push("# cssprobe-cli report");
-  lines.push(`viewport: ${vp} | root: ${snapshot.rootSelector} | nodes: ${snapshot.nodeCount}`);
-  lines.push(`confidence: ${confidenceSummary(findings)}`);
-  if (snapshot.error) {
-    lines.push("");
-    lines.push(`\u26A0 ${snapshot.error}`);
-    if (snapshot.candidates && snapshot.candidates.length) {
-      lines.push(`Similar nodes: ${snapshot.candidates.join(", ")}`);
-    }
-    return lines.join("\n");
-  }
-  lines.push("");
-  lines.push(`## Ancestor chain (root\u2192${snapshot.upTo})`);
-  lines.push("```");
-  lines.push(...renderAncestors(snapshot.ancestors));
-  lines.push("```");
-  if (layout) {
-    lines.push("");
-    lines.push(...renderLayout(snapshot, findings));
-  }
-  if (brief) {
-    lines.push("");
-    lines.push("## Tree Sketch (issues only)");
-    lines.push("```");
-    lines.push(...renderSketch(snapshot.tree, findings));
-    lines.push("```");
-  } else if (!layout) {
-    lines.push("");
-    lines.push(`## DOM tree (${snapshot.downDepth} levels deep)`);
-    lines.push("```");
-    lines.push(...renderNode(snapshot.tree, 0));
-    lines.push("```");
-  }
-  lines.push("");
-  lines.push(...brief ? renderBriefFindings(findings) : renderFindings(findings));
-  if (snapshot.crossOriginBlocked && snapshot.crossOriginBlocked > 0) {
-    lines.push("");
-    lines.push("## Cross-origin limitation");
-    lines.push(`\u26A0 ${snapshot.crossOriginBlocked} stylesheet(s) blocked by browser security (SecurityError). Declared values from these sheets are marked UNVERIFIABLE \u2014 computed values from getComputedStyle() are still accurate.`);
-    if (snapshot.blockedSheetUrls && snapshot.blockedSheetUrls.length > 0) {
-      lines.push(`Blocked: ${snapshot.blockedSheetUrls.join(", ")}`);
-    }
-  }
-  return lines.join("\n");
-}
-function renderJSON(snapshot, findings, brief = false) {
-  const counts = findings.reduce((acc, f) => {
-    acc[f.confidence] = (acc[f.confidence] || 0) + 1;
-    return acc;
-  }, {});
-  const meta = {
-    rootSelector: snapshot.rootSelector,
-    viewport: snapshot.viewport,
-    nodeCount: snapshot.nodeCount,
-    crossOriginBlocked: snapshot.crossOriginBlocked,
-    blockedSheetUrls: snapshot.blockedSheetUrls
-  };
-  if (brief) {
-    const important = findings.filter((f) => f.level === "warning" || f.level === "error");
-    const briefFindings = important.map((f) => ({
-      id: f.id,
-      level: f.level,
-      message: f.message,
-      confidence: f.confidence,
-      location: f.location,
-      evidence: f.evidence.slice(0, 1)
-    }));
-    return {
-      meta,
-      snapshot: { rootSelector: snapshot.rootSelector, nodeCount: snapshot.nodeCount, downDepth: snapshot.downDepth },
-      findings: briefFindings,
-      summary: {
-        total: findings.length,
-        warnings: important.filter((f) => f.level === "warning").length,
-        errors: important.filter((f) => f.level === "error").length,
-        confidence: { DEFINITE: counts.DEFINITE || 0, INDEFINITE: counts.INDEFINITE || 0, UNVERIFIABLE: counts.UNVERIFIABLE || 0 }
-      }
-    };
-  }
-  return {
-    meta,
-    snapshot: snapshot.error ? { error: snapshot.error, candidates: snapshot.candidates } : snapshot,
-    findings,
-    summary: {
-      total: findings.length,
-      confidence: { DEFINITE: counts.DEFINITE || 0, INDEFINITE: counts.INDEFINITE || 0, UNVERIFIABLE: counts.UNVERIFIABLE || 0 }
-    }
-  };
-}
-
-// src/daemon/daemon.ts
-var AsyncFunction = Object.getPrototypeOf(async function() {
-}).constructor;
-async function startDaemon(sessionName2, clientInfo, options2) {
-  const sessionConfig = createSessionConfig(clientInfo, sessionName2, options2);
-  const { socketPath } = sessionConfig;
-  if (process.platform !== "win32" && await socketExists(socketPath)) {
-    try {
-      await import_fs2.default.promises.unlink(socketPath);
-    } catch (error) {
-      throw error;
-    }
-  }
-  const launcher = new BrowserLauncher({
-    browser: options2.browser || "chromium",
-    headed: options2.headed !== false,
-    viewport: options2.viewport,
-    state: options2.state
-  });
-  const server = import_net.default.createServer((socket) => {
-    const connection = new SocketConnection(socket);
-    connection.onmessage = async (message) => {
-      const { id, method, params } = message;
-      try {
-        if (method === "stop") {
-          await deleteSessionFile(sessionConfig);
-          await launcher.close();
-          connection.send({ id, result: "ok" }).catch(() => {
-          });
-          process.exit(0);
-        } else if (method === "run") {
-          const result = await executeCommand(launcher, params.args);
-          await connection.send({ id, result });
-        } else {
-          throw new Error(`Unknown method: ${method}`);
-        }
-      } catch (e) {
-        const error = e.message;
-        connection.send({ id, error }).catch(() => {
-        });
-      }
-    };
-  });
-  await new Promise((resolve, reject) => {
-    server.on("error", reject);
-    server.listen(socketPath, () => resolve());
-  });
-  await saveSessionFile(clientInfo, sessionConfig);
-  console.log(`Daemon listening on ${socketPath}`);
-  return socketPath;
-}
-async function executeCommand(launcher, args2) {
-  const command = args2._[0];
-  const params = args2._.slice(1);
-  switch (command) {
-    case "goto": {
-      const url = params[0] || "about:blank";
-      await launcher.open(url);
-      return { text: `Navigated to ${url}` };
-    }
-    case "inspect": {
-      const selector = params[0];
-      if (!selector)
-        throw new Error("Selector is required for inspect command");
-      const snapshot = await launcher.collect({
-        rootSelector: selector,
-        downDepth: args2.depth || 6,
-        maxNodes: 60,
-        upTo: "html"
-      });
-      const findings = analyze(snapshot);
-      if (args2.json) {
-        return { text: JSON.stringify(renderJSON(snapshot, findings, args2.brief), null, 2) };
-      } else {
-        return { text: renderMarkdown(snapshot, findings, args2.brief, args2.layout) };
-      }
-    }
-    case "tree": {
-      const selector = params[0];
-      if (!selector)
-        throw new Error("Selector is required for tree command");
-      const snapshot = await launcher.collect({
-        rootSelector: selector,
-        downDepth: args2.depth || 6,
-        maxNodes: 60,
-        upTo: "html"
-      });
-      const lines = [];
-      lines.push(`## DOM tree (${snapshot.downDepth} levels deep)`);
-      lines.push("```");
-      renderNode2(snapshot.tree, lines, 0);
-      lines.push("```");
-      return { text: lines.join("\n") };
-    }
-    case "layout": {
-      const selector = params[0];
-      if (!selector)
-        throw new Error("Selector is required for layout command");
-      const snapshot = await launcher.collect({
-        rootSelector: selector,
-        downDepth: 6,
-        maxNodes: 60,
-        upTo: "html"
-      });
-      const findings = analyze(snapshot);
-      return { text: renderMarkdown(snapshot, findings, false, true) };
-    }
-    case "findings": {
-      const selector = params[0];
-      if (!selector)
-        throw new Error("Selector is required for findings command");
-      const snapshot = await launcher.collect({
-        rootSelector: selector,
-        downDepth: 6,
-        maxNodes: 60,
-        upTo: "html"
-      });
-      const findings = analyze(snapshot);
-      const important = findings.filter((f) => f.level === "warning" || f.level === "error");
-      if (important.length === 0) {
-        return { text: "No warnings or errors found." };
-      }
-      const lines = important.map((f) => {
-        const icon = f.level === "error" ? "\u26A0" : "\u26A0";
-        return `- ${icon} ${f.message} [${f.confidence}]${f.location ? ` @ ${f.location}` : ""}`;
-      });
-      return { text: lines.join("\n") };
-    }
-    case "inject-css": {
-      const css = params[0];
-      if (!css)
-        throw new Error("CSS is required for inject-css command");
-      const page = launcher.getPage();
-      if (!page)
-        throw new Error("Browser is not open. Run: cssprobe-cli open <url>");
-      await page.addStyleTag({ content: css });
-      return { text: JSON.stringify({ success: true }) };
-    }
-    case "screenshot": {
-      const page = launcher.getPage();
-      if (!page)
-        throw new Error("Browser is not open. Run: cssprobe-cli open <url>");
-      const buffer = await page.screenshot({ fullPage: args2.fullPage });
-      const base64 = buffer.toString("base64");
-      return { text: `data:image/png;base64,${base64}` };
-    }
-    case "eval": {
-      const expression = params[0];
-      if (!expression)
-        throw new Error("Expression is required for eval command");
-      const page = launcher.getPage();
-      if (!page)
-        throw new Error("Browser is not open. Run: cssprobe-cli open <url>");
-      const result = await page.evaluate(expression);
-      return { text: JSON.stringify(result, null, 2) };
-    }
-    case "resize": {
-      const width = parseInt(params[0], 10);
-      const height = parseInt(params[1], 10);
-      if (isNaN(width) || isNaN(height))
-        throw new Error("Usage: cssprobe-cli resize <width> <height>");
-      const page = launcher.getPage();
-      if (!page)
-        throw new Error("Browser is not open. Run: cssprobe-cli open <url>");
-      await page.setViewportSize({ width, height });
-      return { text: JSON.stringify({ width, height }) };
-    }
-    case "playwright": {
-      const call = params[0];
-      if (!call)
-        throw new Error("Playwright API call is required");
-      const page = launcher.getPage();
-      if (!page)
-        throw new Error("Browser is not open. Run: cssprobe-cli open <url>");
-      const asyncFunction = new AsyncFunction("page", "browser", `return ${call}`);
-      const browser = page.context().browser();
-      const result = await asyncFunction(page, browser);
-      return { text: JSON.stringify(result, null, 2) };
-    }
-    default:
-      throw new Error(`Unknown command: ${command}`);
-  }
-}
-function renderNode2(node, lines, indent) {
-  if (!node) return;
-  const cls = node.classes?.length ? `.${node.classes.join(".")}` : "";
-  const id = node.id ? `#${node.id}` : "";
-  const m = node.metrics;
-  const s = node.shape || {};
-  const shapeStr = s.role ? `[${s.role} h:${s.heightStrategy} w:${s.widthStrategy}]` : "";
-  const flag = [];
-  if (node.flags?.overflowsParent) flag.push("\u26A0parent-overflow");
-  if (node.flags?.overflowsViewport) flag.push("\u26A0viewport-overflow");
-  if (m?.clientHeight === 0 && m?.offsetHeight === 0) flag.push("\u26A0collapsed");
-  lines.push(`${"  ".repeat(indent)}<${node.tag}${id}${cls}> ${shapeStr} [${node.props?.position},${node.props?.display}] rect(${m?.rect?.width}\xD7${m?.rect?.height})${flag.length ? " " + flag.join(" ") : ""}`);
-  for (const child of node.children || []) renderNode2(child, lines, indent + 1);
-}
-async function socketExists(socketPath) {
-  try {
-    const stat = await import_fs2.default.promises.stat(socketPath);
-    return stat?.isSocket() || false;
-  } catch {
-    return false;
-  }
-}
-function createSessionConfig(clientInfo, sessionName2, options2) {
-  return {
-    name: sessionName2,
-    version: clientInfo.version,
-    timestamp: Date.now(),
-    socketPath: daemonSocketPath(clientInfo, sessionName2),
-    browser: {
-      browserName: options2.browser || "chromium",
-      launchOptions: { headless: options2.headed === false }
-    }
-  };
-}
-function daemonSocketPath(clientInfo, sessionName2) {
-  return import_path2.default.join(clientInfo.daemonProfilesDir, `${sessionName2}.sock`);
-}
-async function saveSessionFile(clientInfo, sessionConfig) {
-  await import_fs2.default.promises.mkdir(clientInfo.daemonProfilesDir, { recursive: true });
-  const sessionFile = import_path2.default.join(clientInfo.daemonProfilesDir, `${sessionConfig.name}.session`);
-  await import_fs2.default.promises.writeFile(sessionFile, JSON.stringify(sessionConfig, null, 2));
-}
-async function deleteSessionFile(sessionConfig) {
-  await import_fs2.default.promises.unlink(sessionConfig.socketPath).catch(() => {
-  });
-  const sessionFile = import_path2.default.join(import_path2.default.dirname(sessionConfig.socketPath), `${sessionConfig.name}.session`);
-  await import_fs2.default.promises.rm(sessionFile).catch(() => {
-  });
-}
-
-// src/daemon/session.ts
-var import_crypto = __toESM(require("crypto"));
-var import_fs3 = __toESM(require("fs"));
-var import_os2 = __toESM(require("os"));
-var import_path3 = __toESM(require("path"));
-function createClientInfo() {
-  const workspaceDir = findWorkspaceDir(process.cwd());
-  const version = require_package().version;
-  const hash = import_crypto.default.createHash("sha1");
-  hash.update(workspaceDir || __dirname);
-  const workspaceDirHash = hash.digest("hex").substring(0, 16);
-  return {
-    version,
-    workspaceDir,
-    workspaceDirHash,
-    daemonProfilesDir: daemonProfilesDir(workspaceDirHash),
-    homeDir: import_os2.default.homedir()
-  };
-}
-function findWorkspaceDir(startDir) {
-  let dir = startDir;
-  for (let i = 0; i < 10; i++) {
-    if (import_fs3.default.existsSync(import_path3.default.join(dir, ".cssprobe-cli")))
-      return dir;
-    const parentDir = import_path3.default.dirname(dir);
-    if (parentDir === dir)
-      break;
-    dir = parentDir;
-  }
-  return void 0;
-}
-var baseDaemonDir = (() => {
-  let localCacheDir;
-  if (process.platform === "linux")
-    localCacheDir = process.env.XDG_CACHE_HOME || import_path3.default.join(import_os2.default.homedir(), ".cache");
-  if (process.platform === "darwin")
-    localCacheDir = import_path3.default.join(import_os2.default.homedir(), "Library", "Caches");
-  if (process.platform === "win32")
-    localCacheDir = process.env.LOCALAPPDATA || import_path3.default.join(import_os2.default.homedir(), "AppData", "Local");
-  if (!localCacheDir)
-    throw new Error("Unsupported platform: " + process.platform);
-  return import_path3.default.join(localCacheDir, "cssprobe-cli", "daemon");
-})();
-var daemonProfilesDir = (workspaceDirHash) => {
-  return import_path3.default.join(baseDaemonDir, workspaceDirHash);
-};
-
-// src/daemon/daemonEntry.ts
-var args = process.argv.slice(2);
-var sessionName = args[0] || "default";
-var options = {
-  headed: args.includes("--headed"),
-  browser: args.find((a) => a.startsWith("--browser="))?.split("=")[1],
-  state: args.find((a) => a.startsWith("--state="))?.split("=")[1]
-};
-async function main() {
-  try {
-    const clientInfo = createClientInfo();
-    await startDaemon(sessionName, clientInfo, options);
-  } catch (e) {
-    console.error("Failed to start daemon:", e.message);
-    process.exit(1);
-  }
-}
-main();