ultra11y 2.22.0

package/scripts/vendor/wcag-2.2-sc.json

@@ -0,0 +1,574 @@
+{
+  "wcagVersion": "2.2",
+  "source": "https://www.w3.org/TR/WCAG22/",
+  "criteriaSource": "https://github.com/w3c/wcag",
+  "principles": [
+    {
+      "number": 1,
+      "title": "Perceivable"
+    },
+    {
+      "number": 2,
+      "title": "Operable"
+    },
+    {
+      "number": 3,
+      "title": "Understandable"
+    },
+    {
+      "number": 4,
+      "title": "Robust"
+    }
+  ],
+  "guidelines": [
+    {
+      "number": "1.1",
+      "title": "Text Alternatives"
+    },
+    {
+      "number": "1.2",
+      "title": "Time-based Media"
+    },
+    {
+      "number": "1.3",
+      "title": "Adaptable"
+    },
+    {
+      "number": "1.4",
+      "title": "Distinguishable"
+    },
+    {
+      "number": "2.1",
+      "title": "Keyboard Accessible"
+    },
+    {
+      "number": "2.2",
+      "title": "Enough Time"
+    },
+    {
+      "number": "2.3",
+      "title": "Seizures and Physical Reactions"
+    },
+    {
+      "number": "2.4",
+      "title": "Navigable"
+    },
+    {
+      "number": "2.5",
+      "title": "Input Modalities"
+    },
+    {
+      "number": "3.1",
+      "title": "Readable"
+    },
+    {
+      "number": "3.2",
+      "title": "Predictable"
+    },
+    {
+      "number": "3.3",
+      "title": "Input Assistance"
+    },
+    {
+      "number": "4.1",
+      "title": "Compatible"
+    }
+  ],
+  "criteria": [
+    {
+      "sc": "1.1.1",
+      "slug": "non-text-content",
+      "title": "Non-text Content",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.1"
+    },
+    {
+      "sc": "1.2.1",
+      "slug": "audio-only-and-video-only-prerecorded",
+      "title": "Audio-only and Video-only (Prerecorded)",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.2"
+    },
+    {
+      "sc": "1.2.2",
+      "slug": "captions-prerecorded",
+      "title": "Captions (Prerecorded)",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.2"
+    },
+    {
+      "sc": "1.2.3",
+      "slug": "audio-description-or-media-alternative-prerecorded",
+      "title": "Audio Description or Media Alternative (Prerecorded)",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.2"
+    },
+    {
+      "sc": "1.2.4",
+      "slug": "captions-live",
+      "title": "Captions (Live)",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.2"
+    },
+    {
+      "sc": "1.2.5",
+      "slug": "audio-description-prerecorded",
+      "title": "Audio Description (Prerecorded)",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.2"
+    },
+    {
+      "sc": "1.3.1",
+      "slug": "info-and-relationships",
+      "title": "Info and Relationships",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.3"
+    },
+    {
+      "sc": "1.3.2",
+      "slug": "meaningful-sequence",
+      "title": "Meaningful Sequence",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.3"
+    },
+    {
+      "sc": "1.3.3",
+      "slug": "sensory-characteristics",
+      "title": "Sensory Characteristics",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.3"
+    },
+    {
+      "sc": "1.3.4",
+      "slug": "orientation",
+      "title": "Orientation",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 1,
+      "guideline": "1.3"
+    },
+    {
+      "sc": "1.3.5",
+      "slug": "identify-input-purpose",
+      "title": "Identify Input Purpose",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 1,
+      "guideline": "1.3"
+    },
+    {
+      "sc": "1.4.1",
+      "slug": "use-of-color",
+      "title": "Use of Color",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.2",
+      "slug": "audio-control",
+      "title": "Audio Control",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.3",
+      "slug": "contrast-minimum",
+      "title": "Contrast (Minimum)",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.4",
+      "slug": "resize-text",
+      "title": "Resize Text",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.5",
+      "slug": "images-of-text",
+      "title": "Images of Text",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.10",
+      "slug": "reflow",
+      "title": "Reflow",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.11",
+      "slug": "non-text-contrast",
+      "title": "Non-text Contrast",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.12",
+      "slug": "text-spacing",
+      "title": "Text Spacing",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "1.4.13",
+      "slug": "content-on-hover-or-focus",
+      "title": "Content on Hover or Focus",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 1,
+      "guideline": "1.4"
+    },
+    {
+      "sc": "2.1.1",
+      "slug": "keyboard",
+      "title": "Keyboard",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.1"
+    },
+    {
+      "sc": "2.1.2",
+      "slug": "no-keyboard-trap",
+      "title": "No Keyboard Trap",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.1"
+    },
+    {
+      "sc": "2.1.4",
+      "slug": "character-key-shortcuts",
+      "title": "Character Key Shortcuts",
+      "level": "A",
+      "addedIn": "2.1",
+      "principle": 2,
+      "guideline": "2.1"
+    },
+    {
+      "sc": "2.2.1",
+      "slug": "timing-adjustable",
+      "title": "Timing Adjustable",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.2"
+    },
+    {
+      "sc": "2.2.2",
+      "slug": "pause-stop-hide",
+      "title": "Pause, Stop, Hide",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.2"
+    },
+    {
+      "sc": "2.3.1",
+      "slug": "three-flashes-or-below-threshold",
+      "title": "Three Flashes or Below Threshold",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.3"
+    },
+    {
+      "sc": "2.4.1",
+      "slug": "bypass-blocks",
+      "title": "Bypass Blocks",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.2",
+      "slug": "page-titled",
+      "title": "Page Titled",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.3",
+      "slug": "focus-order",
+      "title": "Focus Order",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.4",
+      "slug": "link-purpose-in-context",
+      "title": "Link Purpose (In Context)",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.5",
+      "slug": "multiple-ways",
+      "title": "Multiple Ways",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.6",
+      "slug": "headings-and-labels",
+      "title": "Headings and Labels",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.7",
+      "slug": "focus-visible",
+      "title": "Focus Visible",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.4.11",
+      "slug": "focus-not-obscured-minimum",
+      "title": "Focus Not Obscured (Minimum)",
+      "level": "AA",
+      "addedIn": "2.2",
+      "principle": 2,
+      "guideline": "2.4"
+    },
+    {
+      "sc": "2.5.1",
+      "slug": "pointer-gestures",
+      "title": "Pointer Gestures",
+      "level": "A",
+      "addedIn": "2.1",
+      "principle": 2,
+      "guideline": "2.5"
+    },
+    {
+      "sc": "2.5.2",
+      "slug": "pointer-cancellation",
+      "title": "Pointer Cancellation",
+      "level": "A",
+      "addedIn": "2.1",
+      "principle": 2,
+      "guideline": "2.5"
+    },
+    {
+      "sc": "2.5.3",
+      "slug": "label-in-name",
+      "title": "Label in Name",
+      "level": "A",
+      "addedIn": "2.1",
+      "principle": 2,
+      "guideline": "2.5"
+    },
+    {
+      "sc": "2.5.4",
+      "slug": "motion-actuation",
+      "title": "Motion Actuation",
+      "level": "A",
+      "addedIn": "2.1",
+      "principle": 2,
+      "guideline": "2.5"
+    },
+    {
+      "sc": "2.5.7",
+      "slug": "dragging-movements",
+      "title": "Dragging Movements",
+      "level": "AA",
+      "addedIn": "2.2",
+      "principle": 2,
+      "guideline": "2.5"
+    },
+    {
+      "sc": "2.5.8",
+      "slug": "target-size-minimum",
+      "title": "Target Size (Minimum)",
+      "level": "AA",
+      "addedIn": "2.2",
+      "principle": 2,
+      "guideline": "2.5"
+    },
+    {
+      "sc": "3.1.1",
+      "slug": "language-of-page",
+      "title": "Language of Page",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.1"
+    },
+    {
+      "sc": "3.1.2",
+      "slug": "language-of-parts",
+      "title": "Language of Parts",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.1"
+    },
+    {
+      "sc": "3.2.1",
+      "slug": "on-focus",
+      "title": "On Focus",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.2"
+    },
+    {
+      "sc": "3.2.2",
+      "slug": "on-input",
+      "title": "On Input",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.2"
+    },
+    {
+      "sc": "3.2.3",
+      "slug": "consistent-navigation",
+      "title": "Consistent Navigation",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.2"
+    },
+    {
+      "sc": "3.2.4",
+      "slug": "consistent-identification",
+      "title": "Consistent Identification",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.2"
+    },
+    {
+      "sc": "3.2.6",
+      "slug": "consistent-help",
+      "title": "Consistent Help",
+      "level": "A",
+      "addedIn": "2.2",
+      "principle": 3,
+      "guideline": "3.2"
+    },
+    {
+      "sc": "3.3.1",
+      "slug": "error-identification",
+      "title": "Error Identification",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.3"
+    },
+    {
+      "sc": "3.3.2",
+      "slug": "labels-or-instructions",
+      "title": "Labels or Instructions",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.3"
+    },
+    {
+      "sc": "3.3.3",
+      "slug": "error-suggestion",
+      "title": "Error Suggestion",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.3"
+    },
+    {
+      "sc": "3.3.4",
+      "slug": "error-prevention-legal-financial-data",
+      "title": "Error Prevention (Legal, Financial, Data)",
+      "level": "AA",
+      "addedIn": "2.0",
+      "principle": 3,
+      "guideline": "3.3"
+    },
+    {
+      "sc": "3.3.7",
+      "slug": "redundant-entry",
+      "title": "Redundant Entry",
+      "level": "A",
+      "addedIn": "2.2",
+      "principle": 3,
+      "guideline": "3.3"
+    },
+    {
+      "sc": "3.3.8",
+      "slug": "accessible-authentication-minimum",
+      "title": "Accessible Authentication (Minimum)",
+      "level": "AA",
+      "addedIn": "2.2",
+      "principle": 3,
+      "guideline": "3.3"
+    },
+    {
+      "sc": "4.1.2",
+      "slug": "name-role-value",
+      "title": "Name, Role, Value",
+      "level": "A",
+      "addedIn": "2.0",
+      "principle": 4,
+      "guideline": "4.1"
+    },
+    {
+      "sc": "4.1.3",
+      "slug": "status-messages",
+      "title": "Status Messages",
+      "level": "AA",
+      "addedIn": "2.1",
+      "principle": 4,
+      "guideline": "4.1"
+    }
+  ]
+}

