testaro 78.0.8 → 78.4.0

package/testaro/allHidden.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,41 +8,39 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const xPath_1 = require("../procs/xPath");
 /*
   allHidden
-  This test reports a page that is entirely or mainly hidden.
+  This test reports a page that is entirely or mainly hidden. Compiled to allHidden.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) => {
-  // Get a count of elements deemed visible by Playwright.
-  const visibleElementCount = await page.locator('body :visible').count();
-  // If no element is visible:
-  if (! visibleElementCount) {
-    // Return data, totals, and a summary standard instance.
+const reporter = async (page, report) => {
+    // Get a count of elements deemed visible by Playwright.
+    const visibleElementCount = await page.locator('body :visible').count();
+    // If no element is visible:
+    if (!visibleElementCount) {
+        // Return data, totals, and a summary standard instance.
+        return {
+            data: {},
+            totals: [0, 0, 0, 1],
+            standardInstances: [{
+                    ruleID: 'allHidden',
+                    what: 'The entire page body is hidden or empty',
+                    ordinalSeverity: 3,
+                    count: 1,
+                    catalogIndex: (0, xPath_1.getXPathCatalogIndex)(report, '/html/body')
+                }]
+        };
+    }
+    // Otherwise, return data, totals, and an empty array of standard instances.
     return {
-      data: {},
-      totals: [0, 0, 0, 1],
-      standardInstances: [{
-        ruleID: 'allHidden',
-        what: 'The entire page body is hidden or empty',
-        ordinalSeverity: 3,
-        count: 1,
-        catalogIndex: getXPathCatalogIndex(report, '/html/body')
-      }]
+        data: {},
+        totals: [0, 0, 0, 0],
+        standardInstances: []
     };
-  }
-  // Otherwise, return data, totals, and an empty array of standard instances.
-  return {
-    data: {},
-    totals: [0, 0, 0, 0],
-    standardInstances: []
-  };
 };
+exports.reporter = reporter;

package/testaro/allHidden.ts

@@ -0,0 +1,50 @@
+/*
+  © 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 {getXPathCatalogIndex} from '../procs/xPath';
+import type {Report} from '../types';
+
+/*
+  allHidden
+  This test reports a page that is entirely or mainly hidden. Compiled to allHidden.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) => {
+  // Get a count of elements deemed visible by Playwright.
+  const visibleElementCount = await page.locator('body :visible').count();
+  // If no element is visible:
+  if (! visibleElementCount) {
+    // Return data, totals, and a summary standard instance.
+    return {
+      data: {},
+      totals: [0, 0, 0, 1],
+      standardInstances: [{
+        ruleID: 'allHidden',
+        what: 'The entire page body is hidden or empty',
+        ordinalSeverity: 3,
+        count: 1,
+        catalogIndex: getXPathCatalogIndex(report, '/html/body')
+      }]
+    };
+  }
+  // Otherwise, return data, totals, and an empty array of standard instances.
+  return {
+    data: {},
+    totals: [0, 0, 0, 0],
+    standardInstances: []
+  };
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,45 +8,41 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   allSlanted
   Related to Tenon rule 154.
   This test reports elements with italic or oblique text at least 40 characters long. Blocks of slanted text are difficult to read.
+  Compiled to allSlanted.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 {textContent} = element;
-    // If the element contains 40 or more characters of slanted text:
-    if (['italic', 'oblique'].includes(styleDec.fontStyle) && textContent.length > 39) {
-      const parent = element.parentElement;
-      // If the element has a parent:
-      if (parent) {
-        // Get the style declaration of the parent.
-        const parentStyleDec = window.getComputedStyle(parent);
-        const {fontStyle: parentFontStyle} = parentStyleDec;
-        // If the parent also has slanted text:
-        if (['italic', 'oblique'].includes(parentFontStyle)) {
-          // Do not report a violation, because the slant may be inherited.
-          return null;
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        const styleDec = window.getComputedStyle(element);
+        const { textContent } = element;
+        // If the element contains 40 or more characters of slanted text:
+        if (['italic', 'oblique'].includes(styleDec.fontStyle) && textContent.length > 39) {
+            const parent = element.parentElement;
+            // If the element has a parent:
+            if (parent) {
+                // Get the style declaration of the parent.
+                const parentStyleDec = window.getComputedStyle(parent);
+                const { fontStyle: parentFontStyle } = parentStyleDec;
+                // If the parent also has slanted text:
+                if (['italic', 'oblique'].includes(parentFontStyle)) {
+                    // Do not report a violation, because the slant may be inherited.
+                    return null;
+                }
+            }
+            // If it has no parent or its slant is autonomous, return a violation description.
+            return 'Element contains all-slanted text';
         }
-      }
-      // If it has no parent or its slant is autonomous, return a violation description.
-      return 'Element contains all-slanted text';
-    }
-  };
-  const selector = 'body, body *:not(style, script, svg)';
-  const whats = 'Elements contain all-slanted text';
-  return await doTest(
-    page, report, withItems, 'allSlanted', selector, whats, 0, getBadWhat.toString()
-  );
+    };
+    const selector = 'body, body *:not(style, script, svg)';
+    const whats = 'Elements contain all-slanted text';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'allSlanted', selector, whats, 0, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/allSlanted.ts

@@ -0,0 +1,54 @@
+/*
+  © 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';
+
+/*
+  allSlanted
+  Related to Tenon rule 154.
+  This test reports elements with italic or oblique text at least 40 characters long. Blocks of slanted text are difficult to read.
+  Compiled to allSlanted.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 styleDec = window.getComputedStyle(element);
+    const {textContent} = element;
+    // If the element contains 40 or more characters of slanted text:
+    if (['italic', 'oblique'].includes(styleDec.fontStyle) && textContent!.length > 39) {
+      const parent = element.parentElement;
+      // If the element has a parent:
+      if (parent) {
+        // Get the style declaration of the parent.
+        const parentStyleDec = window.getComputedStyle(parent);
+        const {fontStyle: parentFontStyle} = parentStyleDec;
+        // If the parent also has slanted text:
+        if (['italic', 'oblique'].includes(parentFontStyle)) {
+          // Do not report a violation, because the slant may be inherited.
+          return null;
+        }
+      }
+      // If it has no parent or its slant is autonomous, return a violation description.
+      return 'Element contains all-slanted text';
+    }
+  };
+  const selector = 'body, body *:not(style, script, svg)';
+  const whats = 'Elements contain all-slanted text';
+  return await doTest(
+    page, report, withItems, 'allSlanted', selector, whats, 0, getBadWhat.toString()
+  );
+};

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

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2025 CVS Health and/or one of its affiliates. All rights reserved.
   © 2025 Juan S. Casado.
@@ -9,39 +10,35 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   altScheme
-  This test reports img elements whose alt attributes are URLs or file names.
+  This test reports img elements whose alt attributes are URLs or file names. Compiled to
+  altScheme.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 value of the alt attribute of the element.
-    const alt = (element.getAttribute('alt') || '').trim();
-    // If it is non-empty:
-    if (alt) {
-      const isURL = /^(?:https?:|file:|ftp:)\S+$/i.test(alt);
-      const isFileName = /favicon|^\S+\.(?:png|jpe?g|gif|svg|webp|ico)$/i.test(alt);
-      // If it is a URL or file name:
-      if (isURL || isFileName) {
-        const valueType = isURL && isFileName
-        ? 'the URL of an image file'
-        : (isURL ? 'a URL' : 'a file name');
-        // Return a violation description.
-        return `img element has an alt attribute with ${valueType} as its value`;
-      }
-    }
-  };
-  const whats = 'img elements have alt attributes with URL or filename values';
-  return await doTest(
-    page, report, withItems, 'altScheme', 'body img[alt]', whats, 1, getBadWhat.toString()
-  );
+const reporter = async (page, report, _, withItems) => {
+    const getBadWhat = element => {
+        // Get the value of the alt attribute of the element.
+        const alt = (element.getAttribute('alt') || '').trim();
+        // If it is non-empty:
+        if (alt) {
+            const isURL = /^(?:https?:|file:|ftp:)\S+$/i.test(alt);
+            const isFileName = /favicon|^\S+\.(?:png|jpe?g|gif|svg|webp|ico)$/i.test(alt);
+            // If it is a URL or file name:
+            if (isURL || isFileName) {
+                const valueType = isURL && isFileName
+                    ? 'the URL of an image file'
+                    : (isURL ? 'a URL' : 'a file name');
+                // Return a violation description.
+                return `img element has an alt attribute with ${valueType} as its value`;
+            }
+        }
+    };
+    const whats = 'img elements have alt attributes with URL or filename values';
+    return await (0, testaro_1.doTest)(page, report, withItems, 'altScheme', 'body img[alt]', whats, 1, getBadWhat.toString());
 };
+exports.reporter = reporter;

package/testaro/altScheme.ts

@@ -0,0 +1,50 @@
+/*
+  © 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';
+
+/*
+  altScheme
+  This test reports img elements whose alt attributes are URLs or file names. Compiled to
+  altScheme.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 the value of the alt attribute of the element.
+    const alt = (element.getAttribute('alt') || '').trim();
+    // If it is non-empty:
+    if (alt) {
+      const isURL = /^(?:https?:|file:|ftp:)\S+$/i.test(alt);
+      const isFileName = /favicon|^\S+\.(?:png|jpe?g|gif|svg|webp|ico)$/i.test(alt);
+      // If it is a URL or file name:
+      if (isURL || isFileName) {
+        const valueType = isURL && isFileName
+        ? 'the URL of an image file'
+        : (isURL ? 'a URL' : 'a file name');
+        // Return a violation description.
+        return `img element has an alt attribute with ${valueType} as its value`;
+      }
+    }
+  };
+  const whats = 'img elements have alt attributes with URL or filename values';
+  return await doTest(
+    page, report, withItems, 'altScheme', 'body img[alt]', whats, 1, getBadWhat.toString()
+  );
+};

package/testaro/attVal.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _0: unknown, withItems: boolean, attributeName: string, areLicit: boolean, values: string[]) => Promise<import("../procs/testaro").RuleResult>;

package/testaro/attVal.js

@@ -1,3 +1,4 @@
+"use strict";
 /*
   © 2023 CVS Health and/or one of its affiliates. All rights reserved.
   © 2026 Jeff Witt.
@@ -7,31 +8,29 @@
 
   SPDX-License-Identifier: MIT
 */
