@mseep/dembrandt 0.19.5

package/dist/lib/normalize.js

@@ -0,0 +1,59 @@
+const TRANSIENT_KEYS = ['_discoveredLinks', '_extractedUrls', '_pageResults'];
+/**
+ * Remove internal crawl/merge fields that must never be persisted, even if a raw
+ * crawl object is fed in. Returns a shallow copy; the input is untouched.
+ */
+export function stripTransient(result) {
+    const clean = { ...result };
+    for (const key of TRANSIENT_KEYS)
+        delete clean[key];
+    return clean;
+}
+const toNumber = (v) => {
+    if (typeof v === 'number')
+        return Number.isFinite(v) ? v : undefined;
+    if (typeof v === 'string') {
+        const n = parseFloat(v);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    return undefined;
+};
+/**
+ * Canonicalize the loose unions to a single shape so the engine and UI never see
+ * variants. Conservative: only touches the documented offenders, leaves the rest
+ * untouched, and never throws. Run after stripTransient() at ingest.
+ *
+ *  - typography weight       : string | number  -> number
+ *  - spacing px              : number | string  -> number
+ *  - spacing display         : guaranteed "Npx" string (backfilled if absent)
+ *  - typography adobeFonts   : string[] | bool  -> string[]
+ *  - components inputs/badges : array | object  -> array
+ */
+export function normalizeExtraction(result) {
+    const out = stripTransient(result);
+    for (const s of out.typography?.styles ?? []) {
+        const w = toNumber(s.weight);
+        if (w !== undefined)
+            s.weight = w;
+    }
+    for (const v of out.spacing?.commonValues ?? []) {
+        const px = toNumber(v.px);
+        if (px !== undefined)
+            v.px = px;
+        if (v.display === undefined) {
+            v.display = px !== undefined ? `${px}px` : String(v.px);
+        }
+    }
+    if (out.typography?.sources && typeof out.typography.sources.adobeFonts === 'boolean') {
+        out.typography.sources.adobeFonts = [];
+    }
+    if (out.components) {
+        const c = out.components;
+        if (c.inputs && !Array.isArray(c.inputs))
+            c.inputs = c.inputs.text ?? [];
+        if (c.badges && !Array.isArray(c.badges))
+            c.badges = c.badges.all ?? [];
+    }
+    return out;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/lib/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../lib/normalize.ts"],"names":[],"mappings":"AAaA,MAAM,cAAc,GAAG,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,CAAU,CAAC;AAEvF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAA2B,MAAS;IAChE,MAAM,KAAK,GAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IACjC,KAAK,MAAM,GAAG,IAAI,cAAc;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;IACpD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,CAAU,EAAsB,EAAE;IAClD,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAA2B,MAAS;IACrE,MAAM,GAAG,GAAQ,cAAc,CAAC,MAAM,CAAC,CAAC;IAExC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,SAAS;YAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,EAAE,YAAY,IAAI,EAAE,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,KAAK,SAAS;YAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5B,CAAC,CAAC,OAAO,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,EAAE,OAAO,IAAI,OAAO,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACtF,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU,GAAG,EAAE,CAAC;IACzC,CAAC;IACD,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC;QACzB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACzE,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/robots.d.ts

@@ -0,0 +1,12 @@
+export type RobotsResult = {
+    status: "unavailable";
+    robotsUrl: string;
+} | {
+    status: "ok";
+    robotsUrl: string;
+    allowed: boolean;
+    rule: string | null;
+};
+export declare function checkRobotsTxt(targetUrl: string, { timeoutMs }?: {
+    timeoutMs?: number;
+}): Promise<RobotsResult>;

package/dist/lib/robots.js

@@ -0,0 +1,110 @@
+const UA = "Dembrandt";
+export async function checkRobotsTxt(targetUrl, { timeoutMs = 5000 } = {}) {
+    const u = new URL(targetUrl);
+    const robotsUrl = `${u.protocol}//${u.host}/robots.txt`;
+    const path = u.pathname || "/";
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let body;
+    try {
+        const res = await fetch(robotsUrl, {
+            signal: controller.signal,
+            headers: { "User-Agent": UA },
+        });
+        if (!res.ok)
+            return { status: "unavailable", robotsUrl };
+        body = await res.text();
+    }
+    catch {
+        return { status: "unavailable", robotsUrl };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    const groups = parseRobots(body);
+    const rules = matchGroup(groups, UA) || matchGroup(groups, "*") || [];
+    const decision = evaluate(rules, path);
+    return { status: "ok", robotsUrl, ...decision };
+}
+function parseRobots(text) {
+    const groups = [];
+    let current = null;
+    let lastWasAgent = false;
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.replace(/#.*$/, "").trim();
+        if (!line)
+            continue;
+        const idx = line.indexOf(":");
+        if (idx === -1)
+            continue;
+        const field = line.slice(0, idx).trim().toLowerCase();
+        const value = line.slice(idx + 1).trim();
+        if (field === "user-agent") {
+            if (!current || !lastWasAgent) {
+                current = { agents: [], rules: [] };
+                groups.push(current);
+            }
+            current.agents.push(value.toLowerCase());
+            lastWasAgent = true;
+        }
+        else if (field === "allow" || field === "disallow") {
+            if (!current) {
+                current = { agents: ["*"], rules: [] };
+                groups.push(current);
+            }
+            current.rules.push({ type: field, value });
+            lastWasAgent = false;
+        }
+    }
+    return groups;
+}
+function matchGroup(groups, agent) {
+    const wanted = agent.toLowerCase();
+    for (const g of groups) {
+        if (g.agents.includes(wanted))
+            return g.rules;
+    }
+    return null;
+}
+function evaluate(rules, path) {
+    let best = {
+        type: null,
+        length: -1,
+        value: "",
+    };
+    for (const r of rules) {
+        if (!r.value)
+            continue;
+        if (!pathMatches(path, r.value))
+            continue;
+        if (r.value.length > best.length)
+            best = { ...r, length: r.value.length };
+    }
+    if (best.type === "disallow")
+        return { allowed: false, rule: best.value };
+    return { allowed: true, rule: best.value || null };
+}
+function pathMatches(path, pattern) {
+    const anchored = pattern.endsWith("$");
+    const p = anchored ? pattern.slice(0, -1) : pattern;
+    const parts = p.split("*");
+    let i = 0;
+    for (let k = 0; k < parts.length; k++) {
+        const seg = parts[k];
+        if (k === 0) {
+            if (!path.startsWith(seg))
+                return false;
+            i = seg.length;
+        }
+        else {
+            const found = path.indexOf(seg, i);
+            if (found === -1)
+                return false;
+            i = found + seg.length;
+        }
+    }
+    if (anchored && i !== path.length)
+        return false;
+    return true;
+}
+//# sourceMappingURL=robots.js.map

package/dist/lib/robots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"robots.js","sourceRoot":"","sources":["../../lib/robots.ts"],"names":[],"mappings":"AAAA,MAAM,EAAE,GAAG,WAAW,CAAC;AAgBvB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,SAAiB,EACjB,EAAE,SAAS,GAAG,IAAI,KAA6B,EAAE;IAEjD,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,IAAI,aAAa,CAAC;IACxD,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;IAE/B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAE9D,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,SAAS,EAAE;YACjC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;QACzD,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;IACtE,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEvC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,QAAQ,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAuB,IAAI,CAAC;IACvC,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEzC,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC9B,OAAO,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YACzC,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;aAAM,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;YACrD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3C,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB,EAAE,KAAa;IACtD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACnC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAmB,EAAE,IAAY;IACjD,IAAI,IAAI,GAAyE;QAC/E,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,CAAC,CAAC;QACV,KAAK,EAAE,EAAE;KACV,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,KAAK;YAAE,SAAS;QACvB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;YAAE,SAAS;QAC1C,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;YAAE,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IAC5E,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;IAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAAe;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACpD,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC;YACxC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACnC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC/B,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/run-summary.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Builds the "what shaped this run" lines for the closing CLI summary (DEM-99):
+ * which flags were active and which paths were merged. Pure and importable so it
+ * is unit-tested without spawning the CLI; index.ts wraps the returned strings
+ * with chalk and prints them under the analysis summary.
+ */
+export interface RunOpts {
+    darkMode?: boolean;
+    mobile?: boolean;
+    slow?: boolean;
+    stealth?: boolean;
+    wcag?: boolean;
+    /** number of pages, or true for the bare flag, or null/undefined when unused */
+    crawl?: number | boolean | null;
+    sitemap?: boolean;
+    browser?: string;
+    /** commander sets false for --no-sandbox; true/undefined otherwise */
+    sandbox?: boolean;
+    rawColors?: boolean;
+    dtcg?: boolean;
+    saveOutput?: boolean;
+    /** --html [path]: undefined when absent, string or true when present */
+    html?: unknown;
+    compare?: unknown;
+    brandGuide?: boolean;
+    designMd?: boolean;
+    screenshot?: unknown;
+}
+/**
+ * The flags that changed the run, in a stable display order. Behaviour-only
+ * flags (--wcag, --dark-mode, ...) included so they leave a trace even though
+ * they write no file; artifact flags included too (their paths print separately).
+ */
+export declare function activeFlags(opts?: RunOpts): string[];
+/**
+ * Explicit paths and/or the merged-page count. Explicit paths are positional
+ * (not flags) so they would otherwise be invisible; --crawl/--sitemap have no
+ * explicit paths but still merge pages, reported by the count alone.
+ */
+export declare function pathSummary(paths: string[] | undefined, mergedPages?: number): string[];

package/dist/lib/run-summary.js

@@ -0,0 +1,64 @@
+/**
+ * Builds the "what shaped this run" lines for the closing CLI summary (DEM-99):
+ * which flags were active and which paths were merged. Pure and importable so it
+ * is unit-tested without spawning the CLI; index.ts wraps the returned strings
+ * with chalk and prints them under the analysis summary.
+ */
+/**
+ * The flags that changed the run, in a stable display order. Behaviour-only
+ * flags (--wcag, --dark-mode, ...) included so they leave a trace even though
+ * they write no file; artifact flags included too (their paths print separately).
+ */
+export function activeFlags(opts = {}) {
+    const bits = [];
+    if (opts.darkMode)
+        bits.push('--dark-mode');
+    if (opts.mobile)
+        bits.push('--mobile');
+    if (opts.slow)
+        bits.push('--slow');
+    if (opts.stealth)
+        bits.push('--stealth');
+    if (opts.wcag)
+        bits.push('--wcag');
+    if (opts.crawl != null && opts.crawl !== false) {
+        bits.push(opts.crawl === true ? '--crawl' : `--crawl ${opts.crawl}`);
+    }
+    if (opts.sitemap)
+        bits.push('--sitemap');
+    if (opts.browser && opts.browser !== 'chromium')
+        bits.push(`--browser ${opts.browser}`);
+    if (opts.sandbox === false)
+        bits.push('--no-sandbox');
+    if (opts.rawColors)
+        bits.push('--raw-colors');
+    if (opts.dtcg)
+        bits.push('--dtcg');
+    if (opts.saveOutput)
+        bits.push('--save-output');
+    if (opts.html !== undefined)
+        bits.push('--html');
+    if (opts.compare)
+        bits.push('--compare');
+    if (opts.brandGuide)
+        bits.push('--brand-guide');
+    if (opts.designMd)
+        bits.push('--design-md');
+    if (opts.screenshot)
+        bits.push('--screenshot');
+    return bits;
+}
+/**
+ * Explicit paths and/or the merged-page count. Explicit paths are positional
+ * (not flags) so they would otherwise be invisible; --crawl/--sitemap have no
+ * explicit paths but still merge pages, reported by the count alone.
+ */
+export function pathSummary(paths, mergedPages = 0) {
+    const bits = [];
+    if (paths && paths.length)
+        bits.push(...paths);
+    if (mergedPages > 1)
+        bits.push(`(${mergedPages} pages merged)`);
+    return bits;
+}
+//# sourceMappingURL=run-summary.js.map

package/dist/lib/run-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-summary.js","sourceRoot":"","sources":["../../lib/run-summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyBH;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAgB,EAAE;IAC5C,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,IAAI,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACxF,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9C,IAAI,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,IAAI,CAAC,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,QAAQ;QAAE,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,IAAI,CAAC,UAAU;QAAE,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAA2B,EAAE,WAAW,GAAG,CAAC;IACtE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC/C,IAAI,WAAW,GAAG,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,WAAW,gBAAgB,CAAC,CAAC;IAChE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/types.d.ts

@@ -0,0 +1,329 @@
+/**
+ * Shared types for dembrandt extraction output and CLI options.
+ * These were JSDoc @typedefs; promoted to real exported interfaces so the rest
+ * of the (now TypeScript) codebase can import and use them.
+ */
+export type Confidence = 'high' | 'medium' | 'low';
+export interface PaletteColor {
+    /** Original color string */
+    color: string;
+    /** Hex color (#rrggbb) */
+    normalized: string;
+    /** Number of occurrences */
+    count: number;
+    /** Semantic relevance score */
+    score?: number;
+    /** CSS class/id sources */
+    sources?: string[];
+    confidence: Confidence;
+}
+export interface Colors {
+    palette: PaletteColor[];
+    /** e.g. { primary: '#hex' } */
+    semantic: Record<string, string>;
+    /** CSS custom properties */
+    cssVariables: Record<string, string>;
+    rawColors?: PaletteColor[];
+}
+export interface TypographyStyle {
+    /** 'heading-1' | 'body' | 'button' | 'caption' | 'display' | 'link' */
+    context: string;
+    family: string;
+    fallbacks?: string[];
+    size: string;
+    weight: string | number;
+    lineHeight?: string;
+    letterSpacing?: string;
+    textTransform?: string;
+    isVariable?: boolean;
+    isFluid?: boolean;
+}
+export interface Typography {
+    styles: TypographyStyle[];
+    sources: {
+        googleFonts?: string[];
+        adobeFonts?: string[] | boolean;
+        variableFonts?: string[];
+        customFonts?: string[];
+        selfHostedFonts?: string[];
+        fontDisplay?: string;
+    };
+}
+export interface SpacingValue {
+    /**
+     * Numeric pixels for math and diffing. Raw extraction emits the "16px" string;
+     * normalizeExtraction() coerces it to a number. Read `display` for rendering.
+     */
+    px: number | string;
+    /** Guaranteed formatted value for display, e.g. "16px". Survives normalize. */
+    display: string;
+    rem?: string;
+    count?: number;
+    /** Numeric pixels as emitted by the extractor; mirror of px once normalized. */
+    numericValue?: number;
+}
+export interface Spacing {
+    /** 'base-4' | 'base-8' | 'fibonacci' | 'custom' */
+    scaleType: string;
+    commonValues: SpacingValue[];
+}
+export interface TokenValue {
+    value: string;
+    count: number;
+    confidence: Confidence;
+}
+export interface BorderRadius {
+    values: TokenValue[];
+}
+export interface BorderCombination {
+    width: string;
+    style: string;
+    color: string;
+    count?: number;
+    confidence?: Confidence;
+}
+export interface Borders {
+    widths?: TokenValue[];
+    styles?: TokenValue[];
+    colors?: TokenValue[];
+    combinations?: BorderCombination[];
+}
+export interface Shadow {
+    shadow: string;
+    count: number;
+    confidence: Confidence;
+}
+export interface Gradient {
+    gradient: string;
+    type: 'linear' | 'radial' | 'conic' | 'linear-repeating' | 'radial-repeating' | 'conic-repeating';
+    stopColors: string[];
+    count: number;
+}
+/** Computed CSS for one interaction state (rest/hover/active/focus). */
+export interface CssState {
+    backgroundColor?: string;
+    color?: string;
+    borderRadius?: string;
+    padding?: string;
+    border?: string;
+    boxShadow?: string;
+    textDecoration?: string;
+    [key: string]: string | undefined;
+}
+export interface ButtonStyle {
+    states: {
+        default: CssState;
+        hover?: CssState;
+        active?: CssState;
+        focus?: CssState;
+        [key: string]: CssState | undefined;
+    };
+    text?: string;
+    fontWeight?: string;
+    fontSize?: string;
+    classes?: string;
+}
+export interface LinkStyle {
+    states: {
+        default: CssState;
+        hover?: CssState;
+    };
+    fontWeight?: string;
+}
+export interface InputStyle {
+    type?: string;
+    border?: string;
+    borderRadius?: string;
+    padding?: string;
+    states?: {
+        default?: CssState;
+        focus?: CssState;
+    };
+}
+export interface BadgeStyle {
+    backgroundColor?: string;
+    color?: string;
+    borderRadius?: string;
+    padding?: string;
+    fontSize?: string;
+    isRounded?: boolean;
+    styleType?: string;
+}
+export interface Components {
+    buttons: ButtonStyle[];
+    inputs: {
+        text?: InputStyle[];
+    } | InputStyle[];
+    links: LinkStyle[];
+    badges: {
+        all?: BadgeStyle[];
+        byVariant?: Record<string, BadgeStyle[]>;
+    } | BadgeStyle[];
+}
+export interface Breakpoint {
+    px: number | string;
+}
+export interface IconSystem {
+    name: string;
+    type: string;
+    sizes?: string[];
+}
+export interface Framework {
+    name: string;
+    confidence: Confidence;
+    evidence?: string;
+}
+export interface Logo {
+    source: 'img' | 'svg';
+    url: string;
+    width?: number;
+    height?: number;
+    alt?: string;
+    inline?: boolean;
+    color?: string | null;
+    ariaLabel?: string | null;
+    markup?: string | null;
+    dataUri?: string | null;
+    safeZone?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    background?: string | null;
+}
+export interface Favicon {
+    type: string;
+    url: string;
+    sizes: string | null;
+}
+export interface WcagPair {
+    fg: string;
+    bg: string;
+    ratio: number;
+    aa: boolean;
+    aaLarge: boolean;
+    aaa: boolean;
+    count?: number;
+    state?: string;
+    tag?: string;
+    source?: string;
+}
+/** Metadata block on the native extraction output. */
+export interface ExtractionMeta {
+    /** Provenance: the CLI release that produced this. Doubles as source.cliVersion. */
+    dembrandtVersion?: string | null;
+    /**
+     * Output contract version. Required: the current producer always stamps it.
+     * Consumers key migrations off this (absent in a persisted blob = pre-1.0) and
+     * must NOT shape-sniff. Bumps on breaking shape changes.
+     */
+    schemaVersion: string;
+    flags?: Record<string, unknown>;
+    /**
+     * Categories that extracted incompletely. Engine rule: do NOT flag drift from a
+     * degraded category (it failed extraction, the brand did not change) — surface
+     * it in the UI instead.
+     */
+    degraded?: string[];
+}
+export interface BrandingResult {
+    url: string;
+    /** ISO 8601 timestamp */
+    extractedAt: string;
+    meta?: ExtractionMeta;
+    siteName?: string | null;
+    logo?: Logo | null;
+    logoInstances?: any[];
+    favicons?: Favicon[];
+    manifest?: any;
+    colors: Colors;
+    typography: Typography;
+    spacing: Spacing;
+    borderRadius: BorderRadius;
+    borders: Borders;
+    shadows: Shadow[];
+    gradients?: Gradient[];
+    motion?: any;
+    components: Components;
+    breakpoints: Breakpoint[];
+    iconSystem: IconSystem[];
+    frameworks: Framework[];
+    wcag?: WcagPair[];
+    pages?: {
+        url: string;
+    }[];
+    /**
+     * CLI-emitted note about the extraction itself (e.g. canvas-only sites). This is
+     * NOT a user annotation — a user note belongs in the storage envelope around the
+     * payload, never on the pristine BrandingResult, or it mutates the payload.
+     */
+    note?: string;
+    isCanvasOnly?: boolean;
+    /** Internal/transient fields used during crawl + merge. Never persist; see stripTransient(). */
+    _discoveredLinks?: any[];
+    _extractedUrls?: any[];
+    _pageResults?: any[];
+}
+/**
+ * Storage envelope around a pristine BrandingResult payload. Identity, time, and
+ * user-facing annotations live HERE, never on the payload — putting them on the
+ * payload would mutate the immutable extraction and break drift comparison.
+ *
+ * This type is reserved for the storage/UI layer (dembrandt-next, drift). The CLI
+ * does not produce it; it is defined in core so every consumer agrees on one
+ * envelope shape instead of forking it. Build the notes/labels feature against
+ * `note`/`label` here — not against BrandingResult.note (which is CLI metadata).
+ */
+export interface Snapshot {
+    id: string;
+    /** Which tracked surface (page/route/brand) this capture belongs to. */
+    surfaceId: string;
+    /** Owns identity + time, separate from payload.extractedAt. */
+    capturedAt: string;
+    /** The untouched extraction. */
+    payload: BrandingResult;
+    /** Optional human label for the capture. */
+    label?: string;
+    /** The customer's own note about this capture. NOT payload.note. */
+    note?: string;
+}
+/**
+ * Minimal spinner contract extractBranding() needs. A real ora `Ora` satisfies
+ * it structurally, as does the MCP null-spinner stub — so we don't pull ora's
+ * full type just to accept a progress reporter.
+ */
+export interface Spinner {
+    text?: string;
+    start(text?: string): Spinner;
+    stop(): Spinner;
+    succeed(text?: string): Spinner;
+    fail(text?: string): Spinner;
+    warn(text?: string): Spinner;
+    info(text?: string): Spinner;
+}
+/** CLI / programmatic options accepted by extractBranding(). */
+export interface ExtractOptions {
+    slow?: boolean;
+    darkMode?: boolean;
+    mobile?: boolean;
+    stealth?: boolean;
+    wcag?: boolean;
+    keepAnimations?: boolean;
+    verbose?: boolean;
+    navigationTimeout?: number;
+    screenshotPath?: string;
+    discoverLinks?: number | null;
+    includeRawColors?: boolean;
+    userAgent?: string;
+    locale?: string;
+    timezoneId?: string;
+    acceptLanguage?: string;
+    screenSize?: string;
+    cookie?: string;
+    header?: string;
+    /** Internal: collect raw :root tokens + interactive-state styles to a sidecar. */
+    teach?: boolean;
+    /** Injected CLI version, surfaced as meta.dembrandtVersion. */
+    _version?: string;
+}

package/dist/lib/types.js

@@ -0,0 +1,7 @@
+/**
+ * Shared types for dembrandt extraction output and CLI options.
+ * These were JSDoc @typedefs; promoted to real exported interfaces so the rest
+ * of the (now TypeScript) codebase can import and use them.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../lib/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}