dembrandt 0.19.2 → 0.19.3

package/README.md

@@ -62,7 +62,7 @@ Load extractions, track token drift, and compare snapshots. **[dembrandt.com/app
 
 ## Recipes
 
-**[dembrandt.com/recipes](https://www.dembrandt.com/recipes)** — 38 ready-to-run workflows. Copy a command, paste a prompt, get a result. Covers competitor benchmarking, WCAG audits, CI/CD drift detection, Figma token push, and agentic design system builds. Filterable by role.
+**[dembrandt.com/recipes](https://www.dembrandt.com/recipes)** — ready-to-run workflows. Copy a command, paste a prompt, get a result. Covers competitor benchmarking, WCAG audits, CI/CD drift detection, Figma token push, and agentic design system builds. Filterable by role.
 
 ## What to expect from extraction?
 
@@ -143,12 +143,24 @@ dembrandt example.com --browser=firefox --save-output --dtcg
 - WSL environments where headless Chromium may struggle
 
 **Installation:**
-Firefox browser is installed automatically with `npm install`. If you need to install manually:
+Browsers are installed on demand, not by `npm install` (dembrandt depends on the lean `playwright-core`, which carries no browser binaries). Fetch the engine you need, matched to the installed `playwright-core`:
 
 ```bash
+npm run install-browser   # chromium (default)
+# or a specific engine:
 npx playwright@$(node -p "require('playwright-core/package.json').version") install firefox
 ```
 
+### Connect to an existing browser (CDP)
+
+Skip the bundled browser entirely and drive an already-running Chromium over the DevTools Protocol. Useful in CI or containers where a browser is already up, and it needs no local browser download at all:
+
+```bash
+BROWSER_CDP_ENDPOINT=http://localhost:9222 dembrandt example.com --browser chromium
+```
+
+CDP is supported only with `--browser chromium`.
+
 ### W3C Design Tokens (DTCG) Format
 
 Use `--dtcg` to export in the standardized [W3C Design Tokens Community Group](https://www.designtokens.org/) format:

package/dist/lib/browser.d.ts

@@ -1,12 +1,14 @@
 /**
  * Lazy loader for the playwright-core browser engines.
  *
- * playwright is an optional peer dependency: 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.
+ * playwright-core (the driver, ~10MB, no browser download) is a regular
+ * dependency, so the import resolves on a plain install without pulling the
+ * ~150MB browser binaries onto every consumer — library-only importers
+ * (drift, types, normalize, dtcg) and Vercel/CI installs stay lean. The actual
+ * browser binary is fetched on demand (`npx playwright install chromium` or
+ * `npm run install-browser`), so only callers that really extract pay for it.
+ * The import is still routed through here and guarded so a missing engine
+ * surfaces a clear instruction; dynamic `import()` defers resolution to use.
  */
 export declare class PlaywrightMissingError extends Error {
     constructor();

package/dist/lib/browser.js

@@ -1,16 +1,18 @@
 /**
  * Lazy loader for the playwright-core browser engines.
  *
- * playwright is an optional peer dependency: 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.
+ * playwright-core (the driver, ~10MB, no browser download) is a regular
+ * dependency, so the import resolves on a plain install without pulling the
+ * ~150MB browser binaries onto every consumer — library-only importers
+ * (drift, types, normalize, dtcg) and Vercel/CI installs stay lean. The actual
+ * browser binary is fetched on demand (`npx playwright install chromium` or
+ * `npm run install-browser`), so only callers that really extract pay for it.
+ * The import is still routed through here and guarded so a missing engine
+ * surfaces a clear instruction; dynamic `import()` defers resolution to use.
  */
 export class PlaywrightMissingError extends Error {
     constructor() {
-        super('playwright not installed, run: npm i playwright');
+        super('browser engine not available, run: npx playwright install chromium');
         this.name = 'PlaywrightMissingError';
     }
 }

package/dist/lib/browser.js.map

@@ -1 +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"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../lib/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C;QACE,KAAK,CAAC,oEAAoE,CAAC,CAAC;QAC5E,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"}

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dembrandt",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "Extract design tokens and publicly visible CSS information from any website",
   "mcpName": "io.github.dembrandt/dembrandt",
   "main": "dist/index.js",
@@ -67,25 +67,22 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
-    "ora": "^7.0.1"
+    "ora": "^7.0.1",
+    "playwright-core": "^1.60.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "playwright": "^1.57.0",
-    "playwright-core": "1.60.0",
+    "playwright": "^1.60.0",
     "zod": "4.3.6"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {
       "optional": true
     },
-    "playwright": {
-      "optional": true
-    },
-    "playwright-core": {
+    "zod": {
       "optional": true
     },
-    "zod": {
+    "playwright": {
       "optional": true
     }
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dembrandt",
-  "version": "0.19.2",
+  "version": "0.19.3",
   "description": "Extract design tokens and publicly visible CSS information from any website",
   "mcpName": "io.github.dembrandt/dembrandt",
   "main": "dist/index.js",
@@ -67,25 +67,22 @@
   "dependencies": {
     "chalk": "^5.3.0",
     "commander": "^11.1.0",
-    "ora": "^7.0.1"
+    "ora": "^7.0.1",
+    "playwright-core": "^1.60.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "1.29.0",
-    "playwright": "^1.57.0",
-    "playwright-core": "1.60.0",
+    "playwright": "^1.60.0",
     "zod": "4.3.6"
   },
   "peerDependenciesMeta": {
     "@modelcontextprotocol/sdk": {
       "optional": true
     },
-    "playwright": {
-      "optional": true
-    },
-    "playwright-core": {
+    "zod": {
       "optional": true
     },
-    "zod": {
+    "playwright": {
       "optional": true
     }
   },