@mseep/dembrandt 0.19.5

package/dist/lib/discovery.js

@@ -0,0 +1,243 @@
+/**
+ * Page Discovery
+ *
+ * Discovers internal pages from a starting URL via DOM link extraction
+ * or sitemap.xml parsing.
+ */
+/**
+ * Score a URL path for importance (higher = more important).
+ * Prioritizes shallow, navigational paths over blog posts / legal pages.
+ */
+export function scoreUrl(pathname) {
+    const lc = pathname.toLowerCase();
+    // Exclude noise
+    const exclude = [
+        /\/(login|signin|sign-in|signup|sign-up|register|auth)/,
+        /\/(terms|privacy|legal|cookie|gdpr|tos)/,
+        /\/(cdn-cgi|wp-admin|wp-content|wp-json)/,
+        /\.(pdf|jpg|jpeg|png|gif|svg|webp|zip|tar|gz|mp4|mp3)$/,
+        /\/tag\//,
+        /\/author\//,
+        /\/page\/\d+/,
+        /\?/, // query strings (shouldn't appear here but safety)
+    ];
+    if (exclude.some(r => r.test(lc)))
+        return -1;
+    let score = 100;
+    // Prefer shallow paths
+    const depth = (pathname.match(/\//g) || []).length;
+    score -= depth * 10;
+    // Boost key navigational pages
+    const boosts = [
+        [/^\/(pricing|plans?|cost)/, 30],
+        [/^\/(about|company|team|story)/, 25],
+        [/^\/(product|features?|solutions?)/, 25],
+        [/^\/(enterprise|business|platform)/, 20],
+        [/^\/(contact|demo|trial|start)/, 20],
+        [/^\/(docs|documentation|developers?|api)/, 15],
+        [/^\/(blog|resources|insights|news)/, 10],
+    ];
+    for (const [re, boost] of boosts) {
+        if (re.test(lc)) {
+            score += boost;
+            break;
+        }
+    }
+    return score;
+}
+/**
+ * Discover internal links from an already-loaded Playwright page.
+ * Call after extractBranding() has loaded and scrolled the page.
+ *
+ * @param {import('playwright-core').Page} page
+ * @param {string} baseUrl - The starting URL (used to determine same-origin)
+ * @param {number} maxPages - Maximum number of URLs to return
+ * @returns {Promise<string[]>} Ordered list of URLs to crawl (excluding homepage)
+ */
+export async function discoverLinks(page, baseUrl, maxPages) {
+    const origin = new URL(baseUrl).origin;
+    const links = await page.evaluate((origin) => {
+        const results = [];
+        const navSelectors = [
+            'nav a', 'header a', 'footer a',
+            '[role="navigation"] a', '[aria-label*="nav"] a',
+            '[data-nav] a', '.nav a', '.navbar a', '.header a', '.menu a',
+        ];
+        // Score links by location: nav/header/footer = 2, elsewhere = 1
+        const scored = new Map(); // pathname → { href, locationScore }
+        function addLinks(selector, locationScore) {
+            document.querySelectorAll(selector).forEach(a => {
+                try {
+                    const url = new URL(a.href);
+                    if (url.origin !== origin)
+                        return;
+                    const pathname = url.pathname.replace(/\/$/, '') || '/';
+                    if (!scored.has(pathname) || scored.get(pathname).locationScore < locationScore) {
+                        scored.set(pathname, { href: url.origin + pathname, locationScore });
+                    }
+                }
+                catch { }
+            });
+        }
+        navSelectors.forEach(sel => addLinks(sel, 2));
+        addLinks('a[href]', 1);
+        scored.forEach(({ href, locationScore }, pathname) => {
+            results.push({ href, pathname, locationScore });
+        });
+        return results;
+    }, origin);
+    // Remove homepage itself
+    const homepagePath = new URL(baseUrl).pathname.replace(/\/$/, '') || '/';
+    const scored = links
+        .filter(l => l.pathname !== homepagePath)
+        .map(l => ({ ...l, score: scoreUrl(l.pathname) + (l.locationScore * 5) }))
+        .filter(l => l.score >= 0)
+        .sort((a, b) => b.score - a.score);
+    return scored.slice(0, maxPages).map(l => l.href);
+}
+const FETCH_OPTS = {
+    headers: { 'User-Agent': 'Mozilla/5.0 (compatible; Dembrandt/1.0)' },
+};
+/**
+ * Discover sitemap URLs by checking robots.txt first, then common paths.
+ * Returns the first sitemap XML that responds successfully.
+ */
+async function findSitemapUrls(origin) {
+    // 1. Check robots.txt for Sitemap: directives
+    try {
+        const res = await fetch(`${origin}/robots.txt`, {
+            ...FETCH_OPTS,
+            signal: AbortSignal.timeout(5000),
+        });
+        if (res.ok) {
+            const text = await res.text();
+            const sitemaps = [...text.matchAll(/^Sitemap:\s*(.+)$/gmi)]
+                .map(m => m[1].trim())
+                .filter(u => u.startsWith('http'));
+            if (sitemaps.length > 0)
+                return sitemaps;
+        }
+    }
+    catch { }
+    // 2. Fall back to common sitemap locations
+    return [
+        `${origin}/sitemap.xml`,
+        `${origin}/sitemap_index.xml`,
+        `${origin}/sitemap/sitemap-index.xml`,
+    ];
+}
+/**
+ * Fetch a single sitemap URL, returning its XML text or empty string.
+ */
+async function fetchSitemap(url) {
+    try {
+        const res = await fetch(url, {
+            ...FETCH_OPTS,
+            signal: AbortSignal.timeout(10000),
+        });
+        if (!res.ok)
+            return '';
+        const text = await res.text();
+        return text.includes('<') ? text : ''; // sanity check for XML
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Discover pages from a site's sitemap.xml.
+ * Checks robots.txt for Sitemap directives, then tries common paths.
+ * Follows sitemapindex references one level deep.
+ *
+ * @param {string} baseUrl - The starting URL (should be post-redirect)
+ * @param {number} maxPages - Maximum number of URLs to return
+ * @returns {Promise<string[]>} List of URLs from sitemap (excluding homepage)
+ */
+export async function parseSitemap(baseUrl, maxPages) {
+    const base = new URL(baseUrl);
+    // Find and fetch sitemap(s)
+    const candidates = await findSitemapUrls(base.origin);
+    let xml = '';
+    for (const candidate of candidates) {
+        xml = await fetchSitemap(candidate);
+        if (xml)
+            break;
+    }
+    if (!xml)
+        return [];
+    // Also accept www/non-www variants of the same domain
+    const acceptedHostnames = new Set([base.hostname]);
+    if (base.hostname.startsWith('www.')) {
+        acceptedHostnames.add(base.hostname.slice(4));
+    }
+    else {
+        acceptedHostnames.add('www.' + base.hostname);
+    }
+    // Expand sitemapindex references up to two levels deep
+    let allXml = xml;
+    if (xml.includes('<sitemapindex')) {
+        const extractLocs = (text) => [...text.matchAll(/<loc>\s*(https?:\/\/[^<]+)\s*<\/loc>/g)]
+            .map(m => m[1].trim())
+            .filter(u => { try {
+            return acceptedHostnames.has(new URL(u).hostname);
+        }
+        catch {
+            return false;
+        } });
+        const childUrls = extractLocs(xml).slice(0, 10);
+        const childXmls = await Promise.all(childUrls.map(u => fetchSitemap(u)));
+        // Check if children are also sitemapindex (e.g. Spotify's 3-level hierarchy)
+        const grandchildFetches = [];
+        const pageXmls = [];
+        for (const childXml of childXmls) {
+            if (!childXml)
+                continue;
+            if (childXml.includes('<sitemapindex')) {
+                const gcUrls = extractLocs(childXml).slice(0, 3);
+                grandchildFetches.push(...gcUrls.map(u => fetchSitemap(u)));
+            }
+            else {
+                pageXmls.push(childXml);
+            }
+        }
+        if (grandchildFetches.length > 0) {
+            const gcXmls = await Promise.all(grandchildFetches);
+            pageXmls.push(...gcXmls);
+        }
+        allXml = pageXmls.join('\n');
+    }
+    const homepagePath = base.pathname.replace(/\/$/, '') || '/';
+    const urls = [...allXml.matchAll(/<loc>\s*(https?:\/\/[^<]+)\s*<\/loc>/g)]
+        .map(m => m[1].trim())
+        .filter(u => {
+        try {
+            return acceptedHostnames.has(new URL(u).hostname);
+        }
+        catch {
+            return false;
+        }
+    })
+        .map(u => {
+        const p = new URL(u);
+        return p.origin + (p.pathname.replace(/\/$/, '') || '/');
+    });
+    // Deduplicate
+    const seen = new Set();
+    const deduped = [];
+    for (const u of urls) {
+        const path = new URL(u).pathname;
+        if (path === homepagePath)
+            continue;
+        if (seen.has(u))
+            continue;
+        seen.add(u);
+        deduped.push(u);
+    }
+    // Score and sort
+    const scored = deduped
+        .map(u => ({ href: u, score: scoreUrl(new URL(u).pathname) }))
+        .filter(l => l.score >= 0)
+        .sort((a, b) => b.score - a.score);
+    return scored.slice(0, maxPages).map(l => l.href);
+}
+//# sourceMappingURL=discovery.js.map

package/dist/lib/discovery.js.map

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

package/dist/lib/drift.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Drift engine — the product core.
+ *
+ * Compares two Dembrandt native extracts (a baseline and a candidate) and
+ * returns a drift report: a 0-100 score (0 = identical), a pass/fail verdict,
+ * and a list of what changed. Pure functions, no dependencies, no infra.
+ *
+ * Baseline-agnostic by design: it does not know or care whether the baseline is
+ * a rolling `main` snapshot or a pinned `ds-vN` release. The caller decides what
+ * to compare against. Two-baseline workflows just call this twice.
+ */
+import type { BrandingResult as ExtractionResult } from "./types.js";
+export interface DriftConfig {
+    /** ΔE at or below this: colors treated as identical. */
+    colorSame: number;
+    /** ΔE at or below this (and above colorSame): a color "shifted". Beyond: removed/added. */
+    colorShift: number;
+    /** Percent change at or below this: a dimension is unchanged. */
+    dimPct: number;
+    /** Percent change at or below this (and above dimPct): "shifted". Beyond: removed/added. */
+    dimShiftPct: number;
+    /** Relative weight of each category in the overall score. */
+    weights: {
+        color: number;
+        typography: number;
+        spacing: number;
+        radius: number;
+        shadow: number;
+    };
+    /** score > failThreshold => fail. */
+    failThreshold: number;
+}
+export declare const DEFAULT_DRIFT_CONFIG: DriftConfig;
+export type DriftKind = "changed" | "added" | "removed";
+export type DriftCategory = "color" | "typography" | "spacing" | "radius" | "shadow";
+export interface DriftChange {
+    category: DriftCategory;
+    kind: DriftKind;
+    label: string;
+    before?: string;
+    after?: string;
+    /** ΔE for colors, percent change for dimensions. */
+    delta?: number;
+}
+export interface CategoryResult {
+    category: DriftCategory;
+    score: number;
+    changed: number;
+    added: number;
+    removed: number;
+}
+export interface DriftReport {
+    score: number;
+    status: "stable" | "drift";
+    threshold: number;
+    summary: {
+        changed: number;
+        added: number;
+        removed: number;
+    };
+    categories: CategoryResult[];
+    changes: DriftChange[];
+}
+export declare function computeDrift(baseline: ExtractionResult, candidate: ExtractionResult, config?: Partial<DriftConfig>): DriftReport;