@wrenautomation/read 0.41.0 → 0.43.0

package/README.md

@@ -3,10 +3,11 @@
 The web and files in, text out. No database, no accounts, no business rules: a library that
 fetches and reads. Until 0.29.0 this was falcon (files, markup, media) and the fetch and video
 halves of weaver; the research engine on top is [`@wrenautomation/birdwatch`](https://github.com/wrenautomation/engine/tree/main/packages/birdwatch),
-whose `birdwatch` CLI carries these readers (`fetch`, `read`, `list`, `text`, `page`, `watch`).
+whose `birdwatch` CLI carries these readers (`fetch`, `read`, `list`, `text`, `page`, `watch`, `brand`).
 
 | Import | Does |
 |---|---|
+| `@wrenautomation/read/brand` | `brandOf` a site: logo (`svg` inline, `img`, `icon`, `og`), palette (`primary`, `accent`, `background`, `text` as `#rrggbb`), fonts (`heading`, `body`), a 0 to 1 confidence each, and `from` (what was read). The page and up to 8 stylesheets by plain HTTP first; when that is `thin` and a `LadderClient` is given, a browser's computed styles (`web GET /brand`, shape `BrandProbe`), else the ladder's render rung's HTML. No model |
 | `@wrenautomation/read/fetch` | `PoliteFetcher` (one request at a time per host, a contact in the User-Agent, retries on 429 and 5xx, a byte cap), `robots` in warn mode, `fetchLadder` (plain GET up to a browser through a `LadderClient`: autobrowse's `web GET /fetch`) |
 | `@wrenautomation/read/text` | `htmlText`, `pdfText`, `decodeHtml`, `decodeEntities`; `readPage` (HTML to title, text, links, mailtos, tels) |
 | `@wrenautomation/read/video` | `watchFile` a video file: ffmpeg cuts and frames, an ear for the speech (`cohereSpeech`), an eye for the frames (`cohereEye`), and a video model's read of the whole file when given (`geminiVideo`, or `geminiReader` with no key check, for a proxy that holds the keys); shot labels. Over a URL: `readYoutube` (captions and chapters by yt-dlp; with an `ear`, a caption 429 rests captions 30 min and the ear hears the uploader's own audio track in 60 s clips; plus a video model's read of the screen in clips), `readYoutubeByUrl` (the video model alone, no download), `readVideo` (any other video: a `MediaStore` copy, else a direct file link such as Instagram Graph's `media_url`, else yt-dlp; then `watchFile`; `mediaKey` names a video `<platform>/<id>` and `dirStore` keeps them in a folder), `readAudio` (a podcast by its audio URL, then `hearAudio`), `watch` over a URL or a file, `flatPlaylist` (what a profile, channel or search holds), `download`. Every reader returns the one `VideoRead` shape |

package/dist/brand/brand.d.ts

@@ -0,0 +1,69 @@
+/**
+ * A site's brand: logo, palette and fonts (WA-1094; the shape follows ScrapeGraphAI's `branding`).
+ * Static first: the page and its stylesheets by plain HTTP. Thin (`thin`) and a ladder at hand: a
+ * browser's computed styles (`web GET /brand`); that route absent, the ladder's render rung's HTML.
+ * No model. Decision log: wren designs/2026-10-26-research-engine.md, 11-05 brand.
+ */
+import type { Fetcher } from "../fetch/fetcher.js";
+import { type LadderClient } from "../fetch/ladder.js";
+import { type Scored } from "./score.js";
+import { type Votes } from "./votes.js";
+/** `static`: plain HTTP; `ladder`: the page came up the ladder; `render`: a rendered page's HTML; `browser`: computed styles. */
+export type BrandSource = "static" | "ladder" | "render" | "browser";
+export interface Brand extends Scored {
+    /** The page read, after redirects. */
+    url: string;
+    from: BrandSource[];
+    /** Stylesheets read. */
+    sheets: number;
+}
+/**
+ * What `web GET /brand` answers: one page's computed styles in a browser, light scheme.
+ * Colours as the browser gives them (`rgb(…)`); fonts as `font-family` lists.
+ */
+export interface BrandProbe {
+    finalUrl: string;
+    status: number | null;
+    /** null: a usable page; else the block the browser still met. */
+    block: string | null;
+    themeColor: string | null;
+    body: {
+        background: string;
+        color: string;
+        font: string;
+    };
+    /** Visible h1 and h2, first 6. */
+    headings: {
+        font: string;
+        color: string;
+    }[];
+    /** Visible buttons and button-like links with a fill, first 20; `area` in px². */
+    buttons: {
+        background: string;
+        color: string;
+        area: number;
+    }[];
+    /** Visible links' text colours, first 30. */
+    links: {
+        color: string;
+    }[];
+    /** Images and SVGs named logo or brand, or in the home link; `svg` is the markup. */
+    logos: {
+        src: string | null;
+        svg: string | null;
+        named: boolean;
+        top: boolean;
+        area: number;
+    }[];
+}
+export interface BrandDeps {
+    fetcher: Fetcher;
+    /** autobrowse's site client: the ladder and `web GET /brand`. Absent: static only. */
+    sites?: LadderClient | undefined;
+    /** Stylesheets to read, `@import`s included. Default 8. */
+    sheets?: number | undefined;
+}
+/** Computed styles as votes: what a person sees, so they outweigh the CSS. */
+export declare function voteProbe(p: BrandProbe, v: Votes): void;
+/** One site's brand. Never throws: a page that cannot be read gives an empty brand. */
+export declare function brandOf(url: string, d: BrandDeps): Promise<Brand>;

package/dist/brand/brand.js

@@ -0,0 +1,127 @@
+import { fetchLadder } from "../fetch/ladder.js";
+import { readPage } from "./page.js";
+import { score, thin } from "./score.js";
+import { importsOf, parseSheet, varsOf, voteSheet, voteVars } from "./sheet.js";
+import { abs, apart, chromatic, fontOf, hexOf, votesOf } from "./votes.js";
+const SHEET_MAX = 2_000_000;
+/** Votes from a page and its stylesheets; `cache` keeps sheets across passes. */
+async function readStatic(html, url, d, cache) {
+    const v = votesOf();
+    const page = readPage(html, url, v);
+    const cap = d.sheets ?? 8;
+    const get = (href) => d.fetcher
+        .get(href)
+        .then((r) => (r.status < 400 ? r.text.slice(0, SHEET_MAX) : null))
+        .catch(() => null);
+    const fetchAll = async (hrefs) => {
+        const fresh = hrefs.filter((h) => !cache.has(h)).slice(0, Math.max(0, cap - cache.size));
+        const got = await Promise.all(fresh.map(get));
+        for (const [i, h] of fresh.entries())
+            cache.set(h, got[i] ?? null);
+    };
+    await fetchAll(page.sheets);
+    const roots = [...page.sheets, ...page.css].flatMap((s, i) => {
+        const text = i < page.sheets.length ? cache.get(s) : s;
+        const root = text ? parseSheet(text) : null;
+        return root ? [{ root, href: i < page.sheets.length ? s : url }] : [];
+    });
+    const imports = roots.flatMap(({ root, href }) => importsOf(root).flatMap((i) => abs(i, href) ?? []));
+    if (imports.length) {
+        await fetchAll(imports);
+        for (const h of imports) {
+            const root = cache.get(h) ? parseSheet(cache.get(h)) : null;
+            if (root)
+                roots.push({ root, href: h });
+        }
+    }
+    const trees = roots.map((r) => r.root);
+    const vars = varsOf(trees);
+    voteVars(vars, v);
+    for (const t of trees)
+        voteSheet(t, vars, v);
+    return v;
+}
+/** Computed styles as votes: what a person sees, so they outweigh the CSS. */
+export function voteProbe(p, v) {
+    const bg = hexOf(p.body.background);
+    const ink = hexOf(p.body.color);
+    if (bg)
+        v.colors.push({ role: "background", hex: bg, w: 0.9 });
+    if (ink)
+        v.colors.push({ role: "text", hex: ink, w: 0.9 });
+    const body = fontOf(p.body.font);
+    if (body)
+        v.fonts.push({ role: "body", family: body, w: 0.9 });
+    for (const h of p.headings) {
+        const family = fontOf(h.font);
+        if (family)
+            v.fonts.push({ role: "heading", family, w: 0.85 / p.headings.length });
+    }
+    const theme = p.themeColor ? hexOf(p.themeColor) : null;
+    if (theme && chromatic(theme))
+        v.colors.push({ role: "primary", hex: theme, w: 0.4 });
+    const filled = p.buttons.flatMap((b) => {
+        const hex = hexOf(b.background);
+        return hex && (!bg || apart(hex, bg)) ? [{ hex, area: Math.max(1, b.area) }] : [];
+    });
+    const area = filled.reduce((s, b) => s + b.area, 0);
+    for (const b of filled)
+        v.colors.push({ role: "primary", hex: b.hex, w: (0.8 * b.area) / area });
+    const links = p.links.flatMap((l) => {
+        const hex = hexOf(l.color);
+        return hex && chromatic(hex) ? [hex] : [];
+    });
+    for (const hex of links)
+        v.colors.push({ role: "accent", hex, w: 0.5 / links.length });
+    for (const l of p.logos) {
+        const url = l.svg
+            ? `data:image/svg+xml;base64,${Buffer.from(l.svg).toString("base64")}`
+            : abs(l.src ?? undefined, p.finalUrl);
+        const w = l.named && l.top ? 0.97 : l.named ? 0.8 : l.top ? 0.65 : 0;
+        if (url && w)
+            v.logos.push({ url, kind: l.svg ? "svg" : "img", w });
+    }
+}
+/** One site's brand. Never throws: a page that cannot be read gives an empty brand. */
+export async function brandOf(url, d) {
+    const from = [];
+    const cache = new Map();
+    let at = url;
+    let html = null;
+    const page = await d.fetcher.get(url).catch(() => null);
+    if (page && page.status < 400) {
+        html = page.text;
+        at = page.url;
+        from.push("static");
+    }
+    else if (d.sites) {
+        const l = await fetchLadder(d.sites, url, "impersonate");
+        if ("fetched" in l && !l.fetched.block) {
+            html = l.fetched.html;
+            at = l.fetched.finalUrl;
+            from.push("ladder");
+        }
+    }
+    let v = html ? await readStatic(html, at, d, cache) : votesOf();
+    let s = score(v);
+    if (thin(s) && d.sites) {
+        const probe = await d.sites.call("web", "GET", "/brand", { url }).catch(() => null);
+        if (probe && !probe.block) {
+            voteProbe(probe, v);
+            at = probe.finalUrl;
+            from.push("browser");
+        }
+        else {
+            const l = await fetchLadder(d.sites, url, "render");
+            if ("fetched" in l && !l.fetched.block) {
+                // the rendered DOM holds the static page and what scripts added
+                v = await readStatic(l.fetched.html, l.fetched.finalUrl, d, cache);
+                at = l.fetched.finalUrl;
+                from.push("render");
+            }
+        }
+        s = score(v);
+    }
+    return { ...s, url: at, from, sheets: [...cache.values()].filter((t) => t !== null).length };
+}
+//# sourceMappingURL=brand.js.map

package/dist/brand/brand.js.map

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

package/dist/brand/index.d.ts

@@ -0,0 +1,5 @@
+/** A site's brand: logo, palette and fonts, from its CSS first and a browser when that is thin. */
+export * from "./brand.js";
+export type { Scored } from "./score.js";
+export { thin } from "./score.js";
+export type { ColorRole, FontRole, LogoKind } from "./votes.js";

package/dist/brand/index.js

@@ -0,0 +1,4 @@
+/** A site's brand: logo, palette and fonts, from its CSS first and a browser when that is thin. */
+export * from "./brand.js";
+export { thin } from "./score.js";
+//# sourceMappingURL=index.js.map

package/dist/brand/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/brand/index.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/dist/brand/page.d.ts

@@ -0,0 +1,9 @@
+import { type Votes } from "./votes.js";
+export interface PageRead {
+    /** Stylesheet URLs, in page order. */
+    sheets: string[];
+    /** `<style>` blocks and inline styles as rules. */
+    css: string[];
+}
+/** Read one page into `v`; returns the CSS to read next. */
+export declare function readPage(html: string, url: string, v: Votes): PageRead;

package/dist/brand/page.js

@@ -0,0 +1,162 @@
+/**
+ * Brand votes from a page's HTML (htmlparser2, one pass): the logo (an image or inline SVG in the
+ * header or the home link, by its name), favicons, the theme colour, Google Fonts, and the CSS to
+ * read next (`<link rel=stylesheet>`, `<style>`, inline styles of body and buttons).
+ */
+import { Parser } from "htmlparser2";
+import { abs, chromatic, hexOf } from "./votes.js";
+const TOP = /(^|[\s_-])(header|masthead|navbar|topbar|site-header|nav)([\s_-]|$)/i;
+const LOGO = /logo|brand/i;
+const SVG_MAX = 60_000;
+const FONT_HOSTS = /fonts\.googleapis\.com|use\.typekit\.net|fonts\.bunny\.net/;
+/** Families a Google Fonts or Bunny link loads: `family=Inter:wght@400|Playfair+Display`. */
+function familiesOf(href) {
+    try {
+        const u = new URL(href);
+        return u.searchParams
+            .getAll("family")
+            .flatMap((f) => f.split("|"))
+            .map((f) => f.split(":")[0]?.replace(/\+/g, " ").trim() ?? "")
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+const homeOf = (href, base) => {
+    const u = abs(href, base);
+    if (!u)
+        return false;
+    const a = new URL(u);
+    return a.host === new URL(base).host && (a.pathname === "/" || a.pathname === "");
+};
+/** Read one page into `v`; returns the CSS to read next. */
+export function readPage(html, url, v) {
+    let base = url;
+    const sheets = [];
+    const css = [];
+    const stack = [];
+    let top = 0;
+    let home = 0;
+    let style = null;
+    let svg = null;
+    let svgDepth = 0;
+    const parser = new Parser({
+        onopentag(name, a) {
+            const hint = `${a.class ?? ""} ${a.id ?? ""} ${a.role ?? ""}`;
+            const isTop = name === "header" || name === "nav" || TOP.test(hint);
+            const isHome = name === "a" && homeOf(a.href, base);
+            stack.push({ name, top: isTop, home: isHome });
+            if (isTop)
+                top++;
+            if (isHome)
+                home++;
+            if (name === "base" && a.href)
+                base = abs(a.href, url) ?? base;
+            if (name === "style")
+                style = [];
+            if (name === "svg") {
+                svgDepth++;
+                const named = LOGO.test(`${hint} ${a["aria-label"] ?? ""}`);
+                const w = named && (top || home) ? 0.9 : named ? 0.75 : home && top ? 0.7 : 0;
+                if (svgDepth === 1 && w)
+                    svg = { start: parser.startIndex, depth: 1, w };
+            }
+            if (name === "img") {
+                const src = abs(a.src ?? a["data-src"] ?? a.srcset?.split(/\s+/)[0], base);
+                if (!src || /^data:image\/gif/.test(src))
+                    return;
+                const named = LOGO.test(`${hint} ${a.alt ?? ""} ${src.split("?")[0]}`);
+                const w = named && (top || home) ? 0.95 : named ? 0.7 : home && top ? 0.6 : 0;
+                if (w)
+                    v.logos.push({ url: src, kind: "img", w });
+            }
+            if (name === "link") {
+                const rel = (a.rel ?? "").toLowerCase().split(/\s+/);
+                const href = abs(a.href, base);
+                if (!href)
+                    return;
+                if (FONT_HOSTS.test(href)) {
+                    for (const family of familiesOf(href))
+                        v.fonts.push({ role: "any", family, w: 0.4 });
+                    return;
+                }
+                const sheet = rel.includes("stylesheet") || (rel.includes("preload") && a.as === "style");
+                if (sheet && !/print/.test(a.media ?? ""))
+                    sheets.push(href);
+                if (rel.includes("apple-touch-icon"))
+                    v.logos.push({ url: href, kind: "icon", w: 0.35 });
+                else if (rel.includes("icon") || rel.includes("mask-icon"))
+                    v.logos.push({
+                        url: href,
+                        kind: "icon",
+                        w: a.type === "image/svg+xml" || /\.svg($|\?)/.test(href) ? 0.4 : 0.25,
+                    });
+                const mask = rel.includes("mask-icon") && a.color ? hexOf(a.color) : null;
+                if (mask && chromatic(mask))
+                    v.colors.push({ role: "primary", hex: mask, w: 0.4 });
+            }
+            if (name === "meta") {
+                const key = (a.name ?? a.property ?? "").toLowerCase();
+                if (key === "theme-color" && !a.media?.includes("dark")) {
+                    const hex = a.content ? hexOf(a.content) : null;
+                    if (hex && chromatic(hex))
+                        v.colors.push({ role: "primary", hex, w: 0.5 });
+                    else if (hex)
+                        v.colors.push({ role: "background", hex, w: 0.3 });
+                }
+                if (key === "og:image") {
+                    const img = abs(a.content, base);
+                    if (img)
+                        v.logos.push({ url: img, kind: "og", w: 0.1 });
+                }
+            }
+            if (a.style && (name === "body" || name === "html"))
+                css.push(`body{${a.style}}`);
+            else if (a.style && (name === "button" || /\b(btn|button|cta)\b/i.test(hint)))
+                css.push(`.btn{${a.style}}`);
+        },
+        ontext(text) {
+            if (style)
+                style.push(text);
+        },
+        onclosetag(name) {
+            if (name === "style" && style) {
+                css.push(style.join(""));
+                style = null;
+            }
+            if (name === "svg") {
+                if (svg && svgDepth === 1) {
+                    const markup = html.slice(svg.start, parser.endIndex + 1);
+                    if (markup.length > 80 && markup.length < SVG_MAX)
+                        v.logos.push({
+                            url: `data:image/svg+xml;base64,${Buffer.from(markup).toString("base64")}`,
+                            kind: "svg",
+                            w: svg.w,
+                        });
+                    svg = null;
+                }
+                svgDepth = Math.max(0, svgDepth - 1);
+            }
+            // implied closes: pop to the tag that closed
+            const at = stack.map((s) => s.name).lastIndexOf(name);
+            if (at < 0)
+                return;
+            for (const s of stack.splice(at)) {
+                if (s.top)
+                    top--;
+                if (s.home)
+                    home--;
+            }
+        },
+    }, { decodeEntities: true, lowerCaseAttributeNames: true });
+    try {
+        parser.write(html);
+        parser.end();
+    }
+    catch {
+        // a broken page keeps what was read
+    }
+    return { sheets, css };
+}
+//# sourceMappingURL=page.js.map

package/dist/brand/page.js.map

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

package/dist/brand/score.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Votes to a brand. Per role, the value with the most weight wins. Confidence is how much evidence
+ * the winner has (capped at 1) times its share of its role. Primary and accent must have hue and
+ * differ; with no role votes they fall back to the most used hued colours.
+ */
+import { type LogoKind, type Votes } from "./votes.js";
+export interface Scored {
+    logo: {
+        url: string;
+        kind: LogoKind;
+    } | null;
+    palette: {
+        primary: string | null;
+        accent: string | null;
+        background: string | null;
+        text: string | null;
+    };
+    fonts: {
+        heading: string | null;
+        body: string | null;
+    };
+    /** 0 to 1 each. */
+    confidence: {
+        logo: number;
+        palette: number;
+        fonts: number;
+    };
+}
+export declare function score(v: Votes): Scored;
+/** Thin: worth a browser. No logo or a weak one, no hued primary, or no body font. */
+export declare const thin: (s: Scored) => boolean;

package/dist/brand/score.js

@@ -0,0 +1,63 @@
+/**
+ * Votes to a brand. Per role, the value with the most weight wins. Confidence is how much evidence
+ * the winner has (capped at 1) times its share of its role. Primary and accent must have hue and
+ * differ; with no role votes they fall back to the most used hued colours.
+ */
+import { apart, chromatic, } from "./votes.js";
+function rank(items, key) {
+    const sums = new Map();
+    let total = 0;
+    for (const t of items) {
+        const k = key(t);
+        sums.set(k, (sums.get(k) ?? 0) + t.w);
+        total += t.w;
+    }
+    return [...sums]
+        .map(([value, w]) => ({ value, w, conf: Math.min(1, w) * (total ? w / total : 0) }))
+        .sort((a, b) => b.w - a.w);
+}
+const colors = (v, role) => rank(v.colors.filter((c) => c.role === role), (c) => c.hex);
+const fonts = (v, role) => rank(v.fonts.filter((f) => f.role === role), (f) => f.family.toLowerCase());
+/** Shown names keep the page's casing: the first spelling seen. */
+const spelled = (v, lower) => lower ? (v.fonts.find((f) => f.family.toLowerCase() === lower)?.family ?? lower) : null;
+const round = (n) => Math.round(n * 100) / 100;
+export function score(v) {
+    const background = colors(v, "background")[0] ?? null;
+    // an unset page background is the browser's white
+    const ground = background?.value ?? "#ffffff";
+    const text = colors(v, "text").find((c) => apart(c.value, ground)) ?? null;
+    // counted colours: a weak fallback, so their confidence is cut
+    const hued = colors(v, "any")
+        .filter((c) => chromatic(c.value))
+        .map((c) => ({ ...c, conf: c.conf * 0.5 }));
+    const ok = (c) => apart(c.value, ground);
+    const primary = [...colors(v, "primary"), ...hued].find(ok) ?? null;
+    const notPrimary = (c) => ok(c) && (!primary || apart(c.value, primary.value));
+    const accent = [...colors(v, "accent"), ...colors(v, "primary"), ...hued]
+        .filter(chromaticOf)
+        .find(notPrimary) ?? null;
+    const body = fonts(v, "body")[0] ?? fonts(v, "any")[0] ?? null;
+    const heading = fonts(v, "heading")[0] ?? body;
+    const logo = [...v.logos].sort((a, b) => b.w - a.w || kindRank(a.kind) - kindRank(b.kind))[0] ?? null;
+    const conf = (c) => c?.conf ?? 0;
+    return {
+        logo: logo ? { url: logo.url, kind: logo.kind } : null,
+        palette: {
+            primary: primary?.value ?? null,
+            accent: accent?.value ?? null,
+            background: background?.value ?? null,
+            text: text?.value ?? null,
+        },
+        fonts: { heading: spelled(v, heading?.value), body: spelled(v, body?.value) },
+        confidence: {
+            logo: round(logo?.w ?? 0),
+            palette: round(0.6 * conf(primary) + 0.15 * conf(background) + 0.15 * conf(text) + 0.1 * conf(accent)),
+            fonts: round(0.6 * conf(body) + 0.4 * conf(heading)),
+        },
+    };
+}
+const chromaticOf = (c) => chromatic(c.value);
+const kindRank = (k) => ["svg", "img", "icon", "og"].indexOf(k);
+/** Thin: worth a browser. No logo or a weak one, no hued primary, or no body font. */
+export const thin = (s) => s.confidence.logo < 0.5 || !s.palette.primary || s.confidence.palette < 0.3 || !s.fonts.body;
+//# sourceMappingURL=score.js.map

package/dist/brand/score.js.map

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

package/dist/brand/sheet.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Brand votes from CSS (postcss): custom properties on the root by name (`--primary`, `--font-heading`),
+ * then body, headings, buttons and links by selector, then every colour and family by count.
+ * Dark-mode and print rules are skipped: the page as most first see it.
+ */
+import { type Root } from "postcss";
+import { type Votes } from "./votes.js";
+/** One stylesheet's tree; a sheet postcss cannot read gives none. */
+export declare function parseSheet(css: string): Root | null;
+/** `@import` targets of a sheet, for one more level of fetches. */
+export declare function importsOf(root: Root): string[];
+/** Root custom properties across every sheet; the first one set wins, as on a light page. */
+export declare function varsOf(roots: readonly Root[]): Map<string, string>;
+/** `var()` filled from the root, five levels deep. */
+export declare function resolve(value: string, vars: ReadonlyMap<string, string>): string;
+/** Votes from the root's custom properties, by their names. */
+export declare function voteVars(vars: ReadonlyMap<string, string>, v: Votes): void;
+/** Votes from one sheet's rules, `var()` filled. `@font-face` families count as chosen fonts. */
+export declare function voteSheet(root: Root, vars: ReadonlyMap<string, string>, v: Votes): void;

package/dist/brand/sheet.js

@@ -0,0 +1,158 @@
+/**
+ * Brand votes from CSS (postcss): custom properties on the root by name (`--primary`, `--font-heading`),
+ * then body, headings, buttons and links by selector, then every colour and family by count.
+ * Dark-mode and print rules are skipped: the page as most first see it.
+ */
+import postcss, {} from "postcss";
+import { chromatic, colorsIn, fontOf, hexOf } from "./votes.js";
+const ROOT = /^(:root|html|body|:host|\[data-theme=["']?light["']?\]|\.light)$/;
+const BODY = /^(html|body|:root)$/;
+const HEAD = /(^|\s)(h1|h2|h3|\.h1|\.h2|\.heading|\.display|\.title)([.:[\s]|$)/;
+const BUTTON = /(^|[\s.#[_-])(btn|button|cta)([\s.:[#_-]|$)/;
+const BUTTON_NOT = /:hover|:focus|:active|:disabled|disabled|outline|secondary|ghost|link|close|toggle|light|white|dark|transparent|text|components-|wp-admin|admin-bar/;
+const LINK = /^a(:link|:visited)?$/;
+const DARK = /prefers-color-scheme:\s*dark|print/;
+const DARK_SEL = /\.dark\b|data-theme=["']?dark|\.theme-dark|data-bs-theme=["']?dark/;
+/** One stylesheet's tree; a sheet postcss cannot read gives none. */
+export function parseSheet(css) {
+    try {
+        return postcss.parse(css);
+    }
+    catch {
+        return null;
+    }
+}
+/** `@import` targets of a sheet, for one more level of fetches. */
+export function importsOf(root) {
+    const out = [];
+    root.walkAtRules("import", (a) => {
+        const m = a.params.match(/url\(\s*["']?([^"')]+)|^["']([^"']+)/);
+        const href = m?.[1] ?? m?.[2];
+        if (href && !/print/.test(a.params))
+            out.push(href);
+    });
+    return out;
+}
+const hidden = (node) => {
+    for (let p = node.parent; p; p = p.parent) {
+        if (p.type === "atrule" && DARK.test(p.params))
+            return true;
+        if (p.type === "rule" && DARK_SEL.test(p.selector))
+            return true;
+    }
+    return false;
+};
+const selectorsOf = (node) => node.parent?.type === "rule"
+    ? node.parent.selector
+        .toLowerCase()
+        .split(",")
+        .map((s) => s.trim())
+    : [];
+/** Root custom properties across every sheet; the first one set wins, as on a light page. */
+export function varsOf(roots) {
+    const vars = new Map();
+    for (const root of roots)
+        root.walkDecls(/^--/, (d) => {
+            if (hidden(d) || vars.has(d.prop))
+                return;
+            if (selectorsOf(d).some((s) => ROOT.test(s)))
+                vars.set(d.prop, d.value.trim());
+        });
+    return vars;
+}
+const VAR = /var\(\s*(--[\w-]+)\s*(?:,\s*((?:[^()]|\([^()]*\))*))?\)/g;
+/** `var()` filled from the root, five levels deep. */
+export function resolve(value, vars) {
+    let out = value;
+    for (let i = 0; i < 5 && out.includes("var("); i++)
+        out = out.replace(VAR, (_, name, fallback) => vars.get(name) ?? fallback ?? "");
+    return out;
+}
+/** A custom property's colour: a colour, or bare HSL channels as shadcn sets (`221 83% 53%`). */
+const varColor = (v) => hexOf(v) ?? (/^[\d.]+(deg)?\s+[\d.]+%\s+[\d.]+%$/.test(v) ? hexOf(`hsl(${v})`) : null);
+/** Palette names only under a bare name or a theme's own prefix: design systems name hundreds of roles. */
+const NS = "(?:(?:color|colors|clr|c|bs|theme|site|global|brand|wp--preset--color-|chakra-colors|mantine-color|md-sys-color|ifm-color)-)?";
+const VAR_ROLES = [
+    [new RegExp(`^--${NS}(primary|brand|main)(-color)?$`), "primary", 0.6],
+    [new RegExp(`^--${NS}(accent|secondary)(-color)?$`), "accent", 0.45],
+    [new RegExp(`^--${NS}(background|bg|body-bg|page-bg)(-color)?$`), "background", 0.5],
+    [new RegExp(`^--${NS}(foreground|text|body-color|fg|ink)(-color)?$`), "text", 0.5],
+];
+const FONT_VARS = [
+    [
+        /^--([\w-]*-)?font-?(heading|display|title|headings)$|^--([\w-]*-)?(heading|display)-font$/,
+        "heading",
+    ],
+    [/^--([\w-]*-)?font-?(sans|body|base|text|primary)$|^--([\w-]*-)?(body|base)-font$/, "body"],
+];
+/** Votes from the root's custom properties, by their names. */
+export function voteVars(vars, v) {
+    for (const [name, raw] of vars) {
+        const value = resolve(raw, vars);
+        const fr = FONT_VARS.find(([re]) => re.test(name));
+        if (fr) {
+            const family = fontOf(value);
+            if (family)
+                v.fonts.push({ role: fr[1], family, w: 0.5 });
+            continue;
+        }
+        const hit = VAR_ROLES.find(([re]) => re.test(name));
+        const hex = hit ? varColor(value) : null;
+        if (!hit || !hex)
+            continue;
+        const [, role, w] = hit;
+        if ((role === "primary" || role === "accent") && !chromatic(hex))
+            continue;
+        v.colors.push({ role, hex, w });
+    }
+}
+/** Votes from one sheet's rules, `var()` filled. `@font-face` families count as chosen fonts. */
+export function voteSheet(root, vars, v) {
+    root.walkAtRules("font-face", (a) => {
+        a.walkDecls("font-family", (d) => {
+            const family = fontOf(d.value);
+            if (family)
+                v.fonts.push({ role: "any", family, w: 0.15 });
+        });
+    });
+    root.walkDecls((d) => {
+        if (d.prop.startsWith("--") || hidden(d) || d.parent?.type !== "rule")
+            return;
+        const prop = d.prop.toLowerCase();
+        const value = resolve(d.value, vars);
+        const sels = selectorsOf(d);
+        const body = sels.some((s) => BODY.test(s));
+        const head = sels.some((s) => HEAD.test(s));
+        const button = sels.some((s) => BUTTON.test(s) && !BUTTON_NOT.test(s));
+        const link = sels.some((s) => LINK.test(s));
+        if (prop === "font-family" || prop === "font") {
+            const family = fontOf(value, prop === "font");
+            if (!family)
+                return;
+            if (body)
+                v.fonts.push({ role: "body", family, w: 0.8 });
+            if (head)
+                v.fonts.push({ role: "heading", family, w: 0.7 });
+            v.fonts.push({ role: "any", family, w: 0.05 });
+            return;
+        }
+        const colors = colorsIn(value);
+        const [first] = colors;
+        if (!first)
+            return;
+        const bg = prop === "background" || prop === "background-color";
+        if (bg && body)
+            v.colors.push({ role: "background", hex: first, w: 0.7 });
+        if (prop === "color" && body)
+            v.colors.push({ role: "text", hex: first, w: 0.7 });
+        if (prop === "color" && head)
+            v.colors.push({ role: "text", hex: first, w: 0.2 });
+        if (bg && button)
+            v.colors.push({ role: "primary", hex: first, w: 0.5 });
+        if (prop === "color" && link && chromatic(first))
+            v.colors.push({ role: "accent", hex: first, w: 0.35 });
+        for (const hex of colors)
+            v.colors.push({ role: "any", hex, w: 0.03 });
+    });
+}
+//# sourceMappingURL=sheet.js.map

package/dist/brand/sheet.js.map

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

package/dist/brand/votes.d.ts

@@ -0,0 +1,34 @@
+export type ColorRole = "primary" | "accent" | "background" | "text" | "any";
+export type FontRole = "heading" | "body" | "any";
+/** `svg`: inline in the page (a data URI); `img`: an image tag; `icon`: a favicon; `og`: the share image. */
+export type LogoKind = "svg" | "img" | "icon" | "og";
+export interface Votes {
+    colors: {
+        role: ColorRole;
+        hex: string;
+        w: number;
+    }[];
+    fonts: {
+        role: FontRole;
+        family: string;
+        w: number;
+    }[];
+    logos: {
+        url: string;
+        kind: LogoKind;
+        w: number;
+    }[];
+}
+export declare const votesOf: () => Votes;
+/** One CSS colour as #rrggbb; null for see-through (alpha under 0.5) or not a colour. */
+export declare function hexOf(value: string): string | null;
+/** Every colour in a declaration's value: `1px solid #ccc`, a gradient's stops. */
+export declare function colorsIn(value: string): string[];
+/** Has hue: not a grey, not near white or black. A brand's primary is one. */
+export declare function chromatic(hex: string): boolean;
+/** Two colours a reader tells apart. */
+export declare const apart: (a: string, b: string) => boolean;
+/** The first named family of a `font-family` or `font` value; null for generic or icon stacks. */
+export declare function fontOf(value: string, shorthand?: boolean): string | null;
+/** An href against the page; only http(s) and data images. */
+export declare function abs(href: string | undefined, base: string): string | null;

package/dist/brand/votes.js

@@ -0,0 +1,103 @@
+/**
+ * Evidence for a brand: each colour, font and logo a page or a browser shows, with a weight for how
+ * directly it names the brand. Every reader (HTML, CSS, a browser's computed styles) writes votes;
+ * `score` alone decides.
+ */
+import { colorsNamed, differenceEuclidean, formatHex, oklch, parse } from "culori";
+export const votesOf = () => ({ colors: [], fonts: [], logos: [] });
+/** One CSS colour as #rrggbb; null for see-through (alpha under 0.5) or not a colour. */
+export function hexOf(value) {
+    const c = parse(value.trim());
+    if (!c || (c.alpha ?? 1) < 0.5)
+        return null;
+    return formatHex(c) ?? null;
+}
+const NAMED = new Set(Object.keys(colorsNamed));
+const TOKEN = /#[0-9a-f]{3,8}\b|\b(?:rgba?|hsla?|hwb|lab|lch|oklab|oklch|color)\([^()]*\)|\b[a-z]{3,20}\b/gi;
+/** Every colour in a declaration's value: `1px solid #ccc`, a gradient's stops. */
+export function colorsIn(value) {
+    const out = [];
+    for (const [t] of value.matchAll(TOKEN)) {
+        if (/^[a-z]+$/i.test(t) && !NAMED.has(t.toLowerCase()))
+            continue;
+        const hex = hexOf(t);
+        if (hex)
+            out.push(hex);
+    }
+    return out;
+}
+/** Has hue: not a grey, not near white or black. A brand's primary is one. */
+export function chromatic(hex) {
+    const c = oklch(hex);
+    return !!c && (c.c ?? 0) > 0.05 && c.l > 0.15 && c.l < 0.96;
+}
+const distance = differenceEuclidean("oklab");
+/** Two colours a reader tells apart. */
+export const apart = (a, b) => distance(a, b) > 0.08;
+const GENERIC = new Set([
+    "serif",
+    "sans-serif",
+    "monospace",
+    "cursive",
+    "fantasy",
+    "system-ui",
+    "ui-sans-serif",
+    "ui-serif",
+    "ui-monospace",
+    "ui-rounded",
+    "-apple-system",
+    "blinkmacsystemfont",
+    "inherit",
+    "initial",
+    "unset",
+    "revert",
+    "emoji",
+    "math",
+    "fangsong",
+    "apple color emoji",
+    "segoe ui emoji",
+    "segoe ui symbol",
+    "noto color emoji",
+]);
+const ICON_FONT = /icon|awesome|glyph|material symbols|dashicons|eicons|swiper|slick|fontello|feather|lucide/i;
+/** `font: 600 16px/1.5 Inter, sans-serif`: the families after the size. */
+const SHORTHAND = /(?:^|\s)[\d.]+(?:px|r?em|%|pt|vw|vh|ch)(?:\s*\/\s*\S+)?\s+(.+)$/;
+/** The first named family of a `font-family` or `font` value; null for generic or icon stacks. */
+export function fontOf(value, shorthand = false) {
+    let list = value.replace(/!important/i, "");
+    if (shorthand) {
+        const m = list.match(SHORTHAND);
+        if (!m?.[1])
+            return null;
+        list = m[1];
+    }
+    for (const raw of list.split(",")) {
+        const name = raw
+            .trim()
+            .replace(/^["']|["']$/g, "")
+            .trim();
+        if (!name || name.includes("("))
+            continue;
+        if (GENERIC.has(name.toLowerCase()))
+            continue;
+        return ICON_FONT.test(name) ? null : name;
+    }
+    return null;
+}
+/** An href against the page; only http(s) and data images. */
+export function abs(href, base) {
+    if (!href)
+        return null;
+    try {
+        const u = new URL(href.trim(), base);
+        if (u.protocol === "http:" || u.protocol === "https:")
+            return u.href;
+        return u.protocol === "data:" && /^data:image\/(svg|png|webp|jpe?g)/i.test(u.href)
+            ? u.href
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=votes.js.map

package/dist/brand/votes.js.map

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

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 /**
- * read: the web and files in, text out. Four doors: `./fetch` (polite HTTP, robots, the fetch
+ * read: the web and files in, text out. Five doors: `./brand` (a site's logo, palette and fonts), `./fetch` (polite HTTP, robots, the fetch
  * ladder up to a browser), `./text` (HTML and PDF to text, a page to title, text and links),
  * `./video` (a video or podcast from a URL or a file: captions, `watch`, audio to markdown, what a
  * channel or search holds) and `./study` (claims that must quote a page, drafts that must cite a
  * claim, the report). Every model call goes through `@wrenautomation/models`. No database here.
  */
+export * from "./brand/index.js";
 export * from "./fetch/index.js";
 export * from "./study/index.js";
 export * from "./text/index.js";

package/dist/index.js

@@ -1,10 +1,11 @@
 /**
- * read: the web and files in, text out. Four doors: `./fetch` (polite HTTP, robots, the fetch
+ * read: the web and files in, text out. Five doors: `./brand` (a site's logo, palette and fonts), `./fetch` (polite HTTP, robots, the fetch
  * ladder up to a browser), `./text` (HTML and PDF to text, a page to title, text and links),
  * `./video` (a video or podcast from a URL or a file: captions, `watch`, audio to markdown, what a
  * channel or search holds) and `./study` (claims that must quote a page, drafts that must cite a
  * claim, the report). Every model call goes through `@wrenautomation/models`. No database here.
  */
+export * from "./brand/index.js";
 export * from "./fetch/index.js";
 export * from "./study/index.js";
 export * from "./text/index.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wrenautomation/read",
-  "version": "0.41.0",
-  "description": "The web and files in, text out. Polite HTTP fetching with robots and a fetch ladder up to a browser; HTML and PDF to text, a page to title, text and links; a video or podcast from a URL or a file (captions, ffmpeg and a vision model, audio to markdown, what a channel or search holds); a study's synthesis reader whose every claim quotes a page.",
+  "version": "0.43.0",
+  "description": "The web and files in, text out. Polite HTTP fetching with robots and a fetch ladder up to a browser; HTML and PDF to text, a page to title, text and links; a video or podcast from a URL or a file (captions, ffmpeg and a vision model, audio to markdown, what a channel or search holds); a site's brand (logo, palette, fonts); a study's synthesis reader whose every claim quotes a page.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/wrenautomation/engine.git",
@@ -23,6 +23,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./brand": {
+      "types": "./dist/brand/index.d.ts",
+      "import": "./dist/brand/index.js"
+    },
     "./fetch": {
       "types": "./dist/fetch/index.d.ts",
       "import": "./dist/fetch/index.js"
@@ -44,12 +48,17 @@
     "node": ">=24"
   },
   "dependencies": {
+    "culori": "4.0.2",
     "entities": "8.1.0",
     "htmlparser2": "12.0.0",
+    "postcss": "8.5.32",
     "robots-parser": "3.0.1",
     "unpdf": "1.8.1",
     "zod": "4.6.5",
-    "@wrenautomation/models": "0.41.0"
+    "@wrenautomation/models": "0.43.0"
+  },
+  "devDependencies": {
+    "@types/culori": "4.0.1"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",