blume 2.0.3 → 2.1.0

package/dist/cli/{chunk-wrr3j9w9.js → chunk-h2a48yhd.js}

@@ -19,27 +19,39 @@ import {
   writeAgentReport,
   fixPrompt,
   launchInstalledAgent
-} from "./chunk-1d7ve1dm.js";
+} from "./chunk-0gz36akr.js";
 import {
   routeSetFor,
   frontmatter_default,
+  isPatternPath,
+  patternDestination,
   gradeExternal,
   probeAll,
   applyBaseToAstroRedirects,
   deployPlatform
-} from "./chunk-pv29h0wf.js";
+} from "./chunk-xkz5xbtv.js";
 import {
   normalizeBasePath,
   normalizePath,
   stripBasePath
-} from "./chunk-3em5wd2y.js";
+} from "./chunk-zccbjcj0.js";
 import {
   deployStaticDir,
   examplesRouteBase
-} from "./chunk-5m5nmvyq.js";
+} from "./chunk-4h8z9vv5.js";
+import {
+  parseColor,
+  composite,
+  contrastRatio,
+  MIN_TEXT_CONTRAST,
+  themeInk,
+  labelOn,
+  resolveAccent,
+  resolveAction
+} from "./chunk-cm89scdv.js";
 import {
   scanProject
-} from "./chunk-j85vccga.js";
+} from "./chunk-43zcf4gz.js";
 
 // src/cli/commands/audit.ts
 import { defineCommand } from "citty";
@@ -337,6 +349,105 @@ var contentChecks = {
   tier: "static"
 };
 
+// src/audit/checks/contrast.ts
+var MODES = ["light", "dark"];
+var fillPair = (key, fill, page, mode) => ({
+  fix: `Neither white nor dark text reaches ${MIN_TEXT_CONTRAST}:1 on this shade. Move \`${key}\`'s ${mode} shade lighter or darker.`,
+  key,
+  label: key === "theme.action" ? "The call-to-action label" : "Button labels on the accent",
+  surface: composite(fill, page),
+  text: parseColor(labelOn(fill, mode)) ?? fill
+});
+var accentPairs = (fill, page, mode) => [
+  {
+    fix: `${mode === "light" ? "Darken" : "Lighten"} \`theme.accent\`'s ${mode} shade (\`theme.accent: { light, dark }\`).`,
+    key: "theme.accent",
+    label: "Accent text on the page",
+    surface: page,
+    text: fill
+  },
+  fillPair("theme.accent", fill, page, mode)
+];
+var backgroundPairs = (page, mode) => {
+  const fix = `Pick a \`theme.background\` ${mode} color further from the text color.`;
+  return [
+    {
+      fix,
+      key: "theme.background",
+      label: "Body text on the page",
+      surface: page,
+      text: themeInk(mode, "foreground")
+    },
+    {
+      fix,
+      key: "theme.background",
+      label: "Secondary text on the page",
+      surface: page,
+      text: themeInk(mode, "mutedForeground")
+    }
+  ];
+};
+var modeColors = (theme, mode) => {
+  const unread = [];
+  const read = (color) => {
+    const parsed = parseColor(color.value);
+    if (!parsed) {
+      unread.push(color);
+    }
+    return parsed;
+  };
+  const custom = theme.background?.[mode];
+  const customPage = custom === undefined ? null : read({ key: "theme.background", value: custom });
+  if (custom !== undefined && !customPage) {
+    return { pairs: [], unread };
+  }
+  const page = customPage ?? themeInk(mode, "background");
+  const pairs = customPage ? backgroundPairs(customPage, mode) : [];
+  const accent = read({
+    key: "theme.accent",
+    value: resolveAccent(theme)[mode]
+  });
+  if (accent) {
+    pairs.push(...accentPairs(accent, page, mode));
+  }
+  const action = resolveAction(theme);
+  const actionFill = action && read({ key: "theme.action", value: action[mode] });
+  if (actionFill) {
+    pairs.push(fillPair("theme.action", actionFill, page, mode));
+  }
+  return { pairs, unread };
+};
+var contrastChecks = {
+  category: "accessibility",
+  run(context) {
+    const { theme } = context.project.config;
+    const site = {
+      file: context.project.context.configFile ?? undefined,
+      url: "/"
+    };
+    const found = [];
+    const reported = new Set;
+    for (const mode of MODES) {
+      const { pairs, unread } = modeColors(theme, mode);
+      for (const color of unread) {
+        const id = `${color.key}:${color.value}`;
+        if (!reported.has(id)) {
+          reported.add(id);
+          found.push(finding("BLUME_AUDIT_THEME_COLOR_UNCHECKED", site, `\`${color.key}\` is "${color.value}", which the audit can't read as a color, so its contrast went unchecked.`));
+        }
+      }
+      for (const pair of pairs) {
+        const ratio = contrastRatio(pair.text, pair.surface);
+        if (ratio < MIN_TEXT_CONTRAST) {
+          found.push(finding("BLUME_AUDIT_THEME_CONTRAST_LOW", site, `${pair.label} in ${mode} mode is ${ratio.toFixed(2)}:1, under the ${MIN_TEXT_CONTRAST}:1 WCAG AA asks of body text (\`${pair.key}\`).`, pair.fix));
+        }
+      }
+    }
+    return found;
+  },
+  tier: "static"
+};
+
 // src/audit/checks/dns-aid.ts
 var RR_SVCB = 64;
 var RR_HTTPS = 65;
