@setsquare/ui 0.4.0 → 0.6.0

package/dist/shell/site-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"site-shell.js","sourceRoot":"","sources":["../../src/shell/site-shell.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAWlC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,QAAQ,EACR,aAAa,GAAG,sBAAsB,EACtC,MAAM,GAAG,MAAM,EACf,SAAS,GACM;IACf,OAAO,CACL,kCACkB,EAAE,EAClB,SAAS,EAAE,EAAE,CAAC,gEAAgE,EAAE,SAAS,CAAC,aAG1F,YACE,IAAI,EAAE,IAAI,MAAM,EAAE,EAClB,SAAS,EAAC,sLAAsL,YAEhM,eAAM,SAAS,EAAC,qKAAqK,YAClL,aAAa,GACT,GACL,EACH,QAAQ,IACL,CACP,CAAC;AACJ,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAiB;IACpF,OAAO,CACL,kBACM,KAAK,EACT,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,CAAC,CAAC,EACZ,SAAS,EAAE,EAAE,CAAC,8BAA8B,EAAE,SAAS,CAAC,YAEvD,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"site-shell.js","sourceRoot":"","sources":["../../src/shell/site-shell.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAoB,MAAM,gBAAgB,CAAC;AAY5D;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,QAAQ,EACR,aAAa,EACb,MAAM,EACN,MAAM,GAAG,MAAM,EACf,SAAS,GACM;IACf,OAAO,CACL,kCACkB,EAAE,EAClB,SAAS,EAAE,EAAE,CAAC,gEAAgE,EAAE,SAAS,CAAC,aAE1F,KAAC,QAAQ,IAAC,IAAI,EAAE,IAAI,MAAM,EAAE,EAAE,KAAK,EAAC,WAAW,EAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAI,EACvF,QAAQ,IACL,CACP,CAAC;AACJ,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,EAAiB;IACpF,OAAO,CACL,kBACM,KAAK,EACT,EAAE,EAAE,EAAE,EACN,QAAQ,EAAE,CAAC,CAAC,EACZ,SAAS,EAAE,EAAE,CAAC,8BAA8B,EAAE,SAAS,CAAC,YAEvD,QAAQ,GACJ,CACR,CAAC;AACJ,CAAC"}

package/dist/styles/theme.css

@@ -40,6 +40,8 @@
   --color-ring: var(--ring);
   --color-edge: var(--edge);
   --color-edge-selected: var(--edge-selected);
+  --color-canvas-mark: var(--canvas-mark);
+  --color-canvas-mark-halo: var(--canvas-mark-halo);
   --color-destructive: var(--destructive);
   --color-destructive-foreground: var(--destructive-foreground);
   --color-destructive-subtle: var(--destructive-subtle);

package/dist/styles/tokens.css

@@ -54,6 +54,7 @@
   --sidebar-width-aaa: 256px;
   --sidebar-width-collapsed-aa: 56px;
   --sidebar-width-collapsed-aaa: 72px;
+  --tree-indent: 16px;
   --rail-width-aa: 72px;
   --rail-width-aaa: 88px;
   --subnav-width-aa: 224px;
@@ -154,6 +155,8 @@
   --ring: var(--brand);
   --edge: var(--input);
   --edge-selected: var(--brand);
+  --canvas-mark: #22369f;
+  --canvas-mark-halo: #ffffff;
   --destructive: #bf2a2a;
   --destructive-foreground: #ffffff;
   --destructive-subtle: #fdecec;
@@ -197,6 +200,8 @@
   --ring: var(--brand);
   --edge: var(--input);
   --edge-selected: var(--brand);
+  --canvas-mark: #22369f;
+  --canvas-mark-halo: #ffffff;
   --destructive: #f47a70;
   --destructive-foreground: #0e1116;
   --destructive-subtle: #3a1616;
@@ -240,6 +245,8 @@
   --ring: var(--brand);
   --edge: var(--input);
   --edge-selected: var(--brand);
+  --canvas-mark: #22369f;
+  --canvas-mark-halo: #ffffff;
   --destructive: #8c1818;
   --destructive-foreground: #ffffff;
   --destructive-subtle: #fbe7e7;
@@ -283,6 +290,8 @@
   --ring: var(--brand);
   --edge: var(--input);
   --edge-selected: var(--brand);
+  --canvas-mark: #22369f;
+  --canvas-mark-halo: #ffffff;
   --destructive: #ffa39b;
   --destructive-foreground: #07090c;
   --destructive-subtle: #3a1313;

package/dist/testing/index.d.ts

@@ -126,6 +126,7 @@ export interface ScreenshotPage extends Evaluates {
         };
         animations?: 'disabled' | 'allow';
         caret?: 'hide' | 'initial';
+        scale?: 'css' | 'device';
     }): Promise<Uint8Array>;
 }
 export interface InvisibleFocus {
@@ -157,6 +158,59 @@ export interface FocusVisibleOptions {
 export declare function findInvisibleFocus(page: ScreenshotPage, options?: FocusVisibleOptions): Promise<InvisibleFocus[]>;
 /** Throws, listing every control whose focus cannot be seen, unless there are none. `trapped` ones are skipped. */
 export declare function expectFocusVisible(page: ScreenshotPage, options?: FocusVisibleOptions): Promise<void>;
+export interface WeakFocus {
+    element: string;
+    /** CSS px² of the indicator whose colour changed by at least 3:1 when the control took focus. */
+    area: number;
+    /**
+     * CSS px² the indicator needs: a 2 CSS px thick perimeter of the unfocused component, 4h + 4w − (16 − 4π)r for a
+     * rectangle with corner radius r (W3C's Understanding 2.4.13, read on 9 October 2026).
+     */
+    needed: number;
+}
+/**
+ * Focus appearance (WCAG 2.4.13, AAA): for every control a keyboard can reach, the pixels that change colour by at
+ * least 3:1 when it takes focus must cover at least the area of a 2 CSS px thick perimeter of the unfocused
+ * component: 4h + 4w − (16 − 4π)r CSS px² for a rectangle with corner radius r (W3C's formulas, read on 9 October
+ * 2026). The component is its visible presentation, which W3C gauges by the indicator itself: the part whose outline
+ * or box shadow changes on focus (a three-layer control's paint), or the control when none does. Screenshots are
+ * taken at CSS scale, with
+ * focus away and then on the control, as `findInvisibleFocus` takes them. Controls the browser draws the indicator
+ * for and the author hasn't touched are exempt in WCAG, and aren't told apart here.
+ */
+export declare function findWeakFocusIndicators(page: ScreenshotPage, options?: FocusVisibleOptions): Promise<WeakFocus[]>;
+/** Throws, listing every control whose focus indicator is too small or too faint for 2.4.13, unless there are none. */
+export declare function expectFocusAppearance(page: ScreenshotPage, options?: FocusVisibleOptions): Promise<void>;
+export interface ObscuredFocus {
+    element: string;
+    /** How much of it other content covered, of the points sampled across it: 1 is all of it. */
+    covered: number;
+}
+export interface FocusObscuredOptions {
+    /** `aa`: fails a control that's entirely hidden (2.4.11). `aaa`: fails one that's hidden at all (2.4.12). */
+    level?: 'aa' | 'aaa';
+    /** How many Tab presses to follow. Default 80. */
+    stops?: number;
+}
+/**
+ * Focus not obscured (WCAG 2.4.11 at AA, 2.4.12 at AAA): presses Tab, and at each stop samples a grid of points
+ * across the focused control. A point is covered when what's on top there is neither the control, something inside
+ * it, nor something it's inside. At AA a control fails when every point is covered; at AAA when any is. A visually
+ * hidden input is measured by the control around it, and only the part of a control that's in view is sampled:
+ * what the window or a scroll container cuts off isn't covered by other content. Elements with
+ * `pointer-events: none` can't be seen by the sampling, so a covering layer that lets clicks through goes unnoticed.
+ */
+export declare function findObscuredFocus(page: Evaluates & {
+    keyboard: {
+        press(key: string): Promise<void>;
+    };
+}, options?: FocusObscuredOptions): Promise<ObscuredFocus[]>;
+/** Throws, listing every tab stop whose focused control is hidden by other content, unless there are none. */
+export declare function expectFocusNotObscured(page: Evaluates & {
+    keyboard: {
+        press(key: string): Promise<void>;
+    };
+}, options?: FocusObscuredOptions): Promise<void>;
 export interface LinkFinding {
     /** The link, described as `tag "text"`. */
     element: string;

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;IACzD,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,UAAqB,GAAG,kBAAkB,EAAE,CAmE5F;AAED,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,UAAqB,GAAG,oBAAoB,EAAE,CAkG7F;AAED,kDAAkD;AAClD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,kBAAkB,EAAE,CAAC;IAClC,qBAAqB,EAAE,oBAAoB,EAAE,CAAC;CAC/C;AAED,mCAAmC;AACnC,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAUlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB/E;AAMD,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,0FAA0F;IAC1F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,UAAqB,GAC1B,aAAa,EAAE,CA4DjB;AAED,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,UAAqB,GAAG,cAAc,EAAE,CA+EpF;AAED,uGAAuG;AACvG,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAcf;AAID,sFAAsF;AACtF,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,EAAE;QAAE,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAChD,UAAU,CAAC,OAAO,EAAE;QAClB,IAAI,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9D,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC5B,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,cAAc,EAAE,CAAC,CA0L3B;AAED,mHAAmH;AACnH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAaf;AAID,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,MAAM,EAAE,aAAa,GAAG,cAAc,CAAC;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,GAAE,WAAgB,EACzB,IAAI,GAAE,UAAqB,GAC1B,WAAW,EAAE,CAuGf;AAED,yGAAyG;AACzG,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAaf;AAID,wFAAwF;AACxF,MAAM,WAAW,SAAU,SAAQ,SAAS;IAC1C,KAAK,EAAE;QAAE,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;CACtD;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,MAAM,GACN,MAAM,GACN,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IACvD,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,mGAAmG;IACnG,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAQD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,aAAa,EAAE,CAAC,CAoJ1B;AAED,wFAAwF;AACxF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAYf;AAID,MAAM,WAAW,YAAY;IAC3B,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,mBAAwB,EACjC,IAAI,GAAE,UAAqB,GAC1B,YAAY,EAAE,CA8EhB;AAED,+GAA+G;AAC/G,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,IAAI,CAAC,CAaf;AAID,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,4GAA4G;IAC5G,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,kBAAkB;IACjC,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,OAAO,GAAE,kBAAuB,EAChC,IAAI,GAAE,UAAqB,GAC1B,WAAW,EAAE,CA6Ef;AAED,wGAAwG;AACxG,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAYf;AAID,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,oGAAoG;IACpG,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,6GAA6G;IAC7G,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,gBAAqB,EAC9B,IAAI,GAAE,UAAqB,GAC1B,gBAAgB,EAAE,CAgEpB;AAED,uGAAuG;AACvG,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAYf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.js

@@ -404,6 +404,21 @@ export async function expectTargetsSized(page, options = {}) {
  * This is the check that finds a ring styled on an element that never receives focus.
  */
 export async function findInvisibleFocus(page, options = {}) {
+    const out = [];
+    await probeFocus(page, options, async ({ box, away, here }) => {
+        if (!box || !away || !here)
+            return;
+        const same = away.length === here.length && away.every((byte, k) => byte === here[k]);
+        if (same)
+            out.push({ element: box.described, reason: 'unchanged' });
+    }, (finding) => out.push(finding));
+    return out;
+}
+/**
+ * Focuses every control a keyboard can reach, one at a time, with focus moved away first, and hands `compare` a
+ * screenshot of it (and `pad` px around it) without focus and with it. Shared by the focus checks.
+ */
+async function probeFocus(page, options, compare, skipped) {
     const pad = options.pad ?? 8;
     const count = await page.evaluate((ignore) => {
         const style = document.createElement('style');
@@ -436,7 +451,6 @@ export async function findInvisibleFocus(page, options = {}) {
     // Keyboard modality, for React Aria's data-focus-visible and the browser's :focus-visible. (React Aria
     // ignores Shift and the other modifiers, so it has to be a real key.)
     await page.keyboard.press('Tab');
-    const out = [];
     for (let i = 0; i < count; i++) {
         // 1. Put focus on another control, far from this one, and measure this one where it now sits.
         const box = await page.evaluate(async (args) => {
@@ -461,9 +475,38 @@ export async function findInvisibleFocus(page, options = {}) {
                         shown = p;
                         break;
                     }
+            // The component, as 2.4.13 measures it: its visible presentation, which the focus indicator follows (W3C's
+            // Understanding page uses the indicator itself as the gauge). That's the first part, the control or something
+            // inside it, whose outline or box shadow changes when it takes focus; the control itself if none does.
+            const parts = [shown, ...shown.querySelectorAll('*')].slice(0, 60);
+            // Unfocused first: the first control has focus from the Tab that set keyboard modality.
+            if (shown.contains(document.activeElement)) {
+                document.activeElement.blur();
+                await frames();
+            }
+            const ring = (e) => [undefined, '::before', '::after'].map((pseudo) => {
+                const st = getComputedStyle(e, pseudo);
+                // An outline that isn't drawn has a width and colour that mean nothing.
+                const outline = st.outlineStyle === 'none'
+                    ? 'none'
+                    : `${st.outlineStyle} ${st.outlineWidth} ${st.outlineColor}`;
+                return `${outline}|${st.boxShadow}`;
+            });
+            const unfocused = parts.map(ring);
             // Where it is when focused (a skip link only appears then) and when not: compare the union of both.
             el.focus({ preventScroll: true });
             await frames();
+            let bearer = shown;
+            let bearerPseudo;
+            find: for (const [k, part] of parts.entries()) {
+                const now = ring(part);
+                for (const [j, pseudo] of [undefined, '::before', '::after'].entries())
+                    if (now[j] !== unfocused[k][j]) {
+                        bearer = part;
+                        bearerPseudo = pseudo;
+                        break find;
+                    }
+            }
             const r1 = shown.getBoundingClientRect();
             const clip = {
                 left: r1.left - args.pad,
@@ -543,20 +586,41 @@ export async function findInvisibleFocus(page, options = {}) {
                 height,
                 trapped: !away,
                 described: `${el.tagName.toLowerCase()}${role ? `[role=${role}]` : ''}${name ? ` "${name}"` : ''}`,
+                own: (() => {
+                    const b = bearer.getBoundingClientRect();
+                    const st = getComputedStyle(bearer, bearerPseudo);
+                    const corners = [
+                        st.borderTopLeftRadius,
+                        st.borderTopRightRadius,
+                        st.borderBottomLeftRadius,
+                        st.borderBottomRightRadius,
+                    ].map((v) => parseFloat(v) || 0);
+                    return {
+                        width: b.width,
+                        height: b.height,
+                        radius: Math.min(Math.min(...corners), b.width / 2, b.height / 2),
+                    };
+                })(),
             };
         }, { i, pad });
         if (!box)
             continue;
         if (box.trapped) {
-            out.push({ element: box.described, reason: 'trapped' });
+            skipped({ element: box.described, reason: 'trapped' });
             continue;
         }
         if (box.width < 1 || box.height < 1) {
-            out.push({ element: box.described, reason: 'offscreen' });
+            skipped({ element: box.described, reason: 'offscreen' });
             continue;
         }
         const clip = { x: box.x, y: box.y, width: box.width, height: box.height };
-        const away = await page.screenshot({ clip, animations: 'disabled', caret: 'hide' });
+        const shoot = () => page.screenshot({
+            clip,
+            animations: 'disabled',
+            caret: 'hide',
+            ...(options.scale ? { scale: options.scale } : {}),
+        });
+        const away = await shoot();
         // 2. Focus this one. If it hands focus to something inside it (a grid to its first row), that element is
         //    probed on its own turn.
         const kept = await page.evaluate(async (n) => {
@@ -569,10 +633,8 @@ export async function findInvisibleFocus(page, options = {}) {
         }, i);
         if (!kept)
             continue;
-        const here = await page.screenshot({ clip, animations: 'disabled', caret: 'hide' });
-        const same = away.length === here.length && away.every((byte, k) => byte === here[k]);
-        if (same)
-            out.push({ element: box.described, reason: 'unchanged' });
+        const here = await shoot();
+        await compare({ box, away, here });
     }
     await page.evaluate(() => {
         document.querySelector('style[data-setsquare-focus-probe-style]')?.remove();
@@ -581,7 +643,6 @@ export async function findInvisibleFocus(page, options = {}) {
             el.removeAttribute('data-setsquare-focus-skip');
         }
     }, undefined);
-    return out;
 }
 /** Throws, listing every control whose focus cannot be seen, unless there are none. `trapped` ones are skipped. */
 export async function expectFocusVisible(page, options = {}) {
@@ -595,6 +656,182 @@ export async function expectFocusVisible(page, options = {}) {
             : `  ${f.element}: took focus but could not be seen`),
     ].join('\n'));
 }
+/** A PNG's pixels, decoded by the page itself (no image library): RGBA, row by row. */
+const decodeInPage = (page, shots) => {
+    const base64 = (bytes) => {
+        let text = '';
+        for (let i = 0; i < bytes.length; i += 0x8000)
+            text += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+        return btoa(text);
+    };
+    return page.evaluate(async (pngs) => {
+        const decode = async (b64) => {
+            const blob = await (await fetch(`data:image/png;base64,${b64}`)).blob();
+            const bitmap = await createImageBitmap(blob);
+            const canvas = new OffscreenCanvas(bitmap.width, bitmap.height);
+            const ctx = canvas.getContext('2d');
+            ctx.drawImage(bitmap, 0, 0);
+            return {
+                width: bitmap.width,
+                height: bitmap.height,
+                data: [...ctx.getImageData(0, 0, bitmap.width, bitmap.height).data],
+            };
+        };
+        const [a, b] = await Promise.all(pngs.map(decode));
+        // Count the pixels whose colour changed by at least 3:1 between the two states.
+        const lum = (r, g, bl) => {
+            const c = [r, g, bl].map((v) => {
+                const s = v / 255;
+                return s <= 0.04045 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+            });
+            return 0.2126 * c[0] + 0.7152 * c[1] + 0.0722 * c[2];
+        };
+        if (!a || !b || a.width !== b.width || a.height !== b.height)
+            return 0;
+        let changed = 0;
+        for (let k = 0; k < a.data.length; k += 4) {
+            const la = lum(a.data[k], a.data[k + 1], a.data[k + 2]);
+            const lb = lum(b.data[k], b.data[k + 1], b.data[k + 2]);
+            const [hi, lo] = la > lb ? [la, lb] : [lb, la];
+            if ((hi + 0.05) / (lo + 0.05) >= 3)
+                changed++;
+        }
+        return changed;
+    }, shots.map(base64));
+};
+/**
+ * Focus appearance (WCAG 2.4.13, AAA): for every control a keyboard can reach, the pixels that change colour by at
+ * least 3:1 when it takes focus must cover at least the area of a 2 CSS px thick perimeter of the unfocused
+ * component: 4h + 4w − (16 − 4π)r CSS px² for a rectangle with corner radius r (W3C's formulas, read on 9 October
+ * 2026). The component is its visible presentation, which W3C gauges by the indicator itself: the part whose outline
+ * or box shadow changes on focus (a three-layer control's paint), or the control when none does. Screenshots are
+ * taken at CSS scale, with
+ * focus away and then on the control, as `findInvisibleFocus` takes them. Controls the browser draws the indicator
+ * for and the author hasn't touched are exempt in WCAG, and aren't told apart here.
+ */
+export async function findWeakFocusIndicators(page, options = {}) {
+    const out = [];
+    await probeFocus(page, { ...options, scale: 'css' }, async ({ box, away, here }) => {
+        // W3C's area for a 2 CSS px perimeter of a rounded rectangle: 4h + 4w − (16 − 4π)r (a rectangle when r is 0).
+        const { width: w, height: h, radius: r } = box.own;
+        const needed = Math.round(4 * (w + h) - (16 - 4 * Math.PI) * r);
+        const area = await decodeInPage(page, [away, here]);
+        if (area < needed)
+            out.push({ element: box.described, area, needed });
+    }, () => { });
+    return out;
+}
+/** Throws, listing every control whose focus indicator is too small or too faint for 2.4.13, unless there are none. */
+export async function expectFocusAppearance(page, options = {}) {
+    const found = await findWeakFocusIndicators(page, options);
+    if (!found.length)
+        return;
+    throw new Error([
+        `The focus indicator is too small or too faint on ${found.length} control${found.length === 1 ? '' : 's'} (2.4.13):`,
+        ...found.map((f) => `  ${f.element}: ${f.area} CSS px² changed by 3:1, ${f.needed} needed`),
+    ].join('\n'));
+}
+/**
+ * Focus not obscured (WCAG 2.4.11 at AA, 2.4.12 at AAA): presses Tab, and at each stop samples a grid of points
+ * across the focused control. A point is covered when what's on top there is neither the control, something inside
+ * it, nor something it's inside. At AA a control fails when every point is covered; at AAA when any is. A visually
+ * hidden input is measured by the control around it, and only the part of a control that's in view is sampled:
+ * what the window or a scroll container cuts off isn't covered by other content. Elements with
+ * `pointer-events: none` can't be seen by the sampling, so a covering layer that lets clicks through goes unnoticed.
+ */
+export async function findObscuredFocus(page, options = {}) {
+    const level = options.level ?? 'aa';
+    const out = [];
+    const seen = new Set();
+    for (let i = 0; i < (options.stops ?? 80); i++) {
+        await page.keyboard.press('Tab');
+        const found = await page.evaluate(async () => {
+            await new Promise((r) => requestAnimationFrame(() => requestAnimationFrame(r)));
+            let el = document.activeElement;
+            // Into a same-origin frame: the frame's own focused element is what's focused.
+            while (el?.tagName === 'IFRAME') {
+                const inner = el.contentDocument
+                    ?.activeElement;
+                if (!inner || inner === inner.ownerDocument.body)
+                    break;
+                el = inner;
+            }
+            if (!el || el === document.body)
+                return null;
+            const doc = el.ownerDocument;
+            // A visually hidden input (React Aria's switch, checkbox, radio) stands for the control around it.
+            const tiny = (e) => {
+                const b = e.getBoundingClientRect();
+                return b.width <= 2 || b.height <= 2;
+            };
+            let shown = el;
+            while (tiny(shown) && shown.parentElement)
+                shown = shown.parentElement;
+            // Only the part that's in view: what a scroll container or the window cuts off isn't covered by anything,
+            // and a control larger than its scroller can't be shown whole.
+            const r0 = shown.getBoundingClientRect();
+            const r = { left: r0.left, top: r0.top, right: r0.right, bottom: r0.bottom };
+            const view = doc.defaultView;
+            r.left = Math.max(r.left, 0);
+            r.top = Math.max(r.top, 0);
+            r.right = Math.min(r.right, view.innerWidth);
+            r.bottom = Math.min(r.bottom, view.innerHeight);
+            for (let p = shown.parentElement; p; p = p.parentElement) {
+                const cs = view.getComputedStyle(p);
+                if (cs.overflowX === 'visible' && cs.overflowY === 'visible')
+                    continue;
+                const c = p.getBoundingClientRect();
+                r.left = Math.max(r.left, c.left);
+                r.top = Math.max(r.top, c.top);
+                r.right = Math.min(r.right, c.right);
+                r.bottom = Math.min(r.bottom, c.bottom);
+            }
+            const width = r.right - r.left;
+            const height = r.bottom - r.top;
+            if (width < 1 || height < 1)
+                return null;
+            let total = 0;
+            let covered = 0;
+            for (let gx = 1; gx <= 5; gx++)
+                for (let gy = 1; gy <= 3; gy++) {
+                    const x = r.left + (width * gx) / 6;
+                    const y = r.top + (height * gy) / 4;
+                    total++;
+                    const top = doc.elementFromPoint(x, y);
+                    if (!top || !(shown.contains(top) || top.contains(shown)))
+                        covered++;
+                }
+            const role = el.getAttribute('role');
+            const name = (el.getAttribute('aria-label') ?? el.textContent ?? '')
+                .trim()
+                .replace(/\s+/g, ' ')
+                .slice(0, 40);
+            return {
+                key: `${el.tagName}|${el.id}|${name}|${Math.round(r0.left)}|${Math.round(r0.top)}`,
+                element: `${el.tagName.toLowerCase()}${role ? `[role=${role}]` : ''}${name ? ` "${name}"` : ''}`,
+                covered: covered / total,
+            };
+        }, undefined);
+        if (!found)
+            continue;
+        if (seen.has(found.key))
+            break;
+        seen.add(found.key);
+        if (level === 'aa' ? found.covered >= 1 : found.covered > 0)
+            out.push({ element: found.element, covered: Math.round(found.covered * 100) / 100 });
+    }
+    return out;
+}
+/** Throws, listing every tab stop whose focused control is hidden by other content, unless there are none. */
+export async function expectFocusNotObscured(page, options = {}) {
+    const found = await findObscuredFocus(page, options);
+    if (!found.length)
+        return;
+    throw new Error([
+        `Focus is hidden by other content on ${found.length} control${found.length === 1 ? '' : 's'}:`,
+        ...found.map((f) => `  ${f.element}: ${Math.round(f.covered * 100)}% covered`),
+    ].join('\n'));
+}
 /**
  * Every link in running text that people who can't tell the colours apart could not find. A link counts as
  * in running text when it is laid out inline and the block around it has words of its own — so navigation,