designlang 10.1.0 → 10.2.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [10.2.0] — 2026-04-22
+
+**Dark mode pairing + responsive screenshots.** Joins the light & dark extractor passes into semantic pairs, and adds full-page captures at 4 breakpoints × (light, dark).
+
+### Added
+
+- **`src/extractors/dark-mode-pair.js`** — pure function that maps light ↔ dark pairs for primary/secondary/accent/background/text roles and every CSS variable that actually differs between themes. Emits a drop-in Tailwind `darkMode: 'class'` config plus an audit (tokens missing from either pass).
+- **`src/extractors/responsive-screenshots.js`** — full-page PNGs at mobile / tablet / desktop / wide × (light, dark). Writes to `screenshots/responsive/<breakpoint>-<scheme>.png` with an index.
+- New flag `--responsive-shots`. Auto-on with `--full`.
+- New outputs: `*-dark-mode.json`, `*-responsive.json`.
+
+### Changed
+
+- CLI version test now reads from `package.json` instead of a hardcoded string — no per-release test churn going forward.
+
 ## [10.1.0] — 2026-04-22
 
 **Component screenshots.** The existing `--screenshots` flag now emits cluster-aware, retina (2×), multi-variant PNGs instead of five hardcoded selectors and a full-page image.

package/bin/design-extract.js

@@ -10,6 +10,8 @@ import { refineWithSmart } from '../src/classifiers/smart.js';
 import { crawlCanonicalPages } from '../src/multipage.js';
 import { extractLogo } from '../src/extractors/logo.js';
 import { captureComponentScreenshotsV10 } from '../src/extractors/component-screenshots.js';
+import { pairDarkMode } from '../src/extractors/dark-mode-pair.js';
+import { captureResponsiveScreenshots } from '../src/extractors/responsive-screenshots.js';
 import { buildPromptPack } from '../src/formatters/prompt-pack.js';
 import { formatMarkdown } from '../src/formatters/markdown.js';
 import { formatTokens } from '../src/formatters/tokens.js';
@@ -53,7 +55,7 @@ const program = new Command();
 program
   .name('designlang')
   .description('Extract the complete design language from any website')
-  .version('10.1.0');
+  .version('10.2.0');
 
 // ── Main command: extract ──────────────────────────────────────
 program
@@ -85,6 +87,7 @@ program
   .option('--smart', 'use optional LLM fallback when heuristic classifiers have low confidence (needs OPENAI_API_KEY or ANTHROPIC_API_KEY)')
   .option('--pages <n>', 'crawl N canonical pages (pricing/docs/blog/about/product) in addition to the homepage', parseInt)
   .option('--no-prompts', 'skip writing the prompt-pack directory')
+  .option('--responsive-shots', 'capture full-page PNGs at 4 breakpoints × (light,dark)')
   .option('--json', 'output raw JSON to stdout (for CI/CD)')
   .option('--json-pretty', 'output formatted JSON to stdout')
   .option('--no-history', 'skip saving to history')
@@ -233,6 +236,20 @@ program
         } catch (e) { design.componentScreenshots = { error: e.message }; }
       }
 
