ultra11y 5.5.0 → 5.5.1

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": "5.5.0",
+      "version": "5.5.1",
       "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": "5.5.0",
+  "version": "5.5.1",
   "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": "5.5.0",
+  "version": "5.5.1",
   "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 = "5.5.0";
+const ULTRA11Y_PLUGIN_VERSION = "5.5.1";
 
 const here = dirname(fileURLToPath(import.meta.url));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra11y",
-  "version": "5.5.0",
+  "version": "5.5.1",
   "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",

package/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join51, relative as relative5, resolve as resolve16, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.5.0";
+var VERSION = "5.5.1";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -5456,8 +5456,11 @@ function snippet(doc, el, max = 120) {
   const lineStart = doc.lineStarts[el.line - 1] ?? 0;
   let end = doc.source.indexOf("\n", lineStart);
   if (end === -1) end = doc.source.length;
-  const raw = doc.source.slice(lineStart, end).trim();
-  return raw.length > max ? raw.slice(0, max - 1) + "\u2026" : raw;
+  const from = Math.min(Math.max(el.start, lineStart), end);
+  const tagEnd = doc.source.indexOf(">", from);
+  const to = Math.min(from + max, Math.max(Math.min(end, from + max), tagEnd === -1 ? end : tagEnd + 1));
+  const raw = doc.source.slice(from, Math.min(to, doc.source.length)).replace(/\s+/g, " ").trim();
+  return raw.length > max ? `${raw.slice(0, max - 1)}\u2026` : raw;
 }
 
 // src/parse/jsx.ts

package/skills/review-a11y/SKILL.md

@@ -5,7 +5,7 @@ when_to_use: "Invoke WITHOUT being asked whenever changed front-end code should
 allowed-tools: Bash(node ${CLAUDE_SKILL_DIR}/scripts/ultra11y.mjs *), Read, Grep, Glob
 license: MIT
 metadata:
-  version: 5.5.0
+  version: 5.5.1
 ---
 
 # review-a11y — accessibility review of changed code

package/skills/review-a11y/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join51, relative as relative5, resolve as resolve16, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.5.0";
+var VERSION = "5.5.1";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -5456,8 +5456,11 @@ function snippet(doc, el, max = 120) {
   const lineStart = doc.lineStarts[el.line - 1] ?? 0;
   let end = doc.source.indexOf("\n", lineStart);
   if (end === -1) end = doc.source.length;
-  const raw = doc.source.slice(lineStart, end).trim();
-  return raw.length > max ? raw.slice(0, max - 1) + "\u2026" : raw;
+  const from = Math.min(Math.max(el.start, lineStart), end);
+  const tagEnd = doc.source.indexOf(">", from);
+  const to = Math.min(from + max, Math.max(Math.min(end, from + max), tagEnd === -1 ? end : tagEnd + 1));
+  const raw = doc.source.slice(from, Math.min(to, doc.source.length)).replace(/\s+/g, " ").trim();
+  return raw.length > max ? `${raw.slice(0, max - 1)}\u2026` : raw;
 }
 
 // src/parse/jsx.ts

package/skills/ultra11y/SKILL.md

@@ -4,7 +4,7 @@ description: "Use to AUDIT existing HTML/CSS/JSX against WCAG 2.2 AA accessibili
 when_to_use: "Invoke when the user asks for an accessibility AUDIT or a formal deliverable: audit a repo, site or page against WCAG 2.2 AA or a country standard (RGAA, Section 508, EN 301 549); produce a dated conformance report, a criterion grid, a PRD backlog, or tickets (GitHub/GitLab/Jira); author accessible markup from scratch; wire the repo gate (init --hook/--ci) or a rendered-DOM capture pipeline. For a review of the code UNDER CHANGE (diff, branch, PR), use the `review-a11y` skill instead."
 license: MIT
 metadata:
-  version: 5.5.0
+  version: 5.5.1
 ---
 
 # ultra11y — audit WCAG 2.2 AA and write accessible markup

package/skills/ultra11y/scripts/ultra11y.mjs

