testaro 78.0.6 → 78.4.0

package/testaro/focVis.js

@@ -1,5 +1,7 @@
+"use strict";
 /*
   © 2022–2025 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
@@ -7,41 +9,38 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   focVis
   Derived from the bbc-a11y elementsMustBeVisibleOnFocus test.
   This test reports links that are at least partly off the display when focused.
+  Compiled to focVis.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 isVisible = element.checkVisibility({
-      contentVisibilityAuto: true,
-      opacityProperty: true,
-      visibilityProperty: true
-    });
-    // If the element is visible:
-    if (isVisible) {
-      // Focus it.
-      element.focus();
-      const box = element.getBoundingClientRect();
-      // If it violates the rule:
-      if (box.x < 0 || box.y < 0) {
-        // Return a violation description.
-        return 'Upper left corner of the element is above or to the left of the display';
-      }
-    }
-  };
-  const whats = 'Visible links are above or to the left of the display';
-  return await doTest(
-    page, report, withItems, 'focVis', 'body a', whats, 2, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    // The candidate selector guarantees focusable HTML elements.
+    const getBadWhat = (element) => {
+        const isVisible = element.checkVisibility({
+            contentVisibilityAuto: true,
+            opacityProperty: true,
+            visibilityProperty: true
+        });
+        // If the element is visible:
+        if (isVisible) {
+            // Focus it.
+            element.focus();
+            const box = element.getBoundingClientRect();
+            // If it violates the rule:
+            if (box.x < 0 || box.y < 0) {
+                // Return a violation description.
+                return 'Upper left corner of the element is above or to the left of the display';
+            }
+        }
+    };
+    const whats = 'Visible links are above or to the left of the display';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'focVis', 'body a', whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/focVis.ts

@@ -0,0 +1,52 @@
+/*
+  © 2022–2025 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';
+
+/*
+  focVis
+  Derived from the bbc-a11y elementsMustBeVisibleOnFocus test.
+  This test reports links that are at least partly off the display when focused.
+  Compiled to focVis.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 focusable HTML elements.
+  const getBadWhat = (element: HTMLElement): BadWhat => {
+    const isVisible = element.checkVisibility({
+      contentVisibilityAuto: true,
+      opacityProperty: true,
+      visibilityProperty: true
+    });
+    // If the element is visible:
+    if (isVisible) {
+      // Focus it.
+      element.focus();
+      const box = element.getBoundingClientRect();
+      // If it violates the rule:
+      if (box.x < 0 || box.y < 0) {
+        // Return a violation description.
+        return 'Upper left corner of the element is above or to the left of the display';
+      }
+    }
+  };
+  const whats = 'Visible links are above or to the left of the display';
+  return await doTest(
+    page, report, withItems, 'focVis', 'body a', whats, 2, getBadWhat.toString()
+  );
+};

package/testaro/headEl.d.ts

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

package/testaro/headEl.js

@@ -1,78 +1,78 @@
+"use strict";
 /*
   © 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
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
 /*
   headEl
   Related to ASLint rule elements-not-allowed-in-head.
-  This test reports invalid descendants of the head of the document.
+  This test reports invalid descendants of the head of the document. Compiled to headEl.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) => {
-  // Initialize the data and standard result.
-  const data = {
-    total: 0,
-    badTagNames: []
-  };
-  let totals = [];
-  const standardInstances = [];
-  // Get the tag names of the elements in the head, even if the head tags are omitted.
-  const headElTagNames = await page.evaluate(() => {
-    const head = document.head;
-    const headChildren = head.children;
-    const tagNames = [];
-    for (const child of headChildren) {
-      tagNames.push(child.tagName);
-    }
-    return tagNames;
-  });
-  const validTagNames = [
-    'BASE',
-    'LINK',
-    'META',
-    'SCRIPT',
-    'STYLE',
-    'TITLE',
-    'NOSCRIPT',
-    'TEMPLATE'
-  ];
-  // For each head child:
-  headElTagNames.forEach(tagName => {
-    // If it is invalid:
-    if (! validTagNames.includes(tagName)) {
-      // Add its tag name to the result.
-      data.total++;
-      data.badTagNames.push(tagName);
-    }
-  });
-  // If there are any instances:
-  if (data.total) {
-    // Add a summary instance to the standard instances.
-    standardInstances.push({
-      ruleID: 'headEl',
-      what: `Invalid elements within the head: ${data.badTagNames.join(', ')}`,
-      ordinalSeverity: 2,
-      count: data.total,
-      catalogIndex: getXPathCatalogIndex(report, '/html/head')
+const reporter = async (page, report) => {
+    // Initialize the data and standard result.
+    const data = {
+        total: 0,
+        badTagNames: []
+    };
+    let totals = [];
+    const standardInstances = [];
+    // Get the tag names of the elements in the head, even if the head tags are omitted.
+    const headElTagNames = await page.evaluate(() => {
+        const head = document.head;
+        const headChildren = head.children;
+        const tagNames = [];
+        for (const child of headChildren) {
+            tagNames.push(child.tagName);
+        }
+        return tagNames;
     });
-  }
-  totals = [0, 0, data.total, 0];
-  // Return the data.
-  return {
-    data,
-    totals,
-    standardInstances
-  };
+    const validTagNames = [
+        'BASE',
+        'LINK',
+        'META',
+        'SCRIPT',
+        'STYLE',
+        'TITLE',
+        'NOSCRIPT',
+        'TEMPLATE'
+    ];
+    // For each head child:
+    headElTagNames.forEach(tagName => {
+        // If it is invalid:
+        if (!validTagNames.includes(tagName)) {
+            // Add its tag name to the result.
+            data.total++;
+            data.badTagNames.push(tagName);
+        }
+    });
+    // If there are any instances:
+    if (data.total) {
+        // Add a summary instance to the standard instances.
+        standardInstances.push({
+            ruleID: 'headEl',
+            what: `Invalid elements within the head: ${data.badTagNames.join(', ')}`,
+            ordinalSeverity: 2,
+            count: data.total,
+            catalogIndex: (0, xPath_1.getXPathCatalogIndex)(report, '/html/head')
+        });
+    }
+    totals = [0, 0, data.total, 0];
+    // Return the data.
+    return {
+        data,
+        totals,
+        standardInstances
+    };
 };
+exports.reporter = reporter;

package/testaro/headEl.ts

@@ -0,0 +1,82 @@
+/*
+  © 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 {getXPathCatalogIndex} from '../procs/xPath';
+import type {Report, StandardInstance} from '../types';
+
+/*
+  headEl
+  Related to ASLint rule elements-not-allowed-in-head.
+  This test reports invalid descendants of the head of the document. Compiled to headEl.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) => {
+  // Initialize the data and standard result.
+  const data: {total: number; badTagNames: string[]} = {
+    total: 0,
+    badTagNames: []
+  };
+  let totals: number[] = [];
+  const standardInstances: StandardInstance[] = [];
+  // Get the tag names of the elements in the head, even if the head tags are omitted.
+  const headElTagNames = await page.evaluate(() => {
+    const head = document.head;
+    const headChildren = head.children;
+    const tagNames: string[] = [];
+    for (const child of headChildren) {
+      tagNames.push(child.tagName);
+    }
+    return tagNames;
+  });
+  const validTagNames = [
+    'BASE',
+    'LINK',
+    'META',
+    'SCRIPT',
+    'STYLE',
+    'TITLE',
+    'NOSCRIPT',
+    'TEMPLATE'
+  ];
+  // For each head child:
+  headElTagNames.forEach(tagName => {
+    // If it is invalid:
+    if (! validTagNames.includes(tagName)) {
+      // Add its tag name to the result.
+      data.total++;
+      data.badTagNames.push(tagName);
+    }
+  });
+  // If there are any instances:
+  if (data.total) {
+    // Add a summary instance to the standard instances.
+    standardInstances.push({
+      ruleID: 'headEl',
+      what: `Invalid elements within the head: ${data.badTagNames.join(', ')}`,
+      ordinalSeverity: 2,
+      count: data.total,
+      catalogIndex: getXPathCatalogIndex(report, '/html/head')
+    });
+  }
+  totals = [0, 0, data.total, 0];
+  // Return the data.
+  return {
+    data,
+    totals,
+    standardInstances
+  };
+};

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

@@ -1,75 +1,67 @@
+"use strict";
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jeff Witt.
   © 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
 */
