npm - @jrpool/kilotest - Versions diffs - 24.0.4 - Mend

@jrpool/kilotest 24.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (69) hide show

package/.claude/settings.local.json +9 -0
package/DEVELOPMENT.md +5860 -0
package/LICENSE +21 -0
package/README.md +44 -0
package/SERVICE.md +268 -0
package/aceconfig.js +28 -0
package/ai0BalanceForm/index.html +30 -0
package/ai0BalanceForm/index.js +79 -0
package/alerts.js +73 -0
package/diagnoses/index.html +46 -0
package/diagnoses/index.js +140 -0
package/env.example +21 -0
package/env.testaro +17 -0
package/error.html +18 -0
package/eslint.config.mjs +53 -0
package/favicon.ico +0 -0
package/index.html +39 -0
package/index.js +639 -0
package/issues/index.html +20 -0
package/issues/index.js +173 -0
package/job.json +100 -0
package/manage/index.html +32 -0
package/manage/index.js +22 -0
package/package.json +38 -0
package/pm2.config.js +15 -0
package/reannotate/index.html +19 -0
package/reannotate/index.js +39 -0
package/reannotateForm/index.html +29 -0
package/reannotateForm/index.js +114 -0
package/recActionForm/index.html +33 -0
package/recActionForm/index.js +49 -0
package/reportHideForm/index.html +29 -0
package/reportHideForm/index.js +89 -0
package/reportIssue/index.html +38 -0
package/reportIssue/index.js +181 -0
package/reportIssues/index.html +47 -0
package/reportIssues/index.js +259 -0
package/reportUnhideForm/index.html +29 -0
package/reportUnhideForm/index.js +89 -0
package/reportsExpungeForm/index.html +29 -0
package/reportsExpungeForm/index.js +105 -0
package/reportsPruneForm/index.html +29 -0
package/reportsPruneForm/index.js +105 -0
package/reportsRewindForm/index.html +29 -0
package/reportsRewindForm/index.js +105 -0
package/retestRec/index.html +23 -0
package/retestRec/index.js +19 -0
package/retestRecForm/index.html +27 -0
package/retestRecForm/index.js +36 -0
package/rules/index.html +28 -0
package/rules/index.js +71 -0
package/style.css +196 -0
package/targets/index.html +37 -0
package/targets/index.js +170 -0
package/testOrder/index.html +23 -0
package/testOrder/index.js +62 -0
package/testRec/index.html +23 -0
package/testRec/index.js +25 -0
package/testRecForm/index.html +34 -0
package/testRecForm/index.js +22 -0
package/tutorial/images/newsletter-form.png +0 -0
package/tutorial/index.html +796 -0
package/tutorial/index.js +53 -0
package/util.js +686 -0
package/wcagMap.json +102 -0
package/wcagRenew/index.html +19 -0
package/wcagRenew/index.js +70 -0
package/wcagRenewForm/index.html +25 -0
package/wcagRenewForm/index.js +22 -0

package/reportHideForm/index.html ADDED Viewed

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="publisher" content="Jonathan Robert Pool">
+    <meta name="creator" content="Jonathan Robert Pool">
+    <meta name="keywords" content="report,accessibility,a11y">
+    <title>Classify report as experimental | Kilotest</title>
+    <link rel="icon" href="/favicon.ico">
+    <link rel="stylesheet" href="/style.css">
+  </head>
+  <body>
+    <main>
+      <h1><a href="/">Kilotest</a>: Classify report as experimental</h1>
+      <p>Choose a report to classify as experimental.</p>
+      <form action="/reportHideForm.html">
+        <fieldset>
+          <legend>Reports</legend>
+          __reports__
+        </fieldset>
+        <p><label>
+          Authorization code: <input size="3" minLength="3" maxlength="3" name="authCode" required>
+        </label></p>
+        <p><button type="submit">Submit</button></p>
+      </form>
+    </main>
+  </body>
+</html>

package/reportHideForm/index.js ADDED Viewed

