cbrowser 19.2.2 → 19.3.0

package/dist/analysis/accessibility-empathy.d.ts

@@ -3,7 +3,38 @@
  * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
  * Learn more at https://cbrowser.ai - MIT License
  */
-import type { EmpathyAuditResult, EmpathyAuditOptions } from "../types.js";
+import type { EmpathyAuditResult, EmpathyAuditOptions, AccessibilityBarrier, AccessibilityBarrierSeverity } from "../types.js";
+/**
+ * Move findings ABOVE the audited WCAG level out of the scored set.
+ *
+ * Policy (Alexa, 2026-10-09): an above-level finding is advisory. It carries
+ * `aboveAuditLevel`, is reported in a separate `advisories` list, takes no
+ * score deduction, is never escalated by persona weight, and is never
+ * "critical".
+ *
+ * Before this an AAA-only 40x40 target in an AA audit was the largest single
+ * deduction on the reported page and showed severityForPersona "critical":
+ * adjustSeverityForLevel capped it at minor, and weightedSeverity -- which has
+ * no idea what level is being audited -- moved it up two steps at weight 3.0.
+ *
+ * Applied once, after every detector, for the same reason the viewport filter
+ * is: one rule in one place cannot be forgotten by a twelfth detector.
+ *
+ * A barrier with no KNOWN criterion is not a WCAG finding (navigation item
+ * count, the spacing heuristic before it related to 2.5.8) and so is not above
+ * any level; it stays scored. getBarrierWcagLevel treats [] as AAA for
+ * severity purposes, which is why it is not reused for this question as-is.
+ */
+export declare function splitAboveAuditLevel<T extends {
+    wcagCriteria?: string[];
+    severity: AccessibilityBarrierSeverity;
+}>(barriers: T[], auditLevel: "A" | "AA" | "AAA"): {
+    scored: T[];
+    advisories: Array<T & {
+        aboveAuditLevel: true;
+        wcagLevelOfFinding: "A" | "AA" | "AAA";
+    }>;
+};
 /**
  * Drop barriers outside the viewport when the audit is viewport-scoped.
  *
@@ -49,6 +80,22 @@ export declare function filterBarriersToViewport<T extends {
 };
 export declare function formatEmpathyAuditReport(result: EmpathyAuditResult): string;
 export declare function generateEmpathyAuditHtmlReport(result: EmpathyAuditResult): string;
+/** How many elements one barrier stands for: its member count, else 1. */
+export declare function barrierElementCount(b: {
+    affectedElementCount?: number;
+}): number;
+/**
+ * Affected elements in a barrier set, counted exactly as topBarriers counts
+ * them: the sum of the grouped entries' affectedElementCount.
+ *
+ * resultsSummary.affectedElements was `barriers.length` -- barrier RECORDS,
+ * not elements -- while each topBarriers entry counted distinct element
+ * STRINGS, so "button", "animation" and "5 element groups" each collapsed many
+ * elements into one and a group barrier counted 1. The two numbers on the
+ * same page could not be reconciled. One function now produces both. (B7,
+ * 2026-10-09)
+ */
+export declare function countAffectedElements(barriers: AccessibilityBarrier[]): number;
 /**
  * Disability shorthand -> roster name. One table for every tool now lives in
  * src/personas.ts (PERSONA_ALIASES); kept under this name for existing

package/dist/analysis/accessibility-empathy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessibility-empathy.d.ts","sourceRoot":"","sources":["../../src/analysis/accessibility-empathy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAmCH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EASpB,MAAM,aAAa,CAAC;AAuKrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACnH,QAAQ,EAAE,CAAC,EAAE,EACb,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAWhC;AAwjED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAmF3E;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAkTjF;AAqJD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC7E,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,EAChC,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,EACnC,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,GAC5B,MAAM,EAAE,CAkBV;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAsW7B"}
+{"version":3,"file":"accessibility-empathy.d.ts","sourceRoot":"","sources":["../../src/analysis/accessibility-empathy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoCH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEnB,oBAAoB,EAEpB,4BAA4B,EAK7B,MAAM,aAAa,CAAC;AA6OrB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,4BAA4B,CAAA;CAAE,EAChH,QAAQ,EAAE,CAAC,EAAE,EACb,UAAU,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,GAC7B;IAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,CAAC,GAAG;QAAE,eAAe,EAAE,IAAI,CAAC;QAAC,kBAAkB,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,CAAA;KAAE,CAAC,CAAA;CAAE,CAmB3G;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EACnH,QAAQ,EAAE,CAAC,EAAE,EACb,QAAQ,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAWhC;AAmgFD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuG3E;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CA2UjF;AAsBD,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE;IAAE,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAE9E;AAmKD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAmB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,KAAK,CAAC;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,EAC7E,mBAAmB,EAAE,GAAG,CAAC,MAAM,CAAC,EAChC,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,EACnC,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,GAC5B,MAAM,EAAE,CAkBV;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAsX7B"}