cursedbelt 5.68.0 → 5.69.0

package/dist/styles-areas/core.css

@@ -15,7 +15,7 @@
  * after an app's responsive variant (task 2124). An app that imports every area gets exactly
  * what `cursedbelt/styles-utilities.css` emits — proved rule by rule in
  * src/stylesAreas.spec.ts, which is also what fails when this file is stale.
- * 903 candidate(s).
+ * 905 candidate(s).
  *
  * Written by scripts/generateAreaStyles.ts (`bun run styles:areas`), which
  * `bun run build` runs. The map of what is in which area, and why the areas are
@@ -24,9 +24,9 @@
 @source inline("*:border-l *:border-rule *:px-[calc(var(--col-gap)/2)] -bottom-1.5 -bottom-px -left-1.5 -left-px");
 @source inline("-mb-px -ml-1 -ml-2 -ml-3 -ml-4 -ml-[calc(var(--col-gap)/2+1px)] -mr-[calc(var(--col-gap)/2)]");
 @source inline("-right-1.5 -right-px -rotate-90 -top-1.5 -top-px -translate-x-1/2 -translate-y-1/2 @container");
-@source inline("@xl:grid-cols-2 [&>*]:w-full [&>:first-child]:min-w-0 [&>:first-child]:shrink-0");
-@source inline("[&>:first-child]:w-[var(--cb-sidebar-side)] [&>:last-child]:flex-1 [&>:last-child]:min-w-0");
-@source inline("[&>button:first-child]:rounded-l-md [&>button:focus-visible]:relative");
+@source inline("@xl:grid-cols-2 [&>*>button]:w-full [&>*]:w-full [&>:first-child]:min-w-0");
+@source inline("[&>:first-child]:shrink-0 [&>:first-child]:w-[var(--cb-sidebar-side)] [&>:last-child]:flex-1");
+@source inline("[&>:last-child]:min-w-0 [&>button:first-child]:rounded-l-md [&>button:focus-visible]:relative");
 @source inline("[&>button:focus-visible]:z-10 [&>button:hover]:relative [&>button:hover]:z-10");
 @source inline("[&>button:last-child]:rounded-r-md [&>button:not(:first-child)]:-ml-px");
 @source inline("[&>button:not(:first-child)]:border-border [&>button:not(:first-child)]:border-l");
@@ -38,31 +38,30 @@
 @source inline("[&_[data-icon]]:text-accent [&_[data-icon]]:text-destructive [&_[data-icon]]:text-success");
 @source inline("[&_[data-icon]]:text-warning [&_sup]:leading-none [&_svg]:shrink-0 [&_svg]:size-12");
 @source inline("[&_svg]:size-4 [&_svg]:size-5 [&_svg]:size-6 [--cbfk-sticky-top:-1rem]");
-@source inline("[-webkit-touch-callout:none] [overflow-clip-margin:calc(var(--spacing)*1)] a absolute act active");
-@source inline("active:bg-accent active:scale-100 active:scale-[var(--press-scale)]");
-@source inline("active:scale-[var(--press-scale-surface)] alert alert-icon align align-middle an animate");
-@source inline("animate-in animate-progress-indeterminate animate-pulse animate-spin aria");
-@source inline("aria-[invalid=true]:border-field-error aria-[invalid=true]:ring-field-error/30 aria-disabled");
-@source inline("aria-disabled:active:scale-100 aria-disabled:cursor-not-allowed");
+@source inline("[-webkit-touch-callout:none] a absolute act active active:bg-accent active:scale-100");
+@source inline("active:scale-[var(--press-scale)] active:scale-[var(--press-scale-surface)] alert alert-icon");
+@source inline("align align-middle an animate animate-in animate-progress-indeterminate animate-pulse");
+@source inline("animate-spin aria aria-[invalid=true]:border-field-error aria-[invalid=true]:ring-field-error/30");
+@source inline("aria-disabled aria-disabled:active:scale-100 aria-disabled:cursor-not-allowed");
 @source inline("aria-disabled:hover:bg-transparent aria-disabled:opacity-30 aria-disabled:opacity-50");
 @source inline("aria-disabled:pointer-events-none aria-pressed aria-pressed:bg-accent/10 aria-pressed:border");
