dembrandt 0.16.0 → 0.17.1

package/README.md

@@ -3,6 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/dembrandt.svg)](https://www.npmjs.com/package/dembrandt)
 [![npm downloads](https://img.shields.io/npm/dm/dembrandt.svg)](https://www.npmjs.com/package/dembrandt)
 [![license](https://img.shields.io/npm/l/dembrandt.svg)](https://github.com/dembrandt/dembrandt/blob/main/LICENSE)
+[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-me-pink?style=flat&logo=github-sponsors)](https://github.com/sponsors/dembrandt)
 
 Extract a website's design system into design tokens in a few seconds: logo, colors, typography, borders, and more. One command.
 
@@ -25,7 +26,7 @@ Requires Node.js 18+
 Use Dembrandt as a tool in Claude Code, Cursor, Windsurf, or any MCP-compatible client. Ask your agent to "extract the color palette from example.com" and it calls Dembrandt automatically.
 
 ```bash
-claude mcp add --transport stdio dembrandt -- npx -y dembrandt-mcp
+claude mcp add --transport stdio dembrandt -- npx -y --package dembrandt dembrandt-mcp
 ```
 
 Or add to your project's `.mcp.json`:
@@ -35,7 +36,7 @@ Or add to your project's `.mcp.json`:
   "mcpServers": {
     "dembrandt": {
       "command": "npx",
-      "args": ["-y", "dembrandt-mcp"]
+      "args": ["-y", "--package", "dembrandt", "dembrandt-mcp"]
     }
   }
 }
@@ -57,7 +58,7 @@ Load extractions, track token drift, and compare snapshots. **[dembrandt.com/app
 * **Visual diff.** Color swatches, before/after values, delta scores per category.
 * **Snapshot history.** GitHub-style calendar per domain.
 * **Copy tokens.** Paste values straight into Copilot, Claude, or Cursor.
-* **No login.** Your data stays in the browser, nothing is sent to any server.
+* **No login.** Your data stays in the browser. Drift is computed locally — nothing is sent to any server.
 
 ## Recipes
 
@@ -145,7 +146,7 @@ dembrandt example.com --browser=firefox --save-output --dtcg
 Firefox browser is installed automatically with `npm install`. If you need to install manually:
 
 ```bash
-npx playwright install firefox
+npx playwright@$(node -p "require('playwright-core/package.json').version") install firefox
 ```
 
 ### W3C Design Tokens (DTCG) Format
@@ -175,7 +176,7 @@ DESIGN.md reports only what Dembrandt observed on the source site. Exact values
 Use `--wcag` to check accessibility contrast ratios across the page. Unlike palette-based checkers, dembrandt walks the actual DOM and finds what color is rendered on top of what background — per element.
 
 ```bash
-dembrandt stripe.com --wcag
+dembrandt dembrandt.com --wcag
 ```
 
 Returns every text/background pair with contrast ratio and WCAG 2.1 grade (AA, AA-Large, AAA, or fail), sorted by how often each pair appears. Results are shown in terminal and included in JSON output as `wcag`.
@@ -187,7 +188,7 @@ Also captures **interactive state contrast**: dembrandt simulates hover, focus,
 Motion tokens are extracted automatically on every run — no flag needed. Dembrandt analyzes CSS transitions and animations across the page and returns a structured motion profile.
 
 ```bash
-dembrandt stripe.com
+dembrandt dembrandt.com
 ```
 
 Returns:
@@ -207,51 +208,66 @@ dembrandt example.com --brand-guide
 # Saves to: output/example.com/TIMESTAMP.brand-guide.pdf
 ```
 
+## Continuous integration
+
+Dembrandt drives a real browser, so the browser revision must match `playwright-core`.
+
+If you are not using the Playwright container image, install the browser revision that matches `playwright-core`:
+
+```bash
+# in dembrandt's own repo
+npm run install-browser
+# elsewhere — derive the version so it always matches
+npx playwright@$(node -p "require('playwright-core/package.json').version") install --with-deps chromium
+```
+
+A mismatched version fails with "Executable doesn't exist". The container image avoids this entirely — just match its tag (`v1.60.0`) to the `playwright-core` version.
+
 ## Recipes
 
 **Quick brand scan**
 ```bash
-dembrandt stripe.com
+dembrandt dembrandt.com
 ```
 
 **Compare two sites**
 ```bash
-dembrandt stripe.com --save-output
+dembrandt dembrandt.com --save-output
 dembrandt braintree.com --save-output
-# Compare output/stripe.com and output/braintree.com side by side
+# Compare output/dembrandt.com and output/braintree.com side by side
 ```
 
 **Multi-page audit** — get a fuller picture across the whole site
 ```bash
-dembrandt stripe.com --crawl 10 --sitemap --save-output
+dembrandt dembrandt.com --crawl 10 --sitemap --save-output
 ```
 
 **Spot-check a value** — verify a specific token fast
 ```bash
-dembrandt stripe.com --json-only | grep -i "border-radius"
+dembrandt dembrandt.com --json-only | grep -i "border-radius"
 ```
 
 **Export for Tailwind** — get spacing and color values into your config
 ```bash
-dembrandt stripe.com --dtcg --save-output
+dembrandt dembrandt.com --dtcg --save-output
 # Use the .tokens.json with Style Dictionary to generate tailwind.config.js
 ```
 
 **Export for Tokens Studio / Figma**
 ```bash
-dembrandt stripe.com --dtcg --save-output
+dembrandt dembrandt.com --dtcg --save-output
 # Import the .tokens.json directly into Tokens Studio
 ```
 
 **Generate DESIGN.md for your AI agent**
 ```bash
-dembrandt stripe.com --design-md
+dembrandt dembrandt.com --design-md
 # Point your agent at the output DESIGN.md
 ```
 
 **Accessibility audit** — check contrast on any live URL
 ```bash
-dembrandt stripe.com --wcag
+dembrandt dembrandt.com --wcag
 ```
 
 **Regression baseline** — snapshot now, catch drift later
@@ -311,6 +327,16 @@ Only run Dembrandt against sites whose Terms of Service permit automated access,
 
 Dembrandt does not host, redistribute, or claim rights to any third-party brand assets.
 
+## Sponsors
+
+The CLI is MIT-licensed and free. Sponsorship funds the enforcement layer: a committed project-level token baseline, `--compare` and the ingest API for CI/CD drift gates, and the App platform (snapshot history, team drift dashboard, alerts to Slack, Linear, and GitHub).
+
+[![GitHub Sponsors](https://img.shields.io/badge/Sponsor-me-pink?style=flat&logo=github-sponsors)](https://github.com/sponsors/dembrandt)
+
+<!-- sponsors -->
+<!-- Backer ($25+) and Lead sponsor ($500+) logos appear here. -->
+<!-- sponsors -->
+
 ## Contributing
 
 Bugs, weird sites, pull requests. All welcome.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Dembrandt - Design Token Extraction CLI
+ *
+ * Extracts design tokens, brand colors, typography, spacing, and component styles
+ * from any website using Playwright.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,392 @@
+#!/usr/bin/env node
+/**
+ * Dembrandt - Design Token Extraction CLI
+ *
+ * Extracts design tokens, brand colors, typography, spacing, and component styles
+ * from any website using Playwright.
+ */
+import { program } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { chromium, firefox } from "playwright-core";
+import { extractBranding } from "./lib/extractors/index.js";
+import { displayResults } from "./lib/formatters/terminal.js";
+import { color } from "./lib/formatters/theme.js";
+import { toDtcgTokens } from "./lib/formatters/dtcg.js";
+import { generatePDF } from "./lib/formatters/pdf.js";
+import { generateDesignMd } from "./lib/formatters/markdown.js";
+import { parseSitemap } from "./lib/discovery.js";
+import { mergeResults } from "./lib/merger.js";
+import { writeFileSync, mkdirSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { checkRobotsTxt } from "./lib/robots.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const { version } = JSON.parse(readFileSync(join(__dirname, "package.json"), "utf8"));
+/**
+ * ora options for a spinner on the given stream. The spinner animates only on
+ * a real interactive terminal: a non-TTY (piped) or CI environment gets the
+ * final status lines without the frame churn that garbles logs. Some CI runners
+ * allocate a pseudo-TTY, so we check CI explicitly rather than rely on isTTY.
+ */
+function spinnerOptions(useStderr = false) {
+    const stream = useStderr ? process.stderr : process.stdout;
+    return { stream, isEnabled: Boolean(stream.isTTY) && !process.env.CI };
+}
+program
+    .name("dembrandt")
+    .description("Extract design tokens from any website.")
+    .version(version)
+    .enablePositionalOptions()
+    .argument("<url>")
+    .argument("[paths...]", "Additional paths on the same domain to extract and merge, e.g. /pricing /docs")
+    .option("--browser <type>", "Browser to use (chromium|firefox); set BROWSER_CDP_ENDPOINT env var to connect to an existing Chromium instance via CDP", "chromium")
+    .option("--json-only", "Output raw JSON")
+    .option("--save-output", "Save JSON file to output folder")
+    .option("--dtcg", "Export in W3C Design Tokens (DTCG) format")
+    .option("--dark-mode", "Extract colors from dark mode")
+    .option("--mobile", "Extract from mobile viewport")
+    .option("--slow", "3x longer timeouts for slow-loading sites")
+    .option("--brand-guide", "Export a brand guide PDF")
+    .option("--design-md", "Export a DESIGN.md file")
+    .option("--no-sandbox", "Disable browser sandbox (needed for Docker/CI)")
+    .option("--raw-colors", "Include pre-filter raw colors in JSON output")
+    .option("--screenshot <path>", "Save a viewport screenshot of the page (not full-page)")
+    .option("--wcag", "Analyze WCAG contrast ratios between palette colors")
+    .option("--crawl [n]", "Auto-discover and extract up to N pages via DOM links (default: 5); combine with --sitemap to use sitemap discovery instead", (v) => {
+    if (v === undefined || v === true)
+        return 5;
+    const n = parseInt(v, 10);
+    if (isNaN(n) || n < 1)
+        throw new Error(`--crawl must be a positive integer, got: ${v}`);
+    return n;
+})
+    .option("--sitemap", "Discover pages from sitemap.xml instead of DOM links; use alone or combine with --crawl to set page limit")
+    .option("--cookie <string>", "Cookie string for authenticated pages, e.g. \"session=abc; token=xyz\"")
+    .option("--header <string>", "Extra HTTP header, e.g. \"Authorization: Bearer eyJ...\"")
+    .option("--stealth", "Enable anti-detection: navigator spoofing, human mouse simulation, randomized fingerprint (use only when authorized)")
+    .option("--user-agent <string>", "Custom user agent string")
+    .option("--locale <string>", "Browser locale for fingerprint, e.g. en-GB, fi-FI; affects content only if the site reacts to Accept-Language (default: en-US)")
+    .option("--timezone <string>", "Browser timezone for fingerprint, e.g. Europe/Helsinki; affects content only if the site reacts to timezone (default: America/New_York)")
+    .option("--accept-language <string>", "Custom Accept-Language header value")
+    .option("--screen-size <WxH>", "Physical screen resolution to report, e.g. 1920x1080 (default: 1920x1080)")
+    .action(async (input, paths, opts) => {
+    let url = input;
+    if (!url.startsWith("http://") && !url.startsWith("https://")) {
+        url = "https://" + url;
+    }
+    // In --json-only mode, redirect all status output to stderr so stdout is clean JSON
+    const originalConsoleLog = console.log;
+    if (opts.jsonOnly) {
+        console.log = (...args) => console.error(...args);
+    }
+    const spinner = ora({ text: "Starting extraction...", ...spinnerOptions(opts.jsonOnly) }).start();
+    try {
+        const robots = await checkRobotsTxt(url);
+        if (robots.status === "ok" && robots.allowed === false) {
+            spinner.warn(chalk.hex("#FFB86C")(`robots.txt disallows this path (rule: "${robots.rule}"). Proceeding anyway — respect the site's terms.`));
+            spinner.start("Starting extraction...");
+        }
+    }
+    catch {
+        // robots check is advisory; never block extraction
+    }
+    let browser = null;
+    try {
+        let useHeaded = false;
+        let result;
+        while (true) {
+            // Select browser type based on --browser flag
+            const browserType = opts.browser === 'firefox' ? firefox : chromium;
+            spinner.text = `Launching browser (${useHeaded ? "visible" : "headless"} mode)`;
+            // Firefox-specific launch args (Firefox doesn't support Chromium flags)
+            const launchArgs = opts.browser === 'firefox'
+                ? [] // Firefox has different flags
+                : ["--disable-blink-features=AutomationControlled"];
+            if (opts.noSandbox && opts.browser === 'chromium') {
+                launchArgs.push("--no-sandbox", "--disable-setuid-sandbox");
+            }
+            if (process.env.BROWSER_CDP_ENDPOINT) {
+                if (opts.browser !== 'chromium') {
+                    throw new Error("BROWSER_CDP_ENDPOINT is only supported with --browser chromium.");
+                }
+                spinner.text = "Connecting over CDP...";
+                browser = await browserType.connectOverCDP(process.env.BROWSER_CDP_ENDPOINT);
+            }
+            else {
+                browser = await browserType.launch({
+                    headless: !useHeaded,
+                    args: launchArgs,
+                });
+            }
+            try {
+                const crawlN = opts.crawl ?? null;
+                const isAutoCrawl = crawlN && !opts.sitemap && (!paths || paths.length === 0);
+                const hasExplicitPaths = paths && paths.length > 0;
+                result = await extractBranding(url, spinner, browser, {
+                    navigationTimeout: 90000,
+                    verbose: !opts.jsonOnly,
+                    darkMode: opts.darkMode,
+                    mobile: opts.mobile,
+                    slow: opts.slow,
+                    screenshotPath: opts.screenshot,
+                    discoverLinks: isAutoCrawl ? crawlN - 1 : null,
+                    wcag: opts.wcag,
+                    includeRawColors: opts.rawColors,
+                    stealth: opts.stealth,
+                    cookie: opts.cookie,
+                    header: opts.header,
+                    userAgent: opts.userAgent,
+                    locale: opts.locale,
+                    timezoneId: opts.timezone,
+                    acceptLanguage: opts.acceptLanguage,
+                    screenSize: opts.screenSize,
+                    _version: version,
+                });
+                // Build list of additional URLs to extract
+                let additionalUrls = [];
+                if (hasExplicitPaths) {
+                    // Explicit paths: resolve against base URL
+                    const base = new URL(result.url);
+                    additionalUrls = paths.map(p => {
+                        if (p.startsWith('http'))
+                            return p;
+                        return `${base.protocol}//${base.host}${p.startsWith('/') ? p : '/' + p}`;
+                    });
+                }
+                else if (opts.sitemap) {
+                    if (!opts.jsonOnly)
+                        spinner.start("Fetching sitemap...");
+                    const max = crawlN ? crawlN - 1 : 20;
+                    additionalUrls = await parseSitemap(result.url, max);
+                    if (additionalUrls.length === 0 && result.url !== url) {
+                        additionalUrls = await parseSitemap(url, max);
+                    }
+                }
+                else if (isAutoCrawl) {
+                    additionalUrls = result._discoveredLinks || [];
+                }
+                delete result._discoveredLinks;
+                if (additionalUrls.length === 0) {
+                    if ((hasExplicitPaths || opts.sitemap || isAutoCrawl) && !opts.jsonOnly) {
+                        spinner.warn("No additional pages discovered");
+                    }
+                }
+                else {
+                    spinner.stop();
+                    if (!opts.jsonOnly)
+                        console.log(chalk.dim(`  Found ${additionalUrls.length} page(s) to analyze`));
+                    const allResults = [result];
+                    for (let i = 0; i < additionalUrls.length; i++) {
+                        const pageUrl = additionalUrls[i];
+                        const pageNum = i + 2;
+                        const total = additionalUrls.length + 1;
+                        if (!opts.jsonOnly)
+                            spinner.start(`Extracting page ${pageNum}/${total}: ${new URL(pageUrl).pathname}`);
+                        await new Promise(r => setTimeout(r, 1500 + Math.random() * 1500));
+                        try {
+                            const pageResult = await extractBranding(pageUrl, spinner, browser, {
+                                navigationTimeout: 90000,
+                                verbose: !opts.jsonOnly,
+                                darkMode: opts.darkMode,
+                                mobile: opts.mobile,
+                                slow: opts.slow,
+                                stealth: opts.stealth,
+                                userAgent: opts.userAgent,
+                                locale: opts.locale,
+                                timezoneId: opts.timezone,
+                                acceptLanguage: opts.acceptLanguage,
+                            });
+                            delete pageResult._discoveredLinks;
+                            allResults.push(pageResult);
+                        }
+                        catch (err) {
+                            if (!opts.jsonOnly)
+                                spinner.warn(`Skipping ${pageUrl}: ${String(err?.message || err).slice(0, 80)}`);
+                        }
+                    }
+                    spinner.stop();
+                    result = mergeResults(allResults);
+                }
+                if (!hasExplicitPaths && !opts.sitemap && !isAutoCrawl) {
+                    delete result._discoveredLinks;
+                }
+                break;
+            }
+            catch (err) {
+                await browser.close();
+                browser = null;
+                if (useHeaded || process.env.BROWSER_CDP_ENDPOINT)
+                    throw err;
+                if (err.message.includes("Timeout") ||
+                    err.message.includes("net::ERR_")) {
+                    spinner.warn("Navigation failed → retrying with visible browser");
+                    console.error(chalk.dim(`  ↳ Error: ${err.message}`));
+                    console.error(chalk.dim(`  ↳ URL: ${url}`));
+                    console.error(chalk.dim(`  ↳ Mode: headless`));
+                    useHeaded = true;
+                    continue;
+                }
+                throw err;
+            }
+        }
+        console.log();
+        // Strip raw colors unless --raw-colors flag is set
+        if (!opts.rawColors && result.colors && result.colors.rawColors) {
+            delete result.colors.rawColors;
+        }
+        // Convert to W3C format if requested
+        const outputData = opts.dtcg ? toDtcgTokens(result) : result;
+        // Collect "saved to" notices and print them after the results below
+        const savedNotices = [];
+        // Save JSON output if --save-output or --dtcg is specified
+        if (opts.saveOutput || opts.dtcg) {
+            try {
+                const domain = new URL(url).hostname.replace("www.", "");
+                const timestamp = new Date()
+                    .toISOString()
+                    .replace(/[:.]/g, "-")
+                    .split(".")[0];
+                // Save to current working directory, not installation directory
+                const outputDir = join(process.cwd(), "output", domain);
+                mkdirSync(outputDir, { recursive: true });
+                const suffix = opts.dtcg ? '.tokens' : '';
+                const filename = `${timestamp}_v${version}${suffix}.json`;
+                const filepath = join(outputDir, filename);
+                writeFileSync(filepath, JSON.stringify(outputData, null, 2));
+                const jsonLabel = opts.dtcg
+                    ? 'DTCG tokens saved (--dtcg)'
+                    : 'JSON saved (--save-output)';
+                savedNotices.push(chalk.dim(`💾 ${jsonLabel}: ${color.info(`output/${domain}/${filename}`)}`));
+            }
+            catch (err) {
+                console.log(color.warning(`! Could not save JSON file: ${err.message}`));
+            }
+        }
+        // Generate PDF brand guide
+        if (opts.brandGuide) {
+            try {
+                const pdfDomain = new URL(url).hostname.replace("www.", "");
+                const now = new Date();
+                const pdfDate = now.toISOString().slice(0, 10);
+                const pdfTime = `${String(now.getHours()).padStart(2, '0')}-${String(now.getMinutes()).padStart(2, '0')}`;
+                const pdfDir = join(process.cwd(), "output", pdfDomain);
+                mkdirSync(pdfDir, { recursive: true });
+                const pdfFilename = `${pdfDomain}-brand-guide-${pdfDate}-${pdfTime}.pdf`;
+                const pdfPath = join(pdfDir, pdfFilename);
+                spinner.start("Generating PDF brand guide...");
+                await generatePDF(result, pdfPath, browser);
+                spinner.stop();
+                savedNotices.push(chalk.dim(`💾 Brand guide PDF saved (--brand-guide): ${color.info(`output/${pdfDomain}/${pdfFilename}`)}`));
+            }
+            catch (err) {
+                spinner.stop();
+                console.log(color.warning(`Could not generate PDF: ${err.message}`));
+            }
+        }
+        // Generate DESIGN.md
+        if (opts.designMd) {
+            try {
+                const mdDomain = new URL(url).hostname.replace("www.", "");
+                const mdDir = join(process.cwd(), "output", mdDomain);
+                mkdirSync(mdDir, { recursive: true });
+                const mdPath = join(mdDir, "DESIGN.md");
+                writeFileSync(mdPath, generateDesignMd(result));
+                savedNotices.push(chalk.dim(`💾 DESIGN.md saved (--design-md): ${color.info(`output/${mdDomain}/DESIGN.md`)}`));
+            }
+            catch (err) {
+                console.log(color.warning(`Could not generate DESIGN.md: ${err.message}`));
+            }
+        }
+        // Output to terminal
+        const summaryLine = color.accent('✨ Analysis summary: ') +
+            chalk.dim(`${result.colors?.palette?.length ?? 0} colors, ` +
+                `${result.typography?.styles?.length ?? 0} text styles, ` +
+                `${result.breakpoints?.length ?? 0} breakpoints.`);
+        if (opts.jsonOnly) {
+            console.log = originalConsoleLog;
+            console.log(JSON.stringify(outputData, null, 2));
+            console.error(summaryLine);
+            for (const notice of savedNotices)
+                console.error(notice);
+        }
+        else {
+            console.log();
+            displayResults(result);
+            console.log();
+            console.log(summaryLine);
+            for (const notice of savedNotices)
+                console.log(notice);
+        }
+    }
+    catch (err) {
+        spinner.fail("Failed");
+        console.error(chalk.red("\n✗ Extraction failed"));
+        console.error(chalk.red(`  Error: ${err.message}`));
+        console.error(chalk.dim(`  URL: ${url}`));
+        process.exit(1);
+    }
+    finally {
+        if (browser)
+            await browser.close();
+    }
+});
+// Grouped --help for the root command. Commander 11 has no native option groups,
+// so render them via a custom formatHelp. Subcommands keep a single flat list.
+const OPTION_GROUPS = [
+    ["Extraction", ["--dark-mode", "--mobile", "--slow", "--crawl", "--sitemap", "--browser"]],
+    ["Output & export", ["--json-only", "--save-output", "--dtcg", "--brand-guide", "--design-md", "--screenshot", "--raw-colors"]],
+    ["Analysis", ["--wcag"]],
+    ["Network & auth", ["--cookie", "--header", "--user-agent", "--locale", "--timezone", "--accept-language", "--screen-size"]],
+    ["Anti-detection", ["--stealth", "--no-sandbox"]],
+];
+program.configureHelp({
+    formatHelp(cmd, helper) {
+        const helpWidth = helper.helpWidth ?? 80;
+        const termWidth = helper.padWidth(cmd, helper);
+        const indent = 2;
+        const item = (term, desc) => {
+            if (!desc)
+                return term;
+            const full = `${term.padEnd(termWidth + 2)}${desc}`;
+            return helper.wrap(full, helpWidth - indent, termWidth + 2);
+        };
+        const block = (lines) => lines.map((l) => " ".repeat(indent) + l).join("\n");
+        const out = [`Usage: ${helper.commandUsage(cmd)}`, ""];
+        const description = helper.commandDescription(cmd);
+        if (description)
+            out.push(description, "");
+        const args = helper.visibleArguments(cmd);
+        if (args.length) {
+            out.push("Arguments:", block(args.map((a) => item(helper.argumentTerm(a), helper.argumentDescription(a)))), "");
+        }
+        const options = helper.visibleOptions(cmd);
+        if (options.length) {
+            if (cmd.parent) {
+                out.push("Options:", block(options.map((o) => item(helper.optionTerm(o), helper.optionDescription(o)))), "");
+            }
+            else {
+                const byLong = new Map(options.map((o) => [o.long ?? o.short, o]));
+                const used = new Set();
+                for (const [title, flags] of OPTION_GROUPS) {
+                    const groupOpts = flags.map((f) => byLong.get(f)).filter(Boolean);
+                    if (!groupOpts.length)
+                        continue;
+                    groupOpts.forEach((o) => used.add(o));
+                    out.push(`${title}:`, block(groupOpts.map((o) => item(helper.optionTerm(o), helper.optionDescription(o)))), "");
+                }
+                const rest = options.filter((o) => !used.has(o));
+                if (rest.length) {
+                    out.push("General:", block(rest.map((o) => item(helper.optionTerm(o), helper.optionDescription(o)))), "");
+                }
+            }
+        }
+        const commands = helper.visibleCommands(cmd);
+        if (commands.length) {
+            out.push("Commands:", block(commands.map((c) => item(helper.subcommandTerm(c), helper.subcommandDescription(c)))), "");
+        }
+        return out.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd() + "\n";
+    },
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/browser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Lazy loader for the playwright-core browser engines.
+ *
+ * playwright is an optionalDependency: consumers that use only the pure
+ * exports (drift, types, normalize, dtcg) are not forced to install the
+ * browser stack. Anything that actually drives a browser routes its import
+ * through here, so a missing install surfaces a clear instruction instead of
+ * a raw ERR_MODULE_NOT_FOUND at startup. Static `import` would fail at module
+ * load, before any guard could run; dynamic `import()` defers it to use.
+ */
+export declare class PlaywrightMissingError extends Error {
+    constructor();
+}
+export declare function loadBrowserEngines(): Promise<typeof import('playwright-core')>;

package/dist/lib/browser.js

@@ -0,0 +1,25 @@
+/**
+ * Lazy loader for the playwright-core browser engines.
+ *
+ * playwright is an optionalDependency: consumers that use only the pure
+ * exports (drift, types, normalize, dtcg) are not forced to install the
+ * browser stack. Anything that actually drives a browser routes its import
+ * through here, so a missing install surfaces a clear instruction instead of
+ * a raw ERR_MODULE_NOT_FOUND at startup. Static `import` would fail at module
+ * load, before any guard could run; dynamic `import()` defers it to use.
+ */
+export class PlaywrightMissingError extends Error {
+    constructor() {
+        super('playwright not installed, run: npm i playwright');
+        this.name = 'PlaywrightMissingError';
+    }
+}
+export async function loadBrowserEngines() {
+    try {
+        return await import('playwright-core');
+    }
+    catch {
+        throw new PlaywrightMissingError();
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/lib/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../lib/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C;QACE,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,sBAAsB,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}