raven-mcp 1.10.0 → 1.12.0

package/README.md

@@ -10,7 +10,7 @@ A design knowledge MCP server that Claude can query when generating UI. Eight la
 
 Raven gives Claude access to a comprehensive design knowledge base:
 
-- **Principles** — Nielsen's 10 Heuristics, all 21 Laws of UX, Gestalt principles, WCAG accessibility, typography rules, color theory, mobile UX, D4D framework, UX writing, service design, and brand
+- **Principles** — Nielsen's 10 Heuristics, all 21 Laws of UX, Gestalt principles, WCAG accessibility, typography rules, color theory, mobile UX, D4D framework, UX writing, service design, brand, color-systems (palette-size discipline), and spacing-systems (base-unit grid + scale limits)
 - **Patterns** — Proven UI patterns for signup flows, pricing pages, navigation, forms, landing pages, dashboards, modals, empty/error/loading states, CTAs, social proof, mobile conversion — plus content patterns (error messages, empty-state copy, notifications, form validation) and service patterns (service blueprinting, human handoff, signup-as-service, omnichannel continuity, moments of truth)
 - **Content systems** — Voice & tone guides from publicly documented brand systems: Mailchimp, GOV.UK, Shopify Polaris, and Atlassian
 - **Research** — Qualitative, quantitative, and usability methods with do/don't protocols and checklists. Metrics frameworks: HEART, AARRR/Pirate, North Star Metric, conversion funnel, RICE, OKRs.
@@ -55,7 +55,7 @@ cd raven-mcp && npm install && npm run build
 | `get_principles` | Get design principles relevant to a UI context |
 | `get_pattern` | Get proven patterns for a specific UI type |
 | `get_business_strategy` | Get business/monetization strategies |
-| `evaluate_design` | Evaluate a design description against principles. Pass base64 PNG screenshots (`before_screenshot`/`after_screenshot`) for a structured before/after pixel diff with `fix_confirmed`, `changed_ratio`, and changed region. |
+| `evaluate_design` | Evaluate a design description against principles. Pass base64 PNG screenshots (`before_screenshot`/`after_screenshot`) for a structured before/after pixel diff with `fix_confirmed`, `changed_ratio`, and changed region. Pass `compact: true` to return only scores and violations (drops full principle/pattern bodies) when the full payload is too large. |
 | `search_knowledge` | Search across all principles, patterns, and strategies |
 | `get_checklist` | Get a pre-publish checklist for a UI type |
 | `get_d4d_framework` | Get Design for Delight framework templates |
@@ -63,14 +63,16 @@ cd raven-mcp && npm install && npm run build
 | `get_design_system` | Get tokens for a specific design system |
 | `compose_system` | Mix tokens from different systems |
 | `get_brand_system` | Get a full system styled like a well-known brand |
-| `audit_page` | Audit HTML/CSS against Raven's quality standards — pass `html` for static audit, or `url` to render headless with optional `scroll_settle` (scroll to bottom + settle reveals) and `viewport` parameters; `containerMaxWidth` makes container checks token-aware |
+| `audit_page` | Audit HTML/CSS against Raven's quality standards — pass `html` for static audit, or `url` to render headless with optional `scroll_settle` (scroll to bottom + settle reveals) and `viewport` parameters; `containerMaxWidth` makes container checks token-aware. Pass `compact: true` to return only scores, violations, and fix_priority (drops embedded base64 screenshots) when the full payload is too large. |
 | `audit_layout` | Evaluate visual rhythm, alignment, and optical balance |
 | `audit_responsive_visibility` | Render a URL at multiple breakpoints and flag content elements that are visible on desktop but hidden on mobile (display:none/opacity:0/zero-size) — categorises each as likely-oversight (content vanishing on mobile) vs intentional (decorative) |
 | `audit_contrast` | Compute WCAG contrast ratios for every text element on a rendered page and report AA (4.5:1 / 3:1 large) and AAA pass-fail per element, with delta-to-pass for failures |