-@source inline("aria-pressed:border-accent aria-pressed:text-accent auto auto-cols-fr b back backdrop");
-@source inline("backdrop-blur backdrop-blur-md backdrop-blur-sm bg bg-accent bg-accent-solid bg-accent/10");
-@source inline("bg-accent/5 bg-background bg-background/80 bg-background/90 bg-background/95 bg-black/50");
-@source inline("bg-border bg-border-strong bg-card bg-card-raised bg-current bg-destructive bg-destructive-solid");
-@source inline("bg-destructive/15 bg-destructive/5 bg-destructive/8 bg-emerald-100 bg-field-bg bg-foreground/70");
-@source inline("bg-muted bg-muted-foreground bg-muted-foreground/40 bg-muted-foreground/50");
-@source inline("bg-muted-foreground/60 bg-muted/20 bg-muted/40 bg-popover bg-popover! bg-success");
-@source inline("bg-success-solid bg-success/15 bg-success/5 bg-surface bg-surface-sunken bg-tone-amber-bg");
-@source inline("bg-tone-amber-fg bg-tone-cyan-bg bg-tone-cyan-fg bg-tone-emerald-bg bg-tone-emerald-fg");
-@source inline("bg-tone-fuchsia-bg bg-tone-fuchsia-fg bg-tone-lime-bg bg-tone-lime-fg bg-tone-orange-bg");
-@source inline("bg-tone-orange-fg bg-tone-purple-bg bg-tone-purple-fg bg-tone-rose-bg bg-tone-rose-fg");
-@source inline("bg-tone-sky-bg bg-tone-sky-fg bg-tone-slate-bg bg-tone-slate-fg bg-tone-teal-bg bg-tone-teal-fg");
-@source inline("bg-tone-violet-bg bg-tone-violet-fg bg-transparent bg-warning bg-warning/15 bg-warning/5");
-@source inline("bg-warning/8 bg-white block blur border border-0 border-accent border-accent/40 border-accent/50");
-@source inline("border-b border-b-0 border-b-2 border-b-[length:var(--status-glyph-h)] border-b-current");
-@source inline("border-border border-border! border-border-strong border-border/60 border-collapse");
-@source inline("border-current border-destructive/30 border-destructive/40 border-destructive/50");
+@source inline("aria-pressed:border-accent aria-pressed:text-accent auto auto-cols-[minmax(min-content,1fr)] b");
+@source inline("back backdrop backdrop-blur backdrop-blur-md backdrop-blur-sm bg bg-accent bg-accent-solid");
+@source inline("bg-accent/10 bg-accent/5 bg-background bg-background/80 bg-background/90 bg-background/95");
+@source inline("bg-black/50 bg-border bg-border-strong bg-card bg-card-raised bg-current bg-destructive");
+@source inline("bg-destructive-solid bg-destructive/15 bg-destructive/5 bg-destructive/8 bg-emerald-100");
+@source inline("bg-field-bg bg-foreground/70 bg-muted bg-muted-foreground bg-muted-foreground/40");
+@source inline("bg-muted-foreground/50 bg-muted-foreground/60 bg-muted/20 bg-muted/40 bg-popover bg-popover!");
+@source inline("bg-success bg-success-solid bg-success/15 bg-success/5 bg-surface bg-surface-sunken");
+@source inline("bg-tone-amber-bg bg-tone-amber-fg bg-tone-cyan-bg bg-tone-cyan-fg bg-tone-emerald-bg");
+@source inline("bg-tone-emerald-fg bg-tone-fuchsia-bg bg-tone-fuchsia-fg bg-tone-lime-bg bg-tone-lime-fg");
+@source inline("bg-tone-orange-bg bg-tone-orange-fg bg-tone-purple-bg bg-tone-purple-fg bg-tone-rose-bg");
+@source inline("bg-tone-rose-fg bg-tone-sky-bg bg-tone-sky-fg bg-tone-slate-bg bg-tone-slate-fg bg-tone-teal-bg");
+@source inline("bg-tone-teal-fg bg-tone-violet-bg bg-tone-violet-fg bg-transparent bg-warning bg-warning/15");
+@source inline("bg-warning/5 bg-warning/8 bg-white block blur border border-0 border-accent border-accent/40");
+@source inline("border-accent/50 border-b border-b-0 border-b-2 border-b-[length:var(--status-glyph-h)]");
+@source inline("border-b-current border-border border-border! border-border-strong border-border/60");
+@source inline("border-collapse border-current border-destructive/30 border-destructive/40 border-destructive/50");
 @source inline("border-field-border border-rule border-success/30 border-success/40 border-success/50 border-t");
 @source inline("border-tone-sky-fg/30 border-tone-slate-fg/30 border-transparent border-warning/30");
 @source inline("border-warning/40 border-warning/50 border-x-4 border-x-transparent bot bottom bottom-0 break");
@@ -120,7 +119,7 @@
 @source inline("group-data-[state=open]:rotate-90 group-focus-visible/sep:opacity-100 group-hover");
 @source inline("group-hover/path:opacity-100 group-hover/sep:opacity-100 group-hover:opacity-100 group/path");
 @source inline("group/properties group/sep grow h h-0.5 h-1 h-1.5 h-10 h-14 h-16 h-2 h-2.5 h-24 h-3 h-32 h-4 h-5");
-@source inline("h-6 h-7 h-8 h-9 h-[calc(100dvh-…)] h-[min(var(--region-h-lg),var(--region-h-phone))]");
+@source inline("h-6 h-7 h-8 h-9 h-[min(var(--region-h-lg),var(--region-h-phone))]");
 @source inline("h-[min(var(--region-h-md),var(--region-h-phone))]");
 @source inline("h-[min(var(--region-h-sm),var(--region-h-phone))] h-[var(--control-h-lg)]");
 @source inline("h-[var(--control-h-md)] h-[var(--control-h-sm)] h-[var(--indicator-w)] h-auto h-full h-px hi hid");
@@ -172,17 +171,19 @@
 @source inline("sm:max-w-[var(--modal-w-lg)] sm:max-w-[var(--modal-w-md)] sm:max-w-[var(--modal-w-sm)] sm:p-4");
 @source inline("sm:p-5 sm:p-8 sm:pointer-fine:text-sm sm:px-6 sm:rounded-xl sm:text-sm sm:top-1/2");
 @source inline("sm:w-[calc(100vw-2rem)] space space-y-1 space-y-3 sr-only stat static sticky stroke");
