testaro 78.0.8 → 78.4.0

package/testaro/nonTable.ts

@@ -0,0 +1,66 @@
+/*
+  © 2022–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';
+
+/*
+  nonTable
+  Derived from the bbc-a11y useTablesForData test. Crude heuristics omitted.
+  This test reports tables used for layout.
+  Compiled to nonTable.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, _: unknown, withItems: boolean) => {
+  // The candidate selector yields table elements.
+  const getBadWhat = (element: HTMLTableElement): BadWhat => {
+    // If the element contains another table:
+    if (element.querySelector('table')) {
+      // Return a violation description.
+      return 'Element contains another table';
+    }
+    const rowCount = element.querySelectorAll('tr').length;
+    const columnCount = Math.max(
+      ... Array
+      .from(element.querySelectorAll('tr'))
+      .map(row => Array.from(row.querySelectorAll('th, td')).length)
+    );
+    // Otherwise, if it has only 1 column or 1 row:
+    if (rowCount === 1 || columnCount === 1) {
+      // Return a violation description.
+      return 'Element has only one row or one column';
+    }
+    // Otherwise, if it contains an object or player:
+    if (element.querySelector('object, embed, applet, audio, video')) {
+      // Return a violation description.
+      return 'Element contains an object or player';
+    }
+    const role = element.getAttribute('role');
+    // Otherwise, if it has no table-compatible explicit role or descendant element:
+    if (! (
+      ['grid', 'treegrid'].includes(role as string)
+      || element.caption
+      || element.querySelector('col, colgroup, tfoot, th, thead')
+    )) {
+      // Return a violation description.
+      return 'Element has no table-compatible explicit role or descendant element';
+    }
+  };
+  const whats = 'table elements are misused for non-table content';
+  return await doTest(
+    page, report, withItems, 'nonTable', 'body table', whats, 2, getBadWhat.toString()
+  );
+};

package/testaro/optRoleSel.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;

package/testaro/optRoleSel.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2025 Juan S. Casado.
@@ -9,30 +10,26 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   optRoleSel
   Clean-room rule.
   This test reports elements with role=option that are missing aria-selected attributes.
+  Compiled to optRoleSel.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, _, withItems) => {
-  const getBadWhat = element => {
-    // If the element has no aria-selected attribute:
-    if (! element.hasAttribute('aria-selected')) {
-      // Return a violation description.
-      return 'Element has role=option but no aria-selected attribute';
-    }
-  };
-  const whats = 'Elements with role=option have no aria-selected attributes';
-  return await doTest(
-    page, report, withItems, 'optRoleSel', 'body [role="option"]', whats, 1, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // If the element has no aria-selected attribute:
+        if (!element.hasAttribute('aria-selected')) {
+            // Return a violation description.
+            return 'Element has role=option but no aria-selected attribute';
+        }
+    };
+    const whats = 'Elements with role=option have no aria-selected attributes';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'optRoleSel', 'body [role="option"]', whats, 1, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/optRoleSel.ts

@@ -0,0 +1,41 @@
+/*
+  © 2025 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2025 Juan S. Casado.
+  © 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 {GetBadWhat, Report} from '../types';
+
+/*
+  optRoleSel
+  Clean-room rule.
+  This test reports elements with role=option that are missing aria-selected attributes.
+  Compiled to optRoleSel.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, _: unknown, withItems: boolean) => {
+  const getBadWhat: GetBadWhat = element => {
+    // If the element has no aria-selected attribute:
+    if (! element.hasAttribute('aria-selected')) {
+      // Return a violation description.
+      return 'Element has role=option but no aria-selected attribute';
+    }
+  };
+  const whats = 'Elements with role=option have no aria-selected attributes';
+  return await doTest(
+    page, report, withItems, 'optRoleSel', 'body [role="option"]', whats, 1, getBadWhat.toString()
+  );
+};

package/testaro/phOnly.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;

package/testaro/phOnly.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2025 Juan S. Casado.
@@ -9,32 +10,28 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   phOnly
   Clean-room rule.
   This test reports input elements that have placeholders but no accessible names. The standard for accessible name computation is employed; it accepts title attributes as sources for accessible names. Thus, this test does not report reliance on title attributes for accessible names, although such reliance is generally considered a poor practice.
+  Compiled to phOnly.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, _, withItems) => {
-  const getBadWhat = element => {
-    // Get the accessible name of the element.
-    const accessibleName = window.getAccessibleName(element);
-    // If there is none:
-    if (! accessibleName) {
-      // Return a violation description.
-      return 'Element has a placeholder but no accessible name';
-    }
-  };
-  const whats = 'input elements have placeholders but no accessible names';
-  return await doTest(
-    page, report, withItems, 'phOnly', 'body input[placeholder]', whats, 2, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // Get the accessible name of the element.
+        const accessibleName = window.getAccessibleName(element);
+        // If there is none:
+        if (!accessibleName) {
+            // Return a violation description.
+            return 'Element has a placeholder but no accessible name';
+        }
+    };
+    const whats = 'input elements have placeholders but no accessible names';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'phOnly', 'body input[placeholder]', whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/phOnly.ts

@@ -0,0 +1,43 @@
+/*
+  © 2025 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2025 Juan S. Casado.
+  © 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 {GetBadWhat, Report} from '../types';
+
+/*
+  phOnly
+  Clean-room rule.
+  This test reports input elements that have placeholders but no accessible names. The standard for accessible name computation is employed; it accepts title attributes as sources for accessible names. Thus, this test does not report reliance on title attributes for accessible names, although such reliance is generally considered a poor practice.
+  Compiled to phOnly.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, _: unknown, withItems: boolean) => {
+  const getBadWhat: GetBadWhat = element => {
+    // Get the accessible name of the element.
+    const accessibleName = window.getAccessibleName(element);
+    // If there is none:
+    if (! accessibleName) {
+      // Return a violation description.
+      return 'Element has a placeholder but no accessible name';
+    }
+  };
+  const whats = 'input elements have placeholders but no accessible names';
+  return await doTest(
+    page, report, withItems, 'phOnly', 'body input[placeholder]', whats, 2, getBadWhat.toString()
+  );
+};

package/testaro/pseudoP.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;

package/testaro/pseudoP.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,49 +8,46 @@
 
   SPDX-License-Identifier: MIT
 */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   pseudoP
   This test reports 2 or more sequential br elements without intervening text content. They may be inferior substitutes for p elements.
