testaro 78.0.8 → 78.4.0

package/testaro/linkAmb.ts

@@ -0,0 +1,105 @@
+/*
+  © 2023–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 {getXPathCatalogIndex} from '../procs/xPath';
+import type {Report, StandardInstance} from '../types';
+
+/*
+  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.
+*/
+
+// FUNCTIONS
+
+// Runs the test and returns the result.
+export const reporter = async (page: Page, report: Report, _: unknown, withItems: boolean) => {
+  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: [string, string | null][];
+      textTotals: Record<string, {linkCount: number; hrefs: Set<string | null>}>;
+    } = {
+      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: StandardInstance[] = [];
+    // 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
+      });
+    }
+    return {
+      data: {},
+      totals: [0, 0, violationCount, 0],
+      standardInstances
+    };
+  }, [withItems, catalogIndex] as const);
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,26 +8,22 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   linkExt
   This test reports links with target=_blank attributes.
+  Compiled to linkExt.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 => {
-    // Return a violation description.
-    return `Link has a target=_blank attribute`;
-  };
-  const whats = 'Links have target=_blank attributes';
-  return await doTest(
-    page, report, withItems, 'linkExt', 'body a[target=_blank]', whats, 0, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // Return a violation description.
+        return `Link has a target=_blank attribute`;
+    };
+    const whats = 'Links have target=_blank attributes';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'linkExt', 'body a[target=_blank]', whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/linkExt.ts

@@ -0,0 +1,35 @@
+/*
+  © 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';
+
+/*
+  linkExt
+  This test reports links with target=_blank attributes.
+  Compiled to linkExt.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 => {
+    // Return a violation description.
+    return `Link has a target=_blank attribute`;
+  };
+  const whats = 'Links have target=_blank attributes';
+  return await doTest(
+    page, report, withItems, 'linkExt', 'body a[target=_blank]', whats, 0, getBadWhat.toString()
+  );
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,38 +9,34 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   linkOldAtt
   This test reports links with deprecated attributes.
+  Compiled to linkOldAtt.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 attNames = element.getAttributeNames();
-    const allBadAttNames = ['charset', 'coords', 'name', 'rev', 'shape'];
-    const elementBadAttNames = allBadAttNames.filter(att => attNames.includes(att));
-    // If the element has 1 deprecated attribute:
-    if (elementBadAttNames.length === 1) {
-      // Return a violation description.
-      return `${elementBadAttNames[0]} attribute is deprecated`;
-    }
-    // Otherwise, if the element has 2 or more deprecated attributes:
-    if (elementBadAttNames.length > 1) {
-      // Return a violation description.
-      return `Element has deprecated attributes: ${elementBadAttNames.join(', ')}`;
-    }
-  };
-  const selector = 'body a[charset], body a[coords], body a[name], body a[rev], body a[shape]';
-  const whats = 'Links have deprecated attributes';
-  return await doTest(
-    page, report, withItems, 'linkOldAtt', selector, whats, 1, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const attNames = element.getAttributeNames();
+        const allBadAttNames = ['charset', 'coords', 'name', 'rev', 'shape'];
+        const elementBadAttNames = allBadAttNames.filter(att => attNames.includes(att));
+        // If the element has 1 deprecated attribute:
+        if (elementBadAttNames.length === 1) {
+            // Return a violation description.
+            return `${elementBadAttNames[0]} attribute is deprecated`;
+        }
+        // Otherwise, if the element has 2 or more deprecated attributes:
+        if (elementBadAttNames.length > 1) {
+            // Return a violation description.
+            return `Element has deprecated attributes: ${elementBadAttNames.join(', ')}`;
+        }
+    };
+    const selector = 'body a[charset], body a[coords], body a[name], body a[rev], body a[shape]';
+    const whats = 'Links have deprecated attributes';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'linkOldAtt', selector, whats, 1, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/linkOldAtt.ts

@@ -0,0 +1,48 @@
+/*
+  © 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';
+
+/*
+  linkOldAtt
+  This test reports links with deprecated attributes.
+  Compiled to linkOldAtt.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 attNames = element.getAttributeNames();
+    const allBadAttNames = ['charset', 'coords', 'name', 'rev', 'shape'];
+    const elementBadAttNames = allBadAttNames.filter(att => attNames.includes(att));
+    // If the element has 1 deprecated attribute:
+    if (elementBadAttNames.length === 1) {
+      // Return a violation description.
+      return `${elementBadAttNames[0]} attribute is deprecated`;
+    }
+    // Otherwise, if the element has 2 or more deprecated attributes:
+    if (elementBadAttNames.length > 1) {
+      // Return a violation description.
+      return `Element has deprecated attributes: ${elementBadAttNames.join(', ')}`;
+    }
+  };
+  const selector = 'body a[charset], body a[coords], body a[name], body a[rev], body a[shape]';
+  const whats = 'Links have deprecated attributes';
+  return await doTest(
+    page, report, withItems, 'linkOldAtt', selector, whats, 1, getBadWhat.toString()
+  );
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,32 +9,31 @@
 
   SPDX-License-Identifier: MIT
 */
+// IMPORTS
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   linkTo
   This test reports links without href attributes.