-| `audit_url` | Render a live URL at each viewport×theme, scroll-settle, fire interactions, capture real pixels + DOM, then run the page/contrast/responsive/blank-media checks **plus** sliced-image edge-symmetry and hover-state white-wash detection over the captures — every finding tagged confirmed/likely-artifact/inconclusive, ranked by severity |
+| `suggest_contrast_fix` | Given failing WCAG color pairs, return the minimal fg/bg change that clears the AA/AAA target — concrete passing values to fix `audit_contrast` failures |
+| `audit_url` | Render a live URL at each viewport×theme, scroll-settle, fire interactions, capture real pixels + DOM, then run the page/contrast/responsive/blank-media checks **plus** sliced-image edge-symmetry and hover-state white-wash detection over the captures — every finding tagged confirmed/likely-artifact/inconclusive, ranked by severity. Pass `compact: true` to return only findings and summary (drops per-capture base64 screenshots) when the full payload is too large. |
 | `audit_content` | Per-item content verdicts (pass/warn/fail) for headings, prose, CTAs, labels, captions, metrics & outcomes against UX-writing principles + deterministic heuristics (metric needs number+unit; CTA action-led ≤4 words; prose flags passive/jargon/hedging; caption-vs-heading duplication) — with a before→after rewrite suggestion per item. Pure offline |
 | `audit_typography` | Typographic-**scale** report over rendered DOM text nodes (or a supplied snapshot) — detects the dominant modular-scale ratio and flags off-scale sizes, checks line-height consistency vs the body rhythm, and flags weight ladders >4 weights or non-standard values. Goes beyond `audit_page`'s pass/fail typography checks |
 | `audit_tap_targets` | WCAG 2.5.5 / Apple 44pt **web** tap-target audit — enumerates every interactive element (rendered URL or snapshot) and emits a per-element fix table: selector, role, text, measured w/h, per-axis pixel deficit, and a concrete CSS fix, sorted worst-first |
+| `audit_device_frame` | Flag cropped content in device-mockup frames — `frames` (container box + intrinsic media + object-fit, or a DevTools snippet) detects object-fit:cover crop loss when frame AR ≠ media AR; `clips` (first/last frame PNGs) detects baked-in pan/zoom (Ken Burns); `edge_frames` (PNGs) flags content truncated at a frame edge |
 | `audit_swiftui` | Audit SwiftUI source against Apple HIG — Dynamic Type, semantic colors, 44pt targets, 4/8pt spacing, AccentColor |
 | `audit_ios_screen` | Score a rendered iOS screen from an accessibility/view-hierarchy snapshot — 44pt targets + contrast + rhythm, in points |
 | `audit_ios_privacy` | Audit Info.plist (or Expo app.json) /PRIVACY.md/entitlements/source — usage-string honesty, ATS, Android permissions, bundled secrets, undisclosed default data-egress |
@@ -148,7 +150,7 @@ Returns flagged elements with selector, hiding class, visibility at each breakpo
 
 ## Contrast audits
 
-`audit_contrast` computes WCAG contrast ratios for every text element on a rendered page, reporting AA (4.5:1 normal text, 3:1 large) and AAA (7:1 normal, 4.5:1 large) pass-fail. Useful for catching small-text / low-contrast pairs that a screenshot eyedropper would catch manually — Raven replaces the math.
+`audit_contrast` computes WCAG contrast ratios for every text element on a rendered page, reporting AA (4.5:1 normal text, 3:1 large) and AAA (7:1 normal, 4.5:1 large) pass-fail. Useful for catching small-text / low-contrast pairs that a screenshot eyedropper would catch manually — Raven replaces the math. The background color is composited from the full ancestor stack (nearest opaque layer onward) for accurate contrast on layered UIs.
 
 **Usage:**
 - `audit_contrast(url)` — render a live page and audit all text.

package/dist/audit-consistency.d.ts

