@fusion.dev/helix-cli 0.205.2 → 0.206.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-cli",
   "description": "The Helix command line, for a workspace that reaches it through npm, and the visual tests it runs.",
-  "version": "0.205.2",
+  "version": "0.206.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -41,11 +41,11 @@
     "visual-regression"
   ],
   "optionalDependencies": {
-    "@fusion.dev/helix-cli-darwin-arm64": "0.205.2",
-    "@fusion.dev/helix-cli-darwin-x64": "0.205.2",
-    "@fusion.dev/helix-cli-linux-arm64": "0.205.2",
-    "@fusion.dev/helix-cli-linux-x64": "0.205.2",
-    "@fusion.dev/helix-cli-win32-x64": "0.205.2"
+    "@fusion.dev/helix-cli-darwin-arm64": "0.206.0",
+    "@fusion.dev/helix-cli-darwin-x64": "0.206.0",
+    "@fusion.dev/helix-cli-linux-arm64": "0.206.0",
+    "@fusion.dev/helix-cli-linux-x64": "0.206.0",
+    "@fusion.dev/helix-cli-win32-x64": "0.206.0"
   },
   "peerDependencies": {
     "@anthropic-ai/sdk": ">=0.132",

package/visual/README.md

@@ -159,7 +159,9 @@ export default defineConfig({
   ground it is painted on, in each color scheme the shots picture. The ground
   is composited through every translucent layer, and a ground that is a
   picture or a video is not judged. Text hidden from the accessibility tree is
-  a glyph for the eye, and answers to the 3:1 of a graphic. `rules` names the colors of lines that
+  a glyph for the eye, and answers to the 3:1 of a graphic. The run record
+  lists every ink and ground pair it measured, passing or not, under
+  `painted`, so a project can say which of its colors its pages put together. `rules` names the colors of lines that
   separate, which answer to no target.
 - Each check takes `ignore`, selectors it leaves alone with everything inside
   them, and an exception's `checks` excuses one entry from the checks it names.

package/visual/checks.mjs

@@ -12,11 +12,15 @@
 
 /**
  * Reads the page for the checks `options` turns on: `clipped`, `overlap` and
- * `contrast`, each with its own settings, or absent.
+ * `contrast`, each with its own settings, or absent. Returns the findings,
+ * and every ink and ground pair contrast measured, passing or not, as
+ * `<scheme> <ink> on <ground>` in hex, so a run can say which pairs its pages
+ * paint.
  */
 export const readPage = (page, options) =>
   page.evaluate((options) => {
     const findings = []
+    const pairs = new Set()
 
     /* **Every element, shadow roots included**, because the boxes a component
        lays out for itself are inside one, and the light tree alone holds only
@@ -696,6 +700,7 @@ export const readPage = (page, options) =>
         const wanted =
           !text || drawn || size >= large || (bold && size >= largeBold) ? component : target
         const flat = ink.a === 1 ? ink : over(ink, ground.color)
+        pairs.add(`${scheme} ${hex(flat)} on ${hex(ground.color)}`)
         const measured = ratio(flat, ground.color)
         if (measured < wanted) {
           const line = `${describe(painter)} is ${hex(flat)} on ${hex(ground.color)} in ${scheme}, ${measured.toFixed(2)}:1 against ${wanted}:1: "${sample(element.textContent ?? '')}"`
@@ -712,7 +717,7 @@ export const readPage = (page, options) =>
       window.scrollTo(pageAt[0], pageAt[1])
     }
 
-    return findings
+    return { findings, pairs: [...pairs] }
   }, options)
 
 /**

package/visual/driver.mjs

@@ -397,6 +397,8 @@ const take = async (lane, item, { elements, readyProperty }, progress) => {
   let error = null
   let problems = []
   let findings = []
+  /* Every ink and ground pair contrast measured on the page. */
+  let painted = []
   let aria = null
   /* The color schemes contrast has been read in. */
   const read = new Set()
@@ -488,13 +490,13 @@ const take = async (lane, item, { elements, readyProperty }, progress) => {
       if ((index === 0 && (item.checks?.clipped || item.checks?.overlap)) || contrast) {
         progress.stage = 'reading the page'
         read.add(shot.scheme)
-        findings = findings.concat(
-          await readPage(page, {
-            clipped: index === 0 ? (item.checks.clipped ?? null) : null,
-            contrast: contrast ? { ...item.checks.contrast, scheme: shot.scheme } : null,
-            overlap: index === 0 ? (item.checks.overlap ?? null) : null,
-          }),
-        )
+        const reading = await readPage(page, {
+          clipped: index === 0 ? (item.checks.clipped ?? null) : null,
+          contrast: contrast ? { ...item.checks.contrast, scheme: shot.scheme } : null,
+          overlap: index === 0 ? (item.checks.overlap ?? null) : null,
+        })
+        findings = findings.concat(reading.findings)
+        painted = painted.concat(reading.pairs)
       }
       if (index === 0 && item.aria) {
         progress.stage = 'taking its accessibility snapshot'
@@ -526,6 +528,7 @@ const take = async (lane, item, { elements, readyProperty }, progress) => {
     findings,
     key: item.key,
     op: 'item',
+    painted,
     problems,
     seconds,
   })