Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScript aiai-agentsai-crawlerai-scrapingai-searchcrawlerdata-extractionhtml-to-markdownllmmarkdownscraperscrapingweb-crawlerweb-dataweb-data-extractionweb-scraperweb-scrapingweb-searchwebscraping
fix(branding): use black as the primary color for monochrome brands (#5098)
Abimael Martell4c33951663df
diff --git a/apps/api/src/__tests__/lib/branding/color-roles.test.ts b/apps/api/src/__tests__/lib/branding/color-roles.test.tsindex 7bea2d974..8eea51eba 100644--- a/apps/api/src/__tests__/lib/branding/color-roles.test.ts+++ b/apps/api/src/__tests__/lib/branding/color-roles.test.ts@@ -251,3 +251,68 @@ describe("processRawBranding primary", () => {expect(profile.colors?.primary).toBe("#635BFF");});});++describe("monochrome brands", () => {+ const button = (background: string, textColor: string, index: number) => ({+ index,+ text: `Button ${index}`,+ html: "",+ classes: "",+ background,+ textColor,+ });+ const llmPicking = (primaryColor: string) => ({+ ...emptyLlm,+ buttonClassification: {+ primaryButtonIndex: 0,+ primaryButtonReasoning: "n/a",+ secondaryButtonIndex: -1,+ secondaryButtonReasoning: "n/a",+ confidence: 0.9,+ },+ colorRoles: {+ primaryColor,+ accentColor: "",+ backgroundColor: "#FFFFFF",+ textPrimary: "#171717",+ confidence: 0.8,+ },+ });++ it("uses the black call to action when the chosen color is only a link color", () => {+ const merged = mergeBrandingResults(+ { colorScheme: "light", colors: {} },+ llmPicking("#0072F5"),+ [button("#171717", "#FFFFFF", 0), button("#FFFFFF", "#171717", 1)],+ );+ expect(merged.colors?.primary).toBe("#171717");+ expect(merged.colors?.accent).toBe("#0072F5");+ });++ it("keeps a color that also fills a button", () => {+ const merged = mergeBrandingResults(+ { colorScheme: "light", colors: {} },+ llmPicking("#0071E3"),+ [button("#000000", "#FFFFFF", 0), button("#0071E3", "#FFFFFF", 1)],+ );+ expect(merged.colors?.primary).toBe("#0071E3");+ });++ it("keeps a navy call to action from replacing the brand color", () => {+ const merged = mergeBrandingResults(+ { colorScheme: "light", colors: {} },+ llmPicking("#635BFF"),+ [button("#0A2540", "#FFFFFF", 0)],+ );+ expect(merged.colors?.primary).toBe("#635BFF");+ });++ it("leaves dark pages alone", () => {+ const merged = mergeBrandingResults(+ { colorScheme: "dark", colors: {} },+ llmPicking("#1ED760"),+ [button("#111111", "#FFFFFF", 0)],+ );+ expect(merged.colors?.primary).toBe("#1ED760");+ });+});diff --git a/apps/api/src/lib/branding/color-roles.ts b/apps/api/src/lib/branding/color-roles.tsindex 044fd2911..75402bbfb 100644--- a/apps/api/src/lib/branding/color-roles.ts+++ b/apps/api/src/lib/branding/color-roles.ts@@ -32,6 +32,25 @@ export function isNearBlack(hex: string): boolean {return contrastYIQ(hex) < 40 && max < 140;}+/** Near-black with no hue: a monochrome brand's black, not navy chrome. */+export function isNeutralDark(hex: string): boolean {+ const h = hex.replace("#", "");+ if (h.length < 6) return false;+ const channels = [0, 2, 4].map(i => parseInt(h.slice(i, i + 2), 16));+ return isNearBlack(hex) && Math.max(...channels) - Math.min(...channels) < 30;+}++/** Straight-line RGB distance; Infinity unless both are #RRGGBB. */+export function colorDistance(a?: string | null, b?: string | null): number {+ const x = normalizeRoleHex(a);+ const y = normalizeRoleHex(b);+ if (!x || !y || x.length !== 7 || y.length !== 7) return Infinity;+ const channels = (hex: string) =>+ [1, 3, 5].map(i => parseInt(hex.slice(i, i + 2), 16));+ const [p, q] = [channels(x), channels(y)];+ return Math.hypot(p[0] - q[0], p[1] - q[1], p[2] - q[2]);+}+/** Chromatic brand color — not gray chrome, and not a near-black nav on light pages. */export function isUsableBrandPrimary(hex: string,diff --git a/apps/api/src/lib/branding/merge.ts b/apps/api/src/lib/branding/merge.tsindex fa9e3ced5..90596ba01 100644--- a/apps/api/src/lib/branding/merge.ts+++ b/apps/api/src/lib/branding/merge.ts@@ -1,5 +1,7 @@import { BrandingProfile } from "../../types/branding";import {+ colorDistance,+ isNeutralDark,isUsableBrandPrimary,normalizeRoleHex,shouldApplyLlmColorRoles,@@ -318,6 +320,34 @@ export function mergeBrandingResults(}}+ // Monochrome brands (black logo and calls to action, color only in links or+ // artwork) have black as their primary color, which the chrome filters above+ // reject on light pages. A near-black primary button is that signal, unless+ // the chosen color also fills a button, as when a brand pairs a black call to+ // action with colored ones.+ const primaryFill = normalizeRoleHex(+ merged.components?.buttonPrimary?.background,+ );+ const primaryColor = normalizeRoleHex(merged.colors?.primary);+ if (+ merged.colorScheme !== "dark" &&+ primaryFill &&+ isNeutralDark(primaryFill) &&+ primaryColor &&+ primaryColor !== primaryFill &&+ !buttonSnapshots.some(+ b =>+ colorDistance(b.background, primaryColor) < 40 ||+ colorDistance(b.borderColor, primaryColor) < 40,+ )+ ) {+ merged.colors = {+ ...merged.colors,+ primary: primaryFill,+ accent: merged.colors?.accent ?? primaryColor,+ };+ }+if (llm.personality) {(merged as any).personality = llm.personality;}