-@source inline("stroke-accent-solid stroke-destructive stroke-muted stroke-warning t ta tab table tabular");
-@source inline("tabular-nums text text-2xl text-[length:var(--text-glyph-relative)] text-[var(--foreground)]");
-@source inline("text-[var(--muted-foreground)] text-accent text-accent-strong text-base text-caption text-center");
-@source inline("text-current text-data text-destructive text-destructive-foreground text-destructive-strong");
-@source inline("text-emerald-700 text-field-error text-field-fg text-foreground text-h1 text-h3 text-inherit");
-@source inline("text-left text-lg text-meta text-muted-foreground text-muted-foreground! text-popover-foreground");
-@source inline("text-right text-sm text-success-strong text-tone-amber-fg text-tone-cyan-fg text-tone-emerald-fg");
-@source inline("text-tone-fuchsia-fg text-tone-lime-fg text-tone-orange-fg text-tone-purple-fg text-tone-rose-fg");
-@source inline("text-tone-sky-fg text-tone-slate-fg text-tone-teal-fg text-tone-violet-fg text-warning");
-@source inline("text-warning-strong text-white text-xs to top top-0 top-1/2 top-2 touch touch-manipulation");
-@source inline("touch-none track tracking tracking-tight tracking-wide tracking-wider transform transition");
+@source inline("stroke-accent-solid stroke-destructive stroke-muted stroke-warning support supports");
+@source inline("supports-[overflow-clip-margin:1px]:[overflow-clip-margin:calc(var(--spacing)*1)] t ta tab table");
+@source inline("tabular tabular-nums text text-2xl text-[length:var(--text-glyph-relative)]");
+@source inline("text-[var(--foreground)] text-[var(--muted-foreground)] text-accent text-accent-strong text-base");
+@source inline("text-caption text-center text-current text-data text-destructive text-destructive-foreground");
+@source inline("text-destructive-strong text-emerald-700 text-field-error text-field-fg text-foreground text-h1");
+@source inline("text-h3 text-inherit text-left text-lg text-meta text-muted-foreground text-muted-foreground!");
+@source inline("text-popover-foreground text-right text-sm text-success-strong text-tone-amber-fg");
+@source inline("text-tone-cyan-fg text-tone-emerald-fg text-tone-fuchsia-fg text-tone-lime-fg");
+@source inline("text-tone-orange-fg text-tone-purple-fg text-tone-rose-fg text-tone-sky-fg text-tone-slate-fg");
+@source inline("text-tone-teal-fg text-tone-violet-fg text-warning text-warning-strong text-white text-xs to top");
+@source inline("top-0 top-1/2 top-2 touch touch-manipulation touch-none track tracking tracking-tight");
+@source inline("tracking-wide tracking-wider transform transition");
 @source inline("transition-[color,background-color,border-color,box-shadow,scale] transition-[stroke-dashoffset]");
 @source inline("transition-[transform,width] transition-[width] transition-all transition-colors");
 @source inline("transition-opacity transition-transform translate-x-1/2 translate-y-1/2 truncate under underline");

package/dist/styles-utilities.css

@@ -716,9 +716,6 @@
   .h-105 {
     height: calc(var(--spacing) * 105);
   }
-  .h-\[calc\(100dvh-…\)\] {
-    height: calc(100dvh - …);
-  }
   .h-\[min\(var\(--region-h-lg\)\,var\(--region-h-phone\)\)\] {
     height: min(var(--region-h-lg), var(--region-h-phone));
   }
@@ -1335,8 +1332,8 @@
   .appearance-none {
     appearance: none;
   }