-
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reporter = void 0;
+const testaro_1 = require("../procs/testaro");
 /*
   attVal
   This test reports elements with illicit values of an attribute.
+  Compiled to attVal.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, _0, withItems, attributeName, areLicit, values) => {
-  const getBadWhat = element => {
-    // Get the value of the attribute.
-    const value = element.getAttribute(attributeName);
-    // If it violates the rule:
-    if (areLicit !== values.includes(value)) {
-      // Return a violation description.
-      return `Element has attribute ${attributeName} with illicit value ${value}`;
-    }
-  };
-  const whats = `Elements have attribute ${attributeName} with illicit values`;
-  return await doTest(
-    page, report, withItems, 'attVal', `body [${attributeName}]`, whats, 2, getBadWhat.toString()
-  );
+const reporter = async (page, report, _0, withItems, attributeName, areLicit, values) => {
+    const getBadWhat = element => {
+        // Get the value of the attribute.
+        const value = element.getAttribute(attributeName);
+        // If it violates the rule:
+        if (areLicit !== values.includes(value)) {
+            // Return a violation description.
+            return `Element has attribute ${attributeName} with illicit value ${value}`;
+        }
+    };
+    // The predicate runs inside the page, so bind its parameters as literals in the serialized source.
+    const getBadWhatString = `((attributeName, areLicit, values) => ${getBadWhat.toString()})(${JSON.stringify(attributeName)}, ${Boolean(areLicit)}, ${JSON.stringify(values)})`;
+    const whats = `Elements have attribute ${attributeName} with illicit values`;
+    return await (0, testaro_1.doTest)(page, report, withItems, 'attVal', `[${attributeName}]`, whats, 2, getBadWhatString);
 };
+exports.reporter = reporter;

package/testaro/attVal.ts

@@ -0,0 +1,52 @@
+/*
+  © 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 {doTest} from '../procs/testaro';
+import type {GetBadWhat, Report} from '../types';
+
+/*
+  attVal
+  This test reports elements with illicit values of an attribute.
+  Compiled to attVal.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,
+  _0: unknown,
+  withItems: boolean,
+  attributeName: string,
+  areLicit: boolean,
+  values: string[]
+) => {
+  const getBadWhat: GetBadWhat = element => {
+    // Get the value of the attribute.
+    const value = element.getAttribute(attributeName);
+    // If it violates the rule:
+    if (areLicit !== values.includes(value as string)) {
+      // Return a violation description.
+      return `Element has attribute ${attributeName} with illicit value ${value}`;
+    }
+  };
+  // The predicate runs inside the page, so bind its parameters as literals in the serialized source.
+  const getBadWhatString = `((attributeName, areLicit, values) => ${
+    getBadWhat.toString()
+  })(${JSON.stringify(attributeName)}, ${Boolean(areLicit)}, ${JSON.stringify(values)})`;
+  const whats = `Elements have attribute ${attributeName} with illicit values`;
+  return await doTest(
+    page, report, withItems, 'attVal', `[${attributeName}]`, whats, 2, getBadWhatString
+  );
+};

package/testaro/autocomplete.d.ts

@@ -0,0 +1,3 @@
+import type { Page } from 'playwright';
+import type { Report } from '../types';
+export declare const reporter: (page: Page, report: Report, _0: unknown, withItems: boolean, labels?: Record<"name" | "email" | "given" | "family", string[]>) => Promise<import("../procs/testaro").RuleResult>;