@@ -0,0 +1,89 @@
+/*
+  index.js
+  Serves a form for hiding a report.
+*/
+// IMPORTS
+const {getJSON, getLog, logsPath, reportsPath} = require('../util');
+const fs = require('fs/promises');
+const path = require('path');
+// FUNCTIONS
+// Returns a form for hiding a report.
+exports.answer = async (_, search) => {
+  const searchParams = new URLSearchParams(search);
+  const authCode = searchParams?.get('authCode');
+  const jobName = searchParams?.get('report');
+  // If the form has been displayed by itself after a submission and a report is to be hidden:
+  if (jobName) {
+    // If the authorization code is valid:
+    if (authCode === process.env.AUTH_CODE) {
+      // Get the log of the report.
+      const log = await getLog(... jobName.split('-'));
+      // Add a hiddenness property to the log.
+      log.hidden = true;
+      // Save the updated log.
+      await fs.writeFile(path.join(logsPath, `${jobName}.json`), getJSON(log));
+    }
+    // Otherwise, i.e. if the authorization code is invalid:
+    else {
+      // Report the error.
+      return {
+        status: 'error',
+        error: 'Invalid authorization code'
+      }
+    }
+  }
+  const reportFileNames = await fs.readdir(reportsPath);
+  const reportSpecs = [];
+  // For each report:
+  for (const reportFileName of reportFileNames) {
+    const [timeStamp, jobID] = reportFileName.slice(0, -5).split('-');
+    // Get its log.
+    const log = await getLog(timeStamp, jobID);
+    const {what, hidden} = log;
+    reportSpecs.push({
+      what,
+      timeStamp,
+      jobID,
+      hidden
+    });
+  }
+  // Sort the logs by page name and then by time stamp.
+  reportSpecs.sort((a, b) => {
+    if (a.what === b.what) {
+      return a.timeStamp.localeCompare(b.timeStamp);
+    }
+    return a.what.localeCompare(b.what);
+  });
+  const lines = [];
+  const margin = ' '.repeat(12);
+  // For each report:
+  reportSpecs.forEach(spec => {
+    const {hidden, what, timeStamp, jobID} = spec;
+    // If it is not already hidden:
+    if (! hidden) {
+      const specString = `${what} (job <code>${jobID}</code> at ${timeStamp})`;
+      // Add a line with a radio button to hide it.
+      lines.push(
+        `${margin}<p><input type="radio" name="report" value="${timeStamp}-${jobID}"> ${specString}</p>`
+      );
+    }
+  });
+  const query = {
+    reports: lines.join('\n'),
+  };
+  // Get the hiding form template.
+  let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
+  // Replace its placeholders.
+  Object.keys(query).forEach(param => {
+    answerPage = answerPage.replace(new RegExp(`__${param}__`, 'g'), query[param]);
+  });
+  // Return the populated page.
+  return {
+    status: 'ok',
+    answerPage
+  };
+};

package/reportIssue/index.html ADDED Viewed

@@ -0,0 +1,38 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="publisher" content="Jonathan Robert Pool">
+    <meta name="creator" content="Jonathan Robert Pool">
+    <meta name="keywords" content="report,accessibility,a11y">
+    <title>Violations of __issue__ for __target__ | Kilotest</title>
+    <link rel="icon" href="/favicon.ico">
+    <link rel="stylesheet" href="/style.css">
+  </head>
+  <body>
+    <main>
+      <h1><a href="/">Kilotest</a>: Violations of <q>__issue__</q> issue for __target__ page</h1>
+      <h2>Basics</h2>
+      <h3>About the __target__ page</h3>
+      <ul>
+        <li>URL: __urlLink__</li>
+        <li>__testInfo__</li>
+      </ul>
+      <h3>About the <q>__issue__</q> issue</h3>
+      <ul>
+        <li>Why it matters: __why__</li>
+        <li>Priority: __priority__</li>
+        <li>Related WCAG standard: __wcag__</li>
+        <li>Reported by __reporterCount__ (__reporters__)</li>
+        <li>__violatorCount__ reported</li>
+      </ul>
+      <h2>Violators</h2>
+      <p>Here are the HTML elements reported to violate rules belonging to the <q>__issue__</q> issue.</p>
+      __takeMeThere__
+      <ul class="headed">
+        __violators__
+      </ul>
+    </main>
+  </body>
+</html>