@@ -495,6 +606,68 @@ var duplicateChecks = {
   tier: "static"
 };
 
+// src/audit/redirects.ts
+var pathOnly = (value) => {
+  const cut = value.search(/[?#]/u);
+  return cut === -1 ? value : value.slice(0, cut);
+};
+var resolveRedirects = (redirects, served) => {
+  const byFrom = new Map;
+  for (const redirect of redirects) {
+    byFrom.set(normalizePath(redirect.from), redirect);
+  }
+  const hopFrom = (path) => byFrom.get(path)?.to ?? patternDestination(redirects, path);
+  return redirects.map((redirect) => {
+    const from = normalizePath(redirect.from);
+    if (isPatternPath(redirect.from)) {
+      return { ...redirect, chain: [from], outcome: "pattern" };
+    }
+    const chain = [from];
+    const seen = new Set([from]);
+    let current = redirect.to;
+    for (;; ) {
+      if (/^https?:\/\//iu.test(current)) {
+        chain.push(current);
+        break;
+      }
+      const next = normalizePath(pathOnly(current));
+      if (seen.has(next)) {
+        chain.push(next);
+        return {
+          ...redirect,
+          chain,
+          outcome: "loop"
+        };
+      }
+      chain.push(next);
+      seen.add(next);
+      const hop = hopFrom(next);
+      if (hop === undefined) {
+        break;
+      }
+      current = hop;
+    }
+    const destination = chain.at(-1) ?? from;
+    const external = /^https?:\/\//iu.test(destination);
+    if (!(external || served(destination))) {
+      return { ...redirect, chain, outcome: "broken" };
+    }
+    return {
+      ...redirect,
+      chain,
+      outcome: chain.length > 2 ? "chain" : "ok"
+    };
+  });
+};
+var redirectAt = (redirects, path) => {
+  const exact = redirects.find((entry) => normalizePath(entry.from) === path);
+  if (exact) {
+    return exact;
+  }
+  const to = patternDestination(redirects, path);
+  return to === undefined ? undefined : { to };
+};
+
 // src/audit/checks/indexability.ts
 var parseCanonical = (canonical) => {
   try {
@@ -538,7 +711,7 @@ var canonicalChecks = (context, page) => {
   if (target === normalizePath(page.url)) {
     return found;
   }
-  const redirect = context.redirects.find((entry) => normalizePath(entry.from) === target);
+  const redirect = redirectAt(context.redirects, target);
   if (redirect) {
     found.push(finding("BLUME_AUDIT_CANONICAL_BAD_TARGET", pageSite(context, page, ["seo", "canonical"]), `Canonical points at ${target}, which is a redirect to ${redirect.to}.`));
   } else if (context.byUrl.has(target)) {
@@ -643,7 +816,7 @@ var hreflangChecks = (context, page) => {
       continue;
     }
     const target = context.byUrl.get(path);
-    const redirect = context.redirects.find((entry) => normalizePath(entry.from) === path);
+    const redirect = redirectAt(context.redirects, path);
     if (redirect) {
       found.push(finding("BLUME_AUDIT_HREFLANG_BAD_TARGET", pageSite(context, page), `hreflang="${alternate.lang}" points at ${path}, which redirects to ${redirect.to}.`));
     } else if (!target) {
@@ -758,7 +931,6 @@ var anchorResolves = (target, fragment) => {
     return target.ids.has(fragment);
   }
 };
-var redirectFrom = (context, path) => context.redirects.find((entry) => normalizePath(entry.from) === path);
 var linkChecks = {
   category: "links",
   run(context) {
@@ -811,7 +983,7 @@ var linkChecks = {
         found.push(finding("BLUME_AUDIT_INTERNAL_LINK_NOFOLLOW", pageSite(context, page), `Internal link to ${resolved.path} is rel="nofollow".`));
       }
       const { path } = resolved;
-      const redirect = redirectFrom(context, path);
+      const redirect = redirectAt(context.redirects, path);
       if (redirect) {
         if (link.content) {
           found.push(finding("BLUME_AUDIT_LINK_TO_REDIRECT", pageSite(context, page), `Link to ${path} goes through a redirect to ${redirect.to}.`));
@@ -838,7 +1010,7 @@ var linkChecks = {
       found.push(finding("BLUME_AUDIT_LINK_TO_BROKEN", { url: page.url }, `Navigation links to ${path}, which the build does not serve.`, "Fix the entry in your navigation config or meta file."));
     }
     for (const [path, page] of redirectedChrome) {
-      const redirect = redirectFrom(context, path);
+      const redirect = redirectAt(context.redirects, path);
       found.push(finding("BLUME_AUDIT_LINK_TO_REDIRECT", { url: page.url }, `Navigation links to ${path}, which redirects to ${redirect?.to}.`, "Point the navigation entry straight at the destination."));
     }
     for (const [key, page] of brokenChromeAnchors) {
@@ -1238,7 +1410,7 @@ var checkListedUrl = (context, loc, origin, file, deployBase) => {
   const path = normalizePath(stripBasePath(deployBase, decodePath(parsed.pathname)));
   const page = context.byUrl.get(path);
   if (!page) {
-    const redirect = context.redirects.find((entry) => normalizePath(entry.from) === path);
+    const redirect = redirectAt(context.redirects, path);
     return [
       finding("BLUME_AUDIT_SITEMAP_BAD_URL", { file, url: loc }, redirect ? `sitemap.xml lists ${path}, which redirects to ${redirect.to}.` : `sitemap.xml lists ${path}, which the build does not serve.`)
     ];
@@ -1779,56 +1951,6 @@ var crawlStaticDir = async (options) => {
   };
 };
 
-// src/audit/redirects.ts
-var pathOnly = (value) => {
-  const cut = value.search(/[?#]/u);
-  return cut === -1 ? value : value.slice(0, cut);
-};
-var resolveRedirects = (redirects, served) => {
-  const byFrom = new Map;
-  for (const redirect of redirects) {
-    byFrom.set(normalizePath(redirect.from), redirect);
-  }
-  return redirects.map((redirect) => {
-    const from = normalizePath(redirect.from);
-    const chain = [from];
-    const seen = new Set([from]);
-    let current = redirect.to;
-    for (;; ) {
-      if (/^https?:\/\//iu.test(current)) {
-        chain.push(current);
-        break;
-      }
-      const next = normalizePath(pathOnly(current));
-      if (seen.has(next)) {
-        chain.push(next);
-        return {
-          ...redirect,
-          chain,
-          outcome: "loop"
-        };
-      }
-      chain.push(next);
-      seen.add(next);
-      const hop = byFrom.get(next);
-      if (!hop) {
-        break;
-      }
-      current = hop.to;
-    }
-    const destination = chain.at(-1) ?? from;
-    const external = /^https?:\/\//iu.test(destination);
-    if (!(external || served(destination))) {
-      return { ...redirect, chain, outcome: "broken" };
-    }
-    return {
-      ...redirect,
-      chain,
-      outcome: chain.length > 2 ? "chain" : "ok"
-    };
-  });
-};
-
 // src/audit/terms.ts
 var shortId = (id) => id.replace("BLUME_AUDIT_", "").toLowerCase();
 var checkTerms = () => [
@@ -1856,6 +1978,7 @@ var MODULES = [
   ogImageChecks,
   i18nChecks,
   assetChecks,
+  contrastChecks,
   sitemapChecks,
   robotsChecks,
   llmsChecks,
@@ -2113,5 +2236,5 @@ export {
   shouldFail
 };
 
-//# debugId=E1B16241D184BD6E64756E2164756E21
-//# sourceMappingURL=chunk-wrr3j9w9.js.map
+//# debugId=5A0EAC80A1CBB9B964756E2164756E21
+//# sourceMappingURL=chunk-h2a48yhd.js.map