cursedbelt 5.67.0 → 5.69.0

package/dist/styles-areas/fields.css

@@ -18,7 +18,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.
- * 120 candidate(s).
+ * 119 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
@@ -40,7 +40,7 @@
 @source inline("focus-within:ring-2 focus-within:ring-field-ring/30 focus-within:ring-offset-1");
 @source inline("focus-within:ring-ring group-focus-within:opacity-100 h-105 h-12 h-3.5");
 @source inline("has-[[aria-invalid=true]]:border-field-error hover:bg-muted/50 hover:border-field-ring");
-@source inline("hover:scale-110 hover:text-warning italic leading-5 left-2.5 li list-none max-h-64");
+@source inline("hover:scale-110 hover:text-warning italic left-2.5 li list-none max-h-64");
 @source inline("max-h-[var(--sheet-h-lg)] max-h-[var(--sheet-h-md)] max-h-[var(--sheet-h-sm)] max-w-sm");
 @source inline("md:flex-col md:gap-0.5 md:justify-start md:overflow-visible md:text-left md:w-full min-h-20");
 @source inline("min-w-24 min-w-64 min-w-[var(--anchor-width)] min-w-full min-w-max mix-blend-difference mr-2");

package/dist/styles-areas/filter-rail.css

@@ -18,7 +18,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.
- * 31 candidate(s).
+ * 30 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
@@ -27,7 +27,7 @@
 @source inline("-mx-2 -outline-offset-2 [&_button]:min-h-0 [&_button]:min-w-0 [&_button]:p-0 [&_button]:size-7");
 @source inline("bg-card-overlay border-r duration-150 group-data-[state=open]/rail-section:rotate-90");
 @source inline("group-focus-within/rail-row:opacity-100 group-hover/rail-row:opacity-100 group/rail-row");
-@source inline("group/rail-section hover:bg-card-raised last:mb-0 mx-2 opacity-100 outline-2 outline-accent");
-@source inline("outline-dashed place-items-center pointer-coarse:[&_button]:min-h-11");
-@source inline("pointer-coarse:[&_button]:min-w-11 pointer-coarse:[&_button]:size-11 pt-1 self-stretch");
-@source inline("shadow-[inset_3px_0_0_0_var(--accent)] w-14 w-3 w-56");
+@source inline("group/rail-section last:mb-0 mx-2 opacity-100 outline-2 outline-accent outline-dashed");
+@source inline("place-items-center pointer-coarse:[&_button]:min-h-11 pointer-coarse:[&_button]:min-w-11");
+@source inline("pointer-coarse:[&_button]:size-11 pt-1 self-stretch shadow-[inset_3px_0_0_0_var(--accent)] w-14");
+@source inline("w-3 w-56");

package/dist/styles-areas/nav.css

@@ -18,7 +18,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.
- * 142 candidate(s).
+ * 141 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
@@ -42,11 +42,11 @@
 @source inline("group-hover/tile:opacity-100 group/navitem group/tile h-12 h-[var(--header-h)]");
 @source inline("h-[var(--header-h-dense)] h-[var(--header-h-roomy)] h-dvh hover:border-foreground/20");
 @source inline("hover:decoration-border hover:scale-110 hover:underline-offset-4 inset-x-2 inset-x-3 inset-y-1");
-@source inline("inset-y-1.5 items-stretch justify-around leading-4 left-3 lg:flex lg:flex-col lg:hidden");
-@source inline("lg:shrink-0 list-none max-h-72 max-h-[inherit] max-h-[var(--palette-max-h)]");
-@source inline("max-h-[var(--sheet-h-lg)] max-h-[var(--sheet-h-md)] max-h-[var(--sheet-h-sm)] max-md:-right-0.5");
-@source inline("max-md:-top-0.5 max-md:absolute max-md:hidden max-sm:flex-none max-sm:justify-center max-sm:px-0");
-@source inline("max-sm:w-10 max-w max-w-48 max-w-64 max-w-80 max-w-sm md:flex md:flex-col md:gap-4 md:hidden");
+@source inline("inset-y-1.5 items-stretch justify-around left-3 lg:flex lg:flex-col lg:hidden lg:shrink-0");
+@source inline("list-none max-h-72 max-h-[inherit] max-h-[var(--palette-max-h)] max-h-[var(--sheet-h-lg)]");
+@source inline("max-h-[var(--sheet-h-md)] max-h-[var(--sheet-h-sm)] max-md:-right-0.5 max-md:-top-0.5");
+@source inline("max-md:absolute max-md:hidden max-sm:flex-none max-sm:justify-center max-sm:px-0 max-sm:w-10");
+@source inline("max-w max-w-48 max-w-64 max-w-80 max-w-sm md:flex md:flex-col md:gap-4 md:hidden");
 @source inline("md:pointer-coarse:w-auto md:px-3 md:px-6 md:shrink-0 min-h-10 min-h-12 min-h-dvh min-w-3.5");
 @source inline("min-w-8 min-w-9 mix-blend-difference mt-auto mx-1 no-underline opacity-55 opacity-80");
 @source inline("pb-[env(safe-area-inset-bottom,0px)] pl-11 pl-9 place-items-center");

