@surea11y/webdriverio 0.1.2 → 1.0.0

package/README.md

@@ -62,6 +62,8 @@ WebdriverIO v9 defaults to the WebDriver **BiDi** protocol. A long-lived session
 
 `withTags()`/`disableRules()` above have counterparts: `.withRules([...])` (only run these specific rule IDs) and `.disableTags([...])` (never run rules carrying any of these tags). All four compose the same way similar allow/deny-list options do in other accessibility testing tools, with one non-obvious rule worth knowing: a "disable" always wins over a "with" on the same ID/tag (e.g. `.withRules(['a']).disableRules(['a'])` drops `'a'` entirely), and combining `.withRules()` **and** `.withTags()` together requires a rule to satisfy *both* (surea11y's default `includeMode: 'and'` — see `../surea11y/docs/ENGINE_OPTIONS.md`), not either one.
 
+`.exclude(selector)` above excludes globally. Pass a second argument to scope it to specific rule IDs instead: `.exclude('.mat-select', { rules: ['aria-required-children'] })` skips `.mat-select` for that rule only — every other rule still sees it. Global and rule-scoped `.exclude()` calls compose freely.
+
 **Create one builder per scan.** `A11yCoreBuilder` is a mutable object with no reset between `.analyze()` calls — `include()`/`exclude()`/`withRules()`/`disableRules()`/`withTags()`/`disableTags()`/`options()`/`withCustomRules()` all push onto or merge into internal state that persists for the instance's lifetime. Calling one of them again before a second `.analyze()` call *accumulates* on top of the first scan's scope rather than replacing it (this is exactly what makes "call `.include()` several times for one scan," above, work — the same accumulation just also applies across separate scans if you reuse an instance). `.reportOnly()`/`.frames()`/`.elementRef()` are the exception: each call replaces the previous value instead of merging with it.
 
 This binding works against any browser WebdriverIO can drive; the tests and examples use headless Chrome via `chromedriver`, which WebdriverIO manages automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@surea11y/webdriverio",
-  "version": "0.1.2",
+  "version": "1.0.0",
   "description": "WebdriverIO binding for surea11y -- scan real, live-rendered pages for accessibility issues.",
   "main": "src/index.js",
   "types": "src/index.d.ts",
@@ -26,8 +26,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@surea11y/binding-base": "^1.0.0",
-    "@surea11y/core": "^1.0.0"
+    "@surea11y/binding-base": "^1.1.0",
+    "@surea11y/core": "^1.1.0"
   },
   "peerDependencies": {
     "webdriverio": ">=8.0.0"

package/src/A11yCoreBuilder.d.ts

@@ -178,8 +178,13 @@ export class A11yCoreBuilder {
 
   /** Scope the scan to one region. Call multiple times for a multi-region union. */
   include(selector: string): this;
-  /** Skip elements matching this selector anywhere in the scanned scope. */
-  exclude(selector: string): this;
+  /**
+   * Skip elements matching this selector anywhere in the scanned scope.
+   * With `opts.rules`, scopes the exclusion to just the named rule ID(s)
+   * instead of globally -- on top of, not instead of, any global exclusions
+   * from other `.exclude(selector)` calls.
+   */
+  exclude(selector: string, opts?: { rules?: string | string[] }): this;
   /** Only run rules carrying at least one of these tags. */
   withTags(tags: string | string[]): this;
   /** Never run rules carrying any of these tags (applied after withTags). */