testaro 78.0.8 → 78.4.0

package/testaro/distortion.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,37 +9,67 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   distortion
   Related to Tenon rule 271.
   This test reports elements whose transform style properties distort the content. Distortion makes text difficult to read.
+  Compiled to distortion.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 styleDec = window.getComputedStyle(element);
-    const {transform} = styleDec;
-    const badTransformTypes = ['matrix', 'perspective', 'rotate', 'scale', 'skew'];
-    // If the element style transforms the text:
-    if (transform) {
-      const transformType = badTransformTypes.find(key => transform.includes(key));
-      // If the transformation is distortive:
-      if (transformType) {
-        // Return a violation description.
-        return `Element distorts its text with ${transformType} transformation`;
-      }
-    }
-  };
-  const whats = 'Elements distort their texts';
-  return await doTest(
-    page, report, withItems, 'distortion', 'body, body *', whats, 0, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const { transform } = window.getComputedStyle(element);
+        // If the element has a transform (a computed value is always a matrix or matrix3d function):
+        if (transform && transform !== 'none') {
+            // Get the numeric arguments of the matrix function (its name is excluded, since it may contain a digit).
+            const argumentString = transform.slice(transform.indexOf('(') + 1);
+            const values = (argumentString.match(/-?\d*\.?\d+(?:e[+-]?\d+)?/g) || []).map(Number);
+            const isNear = (value0, value1) => Math.abs(value0 - value1) < 1e-6;
+            // Returns the type of a 2-dimensional transformation, or null if it only translates.
+            const get2DType = (a, b, c, d) => {
+                if (isNear(a, 1) && isNear(b, 0) && isNear(c, 0) && isNear(d, 1)) {
+                    return null;
+                }
+                if (isNear(b, 0) && isNear(c, 0)) {
+                    return 'scale';
+                }
+                if (isNear(a, d) && isNear(b, -c)) {
+                    return 'rotation';
+                }
+                return 'skew';
+            };
+            let type = 'nonstandard';
+            // If the transform is 2-dimensional:
+            if (values.length === 6) {
+                type = get2DType(values[0], values[1], values[2], values[3]);
+            }
+            // Otherwise, if it is 3-dimensional:
+            else if (values.length === 16) {
+                const [m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, , , m43, m44] = values;
+                const is2D = [m13, m14, m23, m24, m31, m32, m34, m43].every(value => isNear(value, 0))
+                    && isNear(m33, 1)
+                    && isNear(m44, 1);
+                // If it is equivalent to a 2-dimensional transform, classify it as one.
+                if (is2D) {
+                    type = get2DType(m11, m12, m21, m22);
+                }
+                // Otherwise, classify it as a perspective or other 3-dimensional transformation.
+                else {
+                    type = isNear(m34, 0) ? '3-dimensional' : 'perspective';
+                }
+            }
+            // If the transformation is distortive, i.e. not a pure translation:
+            if (type) {
+                // Return a violation description.
+                return `Element distorts its text with a ${type} transformation`;
+            }
+        }
+    };
+    const whats = 'Elements distort their texts';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'distortion', 'body, body *', whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/distortion.ts

