Merge branch 'main' into joyce/document_questions

Author: JoyceZhu

.github/actions/auth/package-lock.json

@@ -17,7 +17,7 @@
     "playwright": "^1.58.2"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.3",
     "typescript": "^5.9.3"
   }
 }

.github/actions/auth/package.json

@@ -18,7 +18,7 @@
     "@octokit/plugin-throttling": "^11.0.3"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.3",
     "typescript": "^5.9.3"
   }
 }

.github/actions/file/package-lock.json

@@ -19,6 +19,18 @@ https://primer.style/octicons/
 
 **Optional** Stringified JSON object containing `username`, `password`, `cookies`, and/or `localStorage` from an authenticated session. For example: `{"username":"some-user","password":"correct-horse-battery-staple","cookies":[{"name":"theme-preference","value":"light","domain":"primer.style","path":"/"}],"localStorage":{"https://primer.style":{"theme-preference":"light"}}}`
 
+#### `reduced_motion`
+
+**Optional** Playwright
+[`reducedMotion`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-reduced-motion)
+configuration option.
+
+#### `color_scheme`
+
+**Optional** Playwright
+[`colorScheme`](https://playwright.dev/docs/api/class-browser#browser-new-context-option-color-scheme)
+configuration option.
+
 ### Outputs
 
 #### `findings`

.github/actions/file/package.json

@@ -13,6 +13,12 @@ inputs:
     description: "Whether to capture screenshots of scanned pages and include links to them in the issue"
     required: false
     default: "false"
+  reduced_motion:
+    description: "Playwright reducedMotion setting: https://playwright.dev/docs/api/class-browser#browser-new-page-option-reduced-motion"
+    required: false
+  color_scheme:
+    description: "Playwright colorScheme setting: https://playwright.dev/docs/api/class-browser#browser-new-context-option-color-scheme"
+    required: false
 
 outputs:
   findings:

.github/actions/find/README.md

@@ -18,7 +18,7 @@
     "playwright": "^1.58.2"
   },
   "devDependencies": {
-    "@types/node": "^25.3.0",
+    "@types/node": "^25.3.3",
     "typescript": "^5.9.3"
   }
 }

.github/actions/find/action.yml

@@ -1,4 +1,4 @@
-import type {Finding} from './types.d.js'
+import type {ColorSchemePreference, Finding, ReducedMotionPreference} from './types.d.js'
 import {AxeBuilder} from '@axe-core/playwright'
 import playwright from 'playwright'
 import {AuthContext} from './AuthContext.js'
@@ -8,12 +8,18 @@ export async function findForUrl(
   url: string,
   authContext?: AuthContext,
   includeScreenshots: boolean = false,
+  reducedMotion?: ReducedMotionPreference,
+  colorScheme?: ColorSchemePreference,
 ): Promise<Finding[]> {
   const browser = await playwright.chromium.launch({
     headless: true,
     executablePath: process.env.CI ? '/usr/bin/google-chrome' : undefined,
   })
-  const contextOptions = authContext?.toPlaywrightBrowserContextOptions() ?? {}
+  const contextOptions = {
+    ...(authContext?.toPlaywrightBrowserContextOptions() ?? {}),
+    ...(reducedMotion ? {reducedMotion} : {}),
+    ...(colorScheme ? {colorScheme} : {}),
+  }
   const context = await browser.newContext(contextOptions)
   const page = await context.newPage()
   await page.goto(url)

.github/actions/find/package-lock.json

@@ -1,4 +1,4 @@
-import type {AuthContextInput} from './types.js'
+import type {AuthContextInput, ColorSchemePreference, ReducedMotionPreference} from './types.js'
 import * as core from '@actions/core'
 import {AuthContext} from './AuthContext.js'
 import {findForUrl} from './findForUrl.js'
@@ -11,11 +11,31 @@ export default async function () {
   const authContext = new AuthContext(authContextInput)
 
   const includeScreenshots = core.getInput('include_screenshots', {required: false}) !== 'false'
+  const reducedMotionInput = core.getInput('reduced_motion', {required: false})
+  let reducedMotion: ReducedMotionPreference | undefined
+  if (reducedMotionInput) {
+    if (!['reduce', 'no-preference', null].includes(reducedMotionInput)) {
+      throw new Error(
+        "Input 'reduced_motion' must be one of: 'reduce', 'no-preference', or null per Playwright documentation.",
+      )
+    }
+    reducedMotion = reducedMotionInput as ReducedMotionPreference
+  }
+  const colorSchemeInput = core.getInput('color_scheme', {required: false})
+  let colorScheme: ColorSchemePreference | undefined
+  if (colorSchemeInput) {
+    if (!['light', 'dark', 'no-preference', null].includes(colorSchemeInput)) {
+      throw new Error(
+        "Input 'color_scheme' must be one of: 'light', 'dark', 'no-preference', or null per Playwright documentation.",
+      )
+    }
+    colorScheme = colorSchemeInput as ColorSchemePreference
+  }
 
   const findings = []
   for (const url of urls) {
     core.info(`Preparing to scan ${url}`)
-    const findingsForUrl = await findForUrl(url, authContext, includeScreenshots)
+    const findingsForUrl = await findForUrl(url, authContext, includeScreenshots, reducedMotion, colorScheme)
     if (findingsForUrl.length === 0) {
       core.info(`No accessibility gaps were found on ${url}`)
       continue