testaro 78.0.8 → 78.4.0

package/testaro/miniText.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -8,58 +9,54 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   miniText
   Derived from the bbc-a11y textCannotBeTooSmall test.
   Related to Tenon rule 134.
   This test reports elements with font sizes smaller than 11 pixels.
+  Compiled to miniText.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 rawText = element.textContent || '';
-    // If the element has text content with any non-whitespace:
-    if (/[^\s]/.test(rawText)) {
-      const isVisible = element.checkVisibility({
-        contentVisibilityAuto: true,
-        opacityProperty: true,
-        visibilityProperty: true
-      });
-      // If the element is visible:
-      if (isVisible) {
-        const styleDec = window.getComputedStyle(element);
-        // Get its font size.
-        const fontSizeString = styleDec.fontSize;
-        const fontSize = Number.parseFloat(fontSizeString);
-        // If its font size is smaller than 11 pixels:
-        if (fontSize < 11) {
-          const parent = element.parentElement;
-          // If the element has a parent:
-          if (parent) {
-            const parentStyleDec = window.getComputedStyle(parent);
-            const parentFontSize = Number.parseFloat(parentStyleDec.fontSize);
-            // If the parent also has a font size smaller than 11 pixels:
-            if (parentFontSize < 11) {
-              // Do not report a violation, because the font size may be inherited.
-              return null;
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const rawText = element.textContent || '';
+        // If the element has text content with any non-whitespace:
+        if (/[^\s]/.test(rawText)) {
+            const isVisible = element.checkVisibility({
+                contentVisibilityAuto: true,
+                opacityProperty: true,
+                visibilityProperty: true
+            });
+            // If the element is visible:
+            if (isVisible) {
+                const styleDec = window.getComputedStyle(element);
+                // Get its font size.
+                const fontSizeString = styleDec.fontSize;
+                const fontSize = Number.parseFloat(fontSizeString);
+                // If its font size is smaller than 11 pixels:
+                if (fontSize < 11) {
+                    const parent = element.parentElement;
+                    // If the element has a parent:
+                    if (parent) {
+                        const parentStyleDec = window.getComputedStyle(parent);
+                        const parentFontSize = Number.parseFloat(parentStyleDec.fontSize);
+                        // If the parent also has a font size smaller than 11 pixels:
+                        if (parentFontSize < 11) {
+                            // Do not report a violation, because the font size may be inherited.
+                            return null;
+                        }
+                    }
+                    // Return a violation description.
+                    return `Element is visible but its font size is ${fontSize}px, smaller than 11px`;
+                }
             }
-          }
-          // Return a violation description.
-          return `Element is visible but its font size is ${fontSize}px, smaller than 11px`;
         }
-      }
-    }
-  };
-  const whats = 'Visible elements have font sizes smaller than 11 pixels';
-  return await doTest(
-    page, report, withItems, 'miniText', 'body, body *:not(script, style)', whats, 2, getBadWhat.toString()
-  );
+    };
+    const whats = 'Visible elements have font sizes smaller than 11 pixels';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'miniText', 'body, body *:not(script, style)', whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/miniText.ts

