@zappie/verify 0.1.3 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @zappie/verify
 
+## 0.2.2
+
+### Patch Changes
+
+- d73fe38: V16 and V17 now wait for the menu to hydrate, then for the work it leaves for idle time, such as overlay preloads, and for the downloads that work starts, before they tap a trigger. That is what a shopper who has read the menu sees. A tap still times everything it starts, so an overlay whose code loads only on tap still fails V16.
+- 959024d: V16 opens each overlay three times, each on a freshly loaded and settled menu, and judges the median against the 100 ms budget, so one slow sample on a busy machine doesn't fail it. `overlayOpenMs` holds the medians and the new `overlayOpenSamplesMs` holds every sample.
+
+  The phone profile's CPU slowdown is now calibrated to the machine. Before the checks run, verify scores the browser's CPU with a short fixed benchmark and sets the throttling rate so that V14, V15 and V16 see the same phone on a fast laptop and on a slow CI runner. A developer laptop still gets about four times. The rate stays between one and eight times, and the report's `environment` records `cpuBenchmark` and `cpuThrottlingRate`. The budgets are unchanged.
+
+## 0.2.1
+
+### Patch Changes
+
+- 82fa181: Local mode now answers `/_zappie/session` as the test site host does, signed out until a check sets its test session cookie, so a template that checks the session as soon as a page loads no longer fails the routes check in a local preview.
+
+## 0.2.0
+
+### Minor Changes
+
+- 79deec3: Hold every template to the same accessibility, semantics, performance and CSS bar.
+
+  - `eslint-plugin-zappie`: `zappie/no-lazy-overlay` reports `React.lazy` and `Suspense` and points at `deferred()` from `@zappie/foundations`. It is an error in `recommended`.
+  - `@zappie/check`: `lint` fails when a project turns down a `jsx-a11y` rule from `recommended`. A new `css` step reports `css/important` and `css/class-patch` as errors, and `css/duplicate-keyframes`, `css/duplicate-selector`, `css/arbitrary-token`, `css/literal-token`, `css/unused-custom-property`, `css/reduced-motion` and `css/unreadable` as warnings.
+  - `@zappie/verify`: V13 fails on a missing main landmark, a page without exactly one h1, a dialog without a name, a positive tabindex, a phone control under 44×44 px and focus that doesn't return after the item or cart closes. V16 times each marked overlay from tap to first paint on a phone profile. V17 checks each marked overlay's focus, Escape and scroll lock. Both are skipped while a menu has no overlay markers. V14 records `menuCssKbGz`. `findRegressions` compares two reports' metrics.
+  - `@zappie/starter`: menu controls are at least 44×44 px on a phone.
+
+### Patch Changes
+
+- Updated dependencies [4f3cdc3]
+  - @zappie/sdk@0.1.8
+
+## 0.1.5
+
+### Patch Changes
+
+- 2aa7669: V15 accepts an item route prefetched as code alone, so a storefront whose item page has no loader no longer needs an empty one to pass.
+
+## 0.1.4
+
+### Patch Changes
+
+- 45295a2: Make product cards ready to tap with route discovery, prefetch lint rules and measured storefront checks.
+- Updated dependencies [45295a2]
+  - @zappie/sdk@0.1.6
+
 ## 0.1.3
 
 ### Patch Changes

package/README.md