-
-/*
-  headingAmb
-  Related to ASLint rule headings-sibling-unique.
-  This test reports adjacent headings with the same levels and text contents.
-*/
-
-// IMPORTS
-
-const {doTest} = require('../procs/testaro');
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 // ########## FUNCTIONS
-
 // Runs the test and returns the result.
-exports.reporter = async (page, report, _, withItems) => {
-  const getBadWhat = element => {
-    const {tagName} = element;
-    const level = tagName[1];
-    const textContent = element.textContent.trim().replace(/\s+/g, ' ');
-    const headingTagNames = ['H1', 'H2', 'H3', 'H4', 'H5', 'H6'];
-    // Initialize the inspected element as the previous element sibling of the element.
-    let inspectedElement = element.previousElementSibling;
-    // As long as the inspected element exists:
-    while (inspectedElement) {
-      const inspectedTagName = inspectedElement.tagName;
-      // If it is a heading:
-      if (headingTagNames.includes(inspectedTagName)) {
-        // If it is inferior to the element:
-        if (inspectedTagName[1] > level) {
-          // Stop inspecting it and start inspecting its previous sibling.
-          inspectedElement = inspectedElement.previousElementSibling;
-          continue;
-        }
-        // Otherwise, if its level is the same as that of the element:
-        else if (inspectedTagName === tagName) {
-          const inspectedTextContent = inspectedElement.textContent.trim().replace(/\s+/g, ' ');
-          // If they have identical text contents:
-          if (inspectedTextContent === textContent) {
-            // Return a violation description.
-            return 'Heading has the same text as the prior same-level sibling heading';
-          }
-          // Otherwise, i.e. if they do not have identical text contents:
-          else {
-            // Stop inspecting.
-            break;
-          }
-        }
-        // Otherwise, i.e. if it is superior to the element:
-        else {
-          // Stop inspecting.
-          break;
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const { tagName } = element;
+        const level = tagName[1];
+        const textContent = element.textContent.trim().replace(/\s+/g, ' ');
+        const headingTagNames = ['H1', 'H2', 'H3', 'H4', 'H5', 'H6'];
+        // Initialize the inspected element as the previous element sibling of the element.
+        let inspectedElement = element.previousElementSibling;
+        // As long as the inspected element exists:
+        while (inspectedElement) {
+            const inspectedTagName = inspectedElement.tagName;
+            // If it is a heading:
+            if (headingTagNames.includes(inspectedTagName)) {
+                // If it is inferior to the element:
+                if (inspectedTagName[1] > level) {
+                    // Stop inspecting it and start inspecting its previous sibling.
+                    inspectedElement = inspectedElement.previousElementSibling;
+                    continue;
+                }
+                // Otherwise, if its level is the same as that of the element:
+                else if (inspectedTagName === tagName) {
+                    const inspectedTextContent = inspectedElement.textContent.trim().replace(/\s+/g, ' ');
+                    // If they have identical text contents:
+                    if (inspectedTextContent === textContent) {
+                        // Return a violation description.
+                        return 'Heading has the same text as the prior same-level sibling heading';
+                    }
+                    // Otherwise, i.e. if they do not have identical text contents:
+                    else {
+                        // Stop inspecting.
+                        break;
+                    }
+                }
+                // Otherwise, i.e. if it is superior to the element:
+                else {
+                    // Stop inspecting.
+                    break;
+                }
+            }
+            // Otherwise, i.e. if it is not a heading:
+            else {
+                // Inspect its previous sibling.
+                inspectedElement = inspectedElement.previousElementSibling;
+            }
         }
-      }
-      // Otherwise, i.e. if it is not a heading:
-      else {
-        // Inspect its previous sibling.
-        inspectedElement = inspectedElement.previousElementSibling;
-      }
-    }
-  };
-  const headingLevels = [1, 2, 3, 4, 5, 6];
-  const selector = headingLevels.map(level => `body h${level}`).join(', ');
-  const whats = 'Adjacent sibling same-level headings have the same text';
-  return await doTest(
-    page, report, withItems, 'headingAmb', selector, whats, 1, getBadWhat.toString()
-  );
+    };
+    const headingLevels = [1, 2, 3, 4, 5, 6];
+    const selector = headingLevels.map(level => `body h${level}`).join(', ');
+    const whats = 'Adjacent sibling same-level headings have the same text';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'headingAmb', selector, whats, 1, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/headingAmb.ts

@@ -0,0 +1,72 @@
+/*
+  © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
+  © 2026 Jeff Witt.
+  © 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';
+
+// ########## FUNCTIONS
+
+// Runs the test and returns the result.
+export const reporter = async (page: Page, report: Report, _: unknown, withItems: boolean) => {
+  const getBadWhat: GetBadWhat = element => {
+    const {tagName} = element;
+    const level = tagName[1];
+    const textContent = element.textContent.trim().replace(/\s+/g, ' ');
+    const headingTagNames = ['H1', 'H2', 'H3', 'H4', 'H5', 'H6'];
+    // Initialize the inspected element as the previous element sibling of the element.
+    let inspectedElement = element.previousElementSibling;
+    // As long as the inspected element exists:
+    while (inspectedElement) {
+      const inspectedTagName = inspectedElement.tagName;
+      // If it is a heading:
+      if (headingTagNames.includes(inspectedTagName)) {
+        // If it is inferior to the element:
+        if (inspectedTagName[1] > level) {
+          // Stop inspecting it and start inspecting its previous sibling.
+          inspectedElement = inspectedElement.previousElementSibling;
+          continue;
+        }
+        // Otherwise, if its level is the same as that of the element:
+        else if (inspectedTagName === tagName) {
+          const inspectedTextContent = inspectedElement.textContent.trim().replace(/\s+/g, ' ');
+          // If they have identical text contents:
+          if (inspectedTextContent === textContent) {
+            // Return a violation description.
+            return 'Heading has the same text as the prior same-level sibling heading';
+          }
+          // Otherwise, i.e. if they do not have identical text contents:
+          else {
+            // Stop inspecting.
+            break;
+          }
+        }
+        // Otherwise, i.e. if it is superior to the element:
+        else {
+          // Stop inspecting.
+          break;
+        }
+      }
+      // Otherwise, i.e. if it is not a heading:
+      else {
+        // Inspect its previous sibling.
+        inspectedElement = inspectedElement.previousElementSibling;
+      }
+    }
+  };
+  const headingLevels = [1, 2, 3, 4, 5, 6];
+  const selector = headingLevels.map(level => `body h${level}`).join(', ');
+  const whats = 'Adjacent sibling same-level headings have the same text';
+  return await doTest(
+    page, report, withItems, 'headingAmb', selector, whats, 1, getBadWhat.toString()
+  );
+};

package/testaro/hovInd.d.ts

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