@@ -0,0 +1,52 @@
+export type ConsistencyDimension = {
+    reference: string | null;
+    source: "token" | "modal" | "none";
+    outliers: string[];
+};
+export type ConsistencyIssue = {
+    severity: "warning";
+    rule: string;
+    message: string;
+    fix: string;
+};
+export type ConsistencyPageResult = {
+    name: string;
+    container: {
+        px: number | null;
+        classes: string[];
+        signature: string;
+    };
+    hero: {
+        size_px: number | null;
+        classes: string;
+        signature: string;
+    };
+};
+export type ConsistencyResult = {
+    page_count: number;
+    pages: ConsistencyPageResult[];
+    consistency: {
+        container: ConsistencyDimension;
+        hero: ConsistencyDimension;
+    };
+    issues: ConsistencyIssue[];
+    score: number;
+    grade: "A" | "B" | "C" | "D";
+    summary: string;
+};
+export type AuditConsistencyOptions = {
+    container_token?: number;
+    hero_token?: string;
+};
+/**
+ * Audit multiple pages for cross-page consistency of:
+ *   - Content-container width (container_px / container_classes)
+ *   - Hero heading tier (hero_size_px / hero_classes)
+ *
+ * Infers the canonical (modal) value from the corpus when no token is supplied.
+ * Pure — no I/O, no browser. Assumes pages.length >= 2.
+ */
+export declare function auditConsistency(pages: Array<{
+    name: string;
+    html: string;
+}>, opts?: AuditConsistencyOptions): ConsistencyResult;

package/dist/audit-consistency.js

