testaro 78.0.8 → 78.4.0

package/testaro/labClash.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,43 +9,40 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   labClash
   This test reports redundant labeling of buttons, non-hidden inputs, select lists, and text areas. Redundant labels are labels that are superseded by other labels. Explicit and implicit (wrapped) labels are additive, not conflicting.
+  Compiled to labClash.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 label types of the element.
-    const labelTypes = [];
-    // Attribute and reference labels.
-    ['aria-label', 'aria-labelledby'].forEach(type => {
-      if (element.hasAttribute(type)) {
-        labelTypes.push(type);
-      }
-    });
-    // Explicit and implicit labels.
-    const labels = Array.from(element.labels);
-    if (labels.length) {
-      labelTypes.push('label');
-    }
-    // If it has more than 1 label type:
-    if (labelTypes.length > 1) {
-      // Return a violation description.
-      return `Element has inconsistent label types (${labelTypes.join(', ')})`;
-    }
-  };
-  const selector = 'body button, body input:not([type=hidden]), body select, body textarea';
-  const whats = 'Elements have inconsistent label types';
-  return await doTest(
-    page, report, withItems, 'labClash', selector, whats, 2, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    // The candidate selector guarantees labelable form controls.
+    const getBadWhat = (element) => {
+        // Get the label types of the element.
+        const labelTypes = [];
+        // Attribute and reference labels.
+        ['aria-label', 'aria-labelledby'].forEach(type => {
+            if (element.hasAttribute(type)) {
+                labelTypes.push(type);
+            }
+        });
+        // Explicit and implicit labels.
+        const labels = Array.from(element.labels);
+        if (labels.length) {
+            labelTypes.push('label');
+        }
+        // If it has more than 1 label type:
+        if (labelTypes.length > 1) {
+            // Return a violation description.
+            return `Element has inconsistent label types (${labelTypes.join(', ')})`;
+        }
+    };
+    const selector = 'body button, body input:not([type=hidden]), body select, body textarea';
+    const whats = 'Elements have inconsistent label types';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'labClash', selector, whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/labClash.ts

@@ -0,0 +1,54 @@
+/*
+  © 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';
+
+/*
+  labClash
+  This test reports redundant labeling of buttons, non-hidden inputs, select lists, and text areas. Redundant labels are labels that are superseded by other labels. Explicit and implicit (wrapped) labels are additive, not conflicting.
+  Compiled to labClash.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 labelable form controls.
+  const getBadWhat = (element: HTMLInputElement): BadWhat => {
+    // Get the label types of the element.
+    const labelTypes = [];
+    // Attribute and reference labels.
+    ['aria-label', 'aria-labelledby'].forEach(type => {
+      if (element.hasAttribute(type)) {
+        labelTypes.push(type);
+      }
+    });
+    // Explicit and implicit labels.
+    const labels = Array.from(element.labels!);
+    if (labels.length) {
+      labelTypes.push('label');
+    }
+    // If it has more than 1 label type:
+    if (labelTypes.length > 1) {
+      // Return a violation description.
+      return `Element has inconsistent label types (${labelTypes.join(', ')})`;
+    }
+  };
+  const selector = 'body button, body input:not([type=hidden]), body select, body textarea';
+  const whats = 'Elements have inconsistent label types';
+  return await doTest(
+    page, report, withItems, 'labClash', selector, whats, 2, getBadWhat.toString()
+  );
+};

package/testaro/legendLoc.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/legendLoc.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2025 Juan S. Casado.
@@ -9,31 +10,27 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   legendLoc
   Clean-room rule.
   This test reports legend elements that are not the first children of fieldset elements.
+  Compiled to legendLoc.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 => {
-    const parent = element.parentElement;
-    // If the element violates the rule:
-    if (! (parent && parent.tagName === 'FIELDSET' && parent.firstElementChild === element)) {
-      // Return a violation description.
-      return 'Element is not the first child of a fieldset element';
-    }
-  };
-  const whats = 'Legend elements are not the first children of fieldset elements';
-  return await doTest(
-    page, report, withItems, 'legendLoc', 'body legend', whats, 3, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const parent = element.parentElement;
+        // If the element violates the rule:
+        if (!(parent && parent.tagName === 'FIELDSET' && parent.firstElementChild === element)) {
+            // Return a violation description.
+            return 'Element is not the first child of a fieldset element';
+        }
+    };
+    const whats = 'Legend elements are not the first children of fieldset elements';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'legendLoc', 'body legend', whats, 3, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/legendLoc.ts

@@ -0,0 +1,42 @@
+/*
+  © 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';
+
+/*
+  legendLoc
+  Clean-room rule.
+  This test reports legend elements that are not the first children of fieldset elements.
+  Compiled to legendLoc.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 => {
+    const parent = element.parentElement;
+    // If the element violates the rule:
+    if (! (parent && parent.tagName === 'FIELDSET' && parent.firstElementChild === element)) {
+      // Return a violation description.
+      return 'Element is not the first child of a fieldset element';
+    }
+  };
+  const whats = 'Legend elements are not the first children of fieldset elements';
+  return await doTest(
+    page, report, withItems, 'legendLoc', 'body legend', whats, 3, getBadWhat.toString()
+  );
+};

package/testaro/lineHeight.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/lineHeight.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,60 +9,54 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   lineHeight
   Related to Tenon rule 144.
   This test reports elements whose line heights are less than 1.5 times their font sizes. Even such elements with no text create accessibility risk, because any text node added to one of them would have a substandard line height. Nonetheless, elements with no non-spacing text in their subtrees are excluded.
+  Compiled to lineHeight.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 whether the element has a non-spacing child text node.
-    const hasText = Array.from(element.childNodes).some(child =>
-      child.nodeType === Node.TEXT_NODE && child.textContent.trim()
-    );
-    // If so:
-    if (hasText) {
-      // Get its relevant style properties.
-      const styleDec = window.getComputedStyle(element);
-      const {fontSize, lineHeight} = styleDec;
-      const fontSizeNum = Number.parseFloat(fontSize);
-      const lineHeightNum = Number.parseFloat(lineHeight);
-      // Get whether it violates the rule.
-      const isBad = lineHeightNum < 1.495 * fontSizeNum;
-      // If it does:
-      if (isBad) {
-        const parent = element.parentElement;
-        // If the element has a parent:
-        if (parent) {
-          // Get the style properties of the parent.
-          const parentStyleDec = window.getComputedStyle(parent);
-          const {fontSize: parentFontSize, lineHeight: parentLineHeight} = parentStyleDec;
-          const parentFontSizeNum = Number.parseFloat(parentFontSize);
-          const parentLineHeightNum = Number.parseFloat(parentLineHeight);
-          // If the parent also violates the rule:
-          if (parentLineHeightNum < 1.495 * parentFontSizeNum) {
-            // Do not report a violation, because the line height may be inherited.
-            return null;
-          }
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // Get whether the element has a non-spacing child text node.
+        const hasText = Array.from(element.childNodes).some(child => child.nodeType === Node.TEXT_NODE && child.textContent.trim());
+        // If so:
+        if (hasText) {
+            // Get its relevant style properties.
+            const styleDec = window.getComputedStyle(element);
+            const { fontSize, lineHeight } = styleDec;
+            const fontSizeNum = Number.parseFloat(fontSize);
+            const lineHeightNum = Number.parseFloat(lineHeight);
+            // Get whether it violates the rule.
+            const isBad = lineHeightNum < 1.495 * fontSizeNum;
+            // If it does:
+            if (isBad) {
+                const parent = element.parentElement;
+                // If the element has a parent:
+                if (parent) {
+                    // Get the style properties of the parent.
+                    const parentStyleDec = window.getComputedStyle(parent);
+                    const { fontSize: parentFontSize, lineHeight: parentLineHeight } = parentStyleDec;
+                    const parentFontSizeNum = Number.parseFloat(parentFontSize);
+                    const parentLineHeightNum = Number.parseFloat(parentLineHeight);
+                    // If the parent also violates the rule:
+                    if (parentLineHeightNum < 1.495 * parentFontSizeNum) {
+                        // Do not report a violation, because the line height may be inherited.
+                        return null;
+                    }
+                }
+                const whatFontSize = `font size (${fontSizeNum.toFixed(1)}px)`;
+                const whatLineHeight = `line height (${lineHeightNum.toFixed(1)}px)`;
+                // Return a violation description.
+                return `Element ${whatLineHeight} is less than 1.5 times its ${whatFontSize}`;
+            }
         }
-        const whatFontSize = `font size (${fontSizeNum.toFixed(1)}px)`;
-        const whatLineHeight = `line height (${lineHeightNum.toFixed(1)}px)`;
-        // Return a violation description.
-        return `Element ${whatLineHeight} is less than 1.5 times its ${whatFontSize}`;
-      }
-    }
-  };
-  const whats = 'Element line heights are less than 1.5 times their font sizes';
-  return await doTest(
-    page, report, withItems, 'lineHeight', 'body, body *', whats, 1, getBadWhat.toString()
-  );
+    };
+    const whats = 'Element line heights are less than 1.5 times their font sizes';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'lineHeight', 'body, body *', whats, 1, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/lineHeight.ts

@@ -0,0 +1,70 @@
+/*
+  © 2023–2024 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';
+
+/*
+  lineHeight
+  Related to Tenon rule 144.
+  This test reports elements whose line heights are less than 1.5 times their font sizes. Even such elements with no text create accessibility risk, because any text node added to one of them would have a substandard line height. Nonetheless, elements with no non-spacing text in their subtrees are excluded.
+  Compiled to lineHeight.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 whether the element has a non-spacing child text node.
+    const hasText = Array.from(element.childNodes).some(child =>
+      child.nodeType === Node.TEXT_NODE && child.textContent!.trim()
+    );
+    // If so:
+    if (hasText) {
+      // Get its relevant style properties.
+      const styleDec = window.getComputedStyle(element);
+      const {fontSize, lineHeight} = styleDec;
+      const fontSizeNum = Number.parseFloat(fontSize);
+      const lineHeightNum = Number.parseFloat(lineHeight);
+      // Get whether it violates the rule.
+      const isBad = lineHeightNum < 1.495 * fontSizeNum;
+      // If it does:
+      if (isBad) {
+        const parent = element.parentElement;
+        // If the element has a parent:
+        if (parent) {
+          // Get the style properties of the parent.
+          const parentStyleDec = window.getComputedStyle(parent);
+          const {fontSize: parentFontSize, lineHeight: parentLineHeight} = parentStyleDec;
+          const parentFontSizeNum = Number.parseFloat(parentFontSize);
+          const parentLineHeightNum = Number.parseFloat(parentLineHeight);
+          // If the parent also violates the rule:
+          if (parentLineHeightNum < 1.495 * parentFontSizeNum) {
+            // Do not report a violation, because the line height may be inherited.
+            return null;
+          }
+        }
+        const whatFontSize = `font size (${fontSizeNum.toFixed(1)}px)`;
+        const whatLineHeight = `line height (${lineHeightNum.toFixed(1)}px)`;
+        // Return a violation description.
+        return `Element ${whatLineHeight} is less than 1.5 times its ${whatFontSize}`;
+      }
+    }
+  };
+  const whats = 'Element line heights are less than 1.5 times their font sizes';
+  return await doTest(
+    page, report, withItems, 'lineHeight', 'body, body *', whats, 1, getBadWhat.toString()
+  );
+};

package/testaro/linkAmb.d.ts

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

package/testaro/linkAmb.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023–2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,92 +9,90 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
 /*
   linkAmb
   Related to Tenon rule 98.
   This test reports text contents that are shared by links with distinct destinations. Text contents are compared case-insensitively.
+  Compiled to linkAmb.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, _, withItems) => {
-  const catalogIndex = getXPathCatalogIndex(report, '/html/body');
-  return await page.evaluate(args => {
-    const [withItems, catalogIndex] = args;
-    // Get all links.
-    const allLinks = Array.from(document.body.getElementsByTagName('a'));
-    // Get the visible ones.
-    const visibleLinks = allLinks.filter(link => link.checkVisibility({
-      contentVisibilityAuto: true,
-      opacityProperty: true,
-      visibilityProperty: true
-    }));
-    // Initialize the data.
-    const linksData = {
-      elementData: [],
-      textTotals: {}
-    };
-    // For each visible link:
-    visibleLinks.forEach(element => {
-      // Get its trimmed and lowercased text.
-      const text = element.textContent.trim().toLowerCase();
-      // Get its destination.
-      const href = element.getAttribute('href');
-      // Add to the data.
-      linksData.elementData.push([text, href]);
-      linksData.textTotals[text] ??= {
-        linkCount: 0,
-        hrefs: new Set()
-      };
-      const linkData = linksData.textTotals[text];
-      linkData.linkCount++;
-      linkData.hrefs.add(href);
-    });
-    let violationCount = 0;
-    const standardInstances = [];
-    // For each link text:
-    for (const [text, {linkCount, hrefs}] of Object.entries(linksData.textTotals)) {
-      const destinationCount = hrefs.size;
-      // If links with it violate the rule:
-      if (destinationCount > 1) {
-        // Increment the violation count.
-        violationCount += linkCount;
-        // If itemization is required:
-        if (withItems) {
-          const what = `${linkCount} links with the text “${text}” have ${destinationCount} different destinations`;
-          // Add an instance to the standard instances.
-          standardInstances.push({
-            ruleID: 'linkAmb',
-            what,
-            ordinalSeverity: 2,
-            count: linkCount,
-            catalogIndex
-          });
+const reporter = async (page, report, _, withItems) => {
+    const catalogIndex = (0, xPath_1.getXPathCatalogIndex)(report, '/html/body');
+    return await page.evaluate(args => {
+        const [withItems, catalogIndex] = args;
+        // Get all links.
+        const allLinks = Array.from(document.body.getElementsByTagName('a'));
+        // Get the visible ones.
+        const visibleLinks = allLinks.filter(link => link.checkVisibility({
+            contentVisibilityAuto: true,
+            opacityProperty: true,
+            visibilityProperty: true
+        }));
+        // Initialize the data.
+        const linksData = {
+            elementData: [],
+            textTotals: {}
+        };
+        // For each visible link:
+        visibleLinks.forEach(element => {
+            // Get its trimmed and lowercased text.
+            const text = element.textContent.trim().toLowerCase();
+            // Get its destination.
+            const href = element.getAttribute('href');
+            // Add to the data.
+            linksData.elementData.push([text, href]);
+            linksData.textTotals[text] ??= {
+                linkCount: 0,
+                hrefs: new Set()
+            };
+            const linkData = linksData.textTotals[text];
+            linkData.linkCount++;
+            linkData.hrefs.add(href);
+        });
+        let violationCount = 0;
+        const standardInstances = [];
+        // For each link text:
+        for (const [text, { linkCount, hrefs }] of Object.entries(linksData.textTotals)) {
+            const destinationCount = hrefs.size;
+            // If links with it violate the rule:
+            if (destinationCount > 1) {
+                // Increment the violation count.
+                violationCount += linkCount;
+                // If itemization is required:
+                if (withItems) {
+                    const what = `${linkCount} links with the text “${text}” have ${destinationCount} different destinations`;
+                    // Add an instance to the standard instances.
+                    standardInstances.push({
+                        ruleID: 'linkAmb',
+                        what,
+                        ordinalSeverity: 2,
+                        count: linkCount,
+                        catalogIndex
+                    });
+                }
+            }
+        }
+        // If there were any violations and itemization is not required:
+        if (violationCount && !withItems) {
+            const what = 'Links have the same text but different destinations';
+            // Add a summary instance to the instances.
+            standardInstances.push({
+                ruleID: 'linkAmb',
+                what,
+                ordinalSeverity: 2,
+                count: violationCount,
+                catalogIndex
+            });
         }
-      }
-    }
-    // If there were any violations and itemization is not required:
-    if (violationCount && ! withItems) {
-      const what = 'Links have the same text but different destinations';
-      // Add a summary instance to the instances.
-      standardInstances.push({
-        ruleID: 'linkAmb',
-        what,
-        ordinalSeverity: 2,
-        count: violationCount,
-        catalogIndex
-      });
-    }
-    return {
-      data: {},
-      totals: [0, 0, violationCount, 0],
-      standardInstances
-    };
-  }, [withItems, catalogIndex]);
+        return {
+            data: {},
+            totals: [0, 0, violationCount, 0],
+            standardInstances
+        };
+    }, [withItems, catalogIndex]);
 };
+exports.reporter = reporter;