Name some types for readability

Author: JoyceZhu

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

@@ -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,8 +8,8 @@ export async function findForUrl(
   url: string,
   authContext?: AuthContext,
   includeScreenshots: boolean = false,
-  reducedMotion?: 'reduce' | 'no-preference',
-  colorScheme?: 'light' | 'dark' | 'no-preference',
+  reducedMotion?: ReducedMotionPreference,
+  colorScheme?: ColorSchemePreference,
 ): Promise<Finding[]> {
   const browser = await playwright.chromium.launch({
     headless: true,

.github/actions/find/src/findForUrl.ts

@@ -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'
@@ -12,20 +12,24 @@ export default async function () {
 
   const includeScreenshots = core.getInput('include_screenshots', {required: false}) !== 'false'
   const reducedMotionInput = core.getInput('reduced_motion', {required: false})
-  let reducedMotion: 'reduce' | 'no-preference' | undefined
+  let reducedMotion: ReducedMotionPreference | undefined
   if (reducedMotionInput) {
-    if (!['reduce', 'no-preference'].includes(reducedMotionInput)) {
-      throw new Error("Input 'reduced_motion' must be one of: 'reduce', 'no-preference'")
+    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 'reduce' | 'no-preference'
+    reducedMotion = reducedMotionInput as ReducedMotionPreference
   }
   const colorSchemeInput = core.getInput('color_scheme', {required: false})
-  let colorScheme: 'light' | 'dark' | 'no-preference' | undefined
+  let colorScheme: ColorSchemePreference | undefined
   if (colorSchemeInput) {
-    if (!['light', 'dark', 'no-preference'].includes(colorSchemeInput)) {
-      throw new Error("Input 'color_scheme' must be one of: 'light', 'dark', 'no-preference'")
+    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 'light' | 'dark' | 'no-preference'
+    colorScheme = colorSchemeInput as ColorSchemePreference
   }
 
   const findings = []

.github/actions/find/src/index.ts

@@ -31,3 +31,7 @@ export type AuthContextInput = {
   cookies?: Cookie[]
   localStorage?: LocalStorage
 }
+
+export type ReducedMotionPreference = 'reduce' | 'no-preference' | null
+
+export type ColorSchemePreference = 'light' | 'dark' | 'no-preference' | null