axe-core 4.10.3-canary.3b8bdde → 4.10.3-canary.3eade11

package/README.md

@@ -138,21 +138,21 @@ axe.configure({
 Axe-core supports the following locales. Do note that since locales are contributed by our community, they are not guaranteed to include all translations needed in a release.
 
 - Basque
+- Chinese (Simplified)
+- Chinese (Traditional)
 - Danish
 - Dutch
 - French
 - German
+- Greek
 - Hebrew
+- Italian
 - Japanese
 - Korean
 - Norwegian (Bokmål)
 - Polish
 - Portuguese (Brazilian)
 - Spanish
-- Greek
-- Italian
-- Simplified Chinese
-- Traditional Chinese
 
 ## Updates & Security
 

package/axe.d.ts

@@ -155,7 +155,7 @@ declare namespace axe {
     toolOptions: RunOptions;
     passes: Result[];
     violations: Result[];
-    incomplete: Result[];
+    incomplete: IncompleteResult[];
     inapplicable: Result[];
   }
   interface Result {
@@ -167,6 +167,9 @@ declare namespace axe {
     tags: TagValue[];
     nodes: NodeResult[];
   }
+  interface IncompleteResult extends Result {
+    error?: Omit<RuleError, 'errorNode'>;
+  }
   interface NodeResult {
     html: string;
     impact?: ImpactValue;
@@ -204,6 +207,21 @@ declare namespace axe {
     fail: string | { [key: string]: string };
     incomplete?: string | { [key: string]: string };
   }
+  interface RuleError {
+    name: string;
+    message: string;
+    stack: string;
+    ruleId?: string;
+    method?: string;
+    cause?: SerialError;
+    errorNode?: SerialDqElement;
+  }
+  interface SerialError {
+    message: string;
+    stack: string;
+    name: string;
+    cause?: SerialError;
+  }
   interface CheckLocale {
     [key: string]: CheckMessages;
   }
@@ -368,23 +386,25 @@ declare namespace axe {
     frameContext: FrameContextObject;
   }
 
-  interface RawCheckResult extends Omit<CheckResult, 'relatedNodes'> {
+  interface RawCheckResult
+    extends Omit<CheckResult, 'relatedNodes' | 'impact'> {
     relatedNodes?: Array<SerialDqElement | DqElement>;
+    impact?: ImpactValue;
   }
 
-  interface RawNodeResult<T extends 'passed' | 'failed' | 'incomplete'> {
+  interface RawNodeResult<T extends 'passed' | 'failed' | 'cantTell'> {
     node: SerialDqElement | DqElement;
     any: RawCheckResult[];
     all: RawCheckResult[];
     none: RawCheckResult[];
-    impact: ImpactValue | null;
+    impact: ImpactValue | undefined;
     result: T;
   }
 
   interface RawResult extends Omit<Result, 'nodes'> {
     inapplicable: Array<never>;
     passes: RawNodeResult<'passed'>[];
-    incomplete: RawNodeResult<'incomplete'>[];
+    incomplete: RawNodeResult<'cantTell'>[];
     violations: RawNodeResult<'failed'>[];
     pageLevel: boolean;
     result: 'failed' | 'passed' | 'incomplete' | 'inapplicable';
@@ -408,6 +428,24 @@ declare namespace axe {
     boundingClientRect: DOMRect;
   }
 
+  type GridCell = VirtualNode[];
+
+  interface Grid {
+    container: VirtualNode | null;
+    cells: unknown; // opaque implementation detail
+    boundaries?: DOMRect;
+    toGridIndex(num: number): number;
+    getCellFromPoint(point: { x: number; y: number }): GridCell;
+    loopGridPosition(
+      gridPosition: DOMRect,
+      callback: (gridCell: GridCell, pos: { row: number; col: number }) => void
+    ): void;
+    getGridPositionOfRect(
+      rect: { top: number; right: number; bottom: number; left: number },
+      margin?: number
+    ): DOMRect;
+  }
+
   interface CustomNodeSerializer<T = SerialDqElement> {
     toSpec: (dqElm: DqElement) => T;
     mergeSpecs: (nodeSpec: T, parentFrameSpec: T) => T;
@@ -443,7 +481,13 @@ declare namespace axe {
     isLabelledShadowDomSelector: (
       selector: unknown
     ) => selector is LabelledShadowDomSelector;
-
+    RuleError: new (options: {
+      error: Error;
+      ruleId?: string;
+      method?: string;
+      errorNode?: SerialDqElement;
+    }) => RuleError;
+    serializeError: (error: Error) => SerialError;
     DqElement: DqElementConstructor;
     uuid: (
       options?: { random?: Uint8Array | Array<number> },
@@ -460,6 +504,7 @@ declare namespace axe {
   interface Dom {
     isFocusable: (node: Element | VirtualNode) => boolean;
     isNativelyFocusable: (node: Element | VirtualNode) => boolean;
+    getNodeGrid: (node: Node | VirtualNode) => Grid;
   }
 
   type AccessibleTextOptions = {