-  .auto-cols-fr {
-    grid-auto-columns: minmax(0, 1fr);
+  .auto-cols-\[minmax\(min-content\,1fr\)\] {
+    grid-auto-columns: minmax(min-content,1fr);
   }
   .grid-flow-col {
     grid-auto-flow: column;
@@ -3485,9 +3482,6 @@
   .\[background\:var\(--cb-swatch-fill\,var\(--muted\)\)\] {
     background: var(--cb-swatch-fill,var(--muted));
   }
-  .\[overflow-clip-margin\:calc\(var\(--spacing\)\*1\)\] {
-    overflow-clip-margin: calc(var(--spacing) * 1);
-  }
   .fade-in {
     --tw-enter-opacity: 0;
   }
@@ -4453,6 +4447,11 @@
   .data-\[state\=unchecked\]\:bg-muted[data-state="unchecked"] {
     background-color: var(--muted);
   }
+  @supports (overflow-clip-margin:1px) {
+    .supports-\[overflow-clip-margin\:1px\]\:\[overflow-clip-margin\:calc\(var\(--spacing\)\*1\)\] {
+      overflow-clip-margin: calc(var(--spacing) * 1);
+    }
+  }
   @media (prefers-reduced-motion: reduce) {
     .motion-reduce\:animate-none {
       animation: none;
@@ -5346,6 +5345,9 @@
       display: none;
     }
   }
+  .\[\&\>\*\>button\]\:w-full > * > button {
+    width: 100%;
+  }
   .\[\&\>\:first-child\]\:w-\[var\(--cb-sidebar-side\)\] > :first-child {
     width: var(--cb-sidebar-side);
   }

package/dist/testing/appleDevices.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The Apple screens every app is held to (forge task apple-device-testing, 2026-10-06): the
+ * smallest iPhone still sold, today's common one and that one on its side, an iPad both ways,
+ * and the Mac's Safari — all in Playwright's WebKit, the engine Apple ships to every one of them.
+ *
+ * 🔴 WebKit, not Chromium in a phone's clothes. Each app's browser gate already audits at 390 and
+ * 1440 in Chromium (`designBaseline.ts`, REV-9); what this roster adds is the engine the owner's
+ * devices actually run, with a real touchscreen (`hasTouch`, so `(pointer: coarse)` applies and a
+ * tap is a tap, not a mouse) and the viewport Safari leaves once its own chrome has taken its share.
+ * On 2026-10-06 orbgem measured the gap this closes: Playwright's WebKit reported itself as 26.6
+ * while the Mac's Safari was 27.0.1 — close enough to find layout faults, and `safariRules.ts` is
+ * for the styles only the shipped release can rule on.
+ *
+ * No Playwright import, on purpose (see `designAudit.ts`'s header): the caller hands in
+ * Playwright's `devices` registry and gets back the options for `browser.newContext`.
+ */
+export type AppleDeviceKind = 'phone' | 'tablet' | 'desktop';
+export interface AppleDevice {
+    /** The name a report prints and a baseline label carries — Playwright's, so it is also the registry key. */
+    name: string;
+    /** `name`, as a file and label stem: `iphone-se-3rd-gen`. */
+    slug: string;
+    kind: AppleDeviceKind;
+    landscape: boolean;
+    /**
+     * The on-screen keyboard's height in CSS px when a field takes focus, suggestion row included,
+     * or `null` where the keyboard rule does not run: on its side (the keyboard covers nearly all
+     * of a landscape phone, and iOS scrolls the field itself) and on a desktop (a hardware keyboard).
+     */
+    keyboard: number | null;
+}
+export declare const KEYBOARD_PHONE = 336;
+export declare const KEYBOARD_TABLET = 408;
+/** The whole roster: what `bun run test:browser` walks. */
+export declare const APPLE_DEVICES: readonly AppleDevice[];
+/**
+ * The gate's subset — one of each kind, the strictest of each: the narrowest phone, the iPad in
+ * the orientation that shares the desktop's layout breakpoints, and the Mac. A gate has a budget
+ * (`$FORGE/tools/check-gate-time.ts`); the rest of the roster runs in the app's full browser suite.
+ */
+export declare const APPLE_GATE_DEVICES: readonly AppleDevice[];
+/** Finds a device by name or slug; throws naming the roster, so a typo fails loud. */
+export declare function appleDevice(nameOrSlug: string): AppleDevice;
+/** The slice of a Playwright device descriptor a context is made from. */
+export interface DeviceDescriptorLike {
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    userAgent?: string;
+    deviceScaleFactor?: number;
+    isMobile?: boolean;
+    hasTouch?: boolean;
+    defaultBrowserType?: string;
+}
+/** The laptop REV-2 names (1440×900), in place of Playwright's 1280×720 for 'Desktop Safari'. */
+export declare const DESKTOP_SAFARI_VIEWPORT: {
+    readonly width: 1440;
+    readonly height: 900;
+};
+/**
+ * `browser.newContext` options for `device`, from Playwright's registry (`import { devices } from
+ * 'playwright'`). The desktop takes the review protocol's laptop size; everything else is the
+ * device's own screen, scale and touch. Throws when the registry lacks the device — a Playwright
+ * too old to know it would otherwise open a bare desktop window and call it an iPhone.
+ */
+export declare function appleContext<T extends DeviceDescriptorLike>(registry: Record<string, T>, device: AppleDevice): T;
+//# sourceMappingURL=appleDevices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appleDevices.d.ts","sourceRoot":"","sources":["../../src/testing/appleDevices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,WAAW;IAC1B,4GAA4G;IAC5G,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,eAAe,MAAM,CAAC;AAWnC,2DAA2D;AAC3D,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAO/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,WAAW,EAEpD,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAI3D;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,iGAAiG;AACjG,eAAO,MAAM,uBAAuB;;;CAAwC,CAAC;AAE7E;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,oBAAoB,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,CAAC,CAKhH"}

package/dist/testing/appleDevices.js

@@ -0,0 +1,65 @@
+/**
+ * The Apple screens every app is held to (forge task apple-device-testing, 2026-10-06): the
+ * smallest iPhone still sold, today's common one and that one on its side, an iPad both ways,
+ * and the Mac's Safari — all in Playwright's WebKit, the engine Apple ships to every one of them.
+ *
+ * 🔴 WebKit, not Chromium in a phone's clothes. Each app's browser gate already audits at 390 and
+ * 1440 in Chromium (`designBaseline.ts`, REV-9); what this roster adds is the engine the owner's
+ * devices actually run, with a real touchscreen (`hasTouch`, so `(pointer: coarse)` applies and a
+ * tap is a tap, not a mouse) and the viewport Safari leaves once its own chrome has taken its share.
+ * On 2026-10-06 orbgem measured the gap this closes: Playwright's WebKit reported itself as 26.6
+ * while the Mac's Safari was 27.0.1 — close enough to find layout faults, and `safariRules.ts` is
+ * for the styles only the shipped release can rule on.
+ *
+ * No Playwright import, on purpose (see `designAudit.ts`'s header): the caller hands in
+ * Playwright's `devices` registry and gets back the options for `browser.newContext`.
+ */
+export const KEYBOARD_PHONE = 336;
+export const KEYBOARD_TABLET = 408;
+const slugOf = (name) => name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');
+const device = (name, kind, landscape, keyboard) => ({
+    name,
+    slug: slugOf(name),
+    kind,
+    landscape,
+    keyboard,
+});
+/** The whole roster: what `bun run test:browser` walks. */
+export const APPLE_DEVICES = [
+    device('iPhone SE (3rd gen)', 'phone', false, KEYBOARD_PHONE),
+    device('iPhone 17', 'phone', false, KEYBOARD_PHONE),
+    device('iPhone 17 landscape', 'phone', true, null),
+    device('iPad (gen 7)', 'tablet', false, KEYBOARD_TABLET),
+    device('iPad (gen 7) landscape', 'tablet', true, null),
+    device('Desktop Safari', 'desktop', false, null),
+];
+/**
+ * The gate's subset — one of each kind, the strictest of each: the narrowest phone, the iPad in
+ * the orientation that shares the desktop's layout breakpoints, and the Mac. A gate has a budget
+ * (`$FORGE/tools/check-gate-time.ts`); the rest of the roster runs in the app's full browser suite.
+ */
+export const APPLE_GATE_DEVICES = APPLE_DEVICES.filter((d) => ['iPhone SE (3rd gen)', 'iPad (gen 7) landscape', 'Desktop Safari'].includes(d.name));
+/** Finds a device by name or slug; throws naming the roster, so a typo fails loud. */
+export function appleDevice(nameOrSlug) {
+    const found = APPLE_DEVICES.find((d) => d.name === nameOrSlug || d.slug === nameOrSlug);
+    if (!found)
+        throw new Error(`no Apple device "${nameOrSlug}" — the roster: ${APPLE_DEVICES.map((d) => d.name).join(', ')}`);
+    return found;
+}
+/** The laptop REV-2 names (1440×900), in place of Playwright's 1280×720 for 'Desktop Safari'. */
+export const DESKTOP_SAFARI_VIEWPORT = { width: 1440, height: 900 };
+/**
+ * `browser.newContext` options for `device`, from Playwright's registry (`import { devices } from
+ * 'playwright'`). The desktop takes the review protocol's laptop size; everything else is the
+ * device's own screen, scale and touch. Throws when the registry lacks the device — a Playwright
+ * too old to know it would otherwise open a bare desktop window and call it an iPhone.
+ */
+export function appleContext(registry, device) {
+    const found = registry[device.name];
+    if (!found?.viewport)
+        throw new Error(`Playwright's devices registry has no "${device.name}" — upgrade playwright, or pick from: ${APPLE_DEVICES.map((d) => d.name).join(', ')}`);
+    if (device.kind === 'desktop')
+        return { ...found, viewport: { ...DESKTOP_SAFARI_VIEWPORT } };
+    return { ...found };
+}
+//# sourceMappingURL=appleDevices.js.map

package/dist/testing/appleDevices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appleDevices.js","sourceRoot":"","sources":["../../src/testing/appleDevices.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmBH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAEnC,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACtG,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,IAAqB,EAAE,SAAkB,EAAE,QAAuB,EAAe,EAAE,CAAC,CAAC;IACjH,IAAI;IACJ,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC;IAClB,IAAI;IACJ,SAAS;IACT,QAAQ;CACT,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,MAAM,CAAC,qBAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC;IAC7D,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,CAAC;IACnD,MAAM,CAAC,qBAAqB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC;IAClD,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC;IACxD,MAAM,CAAC,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC;IACtD,MAAM,CAAC,gBAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,CAAC;CACjD,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA2B,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnF,CAAC,qBAAqB,EAAE,wBAAwB,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CACrF,CAAC;AAEF,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,UAAkB;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACxF,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,UAAU,mBAAmB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5H,OAAO,KAAK,CAAC;AACf,CAAC;AAYD,iGAAiG;AACjG,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAW,CAAC;AAE7E;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAiC,QAA2B,EAAE,MAAmB;IAC3G,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,IAAI,yCAAyC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClL,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAG,uBAAuB,EAAE,EAAE,CAAC;IAC7F,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;AACtB,CAAC"}

package/dist/testing/appleWalk.d.ts

@@ -0,0 +1,72 @@
+import type { AppleDevice } from './appleDevices.js';
+import { type AuditDesignOptions, type DesignViolation, type EvaluatingPage } from './designAudit.js';
+import { type KeyboardView } from './phoneRules.js';
+/**
+ * Installed once per page, BEFORE the app runs (`context.addInitScript`), so the app subscribes to
+ * the stand-in. It speaks on the real viewport as well, for a harness that could only install it
+ * afterwards (the shipped Safari over WebDriver): a keyboard nobody hears passes every rule.
+ */
+export declare const KEYBOARD_STANDIN = "(() => {\n  const real = window.visualViewport;\n  if (!real || window.__keyboard) return;\n  const fake = new EventTarget();\n  const cover = { px: 0, pan: 0 };\n  for (const key of [\"width\", \"offsetLeft\", \"pageLeft\", \"pageTop\", \"scale\"]) Object.defineProperty(fake, key, { get: () => real[key] });\n  Object.defineProperty(fake, \"height\", { get: () => real.height - cover.px });\n  Object.defineProperty(fake, \"offsetTop\", { get: () => real.offsetTop + cover.pan });\n  real.addEventListener(\"resize\", () => fake.dispatchEvent(new Event(\"resize\")));\n  Object.defineProperty(window, \"visualViewport\", { get: () => fake });\n  window.__keyboard = (px, pan = 0) => { cover.px = px; cover.pan = pan; for (const target of [fake, real]) { target.dispatchEvent(new Event(\"resize\")); target.dispatchEvent(new Event(\"scroll\")); } };\n})()";
+/**
+ * Waits for the page to settle: three 100ms polls in a row with no DOM mutation, no finite animation
+ * running and no visible loading indicator (cb's Spinner is `.animate-spin`; anything else may say
+ * `aria-busy`), capped at 5s so a ticking clock or a spinner that never stops cannot stall a gate.
+ * A resize or a navigation can swap a whole layout — family's phone shell remounts its page behind a
+ * Spinner and fills it ~450ms later, with no DOM mutation in between — and a frame audited before
+ * that is the empty shell. Shared by the Chromium audit (`designBaseline.ts`) and the Apple pass.
+ */
+export declare function settleInPage(): Promise<void>;
+/** Scrolls the page's main pane to `to` and says how far it can go. */
+export declare function scrollMainInPage(to: number): {
+    at: number;
+    end: number;
+};
+/** Finishes every finite animation on the document's timeline; endless motion and scroll-driven motion are left alone. */
+export declare function atRestInPage(): void;
+/**
+ * Focuses the field at `css` the way a tap would land on it — scrolled into view, the caret on a
+ * visible line of an editor — and answers whether it took focus. In-page rather than a Playwright
+ * tap: WebDriver calls an editor's document "not interactable", and a focus is no less true.
+ */
+export declare function focusFieldInPage(css: string): boolean;
+/** With the focused field tapped, raises the stood-in keyboard of `keyboard` px over it and reports where the line being typed on ended up. */
+export declare function keyboardViewInPage([keyboard, what]: readonly [number, string]): Promise<KeyboardView>;
+/** Installs the stand-in from its source when the context did not (a page `setContent` made); a no-op once it is there. */
+export declare function installKeyboardStandinInPage(source: string): boolean;
+/** Lowers the stood-in keyboard. */
+export declare function keyboardDownInPage(): void;
+/** The slice of a Playwright `Page` the walk needs: `evaluate`, and a screenshot where one is wanted. */
+export interface ApplePage extends EvaluatingPage {
+    viewportSize(): {
+        width: number;
+        height: number;
+    } | null;
+    screenshot?(options: {
+        path: string;
+    }): Promise<unknown>;
+    waitForTimeout?(ms: number): Promise<void>;
+}
+export interface AuditAppleOptions extends AuditDesignOptions {
+    /** A page that scrolls: read to its end a screen at a time, so what arrives on scroll is judged where it arrives. */
+    long?: boolean;
+    /** A field to type into with the keyboard up, as a selector; on a device with a keyboard height. */
+    keyboard?: string;
+    /** Where to write screenshots (`<shots>/<device slug>/<route slug>[-NN|-keyboard].png`); none when unset. */
+    shots?: string;
+    /** Frames a long page is read through at most. */
+    maxFrames?: number;
+    /** Whether the pointer is a finger; the device's kind decides unless said. The shipped Safari at a phone's width has a mouse. */
+    touch?: boolean;
+}
+/** The same fault seen on two screens of one read-through is one fault. */
+export declare function dedupe(findings: DesignViolation[]): DesignViolation[];
+/**
+ * Judges one screen on one Apple device: the design audit (less LAY-13, which `measurePhone`
+ * owns here by the reach a finger gets rather than the box) plus the phone rules, at rest, a
+ * screen at a time for a long page, and with the keyboard up over `options.keyboard`.
+ */
+export declare function auditApple(page: ApplePage, route: string, device: AppleDevice, options?: AuditAppleOptions): Promise<{
+    violations: DesignViolation[];
+    textNodes: number;
+}>;
+//# sourceMappingURL=appleWalk.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"appleWalk.d.ts","sourceRoot":"","sources":["../../src/testing/appleWalk.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,KAAK,kBAAkB,EAAe,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACnH,OAAO,EAA6B,KAAK,YAAY,EAA6C,MAAM,iBAAiB,CAAC;AAE1H;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,61BAWxB,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAqB5C;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAQxE;AAED,0HAA0H;AAC1H,wBAAgB,YAAY,IAAI,IAAI,CAKnC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAarD;AAED,+IAA+I;AAC/I,wBAAsB,kBAAkB,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CA0B3G;AAED,2HAA2H;AAC3H,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAGpE;AAED,oCAAoC;AACpC,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,yGAAyG;AACzG,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,YAAY,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACzD,UAAU,CAAC,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,cAAc,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D,qHAAqH;IACrH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oGAAoG;IACpG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6GAA6G;IAC7G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iIAAiI;IACjI,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAKD,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,eAAe,EAAE,CAErE;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC;IAAE,UAAU,EAAE,eAAe,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA+CpL"}

package/dist/testing/appleWalk.js

@@ -0,0 +1,209 @@
+/// <reference types="node" />
+/**
+ * Walking one screen the way a thumb does, on an Apple device (forge task apple-device-testing,
+ * 2026-10-06, after orbgem's phone-screens script): the functions here run INSIDE the page
+ * (handed to Playwright's `evaluate` or WebDriver's execute), so each stands alone — no imports,
+ * no closures — and `auditApple` strings them together for the ledger (`designBaseline.ts`).
+ *
+ * - `KEYBOARD_STANDIN` is iOS's keyboard, stood in: the visual viewport loses `px` from the
+ *   bottom and Safari pans it. Playwright's WebKit raises no keyboard, so the rule about the line
+ *   being typed on (LAY-15) has nothing to measure without it.
+ * - `atRestInPage` brings every finite animation to its end before a screen is judged: the rules
+ *   are about the screen at rest, and a fade still running is not a control that only appears on hover.
+ * - `scrollMainInPage` scrolls the tallest pane that scrolls (an app shell scrolls its main region,
+ *   not the window) and says how far it can go, so a long page is read through a screen at a time.
+ * - `keyboardViewInPage` raises the stood-in keyboard over the focused field and reports where the
+ *   line with the caret ended up against the strip the keyboard leaves.
+ */
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { auditDesign } from './designAudit.js';
+import { judgeKeyboard, judgePhone, measurePhone, PHONE_FIELDS, PHONE_TARGETS } from './phoneRules.js';
+/**
+ * Installed once per page, BEFORE the app runs (`context.addInitScript`), so the app subscribes to
+ * the stand-in. It speaks on the real viewport as well, for a harness that could only install it
+ * afterwards (the shipped Safari over WebDriver): a keyboard nobody hears passes every rule.
+ */
+export const KEYBOARD_STANDIN = `(() => {
+  const real = window.visualViewport;
+  if (!real || window.__keyboard) return;
+  const fake = new EventTarget();
+  const cover = { px: 0, pan: 0 };
+  for (const key of ["width", "offsetLeft", "pageLeft", "pageTop", "scale"]) Object.defineProperty(fake, key, { get: () => real[key] });
+  Object.defineProperty(fake, "height", { get: () => real.height - cover.px });
+  Object.defineProperty(fake, "offsetTop", { get: () => real.offsetTop + cover.pan });
+  real.addEventListener("resize", () => fake.dispatchEvent(new Event("resize")));
+  Object.defineProperty(window, "visualViewport", { get: () => fake });
+  window.__keyboard = (px, pan = 0) => { cover.px = px; cover.pan = pan; for (const target of [fake, real]) { target.dispatchEvent(new Event("resize")); target.dispatchEvent(new Event("scroll")); } };
+})()`;
+/**
+ * Waits for the page to settle: three 100ms polls in a row with no DOM mutation, no finite animation
+ * running and no visible loading indicator (cb's Spinner is `.animate-spin`; anything else may say
+ * `aria-busy`), capped at 5s so a ticking clock or a spinner that never stops cannot stall a gate.
+ * A resize or a navigation can swap a whole layout — family's phone shell remounts its page behind a
+ * Spinner and fills it ~450ms later, with no DOM mutation in between — and a frame audited before
+ * that is the empty shell. Shared by the Chromium audit (`designBaseline.ts`) and the Apple pass.
+ */
+export function settleInPage() {
+    return new Promise((resolve) => {
+        let changed = false;
+        let calm = 0;
+        const observer = new MutationObserver(() => {
+            changed = true;
+        });
+        observer.observe(document.body, { subtree: true, childList: true, characterData: true, attributes: true });
+        const started = performance.now();
+        const poll = setInterval(() => {
+            const animating = document.getAnimations().some((a) => a.playState === 'running' && a.effect?.getComputedTiming().endTime !== Infinity);
+            const loading = [...document.querySelectorAll('.animate-spin, [aria-busy="true"]')].some((el) => el.checkVisibility({ opacityProperty: true, visibilityProperty: true }));
+            calm = changed || animating || loading ? 0 : calm + 1;
+            changed = false;
+            if (calm >= 3 || performance.now() - started > 5000) {
+                clearInterval(poll);
+                observer.disconnect();
+                requestAnimationFrame(() => resolve());
+            }
+        }, 100);
+    });
+}
+/** Scrolls the page's main pane to `to` and says how far it can go. */
+export function scrollMainInPage(to) {
+    const panes = [document.scrollingElement ?? document.documentElement, ...document.querySelectorAll('*')].filter((el) => el.scrollHeight > el.clientHeight + 1 && (el === document.scrollingElement || /(auto|scroll)/.test(getComputedStyle(el).overflowY)));
+    const pane = panes.sort((a, b) => b.clientHeight * b.clientWidth - a.clientHeight * a.clientWidth)[0];
+    if (!pane)
+        return { at: 0, end: 0 };
+    pane.scrollTop = to;
+    return { at: pane.scrollTop, end: pane.scrollHeight - pane.clientHeight };
+}
+/** Finishes every finite animation on the document's timeline; endless motion and scroll-driven motion are left alone. */
+export function atRestInPage() {
+    for (const motion of document.getAnimations()) {
+        if (motion.timeline !== document.timeline || !Number.isFinite(motion.effect?.getComputedTiming().endTime ?? Number.POSITIVE_INFINITY))
+            continue;
+        motion.finish();
+    }
+}
+/**
+ * Focuses the field at `css` the way a tap would land on it — scrolled into view, the caret on a
+ * visible line of an editor — and answers whether it took focus. In-page rather than a Playwright
+ * tap: WebDriver calls an editor's document "not interactable", and a focus is no less true.
+ */
+export function focusFieldInPage(css) {
+    const el = document.querySelector(css);
+    if (!(el instanceof HTMLElement))
+        return false;
+    el.scrollIntoView({ block: 'center' });
+    el.focus();
+    if (el.isContentEditable) {
+        const lines = [...el.querySelectorAll('.cm-line, p, div')].filter((line) => {
+            const r = line.getBoundingClientRect();
+            return r.height > 0 && r.top >= 0 && r.bottom <= window.innerHeight;
+        });
+        window.getSelection()?.collapse(lines[Math.floor(lines.length / 2)] ?? el, 0);
+    }
+    return document.activeElement === el || el.contains(document.activeElement);
+}
+/** With the focused field tapped, raises the stood-in keyboard of `keyboard` px over it and reports where the line being typed on ended up. */
+export async function keyboardViewInPage([keyboard, what]) {
+    const H = window.innerHeight;
+    const el = document.activeElement ?? document.body;
+    // In an editor the field is the whole document; what must stay in sight is the line with the caret.
+    // A caret on an empty line has no box of its own in WebKit: then it is the line it is on, never the
+    // whole editor, whose top is scrolled away in anything longer than the strip.
+    const caret = () => {
+        const range = el instanceof HTMLElement && el.isContentEditable ? window.getSelection()?.getRangeAt(0) : null;
+        const line = range?.getClientRects()[0] ?? range?.getBoundingClientRect();
+        if (line && line.height > 0)
+            return line;
+        const node = range?.startContainer === el ? (el.childNodes[range.startOffset] ?? el.lastChild) : range?.startContainer;
+        const holder = node instanceof Element ? node : node?.parentElement;
+        const row = holder && holder !== el && el.contains(holder) ? (holder.closest('.cm-line, p, div') ?? holder) : null;
+        return (row ?? el).getBoundingClientRect();
+    };
+    const first = caret();
+    // Safari pans just far enough to show the line with the caret, a little above the keys.
+    const pan = Math.max(0, Math.min(keyboard, Math.round(first.top + Math.min(first.height, 44) + 12 - (H - keyboard))));
+    window.__keyboard(keyboard, pan);
+    await new Promise((done) => setTimeout(done, 450));
+    const now = caret();
+    const lineY = now.top + Math.min(now.height, 44) / 2;
+    const hit = document.elementFromPoint(now.left + Math.min(now.width / 2, 40), Math.min(Math.max(lineY, 0), H - 1));
+    const mine = hit && (hit === document.activeElement || document.activeElement?.contains(hit) || hit.contains(document.activeElement));
+    const label = hit ? `${hit.tagName.toLowerCase()}${hit.getAttribute('aria-label') ? ` "${hit.getAttribute('aria-label')}"` : ''}` : 'nothing';
+    return { field: what, top: now.top, bottom: now.bottom, stripTop: pan, stripBottom: pan + H - keyboard, coveredBy: mine ? null : label };
+}
+/** Installs the stand-in from its source when the context did not (a page `setContent` made); a no-op once it is there. */
+export function installKeyboardStandinInPage(source) {
+    if (!window.__keyboard)
+        new Function(source)();
+    return typeof window.__keyboard === 'function';
+}
+/** Lowers the stood-in keyboard. */
+export function keyboardDownInPage() {
+    window.__keyboard?.(0, 0);
+}
+const slug = (s) => s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') || 'root';
+const pause = (page, ms) => (page.waitForTimeout ? page.waitForTimeout(ms) : new Promise((r) => setTimeout(r, ms)));
+/** The same fault seen on two screens of one read-through is one fault. */
+export function dedupe(findings) {
+    return findings.filter((f, i) => findings.findIndex((g) => g.rule === f.rule && g.selector === f.selector && g.detail === f.detail) === i);
+}
+/**
+ * Judges one screen on one Apple device: the design audit (less LAY-13, which `measurePhone`
+ * owns here by the reach a finger gets rather than the box) plus the phone rules, at rest, a
+ * screen at a time for a long page, and with the keyboard up over `options.keyboard`.
+ */
+export async function auditApple(page, route, device, options = {}) {
+    const { long, keyboard, shots, maxFrames = 12, touch = device.kind !== 'desktop', ...audit } = options;
+    const shot = (suffix) => {
+        if (!shots || !page.screenshot)
+            return Promise.resolve();
+        const path = `${shots}/${device.slug}/${slug(route)}${suffix}.png`;
+        mkdirSync(dirname(path), { recursive: true });
+        return page.screenshot({ path }).then(() => undefined);
+    };
+    const ignore = { ...(audit.ignore ?? {}), 'LAY-13': 'measurePhone judges the reach a finger gets, halo included, in place of the box' };
+    let textNodes = 0;
+    const judgeNow = async () => {
+        await page.evaluate(settleInPage, undefined);
+        await page.evaluate(atRestInPage, undefined);
+        const design = await auditDesign(page, { ...audit, ignore, route, width: page.viewportSize()?.width });
+        textNodes = Math.max(textNodes, design.census.textNodes);
+        const phone = judgePhone(await page.evaluate(measurePhone, { targets: PHONE_TARGETS, fields: PHONE_FIELDS }), { touch });
+        return [...design.violations, ...phone];
+    };
+    const found = [];
+    // A pause, not a condition: overlays rise over ~200ms, and a measurement mid-rise is of a moving thing.
+    await pause(page, 300);
+    if (long) {
+        const view = page.viewportSize()?.height ?? 600;
+        for (let frame = 0, y = 0; frame < maxFrames; frame++, y += Math.round(view * 0.85)) {
+            const { at, end } = await page.evaluate(scrollMainInPage, y);
+            // A section that fades up once scrolled to needs its moment before `atRest` can finish it.
+            await pause(page, 350);
+            found.push(...(await judgeNow()));
+            await shot(`-${String(frame).padStart(2, '0')}`);
+            if (at >= end - 1)
+                break;
+        }
+        await page.evaluate(scrollMainInPage, 0);
+    }
+    else {
+        found.push(...(await judgeNow()));
+        await shot('');
+    }
+    if (keyboard && device.keyboard) {
+        const focused = await page.evaluate(focusFieldInPage, keyboard);
+        if (!focused)
+            found.push({ rule: 'LAY-15', selector: keyboard, detail: 'is not there, or would not take focus, so the keyboard could not be raised over it' });
+        else if (!(await page.evaluate(installKeyboardStandinInPage, KEYBOARD_STANDIN)))
+            throw new Error('auditApple: the page has no visualViewport to stand a keyboard in on');
+        else {
+            found.push(...judgeKeyboard(await page.evaluate(keyboardViewInPage, [device.keyboard, keyboard])));
+            await shot('-keyboard');
+            await page.evaluate(keyboardDownInPage, undefined);
+        }
+    }
+    return { violations: dedupe(found), textNodes };
+}
+//# sourceMappingURL=appleWalk.js.map