package/reportIssue/index.js ADDED Viewed

@@ -0,0 +1,181 @@
+/*
+  index.js
+  Answers the diagnoses question.
+*/
+// IMPORTS
+const {
+  getPageDataStrings,
+  getPathID,
+  getReport,
+  getToolNamesString,
+  getTextFragmentHref,
+  getWCAGLink,
+  getWeightName,
+  htmlSafe,
+  isHidden,
+  makeBreakable,
+} = require('../util');
+const {issues} = require('testilo/procs/score/tic');
+const fs = require('fs/promises');
+const path = require('path');
+// FUNCTIONS
+// Adds parameters to a query for the answer page.
+const populateQuery = async (issueID, timeStamp, jobID, query) => {
+  // Add facts about the issue to the query.
+  query.issue = issues[issueID].summary;
+  const pageDataStrings = await getPageDataStrings(timeStamp, jobID);
+  const {what, url, urlLink, testInfo} = pageDataStrings;
+  query.target = what;
+  query.urlLink = urlLink;
+  query.testInfo = testInfo;
+  const issue = issues[issueID];
+  const {wcag, weight, why} = issue;
+  query.why = why;
+  query.priority = getWeightName(weight);
+  query.wcag = `<a href="${getWCAGLink(wcag)}">${wcag}</a>`;
+  // Initialize those whose values depend on instance inspection.
+  query.count = 0;
+  query.reporters = new Set();
+  let violators = {};
+  // Get the report.
+  const report = await getReport(timeStamp, jobID);
+  const {acts, catalog} = report;
+  const testActs = acts.filter(act => act.type === 'test');
+  // For each test act:
+  testActs.forEach(act => {
+    const {result, which} = act;
+    const issueInstances = result?.standardResult?.instances?.filter(
+      instance => instance.issueID === issueID
+    ) ?? [];
+    // If the rule of any of its standard instances belongs to the issue:
+    if (issueInstances.length) {
+      query.reporters.add(which);
+    }
+    // For each standard instance whose rule belongs to the issue:
+    issueInstances.forEach(instance => {
+      const pathID = instance.pathID || '/html';
+      const catalogIndex = instance.catalogIndex || '0';
+      const tagName = catalog[catalogIndex]?.tagName
+      ?? pathID?.split('/').pop().replace(/\[.+$/, '').toUpperCase()
+      ?? 'HTML';
+      violators[catalogIndex] ??= {
+        pathID: getPathID(catalog, catalogIndex, pathID),
+        tagName,
+        text: catalog[catalogIndex]?.text ?? '',
+        reporters: new Set()
+      };
+      // Ensure that the tool is in the sets of reporters of the violator and the issue.
+      violators[catalogIndex].reporters.add(which);
+      query.reporters.add(which);
+    });
+    // Populate the violator count.
+    const violatorCount = Object.keys(violators).length;
+    query.violatorCount = violatorCount === 1 ? '1 violator was' : `${violatorCount} violators were`;
+  });
+  // For each violator:
+  Object.values(violators).forEach(violatorData => {
+    // Convert the set of its reporters to a string.
+    violatorData.reporters = getToolNamesString(violatorData.reporters);
+  });
+  const reporterCount = query.reporters.size;
+  query.reporterCount = reporterCount === 1 ? '1 tool' : `${reporterCount} tools`;
+  // Convert the set of issue reporters to a string.
+  query.reporters = getToolNamesString(query.reporters);
+  // Convert the violator data to an array.
+  violators = Object.entries(violators).map(entry => ({
+    catalogIndex: entry[0],
+    ... entry[1]
+  }));
+  // Sort the violators in XPath order.
+  violators.sort((a, b) => a.pathID.localeCompare(b.pathID));
+  // Initialize the lines.
+  const lines = [];
+  const margin = ' '.repeat(6);
+  let takeMeAdviceNeeded = false;
+  // For each violator:
+  violators.forEach((violator, index) => {
+    const {catalogIndex, pathID, reporters, tagName, text} = violator;
+    // Add a heading to the lines.
+    lines.push(`${margin}<li><h3>Element ${catalogIndex}</h3>`);
+    lines.push(`${margin}  <ul class="pseudoTopLevel">`);
+    // Add properties of the violator to the lines.
+    if (pathID) {
+      lines.push(`${margin}    <li>XPath: <code>${makeBreakable(pathID)}</code></li>`);
+    }
+    if (tagName) {
+      lines.push(`${margin}    <li>Tag name: <code>${tagName}</code></li>`);
+    }
+    if (text && ! ['HTML', 'HEAD', 'BODY', 'MAIN', 'NOSCRIPT'].includes(tagName)) {
+      const textString = text.split('\n').join(' … ');
+      lines.push(`${margin}    <li>Text: <q>${htmlSafe(textString)}</q></li>`);
+    }
+    lines.push(`${margin}    <li>Reported by ${reporters}</li>`);
+    lines.push(`${margin}  </ul>`);
+    lines.push(`${margin}  <ul class="nav">`);
+    if (catalogIndex) {
+      const catalogItem = catalog[catalogIndex] || {};
+      if (catalogItem.textLinkable) {
+        takeMeAdviceNeeded = true;
+        const href = getTextFragmentHref(catalogItem.text, url);
+        const label = `Take me to element ${catalogIndex} on the page (in a new tab)`;
+        const takeMeLink = `<a href="${href}" target="_blank" aria-label="${label}">Take me there</a>`;
+        lines.push(`${margin}    <li>${takeMeLink}</li>`);
+      }
+    }
+    const href
+    = `/diagnoses.html/${issueID}/${timeStamp}/${jobID}/${catalogIndex}?pathID=${pathID}`;
+    const questionString = 'What diagnoses were reported';
+    const labelString = `${questionString} for violator ${index + 1}?`;
+    lines.push(
+      `${margin}    <li><a href="${href}" aria-label="${labelString}">${questionString}?</a></li>`
+    );
+    lines.push(`${margin}  </ul>`);
+    lines.push(`${margin}</li>`);
+  });
+  // Add the lines to the query.
+  query.violators = lines.join('\n');
+  query.takeMeThere = '';
+  // If any lines contain text-fragment links:
+  if (takeMeAdviceNeeded) {
+    // Include advice about them in the answer.
+    query.takeMeThere = '<p><q>Take me there</q> links will open the page in a new tab and try to scroll to the element and highlight it. This does not always succeed. You can return here by closing the new tab.</p>';
+  }
+};
+// Returns a page answering the violators question.
+exports.answer = async pageArgs => {
+  const [issueID, timeStamp, jobID] = pageArgs.split('/');
+  const reportIsHidden = await isHidden(timeStamp, jobID);
+  // If the report is not available:
+  if (reportIsHidden) {
+    return {
+      status: 'error',
+      message: 'Report not available'
+    };
+  }
+  const query = {};
+  // Create a query to replace the placeholders.
+  await populateQuery(issueID, timeStamp, jobID, query);
+  // If the test specifications are valid:
+  if (query.testInfo) {
+    // Get the template.
+    let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
+    // Replace its placeholders.
+    Object.keys(query).forEach(param => {
+      answerPage = answerPage.replace(new RegExp(`__${param}__`, 'g'), query[param]);
+    });
+    // Return the populated page.
+    return {
+      status: 'ok',
+      answerPage
+    };
+  }
+  // Otherwise, report this.
+  return {
+    status: 'error',
+    error: 'Invalid report specification'
+  };
+};

package/reportIssues/index.html ADDED Viewed

@@ -0,0 +1,47 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="publisher" content="Jonathan Robert Pool">
+    <meta name="creator" content="Jonathan Robert Pool">
+    <meta name="keywords" content="report,accessibility,a11y">
+    <title>Issues reported for __target__ | Kilotest</title>
+    <link rel="icon" href="/favicon.ico">
+    <link rel="stylesheet" href="/style.css">
+  </head>
+  <body>
+    <main>
+      <h1><a href="/">Kilotest</a>: Issues reported for __target__</h1>
+      <h2>About the __target__ page</h2>
+      <ul>
+        <li>URL: __urlLink__</li>
+        <li>__testInfo__</li>
+        __preventions__
+      </ul>
+      <h2>Issues reported</h2>
+      <h3>Summary</h3>
+      <p>__reporterCount__ reported issues (__reporters__)</p>
+      <p>__issueCount__ reported (__highestCount__ highest, __highCount__ high, __lowCount__ low, __lowestCount__ lowest priority)</p>
+      <p>__violatorCount__ reported</p>
+      <p>Download the <a href="/fullReport.html/__timeStamp__/__jobID__">full technical report</a></p>
+      <h3>Details</h3>
+      <details>
+        <summary>Highest priority: __highestCount__</summary>
+        __highestDetails__
+      </details>
+      <details>
+        <summary>High priority: __highCount__</summary>
+        __highDetails__
+      </details>
+      <details>
+        <summary>Low priority: __lowCount__</summary>
+        __lowDetails__
+      </details>
+      <details>
+        <summary>Lowest priority: __lowestCount__</summary>
+        __lowestDetails__
+      </details>
+    </main>
+  </body>
+</html>

package/reportIssues/index.js ADDED Viewed

@@ -0,0 +1,259 @@
+/*
+  index.js
+  Answers the report-issues question.
+*/
+// IMPORTS
+const {
+  getPageDataStrings,
+  getReport,
+  getToolNamesString,
+  getWCAGLink,
+  getWeightName,
+  htmlSafe,
+  isHidden,
+  isValidReport,
+  objectSort,
+  tools
+} = require('../util');
+const {issues} = require('testilo/procs/score/tic');
+const fs = require('fs/promises');
+const path = require('path');
+// FUNCTIONS
+// Gets data on the issues reported in a report.
+const getIssuesData = async (timeStamp, jobID) => {
+  // Get the report.
+  const report = await getReport(timeStamp, jobID);
+  // If it is valid:
+  if (typeof report === 'object' && isValidReport(report)) {
+    const issuesData = {
+      reporters: new Set(),
+      reporterCount: 0,
+      reportersString: '',
+      violators: new Set(),
+      violatorCount: 0,
+      preventions: {},
+      issuesObject: {},
+      issueCount: 0,
+      issues: []
+    };
+    const {issuesObject, reporters, violators} = issuesData;
+    // For each act in it:
+    report.acts.forEach(act => {
+      // If it is a test act:
+      if (act.type === 'test') {
+        const {result, which} = act;
+        const instances = result?.standardResult?.instances ?? [];
+        // For each of its standard instances:
+        instances.forEach(instance => {
+          const {issueID} = instance;
+          // If the instance has a non-ignorable classified issue:
+          if (issueID && issues[issueID] && issueID !== 'ignorable') {
+            // Ensure that the issues data include data on the issue.
+            issuesObject[issueID] ??= {
+              issueID,
+              weight: issues[issueID].weight ?? 0,
+              reporters: new Set(),
+              reporterCount: 0,
+              reportersString: '',
+              violators: new Set(),
+              violatorCount: 0
+            };
+            // Ensure that the tool is in the issues data.
+            reporters.add(which);
+            // Ensure that it is in the issue data.
+            issuesObject[issueID].reporters.add(which);
+            const {catalogIndex} = instance;
+            // If the instance has a catalog index:
+            if (catalogIndex) {
+              // Ensure that the violator is in the issues data.
+              violators.add(catalogIndex);
+              // Ensure that it is in the issue data.
+              issuesObject[issueID].violators.add(catalogIndex);
+            }
+          }
+        });
+      }
+    });
+    // Populate the unpopulated subproperties of the issues data.
+    issuesData.reporterCount = issuesData.reporters.size;
+    issuesData.reportersString = getToolNamesString(issuesData.reporters);
+    issuesData.violatorCount = issuesData.violators.size;
+    issuesData.preventions = report.jobData.preventions;
+    issuesData.issueCount = Object.keys(issuesData.issuesObject).length;
+    issuesData.issues = Object.values(issuesData.issuesObject);
+    // For each issue in the issues data:
+    issuesData.issues.forEach(issue => {
+      // Populate its unpopulated properties.
+      issue.reporterCount = issue.reporters.size;
+      issue.reportersString = getToolNamesString(issue.reporters);
+      issue.violatorCount = issue.violators.size;
+    });
+    // Sort the issues alphabetically by reporters string.
+    objectSort(issuesData.issues, 'reportersString', 'alpha');
+    // Sort the issues again in descending reporter-count order, making this the primary order.
+    objectSort(issuesData.issues, 'reporterCount', 'numericDown');
+    // Return the issues data.
+    return issuesData;
+  }
+};
+// Adds parameters to a query for the answer page.
+const populateQuery = async (timeStamp, jobID, query) => {
+  // Get fact descriptions for the report.
+  const pageDataStrings = await getPageDataStrings(timeStamp, jobID);
+  const {what, urlLink, testInfo} = pageDataStrings;
+  const issuesData = await getIssuesData(timeStamp, jobID);
+  // If this failed:
+  if (typeof issuesData === 'string') {
+    // Return this.
+    return issuesData;
+  }
+  const {
+    issueCount,
+    preventions,
+    reporterCount,
+    reportersString,
+    violatorCount
+  } = issuesData;
+  // Add an issue count description to the query.
+  query.issueCount = issueCount === 1 ? '1 issue was' : `${issueCount} issues were`;
+  query.reporterCount = reporterCount === 1 ? '1 tool' : `${reporterCount} tools`;
+  // Add a reporter count and list to the query.
+  query.reporters = reportersString;
+  // Add a violator count to the query.
+  query.violatorCount = violatorCount === 1 ? '1 violator was' : `${violatorCount} violators were`;
+  // Add page data to the query.
+  query.target = what;
+  query.urlLink = urlLink;
+  query.testInfo = testInfo;
+  query.timeStamp = timeStamp;
+  query.jobID = jobID;
+  const preventionStrings = [];
+  const margin = ' '.repeat(6);
+  Object.keys(preventions).forEach(preventedToolID => {
+    const toolName = tools[preventedToolID];
+    const toolNameString = `${toolName[0]} (${toolName[1]})`;
+    const causeString = htmlSafe(preventions[preventedToolID]);
+    const preventionString = `${margin}<li>Page not testable by ${toolNameString}: ${causeString}</li>`;
+    preventionStrings.push(preventionString);
+  });
+  query.preventions = preventionStrings.join('\n');
+  // For each weight:
+  [4, 3, 2, 1].forEach(weight => {
+    // Initialize data on issues having the weight.
+    const weightData = [];
+    // Initialize the lines for the weight.
+    const weightLines = [];
+    // For each issue:
+    issuesData.issues.forEach(issueData => {
+      const {
+        issueID, reporterCount, reportersString, violatorCount, weight: issueWeight
+      } = issueData;
+      // If it has the weight:
+      if (issueWeight === weight) {
+        const issue = issues[issueID];
+        const {wcag, why} = issue;
+        const wcagLink = `<a href="${getWCAGLink(wcag)}">${wcag}</a>`;
+        // Add data on it to the weight data.
+        weightData.push({
+          issueID,
+          summary: issue.summary,
+          why,
+          wcag: wcagLink,
+          reporterCount,
+          reportersString,
+          violatorCount
+        });
+      }
+    });
+    const weightName = getWeightName(weight);
+    // Add the issue count to the query.
+    query[`${weightName}Count`] = weightData.length;
+    // If any reported issues have the weight:
+    if (weightData.length) {
+      // Add the start of a list of the issues with the weight to the lines.
+      weightLines.push(`${margin}<ul class="headed">`);
+      // For each issue with the weight:
+      weightData.forEach(weightIssue => {
+        const {issueID, reporterCount, reportersString, violatorCount, wcag, why} = weightIssue;
+        // Add the start of a list item to the lines.
+        weightLines.push(`${margin}  <li>`);
+        // Add a heading summarizing the issue to the lines.
+        weightLines.push(`${margin}    <h5>${weightIssue.summary}</h5>`);
+        // Add the start of alist of facts about the issue to the lines.
+        weightLines.push(`${margin}    <ul class="pseudoTopLevel">`);
+        // Add the issue facts to the lines.
+        weightLines.push(`${margin}      <li>Why it matters: ${why}`);
+        weightLines.push(`${margin}      <li>Related WCAG standard: ${wcag}`);
+        const reporterCountString = reporterCount === 1 ? '1 tool' : `${reporterCount} tools`;
+        weightLines.push(
+          `${margin}      <li>Reported by ${reporterCountString} (${reportersString})</li>`
+        );
+        const violatorCountString = violatorCount === 1
+        ? '1 violator was'
+        : `${violatorCount} violators were`;
+        weightLines.push(`${margin}      <li>${violatorCountString} reported</li>`);
+        // Add the end of the fact list to the lines.
+        weightLines.push(`${margin}    </ul>`);
+        // Add the start of a link list to the lines.
+        weightLines.push(`${margin}    <ul class="nav">`);
+        const whereQuestionString = 'Where was the issue found?';
+        const labelString = `Where was the ${weightIssue.summary} issue found on the ${what} page?`;
+        const href = `href="/reportIssue.html/${issueID}/${timeStamp}/${jobID}"`;
+        const label = `aria-label="${labelString}"`;
+        const whereLink = `<a ${href} ${label}>${whereQuestionString}</a>`;
+        // Add a violations link to the lines.
+        weightLines.push(`${margin}      <li>${whereLink}</li>`);
+        // Add the end of the link list to the lines.
+        weightLines.push(`${margin}    </ul>`);
+        // Add the end of the list item to the lines.
+        weightLines.push(`${margin}  </li>`);
+      });
+      // Add the end of the list of issues with the weight to the lines.
+      weightLines.push(`${margin}</ul>`);
+      // Add the lines documenting the issues with the weight to the query.
+      query[`${weightName}Details`] = weightLines.join('\n');
+    }
+    // Otherwise, i.e. if no reported issues have the weight:
+    else {
+      query[`${weightName}Details`] = `${margin}  <p>None</p>`;
+    }
+  });
+};
+// Returns a page answering the target-issues question.
+exports.answer = async pageArgs => {
+  const [timeStamp, jobID] = pageArgs.split('/');
+  const reportIsHidden = await isHidden(timeStamp, jobID);
+  // If the report is not available:
+  if (reportIsHidden) {
+    return {
+      status: 'error',
+      message: 'Report not available'
+    };
+  }
+  const query = {};
+  // Create a query to replace the placeholders.
+  await populateQuery(timeStamp, jobID, query);
+  // If the report facts were obtained:
+  if (query.testInfo) {
+    // Get the template.
+    let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
+    // Replace its placeholders.
+    Object.keys(query).forEach(param => {
+      answerPage = answerPage.replace(new RegExp(`__${param}__`, 'g'), query[param]);
+    });
+    // Return the populated page.
+    return {
+      status: 'ok',
+      answerPage
+    };
+  }
+  // Otherwise, i.e. if they were not obtained, report this.
+  return {
+    status: 'error',
+    error: 'Report processing failed'
+  };
+};

package/reportUnhideForm/index.html ADDED Viewed

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html lang="en-US">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <meta name="publisher" content="Jonathan Robert Pool">
+    <meta name="creator" content="Jonathan Robert Pool">
+    <meta name="keywords" content="report,accessibility,a11y">
+    <title>Declassify report as experimental | Kilotest</title>
+    <link rel="icon" href="/favicon.ico">
+    <link rel="stylesheet" href="/style.css">
+  </head>
+  <body>
+    <main>
+      <h1><a href="/">Kilotest</a>: Declassify report as experimental</h1>
+      <p>Choose a report to declassify as experimental.</p>
+      <form action="/reportUnhideForm.html">
+        <fieldset>
+          <legend>Reports</legend>
+          __reports__
+        </fieldset>
+        <p><label>
+          Authorization code: <input size="3" minLength="3" maxlength="3" name="authCode" required>
+        </label></p>
+        <p><button type="submit">Submit</button></p>
+      </form>
+    </main>
+  </body>
+</html>