+  Compiled to pseudoP.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, _, withItems) => {
-  const getBadWhat = element => {
-    // Get the node before the element node.
-    const previousNode = element.previousSibling;
-    let isBad = false;
-    // If it is a br element:
-    if (previousNode && previousNode.nodeType === Node.ELEMENT_NODE && previousNode.tagName === 'BR') {
-      // Classify the element as a violator.
-      isBad = true;
-    }
-    // Otherwise, if it is a text node:
-    else if (previousNode && previousNode.nodeType === Node.TEXT_NODE) {
-      // If the text node contains only whitespace:
-      if (previousNode.textContent.trim() === '') {
-        // Get the node before the text node.
-        const beforeText = previousNode.previousSibling;
-        // If that node is a br element:
-        if (beforeText && beforeText.nodeType === Node.ELEMENT_NODE && beforeText.tagName === 'BR') {
-          // Classify the element as a violator.
-          isBad = true;
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // Get the node before the element node.
+        const previousNode = element.previousSibling;
+        let isBad = false;
+        // If it is a br element:
+        if (previousNode && previousNode.nodeType === Node.ELEMENT_NODE && previousNode.tagName === 'BR') {
+            // Classify the element as a violator.
+            isBad = true;
+        }
+        // Otherwise, if it is a text node:
+        else if (previousNode && previousNode.nodeType === Node.TEXT_NODE) {
+            // If the text node contains only whitespace:
+            if (previousNode.textContent.trim() === '') {
+                // Get the node before the text node.
+                const beforeText = previousNode.previousSibling;
+                // If that node is a br element:
+                if (beforeText && beforeText.nodeType === Node.ELEMENT_NODE && beforeText.tagName === 'BR') {
+                    // Classify the element as a violator.
+                    isBad = true;
+                }
+            }
+        }
+        // If the element is a violator:
+        if (isBad) {
+            // Return a violation description.
+            return `Element follows another br element, possibly constituting a pseudo-paragraph`;
         }
-      }
-    }
-    // If the element is a violator:
-    if (isBad) {
-      // Return a violation description.
-      return `Element follows another br element, possibly constituting a pseudo-paragraph`;
-    }
-  };
-  const whats = 'br elements follow other br elements, possibly constituting pseudo-paragraphs';
-  return await doTest(
-    page, report, withItems, 'pseudoP', 'body br', whats, 0, getBadWhat.toString()
-  );
+    };
+    const whats = 'br elements follow other br elements, possibly constituting pseudo-paragraphs';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'pseudoP', 'body br', whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/pseudoP.ts

@@ -0,0 +1,59 @@
+/*
+  © 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 {GetBadWhat, Report} from '../types';
+
+/*
+  pseudoP
+  This test reports 2 or more sequential br elements without intervening text content. They may be inferior substitutes for p elements.
+  Compiled to pseudoP.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, _: unknown, withItems: boolean) => {
+  const getBadWhat: GetBadWhat = element => {
+    // Get the node before the element node.
+    const previousNode = element.previousSibling;
+    let isBad = false;
+    // If it is a br element:
+    if (previousNode && previousNode.nodeType === Node.ELEMENT_NODE && (previousNode as Element).tagName === 'BR') {
+      // Classify the element as a violator.
+      isBad = true;
+    }
+    // Otherwise, if it is a text node:
+    else if (previousNode && previousNode.nodeType === Node.TEXT_NODE) {
+      // If the text node contains only whitespace:
+      if (previousNode.textContent!.trim() === '') {
+        // Get the node before the text node.
+        const beforeText = previousNode.previousSibling;
+        // If that node is a br element:
+        if (beforeText && beforeText.nodeType === Node.ELEMENT_NODE && (beforeText as Element).tagName === 'BR') {
+          // Classify the element as a violator.
+          isBad = true;
+        }
+      }
+    }
+    // If the element is a violator:
+    if (isBad) {
+      // Return a violation description.
+      return `Element follows another br element, possibly constituting a pseudo-paragraph`;
+    }
+  };
+  const whats = 'br elements follow other br elements, possibly constituting pseudo-paragraphs';
+  return await doTest(
+    page, report, withItems, 'pseudoP', 'body br', whats, 0, getBadWhat.toString()
+  );
+};

package/testaro/radioSet.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _: unknown, withItems: boolean) => Promise<import("../procs/testaro").RuleResult>;

package/testaro/radioSet.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,69 +8,66 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   radioSet
   This test reports nonstandard groupings of radio buttons. It defines a standard grouping to require that two or more radio buttons with the same name, and no other radio buttons, be grouped in a fieldset element with a valid legend element.
+  Compiled to radioSet.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, _, withItems) => {
-  const getBadWhat = element => {
-    // Get the name of the element.
-    const elName = element.name;
-    // If it has none:
-    if (! elName) {
-      // Return a violation description.
-      return 'radio button has no name attribute';
-    }
-    // Identify the field set of the element.
-    const elFS = element.closest('fieldset');
-    // If it has none:
-    if (! elFS) {
-      // Return a violation description.
-      return 'radio button is not in a field set';
-    }
-    // Get the first child element of the field set.
-    const fsChild1 = elFS.firstElementChild;
-    // Get whether the child is a legend with text content.
-    const legendOK = fsChild1.tagName === 'LEGEND'
-    && fsChild1.textContent.replace(/\s/g, '').length;
-    // If it is not:
-    if (! legendOK) {
-      // Return a violation description.
-      return 'radio button is in a field set without a valid legend';
-    }
-    // Get the count of radio buttons with the same name in the field set.
-    const nameGroupSize = elFS.querySelectorAll(`input[type=radio][name=${elName}]`).length;
-    // If the count is only 1:
-    if (nameGroupSize === 1) {
-      // Return a violation description.
-      return 'radio button is the only one with its name in its field set';
-    }
-    // Get the count of radio buttons in the field set.
-    const groupSize = elFS.querySelectorAll('input[type=radio]').length;
-    // If it is greater than the count of radio buttons with the same name in the field set:
-    if (groupSize > nameGroupSize) {
-      // Return a violation description.
-      return 'radio button shares a field set with differently named others';
-    }
-    // Get the count of radio buttons with the same name in the document.
-    const nameDocSize = document.querySelectorAll(`input[type=radio][name=${elName}]`).length;
-    // If it is greater, and thus some such radio button is outside the field set:
-    if (nameDocSize > nameGroupSize) {
-      // Return a violation description.
-      return 'radio button shares a name with others outside its field set';
-    }
-  };
-  const whats = 'Radio buttons are not validly grouped in fieldsets with legends';
-  return await doTest(
-    page, report, withItems, 'radioSet', 'body input[type=radio]', whats, 2, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    // The candidate selector guarantees input elements, so the parameter is typed as one.
+    const getBadWhat = (element) => {
+        // Get the name of the element.
+        const elName = element.name;
+        // If it has none:
+        if (!elName) {
+            // Return a violation description.
+            return 'radio button has no name attribute';
+        }
+        // Identify the field set of the element.
+        const elFS = element.closest('fieldset');
+        // If it has none:
+        if (!elFS) {
+            // Return a violation description.
+            return 'radio button is not in a field set';
+        }
+        // Get the first child element of the field set.
+        const fsChild1 = elFS.firstElementChild;
+        // Get whether the child is a legend with text content.
+        const legendOK = fsChild1.tagName === 'LEGEND'
+            && fsChild1.textContent.replace(/\s/g, '').length;
+        // If it is not:
+        if (!legendOK) {
+            // Return a violation description.
+            return 'radio button is in a field set without a valid legend';
+        }
+        // Get the count of radio buttons with the same name in the field set.
+        const nameGroupSize = elFS.querySelectorAll(`input[type=radio][name=${elName}]`).length;
+        // If the count is only 1:
+        if (nameGroupSize === 1) {
+            // Return a violation description.
+            return 'radio button is the only one with its name in its field set';
+        }
+        // Get the count of radio buttons in the field set.
+        const groupSize = elFS.querySelectorAll('input[type=radio]').length;
+        // If it is greater than the count of radio buttons with the same name in the field set:
+        if (groupSize > nameGroupSize) {
+            // Return a violation description.
+            return 'radio button shares a field set with differently named others';
+        }
+        // Get the count of radio buttons with the same name in the document.
+        const nameDocSize = document.querySelectorAll(`input[type=radio][name=${elName}]`).length;
+        // If it is greater, and thus some such radio button is outside the field set:
+        if (nameDocSize > nameGroupSize) {
+            // Return a violation description.
+            return 'radio button shares a name with others outside its field set';
+        }
+    };
+    const whats = 'Radio buttons are not validly grouped in fieldsets with legends';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'radioSet', 'body input[type=radio]', whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/radioSet.ts

@@ -0,0 +1,79 @@
+/*
+  © 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 {doTest} from '../procs/testaro';
+import type {BadWhat, Report} from '../types';
+
+/*
+  radioSet
+  This test reports nonstandard groupings of radio buttons. It defines a standard grouping to require that two or more radio buttons with the same name, and no other radio buttons, be grouped in a fieldset element with a valid legend element.
+  Compiled to radioSet.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, _: unknown, withItems: boolean) => {
+  // The candidate selector guarantees input elements, so the parameter is typed as one.
+  const getBadWhat = (element: HTMLInputElement): BadWhat => {
+    // Get the name of the element.
+    const elName = element.name;
+    // If it has none:
+    if (! elName) {
+      // Return a violation description.
+      return 'radio button has no name attribute';
+    }
+    // Identify the field set of the element.
+    const elFS = element.closest('fieldset');
+    // If it has none:
+    if (! elFS) {
+      // Return a violation description.
+      return 'radio button is not in a field set';
+    }
+    // Get the first child element of the field set.
+    const fsChild1 = elFS.firstElementChild;
+    // Get whether the child is a legend with text content.
+    const legendOK = fsChild1!.tagName === 'LEGEND'
+    && fsChild1!.textContent!.replace(/\s/g, '').length;
+    // If it is not:
+    if (! legendOK) {
+      // Return a violation description.
+      return 'radio button is in a field set without a valid legend';
+    }
+    // Get the count of radio buttons with the same name in the field set.
+    const nameGroupSize = elFS.querySelectorAll(`input[type=radio][name=${elName}]`).length;
+    // If the count is only 1:
+    if (nameGroupSize === 1) {
+      // Return a violation description.
+      return 'radio button is the only one with its name in its field set';
+    }
+    // Get the count of radio buttons in the field set.
+    const groupSize = elFS.querySelectorAll('input[type=radio]').length;
+    // If it is greater than the count of radio buttons with the same name in the field set:
+    if (groupSize > nameGroupSize) {
+      // Return a violation description.
+      return 'radio button shares a field set with differently named others';
+    }
+    // Get the count of radio buttons with the same name in the document.
+    const nameDocSize = document.querySelectorAll(`input[type=radio][name=${elName}]`).length;
+    // If it is greater, and thus some such radio button is outside the field set:
+    if (nameDocSize > nameGroupSize) {
+      // Return a violation description.
+      return 'radio button shares a name with others outside its field set';
+    }
+  };
+  const whats = 'Radio buttons are not validly grouped in fieldsets with legends';
+  return await doTest(
+    page, report, withItems, 'radioSet', 'body input[type=radio]', whats, 2, getBadWhat.toString()
+  );
+};