@@ -0,0 +1,68 @@
+/*
+  © 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 {GetBadWhat, Report} from '../types';
+
+/*
+  miniText
+  Derived from the bbc-a11y textCannotBeTooSmall test.
+  Related to Tenon rule 134.
+  This test reports elements with font sizes smaller than 11 pixels.
+  Compiled to miniText.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 rawText = element.textContent || '';
+    // If the element has text content with any non-whitespace:
+    if (/[^\s]/.test(rawText)) {
+      const isVisible = element.checkVisibility({
+        contentVisibilityAuto: true,
+        opacityProperty: true,
+        visibilityProperty: true
+      });
+      // If the element is visible:
+      if (isVisible) {
+        const styleDec = window.getComputedStyle(element);
+        // Get its font size.
+        const fontSizeString = styleDec.fontSize;
+        const fontSize = Number.parseFloat(fontSizeString);
+        // If its font size is smaller than 11 pixels:
+        if (fontSize < 11) {
+          const parent = element.parentElement;
+          // If the element has a parent:
+          if (parent) {
+            const parentStyleDec = window.getComputedStyle(parent);
+            const parentFontSize = Number.parseFloat(parentStyleDec.fontSize);
+            // If the parent also has a font size smaller than 11 pixels:
+            if (parentFontSize < 11) {
+              // Do not report a violation, because the font size may be inherited.
+              return null;
+            }
+          }
+          // Return a violation description.
+          return `Element is visible but its font size is ${fontSize}px, smaller than 11px`;
+        }
+      }
+    }
+  };
+  const whats = 'Visible elements have font sizes smaller than 11 pixels';
+  return await doTest(
+    page, report, withItems, 'miniText', 'body, body *:not(script, style)', whats, 2, getBadWhat.toString()
+  );
+};

package/testaro/motion.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: {
+        prevented?: boolean;
+        error?: string;
+    };
+    totals: number[];
+    standardInstances: StandardInstance[];
+}>;

package/testaro/motion.js

@@ -1,9 +1,16 @@
+"use strict";
 /*
   © 2026 Jeff Witt.
   © 2025–2026 Jonathan Robert Pool.
   Licensed under the MIT License. See LICENSE for details.
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
+const shoot_1 = require("../procs/shoot");
+// pixelmatch and pngjs ship no bundled declarations, so their imports stay requires, untyped.
+const pixelmatch = require('pixelmatch').default;
+const { PNG } = require('pngjs');
 /*
   motion
   This test reports motion in a page by making a page image and comparing it with the initial one, i.e. the one made by the catalog proc.
@@ -11,107 +18,96 @@
   For minimal accessibility, standards require motion to be brief, or else stoppable by the user. But stopping motion can be difficult or impossible, and, by the time a user manages to stop motion, the motion may have caused annoyance or harm. For superior accessibility, a page contains no motion until and unless the user authorizes it. The test reports a rule violation if any pixels differ between the screenshots. The larger the change fraction, the greater the ordinal severity.
 
   WARNING: The shoot test uses the procs/screenShot module. See the warning in that module about browser types.
-*/
-
-// IMPORTS
-
-const {getXPathCatalogIndex} = require('../procs/xPath');
-const {shoot} = require('../procs/shoot');
-const pixelmatch = require('pixelmatch').default;
-const {PNG} = require('pngjs');
 