package/scripts/verify-rgaa-source.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+// DEV-ONLY (not in `bin`, not bundled, never run by tests — needs network). Proves that
+// the vendored RGAA source (scripts/vendor/rgaa/criteres.json + glossaire.json), which
+// scripts/build-pack-rgaa.mjs derives the shipped pack from, is still faithful to the
+// official DINUM source (github.com/DISIC/accessibilite.numerique.gouv.fr, RGAA 4.1.2,
+// same raw path as build-pack-rgaa.mjs's BASE). Does a DEEP, per-criterion / per-glossary-
+// entry diff (not just a whole-file hash) so drift reads as "critère 4.2: tests differs"
+// rather than an opaque "files differ". Refreshes scripts/vendor/rgaa/SOURCE.json with a
+// provenance record on every run (clean or drifted) so the last verification is traceable.
+//   node scripts/verify-rgaa-source.mjs
+import { writeFileSync, readFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const VENDOR = join(root, "scripts", "vendor", "rgaa");
+const OWNER = "DISIC";
+const REPO = "accessibilite.numerique.gouv.fr";
+const BRANCH = "main";
+const UPSTREAM_DIR = "RGAA"; // same path as build-pack-rgaa.mjs's BASE
+const RAW_BASE = `https://raw.githubusercontent.com/${OWNER}/${REPO}/${BRANCH}/${UPSTREAM_DIR}`;
+const FILES = ["criteres.json", "glossaire.json"];
+
+const sha256 = (s) => createHash("sha256").update(s).digest("hex");
+
+async function fetchText(name) {
+  const url = `${RAW_BASE}/${name}`;
+  const r = await fetch(url);
+  if (!r.ok) throw new Error(`verify-rgaa-source: GET ${url} → HTTP ${r.status}`);
+  return r.text();
+}
+
+async function fetchUpstreamCommit() {
+  const url = `https://api.github.com/repos/${OWNER}/${REPO}/commits/${BRANCH}`;
+  const r = await fetch(url, { headers: { Accept: "application/vnd.github+json" } });
+  if (!r.ok) throw new Error(`verify-rgaa-source: GET ${url} → HTTP ${r.status}`);
+  const json = await r.json();
+  return json.sha;
+}
+
+function criteriaById(criteres) {
+  const byId = new Map();
+  for (const topic of criteres.topics) {
+    for (const { criterium } of topic.criteria) byId.set(`${topic.number}.${criterium.number}`, criterium);
+  }
+  return byId;
+}
+
+// Deep, per-criterion diff over the fields the pack derives from: title, tests,
+// WCAG/technique references, particular cases, technical notes.
+function diffCriteria(upstream, vendored) {
+  const drift = [];
+  const up = criteriaById(upstream);
+  const ven = criteriaById(vendored);
+  const FIELDS = ["title", "tests", "references", "technicalNote", "particularCases"];
+  for (const id of new Set([...up.keys(), ...ven.keys()])) {
+    const u = up.get(id);
+    const v = ven.get(id);
+    if (!u) {
+      drift.push(`critère ${id}: présent dans le vendored, absent en amont`);
+      continue;
+    }
+    if (!v) {
+      drift.push(`critère ${id}: présent en amont, absent du vendored`);
+      continue;
+    }
+    for (const field of FIELDS) {
+      const a = JSON.stringify(u[field] ?? null);
+      const b = JSON.stringify(v[field] ?? null);
+      if (a !== b) drift.push(`critère ${id}: ${field} diffère`);
+    }
+  }
+  return drift.sort();
+}
+
+// Per-entry diff over the glossary (keyed by term title, the glossary's natural key).
+function diffGlossary(upstream, vendored) {
+  const drift = [];
+  const up = new Map(upstream.glossary.map((e) => [e.title, e.body]));
+  const ven = new Map(vendored.glossary.map((e) => [e.title, e.body]));
+  for (const title of new Set([...up.keys(), ...ven.keys()])) {
+    const a = up.get(title);
+    const b = ven.get(title);
+    if (a === undefined) drift.push(`glossaire « ${title} » : présent dans le vendored, absent en amont`);
+    else if (b === undefined) drift.push(`glossaire « ${title} » : présent en amont, absent du vendored`);
+    else if (a !== b) drift.push(`glossaire « ${title} » : corps différent`);
+  }
+  return drift.sort();
+}
+
+async function main() {
+  const upstreamText = {};
+  for (const name of FILES) upstreamText[name] = await fetchText(name);
+
+  const vendoredText = Object.fromEntries(FILES.map((name) => [name, readFileSync(join(VENDOR, name), "utf8")]));
+
+  const drift = [
+    ...diffCriteria(JSON.parse(upstreamText["criteres.json"]), JSON.parse(vendoredText["criteres.json"])),
+    ...diffGlossary(JSON.parse(upstreamText["glossaire.json"]), JSON.parse(vendoredText["glossaire.json"])),
+  ];
+
+  const upstreamCommit = await fetchUpstreamCommit();
+  const files = {};
+  for (const name of FILES) files[name] = sha256(vendoredText[name]);
+  writeFileSync(
+    join(VENDOR, "SOURCE.json"),
+    `${JSON.stringify({ fetchedAt: new Date().toISOString(), upstreamCommit, files }, null, 2)}\n`,
+  );
+
+  if (drift.length === 0) {
+    console.log(
+      `verify-rgaa-source: scripts/vendor/rgaa/*.json is identical to ${OWNER}/${REPO}@${upstreamCommit} (${UPSTREAM_DIR}/).`,
+    );
+    return;
+  }
+
+  console.log(`verify-rgaa-source: ${drift.length} drift(s) vs ${OWNER}/${REPO}@${upstreamCommit} (${UPSTREAM_DIR}/):`);
+  for (const d of drift) console.log(`  - ${d}`);
+  process.exit(1);
+}
+
+main().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});