@@ -18,7 +18,7 @@ ZAPPIE_KEY=pk_test_... npx zappie verify
 ZAPPIE_KEY=pk_test_... npx zappie verify https://your-store.example
 ```
 
-With no URL, it builds your project, starts a local preview, runs the checks and stops the preview. It only accepts test keys, so it never touches live orders.
+With no URL, it builds your project, starts a local preview, runs the checks and stops the preview. It only accepts test keys, so it never touches live orders. A local preview has no site host, so verify answers `/_zappie/session` itself: signed out until a check signs in. Don't build or typecheck the project while it runs, because a rebuild under the preview stops the page from hydrating and fails checks that would pass.
 
 | Option                           | What it does                                         |
 | -------------------------------- | ---------------------------------------------------- |
@@ -42,6 +42,23 @@ console.log(printSummary(report));
 
 The report's shape is the JSON Schema at `@zappie/verify/schema/verify-report.v1.json`.
 
+## Overlays
+
+Mark each control that opens an overlay with `data-zappie-overlay-trigger="bag"`, `"branch"`, `"search"` or `"item"`, and the overlay's `role="dialog"` element with `data-zappie-overlay` and the same name. V16 waits until the menu has hydrated and its idle work, such as overlay preloads, and the downloads that work starts are done, as they would be for a shopper who has read the menu. Then it taps each marked trigger on a phone profile with the CPU slowed four times, and fails when the overlay takes more than 100 ms to paint. Anything the tap itself loads counts toward that time. It opens each overlay three times, each on a freshly loaded and settled menu, and judges the median, so one slow sample on a busy machine doesn't fail it. The CPU slowdown is calibrated to the machine: before the checks run, verify scores the browser's CPU with a short fixed benchmark and sets the throttling rate so that V14, V15 and V16 see the same phone everywhere. A developer laptop gets about four times, a slower CI runner less, between one and eight times. The report's `environment` records `cpuBenchmark` and the `cpuThrottlingRate` the checks used. The report's `overlayOpenMs` holds the medians and `overlayOpenSamplesMs` holds every sample, in the order they ran. V17 opens each one from the keyboard and checks that focus moves in, Tab stays in, the page behind doesn't scroll, Escape closes it and focus returns to the trigger. Both are skipped while the menu has no markers.
+
+## Compare with a baseline
+
+`findRegressions(baseline, head)` compares the metrics of two reports and returns each one that grew past its threshold, even when it is still inside the budget:
+
+```ts
+import { findRegressions } from "@zappie/verify";
+
+const regressions = findRegressions(baselineReport, report);
+// [{ metric: "overlayOpenMs.bag", base: 60, head: 81, allowed: 80 }]
+```
+
+A metric regresses when it grows by more than its relative threshold or its absolute floor, whichever is larger. The defaults are in `DEFAULT_REGRESSION_THRESHOLDS`. A metric the baseline records and the new report doesn't also counts as a regression.
+
 ## Docs
 
 - [CLI: zappie verify](https://docs.zappie.ai/cli/verify)

package/dist/{category-page-UBHOB5IN.js → category-page-I3HDIAJA.js}

@@ -1,6 +1,10 @@
 // ../sdk/src/transport/category-page.ts
-function categoryPage(raw, ctx, mapMenu, invalid) {
-  const menu = mapMenu(raw, ctx.branchId);
+async function categoryPage(raw, ctx, mapMenu, invalid) {
+  const menu = (await import("./presentation-TKOXOILG.js")).presentMenu(
+    mapMenu(raw, ctx.branchId),
+    raw,
+    invalid
+  );
   if (raw.next_cursor != null && (typeof raw.next_cursor !== "string" || !raw.next_cursor || raw.next_cursor === ctx.cursor) || menu.categories.some((c) => c.id !== ctx.categoryId) || Object.keys(menu.items).some(
     (id) => !menu.categories.some((c) => c.itemIds.includes(id))
   ) || !menu.menus?.some(
@@ -18,4 +22,4 @@ function categoryPage(raw, ctx, mapMenu, invalid) {
 export {
   categoryPage
 };
-//# sourceMappingURL=category-page-UBHOB5IN.js.map
+//# sourceMappingURL=category-page-I3HDIAJA.js.map

package/dist/category-page-I3HDIAJA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../sdk/src/transport/category-page.ts"],"mappings":";AASA,eAAsB,aACpB,KACA,KAMA,SACA,SACuB;AACvB,QAAM,QAAQ,MAAM,OAAO,4BAAgB,GAAG;AAAA,IAC5C,QAAQ,KAAK,IAAI,QAAQ;AAAA,IACzB;AAAA,IACA;AAAA,EACF;AACA,MACG,IAAI,eAAe,SACjB,OAAO,IAAI,gBAAgB,YAC1B,CAAC,IAAI,eACL,IAAI,gBAAgB,IAAI,WAC5B,KAAK,WAAW,KAAK,CAAC,MAAM,EAAE,OAAO,IAAI,UAAU,KACnD,OAAO,KAAK,KAAK,KAAK,EAAE;AAAA,IACtB,CAAC,OAAO,CAAC,KAAK,WAAW,KAAK,CAAC,MAAM,EAAE,QAAQ,SAAS,EAAE,CAAC;AAAA,EAC7D,KACA,CAAC,KAAK,OAAO;AAAA,IACX,CAAC,MAAM,EAAE,OAAO,IAAI,UAAU,EAAE,YAAY,SAAS,IAAI,UAAU;AAAA,EACrE,GACA;AACA,UAAM,QAAQ;AAAA,EAChB;AACA,SAAO;AAAA,IACL,MAAM,EAAE,GAAG,MAAM,cAAc,UAAU;AAAA,IACzC,QAAQ,IAAI;AAAA,IACZ,YAAY,IAAI;AAAA,IAChB,GAAI,OAAO,IAAI,gBAAgB,YAAY,IAAI,cAC3C,EAAE,YAAY,IAAI,YAAY,IAC9B,CAAC;AAAA,EACP;AACF;","names":[]}