testaro 78.0.8 → 78.4.0

package/testaro/autocomplete.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,90 +9,73 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   autocomplete
   This test reports failures to equip name and email inputs with correct autocomplete attributes.
+  Compiled to autocomplete.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
-// IMPORTS
-
-const {doTest} = require('../procs/testaro');
-
 // FUNCTIONS
-
 // Runs the test and returns the result.
-exports.reporter = async (
-  page,
-  report,
-  _0,
-  withItems,
-  labels = {
+const reporter = async (page, report, _0, withItems, labels = {
     name: ['your name', 'full name', 'first and last name'],
     email: ['email'],
     given: ['first name', 'forename', 'given name'],
     family: ['last name', 'surname', 'family name']
-  }
-) => {
-  const getBadWhat = element => {
-    // Get the lower-cased accessible name of the element.
-    const accessibleName = window.getAccessibleName(element).toLowerCase();
-    const {type} = element;
-    let requiredAuto = '';
-    const labels = {
-      name: ['__nameLabels__'],
-      email: ['__emailLabels__'],
-      given: ['__givenLabels__'],
-      family: ['__familyLabels__']
+}) => {
+    // The candidate selector guarantees input elements, so the parameter is typed as one.
+    const getBadWhat = (element) => {
+        // Get the lower-cased accessible name of the element.
+        const accessibleName = window.getAccessibleName(element).toLowerCase();
+        const { type } = element;
+        let requiredAuto = '';
+        const labels = {
+            name: ['__nameLabels__'],
+            email: ['__emailLabels__'],
+            given: ['__givenLabels__'],
+            family: ['__familyLabels__']
+        };
+        // Get its required autocomplete value.
+        if (type === 'email'
+            || accessibleName && labels.email.some(label => accessibleName.includes(label))) {
+            requiredAuto = 'email';
+        }
+        else if (accessibleName && type === 'text' && labels.name.some(label => accessibleName.includes(label))) {
+            requiredAuto = 'name';
+        }
+        else if (accessibleName
+            && type === 'text'
+            && labels.given.some(label => accessibleName.includes(label))) {
+            requiredAuto = 'given-name';
+        }
+        else if (accessibleName
+            && type === 'text'
+            && labels.family.some(label => accessibleName.includes(label))) {
+            requiredAuto = 'family-name';
+        }
+        // Get its actual autocomplete value.
+        const actualAuto = element.getAttribute('autocomplete');
+        // If an autocomplete value is required but not present:
+        if (requiredAuto && !(actualAuto && actualAuto.includes(requiredAuto))) {
+            // Return a violation description.
+            return `input has no autocomplete="${requiredAuto}" attribute`;
+        }
     };
-    // Get its required autocomplete value.
-    if (
-      type === 'email'
-      || accessibleName && labels.email.some(label => accessibleName.includes(label))
-    ) {
-      requiredAuto = 'email';
-    }
-    else if (
-      accessibleName && type === 'text' && labels.name.some(label => accessibleName.includes(label))
-    ) {
-      requiredAuto = 'name';
-    }
-    else if (
-      accessibleName
-      && type === 'text'
-      && labels.given.some(label => accessibleName.includes(label))
-    ) {
-      requiredAuto = 'given-name';
-    }
-    else if (
-      accessibleName
-      && type === 'text'
-      && labels.family.some(label => accessibleName.includes(label))
-    ) {
-      requiredAuto = 'family-name';
-    }
-    // Get its actual autocomplete value.
-    const actualAuto = element.getAttribute('autocomplete');
-    // If an autocomplete value is required but not present:
-    if (requiredAuto && ! (actualAuto && actualAuto.includes(requiredAuto))) {
-      // Return a violation description.
-      return `input has no autocomplete="${requiredAuto}" attribute`;
-    }
-  };
-  const selector = 'body input[type=text], body input[type=email], body input:not([type])';
-  const whats = 'Inputs are missing required autocomplete attributes';
-  // Each placeholder sits inside single quotes in getBadWhat (e.g. name: ['__nameLabels__']).
-  // Replace the quoted placeholder with the bracket-stripped JSON so the result is a proper
-  // element list (name: ["your name", ...]) rather than a one-element array holding the JSON
-  // text of the array (name: ['["your name", ...]']), which never matches an accessible name.
-  const placeHolders = Object.keys(labels).map(key => `'__${key}Labels__'`);
-  const replacers = Object.values(labels).map(value => JSON.stringify(value).slice(1, -1));
-  // Create a stringified getBadWhat, with placeholders replaced with the specified label arrays.
-  let getBadWhatString = getBadWhat.toString();
-  [0, 1, 2, 3].forEach(index => {
-    getBadWhatString = getBadWhatString.replace(placeHolders[index], replacers[index]);
-  });
-  return doTest(
-    page, report, withItems, 'autocomplete', selector, whats, 2, getBadWhatString
-  );
+    const selector = 'body input[type=text], body input[type=email], body input:not([type])';
+    const whats = 'Inputs are missing required autocomplete attributes';
+    // Each placeholder sits inside single quotes in getBadWhat (e.g. name: ['__nameLabels__']).
+    // Replace the quoted placeholder with the bracket-stripped JSON so the result is a proper
+    // element list (name: ["your name", ...]) rather than a one-element array holding the JSON
+    // text of the array (name: ['["your name", ...]']), which never matches an accessible name.
+    const placeHolders = Object.keys(labels).map(key => `'__${key}Labels__'`);
+    const replacers = Object.values(labels).map(value => JSON.stringify(value).slice(1, -1));
+    // Create a stringified getBadWhat, with placeholders replaced with the specified label arrays.
+    let getBadWhatString = getBadWhat.toString();
+    [0, 1, 2, 3].forEach(index => {
+        getBadWhatString = getBadWhatString.replace(placeHolders[index], replacers[index]);
+    });
+    return (0, testaro_1.doTest)(page, report, withItems, 'autocomplete', selector, whats, 2, getBadWhatString);
 };
+exports.reporter = reporter;

package/testaro/autocomplete.ts

@@ -0,0 +1,101 @@
+/*
+  © 2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jeff Witt.
+  © 2025–2026 Jonathan Robert Pool.
+
+  Licensed under the MIT License. See LICENSE file at the project root or
+  https://opensource.org/license/mit/ for details.
+
+  SPDX-License-Identifier: MIT
+*/
+
+// IMPORTS
+
+import type {Page} from 'playwright';
+import {doTest} from '../procs/testaro';
+import type {BadWhat, Report} from '../types';
+
+/*
+  autocomplete
+  This test reports failures to equip name and email inputs with correct autocomplete attributes.
+  Compiled to autocomplete.js by tsc (issue #73); edit this file, not the emitted one.
+*/
+
+// FUNCTIONS
+
+// Runs the test and returns the result.
+export const reporter = async (
+  page: Page,
+  report: Report,
+  _0: unknown,
+  withItems: boolean,
+  labels: Record<'name' | 'email' | 'given' | 'family', string[]> = {
+    name: ['your name', 'full name', 'first and last name'],
+    email: ['email'],
+    given: ['first name', 'forename', 'given name'],
+    family: ['last name', 'surname', 'family name']
+  }
+) => {
+  // The candidate selector guarantees input elements, so the parameter is typed as one.
+  const getBadWhat = (element: HTMLInputElement): BadWhat => {
+    // Get the lower-cased accessible name of the element.
+    const accessibleName = window.getAccessibleName(element).toLowerCase();
+    const {type} = element;
+    let requiredAuto = '';
+    const labels = {
+      name: ['__nameLabels__'],
+      email: ['__emailLabels__'],
+      given: ['__givenLabels__'],
+      family: ['__familyLabels__']
+    };
+    // Get its required autocomplete value.
+    if (
+      type === 'email'
+      || accessibleName && labels.email.some(label => accessibleName.includes(label))
+    ) {
+      requiredAuto = 'email';
+    }
+    else if (
+      accessibleName && type === 'text' && labels.name.some(label => accessibleName.includes(label))
+    ) {
+      requiredAuto = 'name';
+    }
+    else if (
+      accessibleName
+      && type === 'text'
+      && labels.given.some(label => accessibleName.includes(label))
+    ) {
+      requiredAuto = 'given-name';
+    }
+    else if (
+      accessibleName
+      && type === 'text'
+      && labels.family.some(label => accessibleName.includes(label))
+    ) {
+      requiredAuto = 'family-name';
+    }
+    // Get its actual autocomplete value.
+    const actualAuto = element.getAttribute('autocomplete');
+    // If an autocomplete value is required but not present:
+    if (requiredAuto && ! (actualAuto && actualAuto.includes(requiredAuto))) {
+      // Return a violation description.
+      return `input has no autocomplete="${requiredAuto}" attribute`;
+    }
+  };
+  const selector = 'body input[type=text], body input[type=email], body input:not([type])';
+  const whats = 'Inputs are missing required autocomplete attributes';
+  // Each placeholder sits inside single quotes in getBadWhat (e.g. name: ['__nameLabels__']).
+  // Replace the quoted placeholder with the bracket-stripped JSON so the result is a proper
+  // element list (name: ["your name", ...]) rather than a one-element array holding the JSON
+  // text of the array (name: ['["your name", ...]']), which never matches an accessible name.
+  const placeHolders = Object.keys(labels).map(key => `'__${key}Labels__'`);
+  const replacers = Object.values(labels).map(value => JSON.stringify(value).slice(1, -1));
+  // Create a stringified getBadWhat, with placeholders replaced with the specified label arrays.
+  let getBadWhatString = getBadWhat.toString();
+  [0, 1, 2, 3].forEach(index => {
+    getBadWhatString = getBadWhatString.replace(placeHolders[index], replacers[index]);
+  });
+  return doTest(
+    page, report, withItems, 'autocomplete', selector, whats, 2, getBadWhatString
+  );
+};

package/testaro/bulk.d.ts

@@ -0,0 +1,13 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report) => Promise<{
+    data: {};
+    totals: number[];
+    standardInstances: {
+        ruleID: string;
+        what: string;
+        ordinalSeverity: number;
+        count: number;
+        catalogIndex: string;
+    }[];
+}>;

package/testaro/bulk.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,45 +9,43 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
 /*
   bulk
   This test reports the count of visible elements. The test assumes that simplicity and compactness, with one page having one purpose, is an accessibility virtue. Users with visual, motor, and cognitive disabilities often have trouble finding what they want or understanding the purpose of a page if the page is cluttered with content.
+  Compiled to bulk.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
-// IMPORTS
-
-const {getXPathCatalogIndex} = require('../procs/xPath');
-
 // FUNCTIONS
-
 // Runs the test and returns the result.
-exports.reporter = async (page, report) => {
-  // Get a count of elements deemed visible by Playwright.
-  const visibleElementCount = await page.locator('body :visible').count();
-  // Convert the count to a severity level, treating up to 400 as non-reportable.
-  const severity = Math.min(4, Math.round(visibleElementCount / 400)) - 1;
-  const totals = [0, 0, 0, 0];
-  // If the severity is reportable:
-  if (severity > -1) {
-    totals[severity] = 1;
-    // Return data, totals, and a summary standard instance.
+const reporter = async (page, report) => {
+    // Get a count of elements deemed visible by Playwright.
+    const visibleElementCount = await page.locator('body :visible').count();
+    // Convert the count to a severity level, treating up to 400 as non-reportable.
+    const severity = Math.min(4, Math.round(visibleElementCount / 400)) - 1;
+    const totals = [0, 0, 0, 0];
+    // If the severity is reportable:
+    if (severity > -1) {
+        totals[severity] = 1;
+        // Return data, totals, and a summary standard instance.
+        return {
+            data: {},
+            totals,
+            standardInstances: [{
+                    ruleID: 'bulk',
+                    what: `Page contains ${visibleElementCount} visible elements`,
+                    ordinalSeverity: severity,
+                    count: 1,
+                    catalogIndex: (0, xPath_1.getXPathCatalogIndex)(report, '/html')
+                }]
+        };
+    }
+    // Otherwise, return data, totals, and an empty array of standard instances.
     return {
-      data: {},
-      totals,
-      standardInstances: [{
-        ruleID: 'bulk',
-        what: `Page contains ${visibleElementCount} visible elements`,
-        ordinalSeverity: severity,
-        count: 1,
-        catalogIndex: getXPathCatalogIndex(report, '/html')
-      }]
+        data: {},
+        totals,
+        standardInstances: []
     };
-  }
-  // Otherwise, return data, totals, and an empty array of standard instances.
-  return {
-    data: {},
-    totals,
-    standardInstances: []
-  };
 };
+exports.reporter = reporter;

package/testaro/bulk.ts

@@ -0,0 +1,55 @@
+/*
+  © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jeff Witt.
+  © 2025–2026 Jonathan Robert Pool.
+
+  Licensed under the MIT License. See LICENSE file at the project root or
+  https://opensource.org/license/mit/ for details.
+
+  SPDX-License-Identifier: MIT
+*/
+
+// IMPORTS
+
+import type {Page} from 'playwright';
+import {getXPathCatalogIndex} from '../procs/xPath';
+import type {Report} from '../types';
+
+/*
+  bulk
+  This test reports the count of visible elements. The test assumes that simplicity and compactness, with one page having one purpose, is an accessibility virtue. Users with visual, motor, and cognitive disabilities often have trouble finding what they want or understanding the purpose of a page if the page is cluttered with content.
+  Compiled to bulk.js by tsc (issue #73); edit this file, not the emitted one.
+*/
+
+// FUNCTIONS
+
+// Runs the test and returns the result.
+export const reporter = async (page: Page, report: Report) => {
+  // Get a count of elements deemed visible by Playwright.
+  const visibleElementCount = await page.locator('body :visible').count();
+  // Convert the count to a severity level, treating up to 400 as non-reportable.
+  const severity = Math.min(4, Math.round(visibleElementCount / 400)) - 1;
+  const totals = [0, 0, 0, 0];
+  // If the severity is reportable:
+  if (severity > -1) {
+    totals[severity] = 1;
+    // Return data, totals, and a summary standard instance.
+    return {
+      data: {},
+      totals,
+      standardInstances: [{
+        ruleID: 'bulk',
+        what: `Page contains ${visibleElementCount} visible elements`,
+        ordinalSeverity: severity,
+        count: 1,
+        catalogIndex: getXPathCatalogIndex(report, '/html')
+      }]
+    };
+  }
+  // Otherwise, return data, totals, and an empty array of standard instances.
+  return {
+    data: {},
+    totals,
+    standardInstances: []
+  };
+};

package/testaro/buttonMenu.d.ts

@@ -0,0 +1,9 @@
+import type { Page } from 'playwright';
+import type { Report, StandardInstance } from '../types';
+export declare const reporter: (page: Page, report: Report, _0: unknown, withItems: boolean, trialKeySpecs?: string[]) => Promise<{
+    data: {
+        trialKeys?: string[];
+    };
+    totals: number[];
+    standardInstances: StandardInstance[];
+}>;