@surea11y/core 1.5.0 → 1.7.0

package/src/checks/manual/table-duplicate-name-manual.js

@@ -6,7 +6,7 @@
  * @check table-duplicate-name
  * @atomic true
  * @summary A table's caption must not duplicate its summary attribute
- * @standard Best Practices (no formal WCAG Success Criterion — see ROADMAP.md Tier 1b)
+ * @standard Best Practices (no formal WCAG Success Criterion)
  * @applicability
  *   Applies to <table> elements that have both a <caption> with text
  *   content and a (deprecated but still encountered) summary attribute.
@@ -16,7 +16,7 @@
  *   same thing, assistive technology that surfaces both announces the
  *   same text twice for one table.
  * @implementation-notes
- * - Not WCAG-normative — authored as an advisory, cantTell-capped
+ * - Not WCAG-normative, authored as an advisory, cantTell-capped
  *   `type: 'manual'` rule; see landmark-banner-is-top-level's
  *   header comment for the shared rationale/precedent.
  * - Narrowly scoped to caption-vs-summary duplication specifically, not a

package/src/checks/manual/table-fake-caption-manual.js

@@ -22,7 +22,7 @@
  * @implementation-notes
  * - Heuristic (a legitimately narrow first data row is possible, if
  *   uncommon), so authored as `type: 'manual'` (cantTell-capped, never
- *   fail) rather than a hard fail — same conservative posture as
+ *   fail) rather than a hard fail, the same conservative posture as
  *   `p-as-heading`.
  * - Does not attempt full colspan/rowspan-aware column counting; "more
  *   than one cell" on another row is used as the multi-column signal,
@@ -121,7 +121,7 @@ function runInPage(ctx) {
       selector: stableSelector,
       html,
       summary:
-        'This table has no <caption>, but its first row is a single cell sitting above multi-cell rows — it may be acting as a fake caption.',
+        'This table has no <caption>, but its first row is a single cell sitting above multi-cell rows, so it may be acting as a fake caption.',
       hint: 'If this cell is meant to describe the table, use a real <caption> element instead of a lone first-row cell.',
       i18n: {
         summaryKey: 'tableFakeCaption_summary_cantTell',

package/src/checks/manual/video-caption-manual.js

@@ -13,18 +13,18 @@
  * @expectation
  *   SC 1.2.2 requires captions for prerecorded synchronized media, but
  *   only when the video actually has an audio track that conveys
- *   information (a silent/decorative video needs none) — which cannot be
+ *   information (a silent/decorative video needs none), which cannot be
  *   verified from static markup alone (jsdom does not decode media).
  *   This rule is therefore `type: 'manual'` (cantTell-capped, never
  *   fail), matching the precedent set by
  *   `media-alternative-transcript-evidence` for the same class
- *   of "normatively mapped but not staticaly verifiable" gap. A <video>
+ *   of "normatively mapped but not statically verifiable" gap. A <video>
  *   with a `<track kind="captions">` (or `kind="subtitles"`, commonly
  *   used interchangeably in the wild even though captions and subtitles
  *   serve technically distinct purposes) whose `src` is non-empty is not
  *   flagged; everything else is flagged for human review.
  * @implementation-notes
- * - Does not attempt to verify the referenced track file's content —
+ * - Does not attempt to verify the referenced track file's content,
  *   only that a captions/subtitles track is declared with a non-empty
  *   `src`.
  */

package/src/checks/manual-review.js

@@ -4,7 +4,23 @@
 
 /**
  * @check manual-review
- * Manual review for keyboard navigation and focus order.
+ * @atomic true
+ * @summary Manual review of keyboard navigation and focus order
+ * @standard WCAG 2.2
+ * @sc 2.1.1
+ * @sc 2.4.3
+ * @sc 2.4.7
+ * @type manual
+ * @applicability
+ *   Applies to every run, whatever the page contains. Keyboard operability
+ *   and focus order are properties of the page as a whole, and no markup
+ *   pattern rules the question out.
+ * @expectation
+ *   Always cantTell, carrying one occurrence at the scan root. Whether focus
+ *   can leave every component, whether the tab order follows the reading
+ *   order, and whether the focus indicator stays visible in use all need a
+ *   person driving the page. The rule exists so that need is stated in the
+ *   results rather than left for the reader to remember.
  */
 
 const id = 'manual-review';