@@ -0,0 +1,81 @@
+/*
+  © 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';
+
+/*
+  distortion
+  Related to Tenon rule 271.
+  This test reports elements whose transform style properties distort the content. Distortion makes text difficult to read.
+  Compiled to distortion.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 {transform} = window.getComputedStyle(element);
+    // If the element has a transform (a computed value is always a matrix or matrix3d function):
+    if (transform && transform !== 'none') {
+      // Get the numeric arguments of the matrix function (its name is excluded, since it may contain a digit).
+      const argumentString = transform.slice(transform.indexOf('(') + 1);
+      const values = (argumentString.match(/-?\d*\.?\d+(?:e[+-]?\d+)?/g) || []).map(Number);
+      const isNear = (value0: number, value1: number) => Math.abs(value0 - value1) < 1e-6;
+      // Returns the type of a 2-dimensional transformation, or null if it only translates.
+      const get2DType = (a: number, b: number, c: number, d: number) => {
+        if (isNear(a, 1) && isNear(b, 0) && isNear(c, 0) && isNear(d, 1)) {
+          return null;
+        }
+        if (isNear(b, 0) && isNear(c, 0)) {
+          return 'scale';
+        }
+        if (isNear(a, d) && isNear(b, -c)) {
+          return 'rotation';
+        }
+        return 'skew';
+      };
+      let type: string | null = 'nonstandard';
+      // If the transform is 2-dimensional:
+      if (values.length === 6) {
+        type = get2DType(values[0], values[1], values[2], values[3]);
+      }
+      // Otherwise, if it is 3-dimensional:
+      else if (values.length === 16) {
+        const [m11, m12, m13, m14, m21, m22, m23, m24, m31, m32, m33, m34, , , m43, m44] = values;
+        const is2D = [m13, m14, m23, m24, m31, m32, m34, m43].every(value => isNear(value, 0))
+        && isNear(m33, 1)
+        && isNear(m44, 1);
+        // If it is equivalent to a 2-dimensional transform, classify it as one.
+        if (is2D) {
+          type = get2DType(m11, m12, m21, m22);
+        }
+        // Otherwise, classify it as a perspective or other 3-dimensional transformation.
+        else {
+          type = isNear(m34, 0) ? '3-dimensional' : 'perspective';
+        }
+      }
+      // If the transformation is distortive, i.e. not a pure translation:
+      if (type) {
+        // Return a violation description.
+        return `Element distorts its text with a ${type} transformation`;
+      }
+    }
+  };
+  const whats = 'Elements distort their texts';
+  return await doTest(
+    page, report, withItems, 'distortion', 'body, body *', whats, 0, getBadWhat.toString()
+  );
+};

package/testaro/docType.d.ts

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

package/testaro/docType.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,35 +9,34 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
 /*
   docType
   Derived from the bbc-a11y allDocumentsMustHaveAW3cRecommendedDoctype test.
   This test reports a failure to equip the page document with a W3C-recommended HTML doctype.
+  Compiled to docType.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
-// IMPORTS
-
-const {getXPathCatalogIndex} = require('../procs/xPath');
-
 // Runs the test and returns the result.
-exports.reporter = async (page, report) => {
-  // Returns whether the page declares a document type.
-  const docHasType = await page.evaluate(() => {
-    const docType = document.doctype;
-    const docHasType = !! docType && docType.name && docType.name.toLowerCase() === 'html';
-    return docHasType;
-  });
-  // Return data, totals, and, if no document type is declared, a standard instance.
-  return {
-    data: {docHasType},
-    totals: [0, 0, 0, docHasType ? 0 : 1],
-    standardInstances: docHasType ? [] : [{
-      ruleID: 'docType',
-      what: 'Document has no standard HTML doctype preamble',
-      ordinalSeverity: 3,
-      count: 1,
-      catalogIndex: getXPathCatalogIndex(report, '/html')
-    }]
-  };
+const reporter = async (page, report) => {
+    // Returns whether the page declares a document type.
+    const docHasType = await page.evaluate(() => {
+        const docType = document.doctype;
+        const docHasType = !!docType && docType.name && docType.name.toLowerCase() === 'html';
+        return docHasType;
+    });
+    // Return data, totals, and, if no document type is declared, a standard instance.
+    return {
+        data: { docHasType },
+        totals: [0, 0, 0, docHasType ? 0 : 1],
+        standardInstances: docHasType ? [] : [{
+                ruleID: 'docType',
+                what: 'Document has no standard HTML doctype preamble',
+                ordinalSeverity: 3,
+                count: 1,
+                catalogIndex: (0, xPath_1.getXPathCatalogIndex)(report, '/html')
+            }]
+    };
 };
+exports.reporter = reporter;

package/testaro/docType.ts

@@ -0,0 +1,45 @@
+/*
+  © 2022–2023 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 {getXPathCatalogIndex} from '../procs/xPath';
+import type {Report} from '../types';
+
+/*
+  docType
+  Derived from the bbc-a11y allDocumentsMustHaveAW3cRecommendedDoctype test.
+  This test reports a failure to equip the page document with a W3C-recommended HTML doctype.
+  Compiled to docType.js by tsc (issue #73); edit this file, not the emitted one.
+*/
+
+// Runs the test and returns the result.
+export const reporter = async (page: Page, report: Report) => {
+  // Returns whether the page declares a document type.
+  const docHasType = await page.evaluate(() => {
+    const docType = document.doctype;
+    const docHasType = !! docType && docType.name && docType.name.toLowerCase() === 'html';
+    return docHasType;
+  });
+  // Return data, totals, and, if no document type is declared, a standard instance.
+  return {
+    data: {docHasType},
+    totals: [0, 0, 0, docHasType ? 0 : 1],
+    standardInstances: docHasType ? [] : [{
+      ruleID: 'docType',
+      what: 'Document has no standard HTML doctype preamble',
+      ordinalSeverity: 3,
+      count: 1,
+      catalogIndex: getXPathCatalogIndex(report, '/html')
+    }]
+  };
+};