+  Compiled to linkTo.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) {
-      // Return a violation description.
-      return `Element has no href attribute`;
-    }
-  };
-  const whats = 'Links are missing href attributes';
-  return await doTest(
-    page, report, withItems, 'linkTo', 'body a:not([href]', whats, 2, getBadWhat.toString()
-  );
+const 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) {
+            // Return a violation description.
+            return `Element has no href attribute`;
+        }
+    };
+    const whats = 'Links are missing href attributes';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'linkTo', 'body a:not([href]', whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/linkTo.ts

@@ -0,0 +1,43 @@
+/*
+  © 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';
+
+/*
+  linkTo
+  This test reports links without href attributes.
+  Compiled to linkTo.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 isVisible = element.checkVisibility({
+      contentVisibilityAuto: true,
+      opacityProperty: true,
+      visibilityProperty: true
+    });
+    // If the element is visible:
+    if (isVisible) {
+      // Return a violation description.
+      return `Element has no href attribute`;
+    }
+  };
+  const whats = 'Links are missing href attributes';
+  return await doTest(
+    page, report, withItems, 'linkTo', 'body a:not([href]', whats, 2, getBadWhat.toString()
+  );
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2021–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,44 +8,39 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   linkUl
   This test reports failures to underline links that have adjacent text. Underlining and color are the traditional style properties that identify links. A link whose text is the entire text of its block may be recognizable without underlining, but otherwise links are difficult or impossible to distinguish visually from surrounding text if not underlined. Underlining links only on hover provides an indicator valuable only to mouse users, and even they must traverse the text with a mouse merely to discover which passages are links.
+  Compiled to linkUl.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 => {
-    let {display, textDecorationLine} = window.getComputedStyle(element);
-    // If the element is not underlined:
-    if (! textDecorationLine.includes('underline')) {
-      let ancestor = element;
-      // Get its closest non-inline ancestor.
-      while (display === 'inline') {
-        ancestor = ancestor.parentElement;
-        display = ancestor ? window.getComputedStyle(ancestor).display : null;
-      }
-      // Removes superfluous whitespace from a string.
-      const compact = string => string?.replace(/\s+/g, ' ')?.trim();
-      // If the rendered compacted text of that ancestor includes more than that of the element:
-      if (
-        compact(element.textContent) !== compact(ancestor?.textContent)
-        && compact(element.innerText) !== compact(ancestor?.innerText)
-      ) {
-        // Return a violation description.
-        return 'Element has adjacent text but is not underlined';
-      }
-    }
-  };
-  const whats = 'Links with adjacent text are not underlined';
-  return await doTest(
-    page, report, withItems, 'linkUl', 'body a', whats, 1, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    // The candidate selector yields rendered HTML link elements.
+    const getBadWhat = (element) => {
+        let { display, textDecorationLine } = window.getComputedStyle(element);
+        // If the element is not underlined:
+        if (!textDecorationLine.includes('underline')) {
+            let ancestor = element;
+            // Get its closest non-inline ancestor.
+            while (display === 'inline') {
+                ancestor = ancestor.parentElement;
+                display = ancestor ? window.getComputedStyle(ancestor).display : null;
+            }
+            // Removes superfluous whitespace from a string.
+            const compact = (string) => string?.replace(/\s+/g, ' ')?.trim();
+            // If the rendered compacted text of that ancestor includes more than that of the element:
+            if (compact(element.textContent) !== compact(ancestor?.textContent)
+                && compact(element.innerText) !== compact(ancestor?.innerText)) {
+                // Return a violation description.
+                return 'Element has adjacent text but is not underlined';
+            }
+        }
+    };
+    const whats = 'Links with adjacent text are not underlined';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'linkUl', 'body a', whats, 1, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/linkUl.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';
+
+/*
+  linkUl
+  This test reports failures to underline links that have adjacent text. Underlining and color are the traditional style properties that identify links. A link whose text is the entire text of its block may be recognizable without underlining, but otherwise links are difficult or impossible to distinguish visually from surrounding text if not underlined. Underlining links only on hover provides an indicator valuable only to mouse users, and even they must traverse the text with a mouse merely to discover which passages are links.
+  Compiled to linkUl.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 rendered HTML link elements.
+  const getBadWhat = (element: HTMLElement): BadWhat => {
+    let {display, textDecorationLine}: {display: string | null; textDecorationLine: string} = window.getComputedStyle(element);
+    // If the element is not underlined:
+    if (! textDecorationLine.includes('underline')) {
+      let ancestor: HTMLElement | null = element;
+      // Get its closest non-inline ancestor.
+      while (display === 'inline') {
+        ancestor = ancestor!.parentElement;
+        display = ancestor ? window.getComputedStyle(ancestor).display : null;
+      }
+      // Removes superfluous whitespace from a string.
+      const compact = (string: string | null | undefined) => string?.replace(/\s+/g, ' ')?.trim();
+      // If the rendered compacted text of that ancestor includes more than that of the element:
+      if (
+        compact(element.textContent) !== compact(ancestor?.textContent)
+        && compact(element.innerText) !== compact(ancestor?.innerText)
+      ) {
+        // Return a violation description.
+        return 'Element has adjacent text but is not underlined';
+      }
+    }
+  };
+  const whats = 'Links with adjacent text are not underlined';
+  return await doTest(
+    page, report, withItems, 'linkUl', 'body a', whats, 1, getBadWhat.toString()
+  );
+};

package/testaro/miniText.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>;