@@ -0,0 +1,290 @@
+// ── Cross-page consistency audit ─────────────────────────────────────
+//
+// Accepts multiple pages (name + HTML string) and flags cross-page
+// divergence in (a) content-container width and (b) hero heading tier.
+// The canonical (reference) value for each dimension is inferred from the
+// corpus modal when no token is supplied, so callers need not know the
+// project's token in advance.
+//
+// Pure HTML-string analysis: no I/O, no browser.
+// Reuses `containerScaleWidths` from audit-container.ts; does NOT modify it.
+//
+// Addresses GitHub issue #9 ("single-blob audit blind spot") — fix #1
+// (multi-page / corpus audit mode).
+import { containerScaleWidths } from "./audit-container.js";
+// ── Per-page extraction helpers ──────────────────────────────────────
+var CONTAINER_CLASS_RE = /\b(max-w-[a-z0-9.]+|container[a-z0-9-]*|w-screen|w-full)\b/gi;
+/**
+ * Extract container-class tokens from the page HTML.
+ * Returns a sorted, unique array of class tokens matching the pattern.
+ */
+function extractContainerClasses(html) {
+    var found = [];
+    var m;
+    var re = new RegExp(CONTAINER_CLASS_RE.source, "gi");
+    while ((m = re.exec(html)) !== null) {
+        found.push(m[0].toLowerCase());
+    }
+    // Sort + deduplicate
+    var unique = Array.from(new Set(found)).sort();
+    return unique;
+}
+/**
+ * Largest declared heading font-size in px among h1/h2 CSS rules, or null.
+ * Mirrors the approach in page-checks.ts lines ~135-138: regex for h1/h2 CSS
+ * rules then pulls the font-size value.
+ */
+function extractHeroSizePx(html) {
+    var best = null;
+    var tags = ["h1", "h2"];
+    for (var i = 0; i < tags.length; i++) {
+        var ht = tags[i];
+        var hre = new RegExp("(?:^|[\\s,}])" + ht + "\\b[^{]*\\{[^}]*font-size\\s*:\\s*(\\d+(?:\\.\\d+)?)\\s*px", "i");
+        var hm = html.match(hre);
+        if (hm) {
+            var n = parseFloat(hm[1]);
+            if (!isNaN(n) && (best === null || n > best))
+                best = n;
+        }
+    }
+    return best;
+}
+/**
+ * Extract the class attribute of the FIRST <h1 ...> tag in the page.
+ * Returns "" if none found or no class attr present.
+ */
+function extractFirstH1Classes(html) {
+    var m = html.match(/<h1\b([^>]*)>/i);
+    if (!m)
+        return "";
+    var attrs = m[1];
+    var classMatch = attrs.match(/\bclass\s*=\s*(?:"([^"]*?)"|'([^']*?)'|([^\s>]*))/i);
+    if (!classMatch)
+        return "";
+    return (classMatch[1] || classMatch[2] || classMatch[3] || "").trim();
+}
+var HERO_TYPE_SCALE_RE = /\btext-(display-[a-z0-9]+|[0-9]?xl|xs|sm|base|lg|xl)\b/i;
+/**
+ * Derive the hero signature for a page.
+ * If hero_size_px is known, use that as the signature (e.g. "64").
+ * Else find the first type-scale class in hero_classes.
+ * Else "".
+ */
+function heroSignature(heroPx, heroClasses) {
+    if (heroPx !== null)
+        return String(heroPx);
+    var m = heroClasses.match(HERO_TYPE_SCALE_RE);
+    if (m)
+        return m[0];
+    return "";
+}
+// ── Per-page extraction ───────────────────────────────────────────────
+function extractPage(name, html) {
+    // Container
+    var widths = containerScaleWidths(html);
+    var containerPx = widths.length > 0 ? Math.max.apply(null, widths) : null;
+    var containerClasses = extractContainerClasses(html);
+    var containerSignature;
+    if (containerPx !== null) {
+        containerSignature = String(containerPx);
+    }
+    else {
+        containerSignature = containerClasses.join(" ");
+    }
+    // Hero
+    var heroPx = extractHeroSizePx(html);
+    var heroClasses = extractFirstH1Classes(html);
+    var herSig = heroSignature(heroPx, heroClasses);
+    return {
+        name: name,
+        container: {
+            px: containerPx,
+            classes: containerClasses,
+            signature: containerSignature
+        },
+        hero: {
+            size_px: heroPx,
+            classes: heroClasses,
+            signature: herSig
+        }
+    };
+}
+// ── Modal inference ───────────────────────────────────────────────────
+/**
+ * Find the modal (most frequent) value among non-empty strings.
+ * Returns null if all are empty, or if there's a tie among ≥2 distinct values.
+ */
+function findModal(values) {
+    var nonEmpty = values.filter(function (v) { return v !== ""; });
+    if (nonEmpty.length === 0)
+        return null;
+    var counts = {};
+    for (var i = 0; i < nonEmpty.length; i++) {
+        var v = nonEmpty[i];
+        counts[v] = (counts[v] || 0) + 1;
+    }
+    var maxCount = 0;
+    var keys = Object.keys(counts);
+    for (var k = 0; k < keys.length; k++) {
+        if (counts[keys[k]] > maxCount)
+            maxCount = counts[keys[k]];
+    }
+    // All values with the max count
+    var leaders = keys.filter(function (k) { return counts[k] === maxCount; });
+    // Tie among ≥2 distinct values → no modal
+    if (leaders.length >= 2)
+        return null;
+    return leaders[0];
+}
+function checkDimension(pageNames, signatures, token) {
+    // All non-empty signatures
+    var nonEmpty = signatures.filter(function (s) { return s !== ""; });
+    // 1. Token override
+    if (token !== undefined && token !== null) {
+        var ref = String(token);
+        var outliers = [];
+        for (var i = 0; i < signatures.length; i++) {
+            var sig = signatures[i];
+            if (sig !== "" && sig !== ref) {
+                outliers.push(pageNames[i]);
+            }
+        }
+        return { reference: ref, source: "token", outliers: outliers };
+    }
+    // 2. All empty → source "none"
+    if (nonEmpty.length === 0) {
+        return { reference: null, source: "none", outliers: [] };
+    }
+    // 3. Modal inference
+    var modal = findModal(signatures);
+    if (modal !== null) {
+        // Clear modal: outliers are non-empty pages that differ
+        var outliers2 = [];
+        for (var j = 0; j < signatures.length; j++) {
+            if (signatures[j] !== "" && signatures[j] !== modal) {
+                outliers2.push(pageNames[j]);
+            }
+        }
+        return { reference: modal, source: "modal", outliers: outliers2 };
+    }
+    // 4. Tie (no modal): emit all non-empty differing pages as outliers.
+    // reference is null (can't declare canonical without a token), so source is
+    // "none" — "modal" always carries a non-null reference, keeping the two fields
+    // internally consistent for consumers.
+    var allOutliers = [];
+    for (var m = 0; m < signatures.length; m++) {
+        if (signatures[m] !== "") {
+            allOutliers.push(pageNames[m]);
+        }
+    }
+    return { reference: null, source: "none", outliers: allOutliers };
+}
+// ── Issue generation ──────────────────────────────────────────────────
+function makeContainerIssue(outliers, reference) {
+    // Reference may be a numeric px width ("1152") or a class signature ("container-wide");
+    // only suffix "px" for the numeric form.
+    var refIsNumeric = reference !== null && /^\d+(?:\.\d+)?$/.test(reference);
+    var refStr = reference === null ? "(no modal — all values diverge)" : (refIsNumeric ? reference + "px" : reference);
+    var pageList = outliers.join(", ");
+    return {
+        severity: "warning",
+        rule: "consistency/container-width",
+        message: "Container-width inconsistency across pages. Reference: " +
+            refStr +
+            ". Divergent page(s): " +
+            pageList +
+            ".",
+        fix: "Align all pages to the same container token (" +
+            (reference === null ? "the project canonical width" : refStr) +
+            "). Use a shared layout wrapper so the container is defined once, not per-page."
+    };
+}
+function makeHeroIssue(outliers, reference) {
+    var refStr = reference !== null ? reference : "(no modal — all values diverge)";
+    var pageList = outliers.join(", ");
+    return {
+        severity: "warning",
+        rule: "consistency/hero-tier",
+        message: "Hero heading tier inconsistency across pages. Reference: " +
+            refStr +
+            ". Divergent page(s): " +
+            pageList +
+            ".",
+        fix: "Use the same hero heading class/size (" +
+            (reference !== null ? reference : "define a canonical tier") +
+            ") for the top-level heading on every page. If a page intentionally uses a smaller heading, document the exception in the design system."
+    };
+}
+/**
+ * Audit multiple pages for cross-page consistency of:
+ *   - Content-container width (container_px / container_classes)
+ *   - Hero heading tier (hero_size_px / hero_classes)
+ *
+ * Infers the canonical (modal) value from the corpus when no token is supplied.
+ * Pure — no I/O, no browser. Assumes pages.length >= 2.
+ */
+export function auditConsistency(pages, opts) {
+    var options = opts || {};
+    // Extract per-page data
+    var pageResults = pages.map(function (p) {
+        return extractPage(p.name, p.html);
+    });
+    var pageNames = pageResults.map(function (p) { return p.name; });
+    var containerSigs = pageResults.map(function (p) { return p.container.signature; });
+    var heroSigs = pageResults.map(function (p) { return p.hero.signature; });
+    // Consistency checks
+    var containerDim = checkDimension(pageNames, containerSigs, options.container_token);
+    var heroDim = checkDimension(pageNames, heroSigs, options.hero_token);
+    // Issues
+    var issues = [];
+    if (containerDim.outliers.length > 0) {
+        issues.push(makeContainerIssue(containerDim.outliers, containerDim.reference));
+    }
+    if (heroDim.outliers.length > 0) {
+        issues.push(makeHeroIssue(heroDim.outliers, heroDim.reference));
+    }
+    // Scoring
+    var failCount = (containerDim.outliers.length > 0 ? 1 : 0) +
+        (heroDim.outliers.length > 0 ? 1 : 0);
+    var score = Math.round(((2 - failCount) / 2) * 100);
+    var grade = failCount === 0 ? "A" : failCount === 1 ? "C" : "D";
+    // Summary
+    var summary;
+    if (failCount === 0) {
+        summary =
+            "All " +
+                pages.length +
+                " pages are consistent on container width and hero heading tier. Score: " +
+                score +
+                "/100 (A).";
+    }
+    else {
+        var dims = [];
+        if (containerDim.outliers.length > 0)
+            dims.push("container width");
+        if (heroDim.outliers.length > 0)
+            dims.push("hero heading tier");
+        summary =
+            pages.length +
+                " pages audited. Inconsistency detected in: " +
+                dims.join(", ") +
+                ". Score: " +
+                score +
+                "/100 (" +
+                grade +
+                ").";
+    }
+    return {
+        page_count: pages.length,
+        pages: pageResults,
+        consistency: {
+            container: containerDim,
+            hero: heroDim
+        },
+        issues: issues,
+        score: score,
+        grade: grade,
+        summary: summary
+    };
+}
+//# sourceMappingURL=audit-consistency.js.map