+      // v10.2: dark-mode pairing (pure, based on already-extracted data).
+      design.darkModePaired = pairDarkMode(design);
+
+      // v10.2: responsive screenshots at 4 breakpoints × (light, dark).
+      if (merged.full || merged.responsiveShots) {
+        spinner.text = 'Capturing responsive screenshots...';
+        try {
+          design.responsiveShots = await captureResponsiveScreenshots(url, outDir, {
+            includeDark: merged.dark || merged.full,
+            channel: merged.systemChrome ? 'chrome' : undefined,
+          });
+        } catch (e) { design.responsiveShots = { error: e.message }; }
+      }
+
       // v10: multi-page canonical crawl (pricing/docs/blog/about/product).
       const pagesArg = merged.pages != null ? merged.pages : (merged.full ? 5 : 0);
       if (pagesArg > 0) {
@@ -322,6 +339,12 @@ program
       if (design.componentScreenshots && (design.componentScreenshots.components || []).length) {
         files.push({ name: `${prefix}-screenshots.json`, content: JSON.stringify(design.componentScreenshots, null, 2), label: 'Component Screenshots index' });
       }
+      if (design.darkModePaired && design.darkModePaired.available) {
+        files.push({ name: `${prefix}-dark-mode.json`, content: JSON.stringify(design.darkModePaired, null, 2), label: 'Dark Mode Pairing' });
+      }
+      if (design.responsiveShots && Array.isArray(design.responsiveShots.shots) && design.responsiveShots.shots.length) {
+        files.push({ name: `${prefix}-responsive.json`, content: JSON.stringify(design.responsiveShots, null, 2), label: 'Responsive Screenshots index' });
+      }
       if (merged.prompts !== false) {
         const pack = buildPromptPack(design);
         const promptsDir = join(outDir, `${prefix}-prompts`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "designlang",
-  "version": "10.1.0",
+  "version": "10.2.0",
   "description": "Extract the complete design language from any website — colors, typography, spacing, shadows, motion, component anatomy, brand voice, page intent, section roles, material language, component library, imagery style, and logo. Outputs AI-optimized markdown, W3C design tokens, motion tokens, typed component stubs, Tailwind config, and ready-to-paste v0 / Lovable / Cursor / Claude-Artifacts prompts.",
   "type": "module",
   "bin": {

package/src/extractors/dark-mode-pair.js

@@ -0,0 +1,96 @@
+// v10.2 — Dark Mode Pairing
+//
+// When the user passes --dark the crawler runs a second pass under
+// `color-scheme: dark` and the main extractor emits `design.darkMode` with
+// parallel colors + CSS variable maps. This module joins the two halves into
+// *semantic pairs* — same role in light mode ↔ same role in dark mode — so
+// downstream consumers (prompt pack, Tailwind darkMode config, agents) can
+// author a single `[data-theme="dark"]` override block without guessing.
+//
+// Pure function. No Page handle, no side effects — takes the finished design
+// object and returns a plain JSON structure.
+
+function hexOf(c) {
+  if (!c) return null;
+  if (typeof c === 'string') return c.toLowerCase();
+  return (c.hex || '').toLowerCase();
+}
+
+function pairRoleColors(light = {}, dark = {}) {
+  const pairs = {};
+  for (const role of ['primary', 'secondary', 'accent']) {
+    const l = hexOf(light[role]);
+    const d = hexOf(dark[role]);
+    if (l || d) pairs[role] = { light: l, dark: d };
+  }
+  const bgPair = {
+    light: (light.backgrounds?.[0]?.hex || null),
+    dark: (dark.backgrounds?.[0]?.hex || null),
+  };
+  if (bgPair.light || bgPair.dark) pairs.background = bgPair;
+  const textPair = {
+    light: (light.text?.[0]?.hex || null),
+    dark: (dark.text?.[0]?.hex || null),
+  };
+  if (textPair.light || textPair.dark) pairs.text = textPair;
+  return pairs;
+}
+
+function pairVariables(lightVars = {}, darkVars = {}) {
+  // Walk the union of keys; emit light/dark only when values differ.
+  const keys = new Set([...Object.keys(lightVars || {}), ...Object.keys(darkVars || {})]);
+  const out = {};
+  for (const k of keys) {
+    const l = lightVars[k];
+    const d = darkVars[k];
+    if (l == null && d == null) continue;
+    if (typeof l === 'string' && typeof d === 'string' && l === d) continue;
+    out[k] = { light: l ?? null, dark: d ?? null };
+  }
+  return out;
+}
+
+export function pairDarkMode(design = {}) {
+  if (!design.darkMode) {
+    return { available: false, reason: 'no --dark pass captured' };
+  }
+  const lightColors = design.colors || {};
+  const darkColors = design.darkMode.colors || {};
+  const roles = pairRoleColors(lightColors, darkColors);
+  const variables = pairVariables(design.variables || {}, design.darkMode.variables || {});
+  const pairedVarCount = Object.keys(variables).length;
+
+  // Light colors that don't appear in dark (and vice versa) signal tokens the
+  // site forgot to theme — useful for an audit.
+  const lightSet = new Set((lightColors.all || []).map(c => (c.hex || '').toLowerCase()).filter(Boolean));
+  const darkSet = new Set((darkColors.all || []).map(c => (c.hex || '').toLowerCase()).filter(Boolean));
+  const missingInDark = [...lightSet].filter(x => !darkSet.has(x)).slice(0, 20);
+  const missingInLight = [...darkSet].filter(x => !lightSet.has(x)).slice(0, 20);
+
+  // Tailwind-ready config snippet.
+  const tailwind = {
+    darkMode: 'class',
+    theme: {
+      extend: {
+        colors: Object.fromEntries(
+          Object.entries(roles)
+            .filter(([, v]) => v.light && v.dark)
+            .map(([role, v]) => [role, { DEFAULT: v.light, dark: v.dark }]),
+        ),
+      },
+    },
+  };
+
+  return {
+    available: true,
+    roles,
+    variables,
+    pairedVarCount,
+    audit: {
+      missingInDark,
+      missingInLight,
+      coverage: pairedVarCount > 0 ? 'paired' : 'light-only-vars',
+    },
+    tailwind,
+  };
+}

package/src/extractors/responsive-screenshots.js

@@ -0,0 +1,55 @@
+// v10.2 — Responsive Screenshots
+//
+// Full-page PNGs at each breakpoint × (light, dark). Lives alongside the
+// component screenshots dir so output stays organised. Writes to
+// `screenshots/responsive/<breakpoint>-<scheme>.png` and returns an index.
+
+import { chromium } from 'playwright';
+import { mkdirSync } from 'fs';
+import { join } from 'path';
+
+const BREAKPOINTS = [
+  { slug: 'mobile', width: 375, height: 812 },
+  { slug: 'tablet', width: 768, height: 1024 },
+  { slug: 'desktop', width: 1280, height: 800 },
+  { slug: 'wide', width: 1920, height: 1080 },
+];
+
+async function captureAt(url, dir, bp, scheme, channel) {
+  const browser = await chromium.launch({ headless: true, ...(channel && { channel }) });
+  try {
+    const ctx = await browser.newContext({
+      viewport: { width: bp.width, height: bp.height },
+      deviceScaleFactor: bp.slug === 'mobile' ? 2 : 1,
+      colorScheme: scheme,
+    });
+    const page = await ctx.newPage();
+    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 30000 }).catch(() => {});
+    await page.waitForLoadState('networkidle').catch(() => {});
+    await page.evaluate(() => document.fonts.ready).catch(() => {});
+    const file = `${bp.slug}-${scheme}.png`;
+    const path = join(dir, file);
+    await page.screenshot({ path, fullPage: true });
+    return { breakpoint: bp.slug, scheme, width: bp.width, path: `screenshots/responsive/${file}` };
+  } finally {
+    await browser.close();
+  }
+}
+
+export async function captureResponsiveScreenshots(url, outDir, { includeDark = true, channel } = {}) {
+  const dir = join(outDir, 'screenshots', 'responsive');
+  mkdirSync(dir, { recursive: true });
+  const out = [];
+  const schemes = includeDark ? ['light', 'dark'] : ['light'];
+  for (const bp of BREAKPOINTS) {
+    for (const scheme of schemes) {
+      try {
+        const row = await captureAt(url, dir, bp, scheme, channel);
+        out.push(row);
+      } catch (e) {
+        out.push({ breakpoint: bp.slug, scheme, error: e.message });
+      }
+    }
+  }
+  return { count: out.filter(r => !r.error).length, shots: out };
+}

package/src/index.js

@@ -203,6 +203,8 @@ export { extractMaterialLanguage } from './extractors/material-language.js';
 export { extractImageryStyle } from './extractors/imagery-style.js';
 export { extractLogo } from './extractors/logo.js';
 export { captureComponentScreenshotsV10 } from './extractors/component-screenshots.js';
+export { pairDarkMode } from './extractors/dark-mode-pair.js';
+export { captureResponsiveScreenshots } from './extractors/responsive-screenshots.js';
 export { refineWithSmart } from './classifiers/smart.js';
 export { crawlCanonicalPages, computeCrossPageConsistency, discoverCanonicalPages } from './multipage.js';
 export { buildPromptPack, formatV0Prompt, formatLovablePrompt, formatCursorPrompt, formatClaudeArtifactPrompt } from './formatters/prompt-pack.js';