@astryxdesign/core 0.7.2-canary.91cfb53 → 0.7.2-canary.9b8b723

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.7.2-canary.91cfb53",
+  "version": "0.7.2-canary.9b8b723",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
@@ -792,8 +792,8 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.7.2-canary.91cfb53",
-    "@astryxdesign/cli": "0.7.2-canary.91cfb53",
+    "@astryxdesign/a11y-spec": "0.7.2-canary.9b8b723",
+    "@astryxdesign/cli": "0.7.2-canary.9b8b723",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",

package/src/CommandPalette/__tests__/CommandPaletteItemAudit.a11y.chromium.spec.ts

@@ -0,0 +1,292 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file CommandPaletteItemAudit.a11y.chromium.spec.ts
+ * @input Exact-head CommandPaletteItem stories across semantics, states, themes, direction, and viewport sizes
+ * @output Screenshots and fail-closed sensor receipts for the CommandPaletteItem whole-component audit
+ * @position Component-owned Night Watch browser evidence; CI runs it only for a CommandPaletteItem audit pull request
+ */
+
+import {createHash} from 'node:crypto';
+import {execFileSync} from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import {expect, test, type Page} from '@playwright/test';
+import {holdMotionStill} from '@astryxdesign/a11y-spec/chromium';
+import {
+  DEFAULT_STORYBOOK_DIR,
+  serveStorybook,
+  type StaticServer,
+} from '@astryxdesign/a11y-spec/storybook';
+
+const OUTPUT = path.resolve('command-palette-item-audit-evidence');
+const WIDE = {width: 1024, height: 768};
+const NARROW = {width: 320, height: 720};
+
+type Mode = 'light' | 'dark';
+type Direction = 'ltr' | 'rtl';
+type Theme = 'neutral' | 'butter';
+type Story = 'states' | 'combined-and-long';
+type State = 'rest' | 'hover';
+
+type AuditCase = {
+  key: string;
+  story: Story;
+  mode: Mode;
+  direction: Direction;
+  theme: Theme;
+  state: State;
+  viewport: {width: number; height: number};
+};
+
+type AuditReceipt = {
+  passed: boolean;
+  expected: Record<string, unknown>;
+};
+
+const cases: AuditCase[] = [];
+function addPair(
+  key: string,
+  options: Partial<Omit<AuditCase, 'key' | 'mode'>> = {},
+) {
+  for (const mode of ['light', 'dark'] as const) {
+    cases.push({
+      key: `${key}-${mode}`,
+      story: options.story ?? 'states',
+      mode,
+      direction: options.direction ?? 'ltr',
+      theme: options.theme ?? 'neutral',
+      state: options.state ?? 'rest',
+      viewport: options.viewport ?? WIDE,
+    });
+  }
+}
+
+addPair('states-rest');
+addPair('states-hover', {state: 'hover'});
+addPair('states-custom-theme', {theme: 'butter'});
+addPair('states-rtl', {direction: 'rtl'});
+addPair('states-narrow', {viewport: NARROW});
+addPair('combined-rest', {story: 'combined-and-long'});
+addPair('combined-custom-theme', {
+  story: 'combined-and-long',
+  theme: 'butter',
+});
+addPair('combined-narrow', {
+  story: 'combined-and-long',
+  viewport: NARROW,
+});
+
+test.describe.configure({mode: 'serial', retries: 0});
+let server: StaticServer;
+let checkoutSha: string;
+let storybookSha: string;
+
+function storyId(item: AuditCase) {
+  return `core-commandpaletteitem--${item.story}`;
+}
+
+function storyUrl(item: AuditCase) {
+  return `${server.origin}/iframe.html?id=${storyId(item)}&viewMode=story&globals=colorMode:${item.mode};astryxTheme:${item.theme};direction:${item.direction}`;
+}
+
+async function settle(page: Page) {
+  await holdMotionStill(page);
+  await page.evaluate(async () => document.fonts.ready);
+  await page.waitForTimeout(40);
+}
+
+test.beforeAll(async () => {
+  fs.rmSync(OUTPUT, {recursive: true, force: true});
+  fs.mkdirSync(OUTPUT, {recursive: true});
+  checkoutSha = execFileSync('git', ['rev-parse', 'HEAD'], {
+    encoding: 'utf8',
+  }).trim();
+  const expected = process.env.ASTRYX_HEAD_SHA;
+  if (expected && expected !== checkoutSha) {
+    throw new Error(
+      `checkout ${checkoutSha} does not match expected head ${expected}`,
+    );
+  }
+  server = await serveStorybook(
+    process.env.ASTRYX_STORYBOOK_DIR ?? DEFAULT_STORYBOOK_DIR,
+  );
+  const response = await fetch(`${server.origin}/astryx-build-sha.txt`);
+  if (!response.ok) {
+    throw new Error(`Storybook build has no SHA stamp (${response.status})`);
+  }
+  storybookSha = (await response.text()).trim();
+  if (storybookSha !== checkoutSha) {
+    throw new Error(
+      `Storybook ${storybookSha} does not match checkout ${checkoutSha}`,
+    );
+  }
+});
+
+test.afterAll(async () => {
+  await server?.close();
+});
+
+for (const item of cases) {
+  test(item.key, async ({browser}) => {
+    const context = await browser.newContext({
+      viewport: item.viewport,
+      colorScheme: item.mode,
+      reducedMotion: 'reduce',
+    });
+    const page = await context.newPage();
+    const pageErrors: string[] = [];
+    page.on('pageerror', error => pageErrors.push(String(error)));
+    await page.goto(storyUrl(item), {waitUntil: 'load'});
+    await page.locator('#storybook-root').waitFor();
+
+    const listName =
+      item.story === 'states'
+        ? 'Command item states'
+        : 'Combined and long command item states';
+    const list = page.getByRole('listbox', {name: listName});
+    const options = list.getByRole('option');
+    const expectedCount = item.story === 'states' ? 4 : 2;
+    const expectedDisabled = item.story === 'states' ? 1 : 0;
+    await expect(list).toBeVisible();
+    await expect(options).toHaveCount(expectedCount);
+    await expect(
+      list.locator('[role="option"][aria-selected="true"]'),
+    ).toHaveCount(1);
+    await expect(
+      list.locator('[role="option"][aria-disabled="true"]'),
+    ).toHaveCount(expectedDisabled);
+    await expect(list.locator('button, a, [tabindex]')).toHaveCount(0);
+
+    if (item.state === 'hover') {
+      await options.first().hover();
+    }
+    await settle(page);
+
+    const observed = await page.evaluate(() => ({
+      theme: document
+        .querySelector('[data-astryx-theme]')
+        ?.getAttribute('data-astryx-theme'),
+      mode: document.documentElement.getAttribute('data-theme'),
+      direction: getComputedStyle(
+        document.querySelector('.astryx-command-palette-item') as HTMLElement,
+      ).direction,
+      viewport: {width: innerWidth, height: innerHeight},
+      reducedMotion: matchMedia('(prefers-reduced-motion: reduce)').matches,
+      horizontalOverflow: document.documentElement.scrollWidth > innerWidth + 1,
+      fonts: document.fonts.status,
+    }));
+    const optionStates = await options.evaluateAll(nodes =>
+      nodes.map(node => {
+        const style = getComputedStyle(node);
+        const box = node.getBoundingClientRect();
+        return {
+          name: node.textContent?.replace(/\s+/g, ' ').trim(),
+          selected: node.getAttribute('aria-selected'),
+          disabled: node.getAttribute('aria-disabled'),
+          backgroundColor: style.backgroundColor,
+          color: style.color,
+          opacity: style.opacity,
+          geometry: {
+            x: box.x,
+            y: box.y,
+            width: box.width,
+            height: box.height,
+          },
+        };
+      }),
+    );
+    const semanticsPass =
+      optionStates.length === expectedCount &&
+      optionStates.filter(option => option.selected === 'true').length === 1 &&
+      optionStates.filter(option => option.disabled === 'true').length ===
+        expectedDisabled &&
+      optionStates.every(
+        option => option.geometry.width > 0 && option.geometry.height > 0,
+      );
+
+    const png = await page.screenshot({animations: 'disabled', fullPage: true});
+    const image = `${item.key}.png`;
+    const receipt = {
+      schemaVersion: 1,
+      expected: {
+        build: checkoutSha,
+        storyId: storyId(item),
+        mode: item.mode,
+        direction: item.direction,
+        theme: item.theme,
+        state: item.state,
+        viewport: item.viewport,
+        optionCount: expectedCount,
+        disabledCount: expectedDisabled,
+        selectedCount: 1,
+      },
+      observed: {
+        build: storybookSha,
+        ...observed,
+        listRole: await list.getAttribute('role'),
+        listName: await list.getAttribute('aria-label'),
+        optionStates,
+        pageErrors,
+      },
+      image: {
+        file: image,
+        sha256: createHash('sha256').update(png).digest('hex'),
+        width: png.readUInt32BE(16),
+        height: png.readUInt32BE(20),
+      },
+      checks: {semanticsPass},
+      passed:
+        storybookSha === checkoutSha &&
+        pageErrors.length === 0 &&
+        observed.theme === item.theme &&
+        observed.mode === item.mode &&
+        observed.direction === item.direction &&
+        observed.viewport.width === item.viewport.width &&
+        observed.viewport.height === item.viewport.height &&
+        observed.reducedMotion &&
+        !observed.horizontalOverflow &&
+        observed.fonts === 'loaded' &&
+        semanticsPass,
+    };
+    fs.writeFileSync(path.join(OUTPUT, image), png);
+    fs.writeFileSync(
+      path.join(OUTPUT, `${item.key}.sensors.json`),
+      `${JSON.stringify(receipt, null, 2)}\n`,
+    );
+
+    await context.close();
+  });
+}
+
+test('manifest is complete', async () => {
+  const receiptFiles = fs
+    .readdirSync(OUTPUT)
+    .filter(file => file.endsWith('.sensors.json'));
+  const receipts = receiptFiles.map(
+    (file): AuditReceipt =>
+      JSON.parse(
+        fs.readFileSync(path.join(OUTPUT, file), 'utf8'),
+      ) as AuditReceipt,
+  );
+  const manifest = {
+    schemaVersion: 1,
+    component: 'core/CommandPaletteItem',
+    build: checkoutSha,
+    frames: cases.map(item => ({
+      key: item.key,
+      image: `${item.key}.png`,
+      receipt: `${item.key}.sensors.json`,
+    })),
+  };
+  fs.writeFileSync(
+    path.join(OUTPUT, 'manifest.json'),
+    `${JSON.stringify(manifest, null, 2)}\n`,
+  );
+  expect(receiptFiles).toHaveLength(cases.length);
+  expect(
+    receipts
+      .filter(receipt => !receipt.passed)
+      .map(receipt => receipt.expected),
+  ).toEqual([]);
+});