package/dist/audit-consistency.js.map

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

package/dist/compact.d.ts

@@ -0,0 +1,3 @@
+export declare function compactAuditPage(result: any): any;
+export declare function compactEvaluation(evaluation: any): any;
+export declare function compactAuditUrl(result: any): any;

package/dist/compact.js

@@ -0,0 +1,103 @@
+// src/compact.ts
+// Compact response shaping for the heavy audit/eval tools. Pure, no side effects.
+// Strips embedded reference bulk (base64 screenshots, principle/pattern bodies, raw DOM)
+// while preserving the decision-grade signal: scores, violations, fix_priority.
+export function compactAuditPage(result) {
+    const out = {};
+    if ("score" in result)
+        out.score = result.score;
+    if ("grade" in result)
+        out.grade = result.grade;
+    if ("summary" in result)
+        out.summary = result.summary;
+    if ("passes" in result && Array.isArray(result.passes)) {
+        out.passes_count = result.passes.length;
+    }
+    else if ("passes_count" in result) {
+        out.passes_count = result.passes_count;
+    }
+    if ("errors" in result)
+        out.errors = result.errors;
+    if ("warnings" in result)
+        out.warnings = result.warnings;
+    if ("fix_priority" in result)
+        out.fix_priority = result.fix_priority;
+    if ("notes" in result)
+        out.notes = result.notes;
+    if ("unloaded_video_artifacts" in result)
+        out.unloaded_video_artifacts = result.unloaded_video_artifacts;
+    if ("adversarial_verification" in result)
+        out.adversarial_verification = result.adversarial_verification;
+    if (result.capture && typeof result.capture === "object") {
+        const cap = {};
+        if ("url" in result.capture)
+            cap.url = result.capture.url;
+        if ("viewport" in result.capture)
+            cap.viewport = result.capture.viewport;
+        if ("scrolledToBottom" in result.capture)
+            cap.scrolledToBottom = result.capture.scrolledToBottom;
+        out.capture = cap; // screenshot_bytes (the base64) intentionally dropped
+    }
+    return out;
+}
+export function compactEvaluation(evaluation) {
+    const out = {};
+    if ("design_description" in evaluation)
+        out.design_description = evaluation.design_description;
+    if ("context" in evaluation)
+        out.context = evaluation.context;
+    if ("goals" in evaluation)
+        out.goals = evaluation.goals;
+    if ("evaluation_guidance" in evaluation)
+        out.evaluation_guidance = evaluation.evaluation_guidance;
+    if (Array.isArray(evaluation.principles_to_check)) {
+        out.principles_to_check = evaluation.principles_to_check.map((p) => ({ id: p.id, name: p.name }));
+    }
+    if (Array.isArray(evaluation.applicable_patterns)) {
+        out.applicable_patterns = evaluation.applicable_patterns.map((p) => ({ id: p.id, name: p.name }));
+    }
+    if ("total_principles" in evaluation)
+        out.total_principles = evaluation.total_principles;
+    if ("total_patterns" in evaluation)
+        out.total_patterns = evaluation.total_patterns;
+    if ("before_after_diff" in evaluation)
+        out.before_after_diff = evaluation.before_after_diff;
+    if ("fix_confirmed" in evaluation)
+        out.fix_confirmed = evaluation.fix_confirmed;
+    return out;
+}
+export function compactAuditUrl(result) {
+    const out = {};
+    if ("tool" in result)
+        out.tool = result.tool;
+    if ("url" in result)
+        out.url = result.url;
+    if ("viewports" in result)
+        out.viewports = result.viewports;
+    if ("themes" in result)
+        out.themes = result.themes;
+    if ("findings" in result)
+        out.findings = result.findings;
+    if ("counts" in result)
+        out.counts = result.counts;
+    if ("summary" in result)
+        out.summary = result.summary;
+    if ("warnings" in result)
+        out.warnings = result.warnings;
+    if (Array.isArray(result.captures)) {
+        out.captures = result.captures.map((c) => {
+            const cc = {};
+            if ("viewport" in c)
+                cc.viewport = c.viewport;
+            if ("theme" in c)
+                cc.theme = c.theme;
+            if ("scrolledToBottom" in c)
+                cc.scrolledToBottom = c.scrolledToBottom;
+            if ("screenshot_bytes" in c)
+                cc.screenshot_bytes = c.screenshot_bytes;
+            return cc; // base64 `screenshot` intentionally dropped
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=compact.js.map

package/dist/compact.js.map

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

package/dist/contrast.d.ts

@@ -42,6 +42,15 @@ export declare function relativeLuminance(rgb: [number, number, number]): number
  * contrastRatio([0,0,0], [255,255,255]) === 21 (±0.01).
  */
 export declare function contrastRatio(fg: [number, number, number], bg: [number, number, number]): number;
+/**
+ * Composite an ordered stack of CSS color strings onto an opaque white base.
+ *
+ * @param layers - CSS color strings ordered **nearest ancestor first → furthest last**.
+ *   Each is parsed with parseColor. Fully-transparent layers (a === 0) are skipped.
+ *   The stack is composited alpha-over from furthest→nearest onto white [255,255,255].
+ * @returns An opaque [r, g, b] triple. Empty or all-transparent input → [255,255,255].
+ */
+export declare function compositeBackground(layers: string[]): [number, number, number];
 /**
  * Score a pre-collected snapshot of elements. No browser required.
  */
@@ -49,6 +58,7 @@ export declare function auditContrastSnapshot(elements: Array<{
     selector: string;
     color: string;
     bgColor: string;
+    bgColors?: string[];
     fontPx?: number;
     bold?: boolean;
     text?: string;
@@ -65,3 +75,25 @@ export declare function auditContrastUrl(url: string, opts?: {
     timeoutMs?: number;
     theme?: "light" | "dark";
 }): Promise<ContrastResult>;
+export type ContrastFixDetail = {
+    color: string;
+    ratio: number;
+    direction: "lighter" | "darker";
+};
+export type SuggestContrastFix = {
+    fg: string;
+    bg: string;
+    currentRatio: number;
+    targetRatio: number;
+    passes: boolean;
+    fgFix: ContrastFixDetail | null;
+    bgFix: ContrastFixDetail | null;
+    reachable: boolean;
+    recommendation: string;
+};
+export declare function suggestContrastFix(fg: string, bg: string, opts?: {
+    targetRatio?: number;
+    level?: "AA" | "AAA";
+    fontPx?: number;
+    bold?: boolean;
+}): SuggestContrastFix;