package/testaro/dupAtt.d.ts

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

package/testaro/dupAtt.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023–2024 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,116 +8,124 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const getSource_1 = require("../procs/getSource");
+const xPath_1 = require("../procs/xPath");
 /*
-  dupAtt.js
+  dupAtt
   This test reports duplicate attributes. The test is performed on the source of the document, because browsers delete additional same-name attributes in the DOM.
+  Compiled to dupAtt.js by tsc (issue #73); edit this file, not the emitted one.
 */
-
-// ########## IMPORTS
-
-const {getSource} = require('../procs/getSource');
-const {getXPathCatalogIndex} = require('../procs/xPath');
-
 // ########## FUNCTIONS
-
+// Returns the catalog index of the element with an ID and tag name, or of the body if none does. Duplicate attributes are found in the source, not the DOM, so the ID is the only handle on the element.
+const getIDCatalogIndex = (report, tagName, id) => {
+    const { catalog } = report;
+    if (id && catalog) {
+        const index = Object.keys(catalog).find(key => catalog[key].id === id && catalog[key].tagName === tagName);
+        if (index !== undefined) {
+            return index;
+        }
+    }
+    return (0, xPath_1.getXPathCatalogIndex)(report, '/html/body');
+};
 // Runs the test and returns the result.
-exports.reporter = async (page, report, _, withItems) => {
-  // Initialize the data and standard result.
-  const data = {total: 0};
-  if (withItems) {
-    data.items = [];
-  }
-  let totals = [];
-  const standardInstances = [];
-  // Get the source.
-  const sourceData = await getSource(page);
-  // If it was not obtained:
-  if (sourceData.prevented) {
-    // Report this.
-    data.prevented = true;
-    data.error = sourceData.error;
-  }
-  // Otherwise, i.e. if it was obtained:
-  else {
-    let rawPage = sourceData.source;
-    // Change any spacing character sequences in it to single spaces.
-    rawPage = rawPage.replace(/\s+/g, ' ');
-    // Delete any spaces adjacent to equal symbols in it.
-    rawPage = rawPage.replace(/ = | =|= /g, '=');
-    // Remove any escaped quotation marks from it.
-    rawPage = rawPage.replace(/\\"|\\'/g, '');
-    // Remove any script code from it.
-    rawPage = rawPage.replace(/<script(?: [^<>]+)?>.*?<\/script>/g, '');
-    rawPage = rawPage.replace(/<script(?: [^<>]+)?>/g, '');
-    rawPage = rawPage.replace(/<\/script>/g, '');
-    // Remove any comments from it.
-    rawPage = rawPage.replace(/<!--.*?-->/g, '');
-    // Extract the syntactically valid opening tags of its elements.
-    let elements = rawPage.match(/<[a-zA-Z]+(?: [^<>]+)?>/g);
-    // Delete their enclosing angle brackets and any closing slashes.
-    elements = elements.map(element => element.replace(/< ?| ?\/?>/g, ''));
-    // Delete the values of any attributes in them.
-    const nvElements = elements.map(element => element.replace(/="[^"]*"/g, ''));
-    // For each element:
-    nvElements.forEach((element, index) => {
-      // Identify its tag name and attributes.
-      const terms = element.split(' ');
-      // If it has 2 or more attributes:
-      if (terms.length > 2) {
-        // If any is duplicated:
-        const tagName = terms[0].toUpperCase();
-        const attributes = terms.slice(1);
-        attributes.sort();
-        const duplicatedAttribute = attributes.find(
-          (current, attIndex) => attributes[attIndex + 1] === current
-        );
-        if (duplicatedAttribute) {
-          // Add data on the element to the data.
-          const id = terms.includes('id')
-            ? elements[index].replace(/^.+id="/, '').replace(/".+/, '')
-            : '';
-          data.total++;
-          if (withItems) {
-            data.items.push({
-              tagName,
-              id,
-              duplicatedAttribute
+const reporter = async (page, report, _, withItems) => {
+    // Initialize the data and standard result.
+    const data = { total: 0 };
+    if (withItems) {
+        data.items = [];
+    }
+    let totals = [];
+    const standardInstances = [];
+    // Get the source.
+    const sourceData = await (0, getSource_1.getSource)(page);
+    // If it was not obtained:
+    if (sourceData.prevented) {
+        // Report this.
+        data.prevented = true;
+        data.error = sourceData.error;
+    }
+    // Otherwise, i.e. if it was obtained:
+    else {
+        let rawPage = sourceData.source;
+        // Change any spacing character sequences in it to single spaces.
+        rawPage = rawPage.replace(/\s+/g, ' ');
+        // Delete any spaces adjacent to equal symbols in it.
+        rawPage = rawPage.replace(/ = | =|= /g, '=');
+        // Remove any escaped quotation marks from it.
+        rawPage = rawPage.replace(/\\"|\\'/g, '');
+        // Remove any script code from it.
+        rawPage = rawPage.replace(/<script(?: [^<>]+)?>.*?<\/script>/g, '');
+        rawPage = rawPage.replace(/<script(?: [^<>]+)?>/g, '');
+        rawPage = rawPage.replace(/<\/script>/g, '');
+        // Remove any comments from it.
+        rawPage = rawPage.replace(/<!--.*?-->/g, '');
+        // Extract the syntactically valid opening tags of its elements.
+        // A pageless source would make the match null; the original dereferenced it unguarded.
+        let elements = rawPage.match(/<[a-zA-Z]+(?: [^<>]+)?>/g);
+        // Delete their enclosing angle brackets and any closing slashes.
+        elements = elements.map(element => element.replace(/< ?| ?\/?>/g, ''));
+        // Delete the values of any attributes in them.
+        const nvElements = elements.map(element => element.replace(/="[^"]*"/g, ''));
+        // For each element:
+        nvElements.forEach((element, index) => {
+            // Identify its tag name and attributes.
+            const terms = element.split(' ');
+            // If it has 2 or more attributes:
+            if (terms.length > 2) {
+                // If any is duplicated:
+                const tagName = terms[0].toUpperCase();
+                const attributes = terms.slice(1);
+                attributes.sort();
+                const duplicatedAttribute = attributes.find((current, attIndex) => attributes[attIndex + 1] === current);
+                if (duplicatedAttribute) {
+                    // Add data on the element to the data.
+                    const id = terms.includes('id')
+                        ? elements[index].replace(/^.+id="/, '').replace(/".+/, '')
+                        : '';
+                    data.total++;
+                    if (withItems) {
+                        data.items.push({
+                            tagName,
+                            id,
+                            duplicatedAttribute
+                        });
+                    }
+                }
+            }
+        });
+        // If itemization is required and there are any instances:
+        if (data.items) {
+            // For each violator:
+            data.items.forEach(item => {
+                // Add an instance to the standard instances.
+                standardInstances.push({
+                    ruleID: 'dupAtt',
+                    what: `${item.tagName} element has 2 attributes named ${item.duplicatedAttribute}`,
+                    ordinalSeverity: 2,
+                    count: 1,
+                    catalogIndex: getIDCatalogIndex(report, item.tagName, item.id)
+                });
             });
-          }
         }
-      }
-    });
-    // If itemization is required and there are any instances:
-    if (data.items) {
-      // For each violator:
-      data.items.forEach(item => {
-        // Add an instance to the standard instances.
-        standardInstances.push({
-          ruleID: 'dupAtt',
-          what: `${item.tagName} element has 2 attributes named ${item.duplicatedAttribute}`,
-          ordinalSeverity: 2,
-          count: 1,
-          catalogIndex: getXPathCatalogIndex(report, '/html/body')
-        });
-      });
-    }
-    // Otherwise, if itemization is not required and there are any violations:
-    else if (data.total) {
-      // Add a summary instance to the standard instances.
-      standardInstances.push({
-        ruleID: 'dupAtt',
-        what: 'In some elements 2 attributes have the same name',
-        ordinalSeverity: 2,
-        count: data.total
-      });
+        // Otherwise, if itemization is not required and there are any violations:
+        else if (data.total) {
+            // Add a summary instance to the standard instances.
+            standardInstances.push({
+                ruleID: 'dupAtt',
+                what: 'In some elements 2 attributes have the same name',
+                ordinalSeverity: 2,
+                count: data.total
+            });
+        }
+        totals = [0, 0, data.total, 0];
     }
-    totals = [0, 0, data.total, 0];
-  }
-  // Return the data.
-  return {
-    data,
-    totals,
-    standardInstances
-  };
+    // Return the data.
+    return {
+        data,
+        totals,
+        standardInstances
+    };
 };
+exports.reporter = reporter;