package/src/ContextMenu/ContextMenu.doc.mjs

@@ -96,14 +96,13 @@ export const docs = {
       name: 'items',
       type: 'ContextMenuOption[]',
       description:
-        'Array of menu entries. Each entry is one of: an action item `{label, onClick?, icon?, isDisabled?, variant?, items?}` (nested `items` open a flyout in popover presentation and drill into a new view in bottom-sheet presentation; variant `"destructive"` renders it in the error color), a divider `{type: "divider"}`, or a section `{type: "section", title?, items: [...action items]}`.',
-      required: true,
+        'Data-driven menu entries. Pass exactly one of `items` or `menuContent`. Each entry is one of: an action item `{label, onClick?, icon?, isDisabled?, variant?, items?}` (nested `items` open a flyout in popover presentation and drill into a new view in bottom-sheet presentation; variant `"destructive"` renders it in the error color), a divider `{type: "divider"}`, or a section `{type: "section", title?, items: [...action items]}`.',
     },
     {
       name: 'menuContent',
       type: 'ReactNode',
       description:
-        'Custom JSX menu content for compound mode. Use instead of items for dynamic or stateful menus.',
+        'Custom JSX menu content for compound mode. Pass exactly one of `menuContent` or `items`.',
     },
     {
       name: 'menuWidth',

package/src/ContextMenu/__tests__/ContextMenuAudit.a11y.chromium.spec.ts

@@ -0,0 +1,438 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file ContextMenuAudit.a11y.chromium.spec.ts
+ * @input Exact-head ContextMenu stories across pointer/touch presentation, state, theme, direction, and viewport
+ * @output Screenshots and fail-closed sensor receipts for the ContextMenu whole-component audit
+ * @position Component-owned Night Watch browser evidence; CI runs it only for a ContextMenu audit pull request
+ */
+
+import {createHash} from 'node:crypto';
+import {execFileSync} from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import {expect, test, type Locator, type Page} from '@playwright/test';
+import {holdMotionStill} from '@astryxdesign/a11y-spec/chromium';
+import {
+  DEFAULT_STORYBOOK_DIR,
+  serveStorybook,
+  type StaticServer,
+} from '@astryxdesign/a11y-spec/storybook';
+
+const OUTPUT = path.resolve('context-menu-audit-evidence');
+const WIDE = {width: 1024, height: 768};
+const NARROW = {width: 320, height: 720};
+
+type Mode = 'light' | 'dark';
+type Direction = 'ltr' | 'rtl';
+type Theme = 'neutral' | 'butter';
+type Surface = 'menu' | 'dialog';
+type AuditCase = {
+  key: string;
+  storyId: string;
+  mode: Mode;
+  direction: Direction;
+  theme: Theme;
+  viewport: {width: number; height: number};
+  surface: Surface;
+  triggerText?: string;
+  menuName?: string;
+  expectedState?: 'default' | 'disabled' | 'sections' | 'selectable';
+};
+
+const cases: AuditCase[] = [
+  {
+    key: 'pointer-neutral-light',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-neutral-dark',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-butter-light',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'butter',
+    viewport: WIDE,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-butter-dark',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'butter',
+    viewport: WIDE,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-rtl-light',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'light',
+    direction: 'rtl',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-rtl-dark',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'dark',
+    direction: 'rtl',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-narrow-light',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: NARROW,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'pointer-narrow-dark',
+    storyId: 'core-contextmenu--pointer-presentation',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: NARROW,
+    surface: 'menu',
+    menuName: 'Document actions',
+  },
+  {
+    key: 'disabled-item-light',
+    storyId: 'core-contextmenu--with-disabled-items',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'Right-click this area',
+    expectedState: 'disabled',
+  },
+  {
+    key: 'sections-dark',
+    storyId: 'core-contextmenu--with-sections',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'Right-click for grouped actions',
+    expectedState: 'sections',
+  },
+  {
+    key: 'selectable-light',
+    storyId: 'core-contextmenu--with-selectable-items',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'Right-click for selectable items',
+    expectedState: 'selectable',
+  },
+  {
+    key: 'selectable-dark',
+    storyId: 'core-contextmenu--with-selectable-items',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'Right-click for selectable items',
+    expectedState: 'selectable',
+  },
+  {
+    key: 'sheet-light',
+    storyId: 'core-contextmenu--bottom-sheet-presentation',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: NARROW,
+    surface: 'dialog',
+  },
+  {
+    key: 'sheet-dark',
+    storyId: 'core-contextmenu--bottom-sheet-presentation',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: NARROW,
+    surface: 'dialog',
+  },
+  {
+    key: 'sheet-rtl',
+    storyId: 'core-contextmenu--bottom-sheet-presentation',
+    mode: 'light',
+    direction: 'rtl',
+    theme: 'neutral',
+    viewport: NARROW,
+    surface: 'dialog',
+  },
+  {
+    key: 'inline-light',
+    storyId: 'core-contextmenu--inline-trigger',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'T123',
+    menuName: 'Task actions',
+  },
+  {
+    key: 'inline-dark',
+    storyId: 'core-contextmenu--inline-trigger',
+    mode: 'dark',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'T123',
+    menuName: 'Task actions',
+  },
+  {
+    key: 'scroll-container-light',
+    storyId: 'core-contextmenu--in-scroll-container',
+    mode: 'light',
+    direction: 'ltr',
+    theme: 'neutral',
+    viewport: WIDE,
+    surface: 'menu',
+    triggerText: 'Right-click this area',
+  },
+];
+
+test.describe.configure({mode: 'serial', retries: 0});
+let server: StaticServer;
+let checkoutSha: string;
+let storybookSha: string;
+
+function storyUrl(item: AuditCase) {
+  return `${server.origin}/iframe.html?id=${item.storyId}&viewMode=story&globals=colorMode:${item.mode};astryxTheme:${item.theme};direction:${item.direction}`;
+}
+
+async function settle(page: Page) {
+  await holdMotionStill(page);
+  await page.evaluate(async () => document.fonts.ready);
+  await page.waitForTimeout(40);
+}
+
+async function openSurface(
+  page: Page,
+  item: AuditCase,
+): Promise<{surface: Locator; pointer: {x: number; y: number}}> {
+  const trigger =
+    item.storyId === 'core-contextmenu--pointer-presentation'
+      ? page.getByTestId('pointer-context-menu')
+      : item.storyId === 'core-contextmenu--bottom-sheet-presentation'
+        ? page.getByTestId('bottom-sheet-context-menu')
+        : item.triggerText
+          ? page.getByText(item.triggerText, {exact: true}).first()
+          : null;
+  if (trigger === null) {
+    throw new Error(`No trigger configured for ${item.key}`);
+  }
+  await trigger.scrollIntoViewIfNeeded();
+  const triggerBox = await trigger.boundingBox();
+  if (triggerBox === null) {
+    throw new Error(`Trigger has no rendered box for ${item.key}`);
+  }
+  const pointer = {
+    x: triggerBox.x + Math.min(40, triggerBox.width / 2),
+    y: triggerBox.y + Math.min(40, triggerBox.height / 2),
+  };
+  await page.mouse.click(pointer.x, pointer.y, {button: 'right'});
+  const surface =
+    item.surface === 'dialog'
+      ? page.getByRole('dialog').last()
+      : item.menuName
+        ? page.getByRole('menu', {name: item.menuName}).last()
+        : page.getByRole('menu').last();
+  await expect(surface).toBeVisible();
+  return {surface, pointer};
+}
+
+test.beforeAll(async () => {
+  fs.rmSync(OUTPUT, {recursive: true, force: true});
+  fs.mkdirSync(OUTPUT, {recursive: true});
+  checkoutSha = execFileSync('git', ['rev-parse', 'HEAD'], {
+    encoding: 'utf8',
+  }).trim();
+  const expected = process.env.ASTRYX_HEAD_SHA;
+  if (expected && expected !== checkoutSha) {
+    throw new Error(
+      `checkout ${checkoutSha} does not match expected head ${expected}`,
+    );
+  }
+  server = await serveStorybook(
+    process.env.ASTRYX_STORYBOOK_DIR ?? DEFAULT_STORYBOOK_DIR,
+  );
+  const response = await fetch(`${server.origin}/astryx-build-sha.txt`);
+  if (!response.ok) {
+    throw new Error(`Storybook build has no SHA stamp (${response.status})`);
+  }
+  storybookSha = (await response.text()).trim();
+  if (storybookSha !== checkoutSha) {
+    throw new Error(
+      `Storybook ${storybookSha} does not match checkout ${checkoutSha}`,
+    );
+  }
+});
+
+test.afterAll(async () => {
+  await server?.close();
+});
+
+for (const item of cases) {
+  test(item.key, async ({browser}) => {
+    const context = await browser.newContext({
+      viewport: item.viewport,
+      colorScheme: item.mode,
+      reducedMotion: 'reduce',
+    });
+    const page = await context.newPage();
+    const pageErrors: string[] = [];
+    page.on('pageerror', error => pageErrors.push(String(error)));
+    await page.goto(storyUrl(item), {waitUntil: 'load'});
+    await page.locator('#storybook-root').waitFor();
+    const {surface, pointer} = await openSurface(page, item);
+    await settle(page);
+
+    const menuItems = page.locator(
+      '[role="menuitem"], [role="menuitemcheckbox"], [role="menuitemradio"]',
+    );
+    if (item.surface === 'menu') {
+      await expect(menuItems.first()).toBeVisible();
+    } else {
+      await expect(surface.getByRole('button').first()).toBeVisible();
+    }
+    if (item.expectedState === 'disabled') {
+      await expect(
+        page.locator('[role="menuitem"][aria-disabled="true"]'),
+      ).toHaveCount(1);
+    }
+    if (item.expectedState === 'sections') {
+      await expect(page.getByRole('group')).toHaveCount(2);
+    }
+    if (item.expectedState === 'selectable') {
+      await expect(page.getByRole('menuitemcheckbox')).toHaveCount(2);
+      await expect(page.getByRole('menuitemradio')).toHaveCount(3);
+      await expect(
+        page.locator('[role="menuitemradio"][aria-checked="true"]'),
+      ).toHaveCount(1);
+    }
+
+    const observed = await surface.evaluate(element => {
+      const box = element.getBoundingClientRect();
+      return {
+        theme: document
+          .querySelector('[data-astryx-theme]')
+          ?.getAttribute('data-astryx-theme'),
+        mode: document.documentElement.getAttribute('data-theme'),
+        direction: getComputedStyle(element).direction,
+        viewport: {width: innerWidth, height: innerHeight},
+        reducedMotion: matchMedia('(prefers-reduced-motion: reduce)').matches,
+        horizontalOverflow:
+          document.documentElement.scrollWidth > innerWidth + 1,
+        fonts: document.fonts.status,
+        surfaceRole:
+          element.getAttribute('role') ??
+          (element instanceof HTMLDialogElement ? 'dialog' : null),
+        surfaceName:
+          element.getAttribute('aria-label') ??
+          element.getAttribute('aria-labelledby'),
+        geometry: {x: box.x, y: box.y, width: box.width, height: box.height},
+      };
+    });
+    const geometryPass =
+      observed.geometry !== null &&
+      observed.geometry.width > 0 &&
+      observed.geometry.height > 0;
+    let pointerPlacementPass = true;
+    if (item.storyId === 'core-contextmenu--pointer-presentation') {
+      const surfaceBox = await surface.boundingBox();
+      pointerPlacementPass =
+        surfaceBox !== null &&
+        Math.abs(
+          (item.direction === 'rtl'
+            ? surfaceBox.x + surfaceBox.width
+            : surfaceBox.x) - pointer.x,
+        ) <= 24 &&
+        Math.abs(surfaceBox.y - pointer.y) <= 24;
+    }
+
+    const png = await page.screenshot({animations: 'disabled', fullPage: true});
+    const image = `${item.key}.png`;
+    const receipt = {
+      schemaVersion: 1,
+      expected: {
+        build: checkoutSha,
+        storyId: item.storyId,
+        mode: item.mode,
+        direction: item.direction,
+        theme: item.theme,
+        viewport: item.viewport,
+        surface: item.surface,
+        state: item.expectedState ?? 'default',
+      },
+      observed: {
+        build: storybookSha,
+        ...observed,
+        menuItemCount: await menuItems.count(),
+        pageErrors,
+      },
+      image: {
+        file: image,
+        sha256: createHash('sha256').update(png).digest('hex'),
+        width: png.readUInt32BE(16),
+        height: png.readUInt32BE(20),
+      },
+      checks: {geometryPass, pointerPlacementPass},
+      passed:
+        storybookSha === checkoutSha &&
+        pageErrors.length === 0 &&
+        observed.theme === item.theme &&
+        observed.mode === item.mode &&
+        observed.direction === item.direction &&
+        observed.viewport.width === item.viewport.width &&
+        observed.viewport.height === item.viewport.height &&
+        observed.reducedMotion &&
+        !observed.horizontalOverflow &&
+        observed.fonts === 'loaded' &&
+        observed.surfaceRole === item.surface &&
+        geometryPass &&
+        pointerPlacementPass,
+    };
+    fs.writeFileSync(path.join(OUTPUT, image), png);
+    fs.writeFileSync(
+      path.join(OUTPUT, `${item.key}.sensors.json`),
+      `${JSON.stringify(receipt, null, 2)}\n`,
+    );
+    expect(receipt.passed).toBe(true);
+    await context.close();
+  });
+}