package/dist/styles-areas/notifications.css

@@ -18,7 +18,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.
- * 33 candidate(s).
+ * 32 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
@@ -26,8 +26,8 @@
  */
 @source inline("-right-0.5 -top-0.5 [&::-webkit-scrollbar]:hidden [scrollbar-width:none] bg-accent/15");
 @source inline("group-focus-within:opacity-100 group-focus-within:pointer-events-auto");
-@source inline("group-hover:pointer-events-auto hover:bg-muted/80 leading-4 list-none min-w-4 ml-1.5 ml-2 pb");
-@source inline("pb-0.5 pointer-coarse:basis-full pointer-coarse:bg-transparent pointer-coarse:justify-end");
+@source inline("group-hover:pointer-events-auto hover:bg-muted/80 list-none min-w-4 ml-1.5 ml-2 pb pb-0.5");
+@source inline("pointer-coarse:basis-full pointer-coarse:bg-transparent pointer-coarse:justify-end");
 @source inline("pointer-coarse:p-0 pointer-coarse:pointer-events-auto pointer-coarse:shadow-none");
 @source inline("pointer-coarse:static py py-10 right-3 ring-1 ring-accent ring-accent/30 ring-inset self-stretch");
 @source inline("text-muted-foreground/50 top-3");

package/dist/styles-areas/place-bar.css

@@ -18,7 +18,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.
- * 30 candidate(s).
+ * 29 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
@@ -27,7 +27,7 @@
 @source inline("-mt-5 -top-1 bg-accent/15 border-l border-r data-[state=closed]:slide-out-to-bottom");
 @source inline("data-[state=closed]:slide-out-to-left data-[state=closed]:slide-out-to-right");
 @source inline("data-[state=open]:slide-in-from-bottom data-[state=open]:slide-in-from-left");
-@source inline("data-[state=open]:slide-in-from-right inset-x-3 items-stretch justify-around leading-4 list-none");
+@source inline("data-[state=open]:slide-in-from-right inset-x-3 items-stretch justify-around list-none");
 @source inline("max-h-[var(--sheet-h-lg)] max-h-[var(--sheet-h-md)] max-h-[var(--sheet-h-sm)] max-w-sm min-h-12");
 @source inline("min-w-3.5 no-underline place-items-center pt-0 px-0.5 rounded-l-xl rounded-r-xl rounded-t-xl");
 @source inline("shadow-lg");

package/dist/styles-utilities.css

@@ -357,6 +357,15 @@
   .z-\[var\(--z-popover\)\] {
     z-index: var(--z-popover);
   }
+  .order-1 {
+    order: 1;
+  }
+  .order-2 {
+    order: 2;
+  }
+  .order-3 {
+    order: 3;
+  }
   .col-span-2 {
     grid-column: span 2 / span 2;
   }
@@ -707,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));
   }
@@ -827,6 +833,9 @@
   .min-h-12 {
     min-height: calc(var(--spacing) * 12);
   }
+  .min-h-14 {
+    min-height: calc(var(--spacing) * 14);
+  }
   .min-h-20 {
     min-height: calc(var(--spacing) * 20);
   }
@@ -1124,6 +1133,9 @@
   .min-w-24 {
     min-width: calc(var(--spacing) * 24);
   }
+  .min-w-26 {
+    min-width: calc(var(--spacing) * 26);
+  }
   .min-w-28 {
     min-width: calc(var(--spacing) * 28);
   }
@@ -1184,6 +1196,9 @@
   .grow {
     flex-grow: 1;
   }
+  .basis-0 {
+    flex-basis: 0px;
+  }
   .basis-40 {
     flex-basis: calc(var(--spacing) * 40);
   }
@@ -1317,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;
@@ -3467,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;
   }
@@ -4435,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;
@@ -4934,12 +4951,24 @@
     }
   }
   @container (width >= 48rem) {
+    .\@3xl\:order-none {
+      order: 0;
+    }
     .\@3xl\:block {
       display: block;
     }
+    .\@3xl\:flex {
+      display: flex;
+    }
     .\@3xl\:hidden {
       display: none;
     }
+    .\@3xl\:shrink-0 {
+      flex-shrink: 0;
+    }
+    .\@3xl\:basis-auto {
+      flex-basis: auto;
+    }
   }
   .dark\:bg-amber-900\/40:where(.dark, .dark *) {
     background-color: color-mix(in srgb, oklch(41.4% 0.112 45.904) 40%, transparent);
@@ -5239,6 +5268,9 @@
       min-width: calc(var(--spacing) * 11);
     }
   }
+  .\[\&_select\]\:w-full select {
+    width: 100%;
+  }
   .\[\&_sup\]\:leading-none sup {
     --tw-leading: 1;
     line-height: 1;
@@ -5313,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"}