@@ -6,7 +6,7 @@ import { join as join51, relative as relative5, resolve as resolve16, sep as sep
 import { fileURLToPath as fileURLToPath5, pathToFileURL as pathToFileURL3 } from "url";
 
 // src/types.ts
-var VERSION = "5.5.0";
+var VERSION = "5.5.1";
 var SCHEMA_VERSION = 2;
 
 // src/audit.ts
@@ -5456,8 +5456,11 @@ function snippet(doc, el, max = 120) {
   const lineStart = doc.lineStarts[el.line - 1] ?? 0;
   let end = doc.source.indexOf("\n", lineStart);
   if (end === -1) end = doc.source.length;
-  const raw = doc.source.slice(lineStart, end).trim();
-  return raw.length > max ? raw.slice(0, max - 1) + "\u2026" : raw;
+  const from = Math.min(Math.max(el.start, lineStart), end);
+  const tagEnd = doc.source.indexOf(">", from);
+  const to = Math.min(from + max, Math.max(Math.min(end, from + max), tagEnd === -1 ? end : tagEnd + 1));
+  const raw = doc.source.slice(from, Math.min(to, doc.source.length)).replace(/\s+/g, " ").trim();
+  return raw.length > max ? `${raw.slice(0, max - 1)}\u2026` : raw;
 }
 
 // src/parse/jsx.ts

package/src/parse/html.ts

@@ -261,10 +261,32 @@ export function allIds(doc: Doc): { id: string; el: El }[] {
 }
 
 /** The source line(s) the element starts on, trimmed and truncated. */
+/** The source text that SHOWS this element, bounded to `max`.
+ *
+ *  Anchored at the element's own offset, not at the start of its line. On hand-written source
+ *  the two are the same thing once indentation is trimmed — but a serialized DOM capture is a
+ *  SINGLE LINE, so anchoring on the line handed back the document head for every element in
+ *  the page, identical for all of them. Measured on a real capture: every one of 128 form
+ *  controls carried `<html data-fr-scheme="system" lang="fr">…` as its snippet, which tells a
+ *  reader nothing and gives the grounding check nothing to match on.
+ *
+ *  The line still bounds the slice, so a multi-line element shows its opening tag rather than
+ *  its whole subtree. */
 export function snippet(doc: Doc, el: El, max = 120): string {
   const lineStart = doc.lineStarts[el.line - 1] ?? 0;
   let end = doc.source.indexOf("\n", lineStart);
   if (end === -1) end = doc.source.length;
-  const raw = doc.source.slice(lineStart, end).trim();
-  return raw.length > max ? raw.slice(0, max - 1) + "…" : raw;
+  const from = Math.min(Math.max(el.start, lineStart), end);
+  // A JSX element usually opens on one line and carries its attributes on the next ones, so
+  // stopping at the line break showed "<a" and nothing else. Read to the end of the OPENING
+  // TAG instead — that is what identifies the element — and collapse the whitespace, which
+  // grounding normalises on both sides anyway (src/grounding.ts).
+  //
+  // The opening tag and not the element: a snippet longer than `max` gets an ellipsis, and an
+  // ellipsis is not in the source, so `includes` stops matching and grounding refuses a
+  // citation that was perfectly real. Keeping the slice short keeps it verbatim.
+  const tagEnd = doc.source.indexOf(">", from);
+  const to = Math.min(from + max, Math.max(Math.min(end, from + max), tagEnd === -1 ? end : tagEnd + 1));
+  const raw = doc.source.slice(from, Math.min(to, doc.source.length)).replace(/\s+/g, " ").trim();
+  return raw.length > max ? `${raw.slice(0, max - 1)}…` : raw;
 }

package/src/types.ts

@@ -1,6 +1,6 @@
 // Single source of truth for shared types + the embedded version. sync-version.mjs
 // rewrites VERSION at release time (kept in lockstep with package.json + SKILL.md).
-export const VERSION = "5.5.0";
+export const VERSION = "5.5.1";
 export const SCHEMA_VERSION = 2;
 
 // Lang = the UI FRAME's language — the `L` localization tables each module (report,