+  Compiled to motion.js by tsc (issue #73); edit this file, not the emitted one.
+*/
 // FUNCTIONS
-
 // Runs the test and returns the result.
-exports.reporter = async (page, report) => {
-  // Initialize the totals and standard instances.
-  const data = {};
-  const totals = [0, 0, 0, 0];
-  const standardInstances = [];
-  // If the initial image exists:
-  if (report.images?.length) {
-    let violationWhat = '';
-    let ordinalSeverity = 0;
-    // Make an image with the same color type as the initial one and get its base64 encoding.
-    const png = await shoot(page, report, {
-      exclusionSelector: null,
-      colorType: report.imageColor,
-      action: 'return'
-    });
-    // If this succeeded:
-    if (png) {
-      // Parse both base64 encodings into PNG objects.
-      const initialPNG = PNG.sync.read(Buffer.from(report.images[0], 'base64'));
-      const finalPNG = PNG.sync.read(Buffer.from(png, 'base64'));
-      // If their dimensions differ:
-      if (finalPNG.width !== initialPNG.width || finalPNG.height !== initialPNG.height) {
-        const fromSize = `${initialPNG.width}×${initialPNG.height}`;
-        const toSize = `${finalPNG.width}×${finalPNG.height}`;
-        // Describe the violation.
-        violationWhat = `Page size changes spontaneously (from ${fromSize} to ${toSize})`;
-      }
-      // Otherwise, i.e. if their dimensions are identical:
-      else {
-        // Get the count of differing pixels between the images, using the default sensitivity.
-        try {
-          const pixelChanges = pixelmatch(
-            initialPNG.data,
-            finalPNG.data,
-            null,
-            initialPNG.width,
-            initialPNG.height,
-            {
-              threshold: 0.1
+const reporter = async (page, report) => {
+    // Initialize the totals and standard instances.
+    const data = {};
+    const totals = [0, 0, 0, 0];
+    const standardInstances = [];
+    // Identify the image of the checkpoint being tested (images[0] for checkpoint 0).
+    const checkpointIndex = report.activeCheckpoint ?? 0;
+    const imageIndex = report.checkpoints?.[checkpointIndex]?.imageIndexes?.[0] ?? 0;
+    // If the initial image exists:
+    if (report.images?.[imageIndex] !== undefined) {
+        let violationWhat = '';
+        let ordinalSeverity = 0;
+        // Make an image with the same color type as the initial one and get its base64 encoding.
+        const png = await (0, shoot_1.shoot)(page, report, {
+            exclusionSelector: null,
+            colorType: report.imageColor,
+            action: 'return'
+        });
+        // If this succeeded:
+        if (png) {
+            // Parse both base64 encodings into PNG objects.
+            const initialPNG = PNG.sync.read(Buffer.from(report.images[imageIndex], 'base64'));
+            const finalPNG = PNG.sync.read(Buffer.from(png, 'base64'));
+            // If their dimensions differ:
+            if (finalPNG.width !== initialPNG.width || finalPNG.height !== initialPNG.height) {
+                const fromSize = `${initialPNG.width}×${initialPNG.height}`;
+                const toSize = `${finalPNG.width}×${finalPNG.height}`;
+                // Describe the violation.
+                violationWhat = `Page size changes spontaneously (from ${fromSize} to ${toSize})`;
+            }
+            // Otherwise, i.e. if their dimensions are identical:
+            else {
+                // Get the count of differing pixels between the images, using the default sensitivity.
+                try {
+                    const pixelChanges = pixelmatch(initialPNG.data, finalPNG.data, null, initialPNG.width, initialPNG.height, {
+                        threshold: 0.1
+                    });
+                    // Get the ratio of differing to all pixels as a percentage.
+                    const changePercent = Math.round(100 * pixelChanges / (initialPNG.width * initialPNG.height));
+                    // If any pixels were changed:
+                    if (pixelChanges) {
+                        // Describe the violation.
+                        violationWhat = `Content changes spontaneously (${changePercent}% of pixels changed)`;
+                        // Get the ordinal severity from the fractional pixel change.
+                        ordinalSeverity = Math.floor(Math.min(3, 0.4 * Math.sqrt(changePercent)));
+                    }
+                }
+                catch (err) {
+                    console.log(`pixelmatch error: ${err.message}, ${err.stack}`);
+                    data.prevented = true;
+                    data.error = `Pixel comparison failed: ${err.message}`;
+                }
+            }
+            // If there was a violation:
+            if (violationWhat) {
+                // Add to the totals.
+                totals[ordinalSeverity] = 1;
+                // Get a summary standard instance.
+                standardInstances.push({
+                    ruleID: 'motion',
+                    what: violationWhat,
+                    ordinalSeverity: ordinalSeverity,
+                    count: 1,
+                    catalogIndex: (0, xPath_1.getXPathCatalogIndex)(report, '/html/body')
+                });
             }
-          );
-          // Get the ratio of differing to all pixels as a percentage.
-          const changePercent = Math.round(
-            100 * pixelChanges / (initialPNG.width * initialPNG.height)
-          );
-          // If any pixels were changed:
-          if (pixelChanges) {
-            // Describe the violation.
-            violationWhat = `Content changes spontaneously (${changePercent}% of pixels changed)`;
-            // Get the ordinal severity from the fractional pixel change.
-            ordinalSeverity = Math.floor(Math.min(3, 0.4 * Math.sqrt(changePercent)));
-          }
-        } catch (err) {
-          console.log(`pixelmatch error: ${err.message}, ${err.stack}`);
-          data.prevented = true;
-          data.error = `Pixel comparison failed: ${err.message}`;
         }
-      }
-      // If there was a violation:
-      if (violationWhat) {
-        // Add to the totals.
-        totals[ordinalSeverity] = 1;
-        // Get a summary standard instance.
-        standardInstances.push({
-          ruleID: 'motion',
-          what: violationWhat,
-          ordinalSeverity,
-          count: 1,
-          catalogIndex: getXPathCatalogIndex(report, '/html/body')
-        });
-      }
+        // Otherwise, i.e. if it failed:
+        else {
+            // Report this.
+            data.prevented = true;
+            data.error = 'Image creation failed';
+        }
     }
-    // Otherwise, i.e. if it failed:
+    // Otherwise, i.e. if the initial image does not exist:
     else {
-      // Report this.
-      data.prevented = true;
-      data.error = 'Image creation failed';
+        // Report this.
+        data.prevented = true;
+        data.error = 'Initial image missing';
     }
-  }
-  // Otherwise, i.e. if the initial image does not exist:
-  else {
-    // Report this.
-    data.prevented = true;
-    data.error = 'Initial image missing';
-  }
-  // Return the result.
-  return {
-    data,
-    totals,
-    standardInstances
-  };
+    // Return the result.
+    return {
+        data,
+        totals,
+        standardInstances
+    };
 };
+exports.reporter = reporter;

package/testaro/motion.ts

@@ -0,0 +1,125 @@
+/*
+  © 2026 Jeff Witt.
+  © 2025–2026 Jonathan Robert Pool.
+  Licensed under the MIT License. See LICENSE for details.
+*/
+
+// IMPORTS
+
+import type {Page} from 'playwright';
+import {getXPathCatalogIndex} from '../procs/xPath';
+import {shoot} from '../procs/shoot';
+import type {Report, StandardInstance} from '../types';
+// pixelmatch and pngjs ship no bundled declarations, so their imports stay requires, untyped.
+const pixelmatch = require('pixelmatch').default;
+const {PNG} = require('pngjs');
+
+/*
+  motion
+  This test reports motion in a page by making a page image and comparing it with the initial one, i.e. the one made by the catalog proc.
+
+  For minimal accessibility, standards require motion to be brief, or else stoppable by the user. But stopping motion can be difficult or impossible, and, by the time a user manages to stop motion, the motion may have caused annoyance or harm. For superior accessibility, a page contains no motion until and unless the user authorizes it. The test reports a rule violation if any pixels differ between the screenshots. The larger the change fraction, the greater the ordinal severity.
+
+  WARNING: The shoot test uses the procs/screenShot module. See the warning in that module about browser types.
+
+  Compiled to motion.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 totals and standard instances.
+  const data: {prevented?: boolean; error?: string} = {};
+  const totals = [0, 0, 0, 0];
+  const standardInstances: StandardInstance[] = [];
+  // Identify the image of the checkpoint being tested (images[0] for checkpoint 0).
+  const checkpointIndex = report.activeCheckpoint ?? 0;
+  const imageIndex = report.checkpoints?.[checkpointIndex]?.imageIndexes?.[0] ?? 0;
+  // If the initial image exists:
+  if (report.images?.[imageIndex] !== undefined) {
+    let violationWhat = '';
+    let ordinalSeverity = 0;
+    // Make an image with the same color type as the initial one and get its base64 encoding.
+    const png = await shoot(page, report, {
+      exclusionSelector: null,
+      colorType: report.imageColor,
+      action: 'return'
+    });
+    // If this succeeded:
+    if (png) {
+      // Parse both base64 encodings into PNG objects.
+      const initialPNG = PNG.sync.read(Buffer.from(report.images[imageIndex], 'base64'));
+      const finalPNG = PNG.sync.read(Buffer.from(png, 'base64'));
+      // If their dimensions differ:
+      if (finalPNG.width !== initialPNG.width || finalPNG.height !== initialPNG.height) {
+        const fromSize = `${initialPNG.width}×${initialPNG.height}`;
+        const toSize = `${finalPNG.width}×${finalPNG.height}`;
+        // Describe the violation.
+        violationWhat = `Page size changes spontaneously (from ${fromSize} to ${toSize})`;
+      }
+      // Otherwise, i.e. if their dimensions are identical:
+      else {
+        // Get the count of differing pixels between the images, using the default sensitivity.
+        try {
+          const pixelChanges = pixelmatch(
+            initialPNG.data,
+            finalPNG.data,
+            null,
+            initialPNG.width,
+            initialPNG.height,
+            {
+              threshold: 0.1
+            }
+          );
+          // Get the ratio of differing to all pixels as a percentage.
+          const changePercent = Math.round(
+            100 * pixelChanges / (initialPNG.width * initialPNG.height)
+          );
+          // If any pixels were changed:
+          if (pixelChanges) {
+            // Describe the violation.
+            violationWhat = `Content changes spontaneously (${changePercent}% of pixels changed)`;
+            // Get the ordinal severity from the fractional pixel change.
+            ordinalSeverity = Math.floor(Math.min(3, 0.4 * Math.sqrt(changePercent)));
+          }
+        } catch (err) {
+          console.log(`pixelmatch error: ${(err as Error).message}, ${(err as Error).stack}`);
+          data.prevented = true;
+          data.error = `Pixel comparison failed: ${(err as Error).message}`;
+        }
+      }
+      // If there was a violation:
+      if (violationWhat) {
+        // Add to the totals.
+        totals[ordinalSeverity] = 1;
+        // Get a summary standard instance.
+        standardInstances.push({
+          ruleID: 'motion',
+          what: violationWhat,
+          ordinalSeverity: ordinalSeverity as StandardInstance['ordinalSeverity'],
+          count: 1,
+          catalogIndex: getXPathCatalogIndex(report, '/html/body')
+        });
+      }
+    }
+    // Otherwise, i.e. if it failed:
+    else {
+      // Report this.
+      data.prevented = true;
+      data.error = 'Image creation failed';
+    }
+  }
+  // Otherwise, i.e. if the initial image does not exist:
+  else {
+    // Report this.
+    data.prevented = true;
+    data.error = 'Initial image missing';
+  }
+  // Return the result.
+  return {
+    data,
+    totals,
+    standardInstances
+  };
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2022–2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,56 +8,49 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   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.
 */
-
-// 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 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)
-      || 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()
-  );
+const reporter = async (page, report, _, withItems) => {
+    // The candidate selector yields table elements.
+    const getBadWhat = (element) => {
+        // 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)
+            || 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 (0, testaro_1.doTest)(page, report, withItems, 'nonTable', 'body table', whats, 2, getBadWhat.toString());
 };
+exports.reporter = reporter;