ultra11y 4.0.1 → 4.2.0

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "ultra11y",
       "source": "./",
       "description": "Automatic accessibility review of the code under change before every commit, push and pull request, plus full WCAG 2.2 AA / RGAA audits and conformance deliverables on demand.",
-      "version": "4.0.1",
+      "version": "4.2.0",
       "author": { "name": "maxgfr" },
       "homepage": "https://github.com/maxgfr/ultra11y",
       "repository": "https://github.com/maxgfr/ultra11y",

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultra11y",
   "description": "Accessibility for WCAG 2.2 AA and country standards (RGAA…): an automatic review of the code under change before every commit, push and pull request, plus full audits and conformance deliverables on demand.",
-  "version": "4.0.1",
+  "version": "4.2.0",
   "author": { "name": "maxgfr" },
   "homepage": "https://github.com/maxgfr/ultra11y",
   "repository": "https://github.com/maxgfr/ultra11y",

package/.codex-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultra11y",
   "description": "Accessibility for WCAG 2.2 AA and country standards (RGAA…): an automatic review of the code under change before every commit, push and pull request, plus full audits and conformance deliverables on demand.",
-  "version": "4.0.1",
+  "version": "4.2.0",
   "author": { "name": "maxgfr", "url": "https://github.com/maxgfr" },
   "homepage": "https://github.com/maxgfr/ultra11y",
   "repository": "https://github.com/maxgfr/ultra11y",

package/.opencode/plugins/ultra11y.js

@@ -27,7 +27,7 @@ import { fileURLToPath } from "node:url";
 // Ownership marker: `ultra11y install --opencode` refuses to overwrite a plugin file that
 // does not carry it, so a user's own ultra11y.js is never clobbered.
 const ULTRA11Y_OPENCODE_PLUGIN = "ULTRA11Y_OPENCODE_PLUGIN";
-const ULTRA11Y_PLUGIN_VERSION = "4.0.1";
+const ULTRA11Y_PLUGIN_VERSION = "4.2.0";
 
 const here = dirname(fileURLToPath(import.meta.url));
 

package/README.md

@@ -409,6 +409,34 @@ node scripts/ultra11y.mjs report --in audit.json --out audits      # audits/wcag
 node scripts/ultra11y.mjs check  --report audits/wcag-YYYY-MM-DD.md # integrity gate
 ```
 
+### A report someone will actually open
+
+`--html` turns the audit into a page: `audits/index.html` as the entry point, plus — from
+`report` — a detachable single file that prints to PDF. Self-contained — no script, no
+external asset, nothing pointing outside the directory — and it passes this engine's own
+accessibility audit, which is the least a tool like this owes. `pages --html` writes the
+navigable sheets only: **one composite per artifact**, or every inlined crop travels twice.
+
+```sh
+node scripts/ultra11y.mjs report --in audit.json --html --evidence --out audits
+node scripts/ultra11y.mjs pages  --in audit.json --format report --split page \
+  --evidence --html --out audits/pages
+```
+
+`--evidence` illustrates each non-conformity with an **annotated crop of the offending
+element**, cut from the page snapshot: `selectorHint` is lossy, and a rendered-tier finding on
+a client-rendered page is anchored at `dom.html:2` whatever it is really about. It illustrates
+the Markdown conformance report as much as the HTML — one set of files in `assets/`, referenced
+by every document that shows the defect — so `--html` is not required to get pictures.
+
+It needs snapshots, and it says per page and per criterion what it could not draw and why — an
+occurrence with no picture must never read as an occurrence with no defect. It distinguishes
+an occurrence *folded* into another's picture from a distinct defect a limit *cut off*, because
+only the second is a gap.
+
+In the GitHub Action both are **on by default**, so the uploaded artifact has a front door
+without changing a workflow. See `references/ci.md`.
+
 The skill (`skills/ultra11y/SKILL.md` + `references/`) teaches the agent when and how to run these, how to complete the manual criteria, and the native-first authoring doctrine.
 
 ## Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra11y",
-  "version": "4.0.1",
+  "version": "4.2.0",
   "description": "Audit HTML/CSS/JSX against WCAG 2.2 AA and produce a dated compliance report, or author/review accessible markup (native-HTML-first). A skills.sh agent skill: an install-free static engine (bundled, no npm install) plus the agent's judgment, with check/verify gates against hallucinated non-conformities, and pluggable in-repo standards packs (RGAA France first; Section 508 & EN 301 549 next).",
   "type": "module",
   "packageManager": "pnpm@10.33.0",