@a11y-pulse/tab-orchestrator 0.3.0 → 0.5.0

package/LICENSE.md

@@ -1,166 +1,21 @@
-Copyright (c) 2026-present, A11y Pulse Limited (https://www.a11ypulse.com/). All rights reserved.
-
-# PolyForm Shield License 1.0.0
-
-<https://polyformproject.org/licenses/shield/1.0.0>
-
-## Acceptance
-
-In order to get any license under these terms, you must agree
-to them as both strict obligations and conditions to all
-your licenses.
-
-## Copyright License
-
-The licensor grants you a copyright license for the
-software to do everything you might do with the software
-that would otherwise infringe the licensor's copyright
-in it for any permitted purpose.  However, you may
-only distribute the software according to [Distribution
-License](#distribution-license) and make changes or new works
-based on the software according to [Changes and New Works
-License](#changes-and-new-works-license).
-
-## Distribution License
-
-The licensor grants you an additional copyright license
-to distribute copies of the software.  Your license
-to distribute covers distributing the software with
-changes and new works permitted by [Changes and New Works
-License](#changes-and-new-works-license).
-
-## Notices
-
-You must ensure that anyone who gets a copy of any part of
-the software from you also gets a copy of these terms or the
-URL for them above, as well as copies of any plain-text lines
-beginning with `Required Notice:` that the licensor provided
-with the software.  For example:
-
-> Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
-
-## Changes and New Works License
-
-The licensor grants you an additional copyright license to
-make changes and new works based on the software for any
-permitted purpose.
-
-## Patent License
-
-The licensor grants you a patent license for the software that
-covers patent claims the licensor can license, or becomes able
-to license, that you would infringe by using the software.
-
-## Noncompete
-
-Any purpose is a permitted purpose, except for providing any
-product that competes with the software or any product the
-licensor or any of its affiliates provides using the software.
-
-## Competition
-
-Goods and services compete even when they provide functionality
-through different kinds of interfaces or for different technical
-platforms.  Applications can compete with services, libraries
-with plugins, frameworks with development tools, and so on,
-even if they're written in different programming languages
-or for different computer architectures.  Goods and services
-compete even when provided free of charge.  If you market a
-product as a practical substitute for the software or another
-product, it definitely competes.
-
-## New Products
-
-If you are using the software to provide a product that does
-not compete, but the licensor or any of its affiliates brings
-your product into competition by providing a new version of
-the software or another product using the software, you may
-continue using versions of the software available under these
-terms beforehand to provide your competing product, but not
-any later versions.
-
-## Discontinued Products
-
-You may begin using the software to compete with a product
-or service that the licensor or any of its affiliates has
-stopped providing, unless the licensor includes a plain-text
-line beginning with `Licensor Line of Business:` with the
-software that mentions that line of business.  For example:
-
-> Licensor Line of Business: YoyodyneCMS Content Management
-System (http://example.com/cms)
-
-## Sales of Business
-
-If the licensor or any of its affiliates sells a line of
-business developing the software or using the software
-to provide a product, the buyer can also enforce
-[Noncompete](#noncompete) for that product.
-
-## Fair Use
-
-You may have "fair use" rights for the software under the
-law. These terms do not limit them.
-
-## No Other Rights
-
-These terms do not allow you to sublicense or transfer any of
-your licenses to anyone else, or prevent the licensor from
-granting licenses to anyone else.  These terms do not imply
-any other licenses.
-
-## Patent Defense
-
-If you make any written claim that the software infringes or
-contributes to infringement of any patent, your patent license
-for the software granted under these terms ends immediately. If
-your company makes such a claim, your patent license ends
-immediately for work on behalf of your company.
-
-## Violations
-
-The first time you are notified in writing that you have
-violated any of these terms, or done anything with the software
-not covered by your licenses, your licenses can nonetheless
-continue if you come into full compliance with these terms,
-and take practical steps to correct past violations, within
-32 days of receiving notice.  Otherwise, all your licenses
-end immediately.
-
-## No Liability
-
-***As far as the law allows, the software comes as is, without
-any warranty or condition, and the licensor will not be liable
-to you for any damages arising out of these terms or the use
-or nature of the software, under any kind of legal claim.***
-
-## Definitions
-
-The **licensor** is the individual or entity offering these
-terms, and the **software** is the software the licensor makes
-available under these terms.
-
-A **product** can be a good or service, or a combination
-of them.
-
-**You** refers to the individual or entity agreeing to these
-terms.
-
-**Your company** is any legal entity, sole proprietorship,
-or other kind of organization that you work for, plus all
-its affiliates.
-
-**Affiliates** means the other organizations than an
-organization has control over, is under the control of, or is
-under common control with.
-
-**Control** means ownership of substantially all the assets of
-an entity, or the power to direct its management and policies
-by vote, contract, or otherwise.  Control can be direct or
-indirect.
-
-**Your licenses** are all the licenses granted to you for the
-software under these terms.
-
-**Use** means anything you do with the software requiring one
-of your licenses.
+# MIT License
+
+Copyright (c) 2026-present, A11y Pulse (https://www.a11ypulse.com/)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,13 +2,13 @@
 
 [![npm version](https://img.shields.io/npm/v/@a11y-pulse/tab-orchestrator)](https://www.npmjs.com/package/@a11y-pulse/tab-orchestrator)
 [![CI](https://github.com/A11y-Pulse/audits/actions/workflows/ci.yml/badge.svg)](https://github.com/A11y-Pulse/audits/actions/workflows/ci.yml)
-[![License: PolyForm Shield 1.0.0](https://img.shields.io/badge/license-PolyForm%20Shield%201.0.0-blue)](./LICENSE.md)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](./LICENSE.md)
 
-A shared Tab-session runner for A11y Pulse's keyboard-driven accessibility audits. It drives a page through its focusable elements once — pressing Tab, tracking visited elements, capturing screenshots and styles on demand — while one or more **consumers** each score the tab stops for their own WCAG success criterion. This lets audits like [`@a11y-pulse/focus-appearance-audit`](../focus-appearance-audit) (WCAG 2.4.7) share a single tab loop with sibling audits instead of each re-tabbing the page from scratch.
+A shared Tab-session runner for A11y Pulse's keyboard-driven accessibility audits. It drives a page through its focusable elements once (pressing Tab, tracking visited elements, capturing screenshots and styles on demand) while one or more **consumers** each score the tab stops for their own WCAG success criterion. This lets audits like [`@a11y-pulse/focus-appearance-audit`](../focus-appearance-audit) (WCAG 2.4.7) share a single tab loop with sibling audits instead of each re-tabbing the page from scratch.
 
 It is not an audit itself: it has no opinion on what "passing" means. It only owns the mechanics of moving focus, tracking cycle completion, and capturing the primitives (computed styles, clipped screenshots, unfocused/focused pairs) that consumers need.
 
-This package was developed by [A11y Pulse](https://www.a11ypulse.com/) for its accessibility monitoring service. It is released as source-available under the [PolyForm Shield License 1.0.0](#license).
+This package was developed by [A11y Pulse](https://www.a11ypulse.com/) for its accessibility monitoring service. It is released under the [MIT License](#license).
 
 ## Install
 
@@ -35,9 +35,9 @@ await orchestrator.run();
 - `.attach(consumer)` registers a `TabConsumer`. Attaching after `run()` has started throws.
 - `.run()` presses Tab repeatedly, dispatching each `TabStopSnapshot` to every still-attached consumer, until either a full tab cycle completes, focus is lost, navigation happens, or every consumer has disconnected. Calling it twice throws; calling it with zero attached consumers returns immediately without tabbing.
 
-Each consumer declares the `capabilities` it needs (e.g. `baselineStyles`, `unfocusedPair`) and can disconnect independently once it has what it needs (say, after hitting its own element limit) — the orchestrator keeps driving the remaining consumers. Per-stop work like unfocused-pair screenshots is only captured if a still-attached consumer actually asks for it that stop.
+Each consumer declares the `capabilities` it needs (e.g. `baselineStyles`, `unfocusedPair`) and can disconnect independently once it has what it needs (say, after hitting its own element limit). The orchestrator keeps driving the remaining consumers. Per-stop work like unfocused-pair screenshots is only captured if a still-attached consumer actually asks for it that stop.
 
-Most callers won't build a `TabConsumer` by hand — audit packages export a `createXAudit(options)` helper that returns one, plus a `runXAudit(adaptor, options)` convenience wrapper that builds a private single-consumer orchestrator for you. See [`@a11y-pulse/focus-appearance-audit`'s "Shared tab session"](../focus-appearance-audit#shared-tab-session) section for a worked example.
+Most callers won't build a `TabConsumer` by hand. Audit packages export a `createXAudit(options)` helper that returns one, plus a `runXAudit(adaptor, options)` convenience wrapper that builds a private single-consumer orchestrator for you. See [`@a11y-pulse/focus-appearance-audit`'s "Shared tab session"](../focus-appearance-audit#shared-tab-session) section for a worked example.
 
 ## `BrowserAdaptor`
 
@@ -50,7 +50,7 @@ The orchestrator drives a page through an **adaptor**: a small interface of prim
 | `disposeRef(ref)`        | Releases a handle previously returned by `evaluateHandle`.                                                                                           |
 | `pressTab()`             | Presses the Tab key, advancing focus to the next focusable element.                                                                                  |
 | `screenshotClip(clip)`   | Screenshots a clipped region of the page (`{ x, y, width, height }`) and returns PNG bytes.                                                          |
-| `ensureFocusReporting()` | Ensures the page reports focus for its lifetime — in particular that `document.hasFocus()` works and `:focus` styles apply, even when the page is not the foreground tab/window. Must not throw. |
+| `ensureFocusReporting()` | Ensures the page reports focus for its lifetime, in particular that `document.hasFocus()` works and `:focus` styles apply, even when the page is not the foreground tab/window. Must not throw. |
 
 The orchestrator is the only thing that mutates the page through this adaptor during a session; consumers score snapshots, they don't call `pressTab`, take screenshots, or install observers themselves.
 
@@ -84,10 +84,7 @@ Trusted Publisher on npm must stay configured for:
 
 ## License
 
-Released under the [PolyForm Shield License 1.0.0](./LICENSE.md), in plain language:
+[MIT](./LICENSE.md). Use it however you like, including in commercial and competing products.
 
-- **Source-available.** The source is public and you can read, fork, and modify it.
-- **Permitted for non-competing use.** You can use this package freely in your own products and services, as long as they don't compete with A11y Pulse.
-- **Competing products are forbidden.** You may not use this software (or a modified version of it) to build a product or service that competes with A11y Pulse's accessibility monitoring offering.
-
-See [LICENSE.md](./LICENSE.md) for the full, binding terms.
+The audit packages in this repository are licensed separately, under the
+[PolyForm Shield License 1.0.0](../../LICENSE.md).

package/dist/adaptor.d.ts

@@ -9,8 +9,8 @@ export type Rect = {
  */
 export type ElementRef = unknown;
 /**
- * A framework-specific adaptor that provides the primitives needed by the audit. An adaptor wraps
- * a single page in a web browser.
+ * A framework-specific adaptor that provides the primitives needed by the audit. An adaptor wraps a
+ * single page in a web browser.
  */
 export interface BrowserAdaptor {
     /**
@@ -30,10 +30,9 @@ export interface BrowserAdaptor {
      */
     pressTab(): Promise<void>;
     /**
-     * Screenshot a clipped region of the page. `scale` is the device scale
-     * factor (bitmap pixels per CSS pixel), multiplied against whatever
-     * deviceScaleFactor the page itself currently has (Puppeteer does not
-     * replace it). The caller is responsible for the page being at a known
+     * Screenshot a clipped region of the page. `scale` is the device scale factor (bitmap pixels per
+     * CSS pixel), multiplied against whatever deviceScaleFactor the page itself currently has
+     * (Puppeteer does not replace it). The caller is responsible for the page being at a known
      * deviceScaleFactor before invoking this.
      */
     screenshotClip(clip: Rect, scale?: number): Promise<Uint8Array>;
@@ -41,8 +40,7 @@ export interface BrowserAdaptor {
     readonly screenshotClipScale?: number;
     /**
      * Ensure the page reports focus for its lifetime. In particular, `document.hasFocus()` must
-     * function correctly and :focus styles must be applied, even when the page is not the
-     * foreground.
+     * function correctly and :focus styles must be applied, even when the page is not the foreground.
      *
      * This function must not throw.
      */

package/dist/adaptors/puppeteer.js

@@ -1,5 +1,5 @@
 // src/adaptors/puppeteer.ts
-var focusEmulationEnabled = /* @__PURE__ */ new WeakSet();
+var focusEmulationSessions = /* @__PURE__ */ new WeakMap();
 var PuppeteerAdaptor = class {
   constructor(page) {
     this.page = page;
@@ -29,20 +29,24 @@ var PuppeteerAdaptor = class {
     });
   }
   async ensureFocusReporting() {
-    if (focusEmulationEnabled.has(this.page)) {
-      return;
-    }
     try {
+      const existing = focusEmulationSessions.get(this.page);
+      if (existing) {
+        await existing.send("Emulation.setFocusEmulationEnabled", {
+          enabled: false
+        });
+        await existing.send("Emulation.setFocusEmulationEnabled", {
+          enabled: true
+        });
+        return;
+      }
       const client = await this.page.createCDPSession();
       await client.send("Emulation.setFocusEmulationEnabled", {
         enabled: true
       });
-      focusEmulationEnabled.add(this.page);
+      focusEmulationSessions.set(this.page, client);
     } catch (error) {
-      console.warn(
-        "Could not enable focus emulation for the tab orchestrator",
-        { error }
-      );
+      console.warn("Could not enable focus emulation for the tab orchestrator", { error });
     }
   }
 };

package/dist/adaptors/puppeteer.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adaptors/puppeteer.ts"],"sourcesContent":["import type { JSHandle, Page } from \"puppeteer\";\nimport type { BrowserAdaptor, ElementRef, Rect } from \"../adaptor\";\n\n// Pages that already have focus emulation enabled. A fresh adaptor is created per\n// audit run, but a page is often reused across runs (e.g. one page per snapshot,\n// many checks), so without this each run would open another CDP session that is\n// never detached. The emulation persists for the page's lifetime, so enabling it\n// once is enough. (Detaching the session instead is not an option — Chrome clears\n// the emulation when the CDP client disconnects.)\nconst focusEmulationEnabled = new WeakSet<Page>();\n\n/** A BrowserAdaptor backed by a Puppeteer Page. */\nexport class PuppeteerAdaptor implements BrowserAdaptor {\n\treadonly screenshotClipScale = 2;\n\n\tconstructor(private readonly page: Page) {}\n\n\tevaluate<T>(\n\t\t// biome-ignore lint/suspicious/noExplicitAny: the page-evaluated fn accepts arbitrary serialised args and element handles.\n\t\tfn: (...args: any[]) => T | Promise<T>,\n\t\t...args: unknown[]\n\t): Promise<T> {\n\t\t// Puppeteer resolves any JSHandle passed as an arg to the live element.\n\t\treturn this.page.evaluate(fn as never, ...(args as never[])) as Promise<T>;\n\t}\n\n\tevaluateHandle(fn: () => Element | null): Promise<ElementRef> {\n\t\treturn this.page.evaluateHandle(fn);\n\t}\n\n\tasync disposeRef(ref: ElementRef): Promise<void> {\n\t\tawait (ref as JSHandle).dispose();\n\t}\n\n\tasync pressTab(): Promise<void> {\n\t\tawait this.page.keyboard.press(\"Tab\");\n\t}\n\n\tasync screenshotClip(clip: Rect, scale = 1): Promise<Uint8Array> {\n\t\treturn (await this.page.screenshot({\n\t\t\ttype: \"png\",\n\t\t\toptimizeForSpeed: true,\n\t\t\tclip: {\n\t\t\t\t...clip,\n\t\t\t\tscale,\n\t\t\t},\n\t\t})) as Uint8Array;\n\t}\n\n\tasync ensureFocusReporting(): Promise<void> {\n\t\t// Pages only report focus while they are the foreground tab. Since this browser instance\n\t\t// is likely running in the background, we need to enable focus emulation to get accurate\n\t\t// results.\n\t\t//\n\t\t// Note this function does not throw if enabling emulation fails; it is a best-effort.\n\t\tif (focusEmulationEnabled.has(this.page)) {\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tconst client = await this.page.createCDPSession();\n\t\t\tawait client.send(\"Emulation.setFocusEmulationEnabled\", {\n\t\t\t\tenabled: true,\n\t\t\t});\n\t\t\tfocusEmulationEnabled.add(this.page);\n\t\t} catch (error) {\n\t\t\tconsole.warn(\n\t\t\t\t\"Could not enable focus emulation for the tab orchestrator\",\n\t\t\t\t{ error },\n\t\t\t);\n\t\t}\n\t}\n}\n"],"mappings":";AASA,IAAM,wBAAwB,oBAAI,QAAc;AAGzC,IAAM,mBAAN,MAAiD;AAAA,EAGvD,YAA6B,MAAY;AAAZ;AAAA,EAAa;AAAA,EAAb;AAAA,EAFpB,sBAAsB;AAAA,EAI/B,SAEC,OACG,MACU;AAEb,WAAO,KAAK,KAAK,SAAS,IAAa,GAAI,IAAgB;AAAA,EAC5D;AAAA,EAEA,eAAe,IAA+C;AAC7D,WAAO,KAAK,KAAK,eAAe,EAAE;AAAA,EACnC;AAAA,EAEA,MAAM,WAAW,KAAgC;AAChD,UAAO,IAAiB,QAAQ;AAAA,EACjC;AAAA,EAEA,MAAM,WAA0B;AAC/B,UAAM,KAAK,KAAK,SAAS,MAAM,KAAK;AAAA,EACrC;AAAA,EAEA,MAAM,eAAe,MAAY,QAAQ,GAAwB;AAChE,WAAQ,MAAM,KAAK,KAAK,WAAW;AAAA,MAClC,MAAM;AAAA,MACN,kBAAkB;AAAA,MAClB,MAAM;AAAA,QACL,GAAG;AAAA,QACH;AAAA,MACD;AAAA,IACD,CAAC;AAAA,EACF;AAAA,EAEA,MAAM,uBAAsC;AAM3C,QAAI,sBAAsB,IAAI,KAAK,IAAI,GAAG;AACzC;AAAA,IACD;AAEA,QAAI;AACH,YAAM,SAAS,MAAM,KAAK,KAAK,iBAAiB;AAChD,YAAM,OAAO,KAAK,sCAAsC;AAAA,QACvD,SAAS;AAAA,MACV,CAAC;AACD,4BAAsB,IAAI,KAAK,IAAI;AAAA,IACpC,SAAS,OAAO;AACf,cAAQ;AAAA,QACP;AAAA,QACA,EAAE,MAAM;AAAA,MACT;AAAA,IACD;AAAA,EACD;AACD;","names":[]}
+{"version":3,"sources":["../../src/adaptors/puppeteer.ts"],"sourcesContent":["import type { CDPSession, JSHandle, Page } from \"puppeteer\";\nimport type { BrowserAdaptor, ElementRef, Rect } from \"../adaptor\";\n\n// The CDP session holding focus emulation for each page. A fresh adaptor is created per audit run,\n// but a page often outlives one run, so without this each run would open another CDP session that\n// is never detached. The session is kept attached for the page's lifetime: Chrome clears the\n// emulation when the CDP client disconnects.\nconst focusEmulationSessions = new WeakMap<Page, CDPSession>();\n\n/** A BrowserAdaptor backed by a Puppeteer Page. */\nexport class PuppeteerAdaptor implements BrowserAdaptor {\n\treadonly screenshotClipScale = 2;\n\n\tconstructor(private readonly page: Page) {}\n\n\tevaluate<T>(\n\t\t// biome-ignore lint/suspicious/noExplicitAny: the page-evaluated fn accepts arbitrary serialised args and element handles.\n\t\tfn: (...args: any[]) => T | Promise<T>,\n\t\t...args: unknown[]\n\t): Promise<T> {\n\t\t// Puppeteer resolves any JSHandle passed as an arg to the live element.\n\t\treturn this.page.evaluate(fn as never, ...(args as never[])) as Promise<T>;\n\t}\n\n\tevaluateHandle(fn: () => Element | null): Promise<ElementRef> {\n\t\treturn this.page.evaluateHandle(fn);\n\t}\n\n\tasync disposeRef(ref: ElementRef): Promise<void> {\n\t\tawait (ref as JSHandle).dispose();\n\t}\n\n\tasync pressTab(): Promise<void> {\n\t\tawait this.page.keyboard.press(\"Tab\");\n\t}\n\n\tasync screenshotClip(clip: Rect, scale = 1): Promise<Uint8Array> {\n\t\treturn (await this.page.screenshot({\n\t\t\ttype: \"png\",\n\t\t\toptimizeForSpeed: true,\n\t\t\tclip: {\n\t\t\t\t...clip,\n\t\t\t\tscale,\n\t\t\t},\n\t\t})) as Uint8Array;\n\t}\n\n\tasync ensureFocusReporting(): Promise<void> {\n\t\t// Pages only report focus while they are the foreground tab. Since this browser instance is\n\t\t// likely running in the background, we need to enable focus emulation to get accurate results.\n\t\t//\n\t\t// Note this function does not throw if enabling emulation fails; it is a best-effort.\n\t\ttry {\n\t\t\tconst existing = focusEmulationSessions.get(this.page);\n\n\t\t\tif (existing) {\n\t\t\t\t// Chromium ignores a redundant enable, so re-asserting has to toggle.\n\t\t\t\tawait existing.send(\"Emulation.setFocusEmulationEnabled\", {\n\t\t\t\t\tenabled: false,\n\t\t\t\t});\n\t\t\t\tawait existing.send(\"Emulation.setFocusEmulationEnabled\", {\n\t\t\t\t\tenabled: true,\n\t\t\t\t});\n\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst client = await this.page.createCDPSession();\n\t\t\tawait client.send(\"Emulation.setFocusEmulationEnabled\", {\n\t\t\t\tenabled: true,\n\t\t\t});\n\t\t\tfocusEmulationSessions.set(this.page, client);\n\t\t} catch (error) {\n\t\t\tconsole.warn(\"Could not enable focus emulation for the tab orchestrator\", { error });\n\t\t}\n\t}\n}\n"],"mappings":";AAOA,IAAM,yBAAyB,oBAAI,QAA0B;AAGtD,IAAM,mBAAN,MAAiD;AAAA,EAGvD,YAA6B,MAAY;AAAZ;AAAA,EAAa;AAAA,EAAb;AAAA,EAFpB,sBAAsB;AAAA,EAI/B,SAEC,OACG,MACU;AAEb,WAAO,KAAK,KAAK,SAAS,IAAa,GAAI,IAAgB;AAAA,EAC5D;AAAA,EAEA,eAAe,IAA+C;AAC7D,WAAO,KAAK,KAAK,eAAe,EAAE;AAAA,EACnC;AAAA,EAEA,MAAM,WAAW,KAAgC;AAChD,UAAO,IAAiB,QAAQ;AAAA,EACjC;AAAA,EAEA,MAAM,WAA0B;AAC/B,UAAM,KAAK,KAAK,SAAS,MAAM,KAAK;AAAA,EACrC;AAAA,EAEA,MAAM,eAAe,MAAY,QAAQ,GAAwB;AAChE,WAAQ,MAAM,KAAK,KAAK,WAAW;AAAA,MAClC,MAAM;AAAA,MACN,kBAAkB;AAAA,MAClB,MAAM;AAAA,QACL,GAAG;AAAA,QACH;AAAA,MACD;AAAA,IACD,CAAC;AAAA,EACF;AAAA,EAEA,MAAM,uBAAsC;AAK3C,QAAI;AACH,YAAM,WAAW,uBAAuB,IAAI,KAAK,IAAI;AAErD,UAAI,UAAU;AAEb,cAAM,SAAS,KAAK,sCAAsC;AAAA,UACzD,SAAS;AAAA,QACV,CAAC;AACD,cAAM,SAAS,KAAK,sCAAsC;AAAA,UACzD,SAAS;AAAA,QACV,CAAC;AAED;AAAA,MACD;AAEA,YAAM,SAAS,MAAM,KAAK,KAAK,iBAAiB;AAChD,YAAM,OAAO,KAAK,sCAAsC;AAAA,QACvD,SAAS;AAAA,MACV,CAAC;AACD,6BAAuB,IAAI,KAAK,MAAM,MAAM;AAAA,IAC7C,SAAS,OAAO;AACf,cAAQ,KAAK,6DAA6D,EAAE,MAAM,CAAC;AAAA,IACpF;AAAA,EACD;AACD;","names":[]}

package/dist/audit-scaffold.d.ts

@@ -22,13 +22,13 @@ export type BaseAuditSummary = {
     /** True if the audit stopped early after hitting `failedElementLimit`. */
     reachedFailedElementLimit: boolean;
     /**
-     * True if the audit returned early because `timeout` elapsed. The results
-     * are whatever had been gathered when the deadline hit.
+     * True if the audit returned early because `timeout` elapsed. The results are whatever had been
+     * gathered when the deadline hit.
      */
     timedOut: boolean;
     /**
-     * Why the tab session ended, or `null` when this consumer disconnected
-     * itself (element limit, failed-element limit, or timeout).
+     * Why the tab session ended, or `null` when this consumer disconnected itself (element limit,
+     * failed-element limit, or timeout).
      */
     sessionEnd: SessionEndReason | null;
 };
@@ -43,8 +43,7 @@ export type AuditSelfDisconnect = {
     clear(): void;
 };
 /**
- * Arms an optional self-disconnecting timeout and tracks whether this
- * consumer initiated its own disconnect, so `onSessionEnd` can tell that
- * apart from an external end.
+ * Arms an optional self-disconnecting timeout and tracks whether this consumer initiated its own
+ * disconnect, so `onSessionEnd` can tell that apart from an external end.
  */
 export declare function createAuditSelfDisconnect(): AuditSelfDisconnect;

package/dist/browser-scripts.d.ts

@@ -1,7 +1,7 @@
 /**
- * IMPORTANT: Functions in this file are serialized and injected into the audited page, so they
- * must not reference any symbols outside their own scope. This also means they cannot share code,
- * so any common logic (like descending into shadow roots) must be duplicated.
+ * IMPORTANT: Functions in this file are serialized and injected into the audited page, so they must
+ * not reference any symbols outside their own scope. This also means they cannot share code, so any
+ * common logic (like descending into shadow roots) must be duplicated.
  */
 import type { Rect } from "./adaptor";
 import type { StyleSnapshot } from "./types";
@@ -30,9 +30,9 @@ export type ActiveElementBase = {
     index: number | null;
     isBody: boolean;
     /**
-     * The focused element is an <iframe>. Tabbing into a frame passes focus into
-     * its embedded document, but the parent's document.activeElement is the frame
-     * element itself, so the loop uses this to skip the frame as a tab stop.
+     * The focused element is an <iframe>. Tabbing into a frame passes focus into its embedded
+     * document, but the parent's document.activeElement is the frame element itself, so the loop uses
+     * this to skip the frame as a tab stop.
      */
     isIframe: boolean;
     html: string;
@@ -40,9 +40,8 @@ export type ActiveElementBase = {
     rect: Rect;
 };
 /**
- * Read the currently focused element (descending open shadow roots), returning
- * its marker index, opening-tag HTML (marker attribute stripped), focus-relevant
- * styles, and page-relative rect.
+ * Read the currently focused element (descending open shadow roots), returning its marker index,
+ * opening-tag HTML (marker attribute stripped), focus-relevant styles, and page-relative rect.
  */
 export declare function probeActiveElementScript(props: string[], markerAttr: string): ActiveElementBase;
 export declare function activeElementHandleScript(): Element | null;
@@ -52,8 +51,8 @@ export declare function pageDimensionsScript(): {
 };
 export declare function elementRectScript(el: Element | null): Rect;
 /**
- * Whether something unrelated (e.g. a fixed cookie banner) covers the element's centre point, so
- * a screenshot of the element's box would show the covering element instead.
+ * Whether something unrelated (e.g. a fixed cookie banner) covers the element's centre point, so a
+ * screenshot of the element's box would show the covering element instead.
  */
 export declare function isCenterObscuredScript(el: Element | null): boolean;
 /**
@@ -61,26 +60,18 @@ export declare function isCenterObscuredScript(el: Element | null): boolean;
  * afterwards isn't captured mid-animation.
  */
 export declare function scrollToCenterScript(el: Element | null): void;
-/**
- * Blur (unfocus) an element
- */
 export declare function blurScript(el: Element | null): void;
-/**
- * Focus an element
- */
 export declare function focusScript(el: Element | null): void;
 /**
- * Read focus-relevant computed styles from a given element. Unlike
- * `probeActiveElementScript`, this does not use `document.activeElement`, so it
- * still works after the node has been blurred.
+ * Read focus-relevant computed styles from a given element. Unlike `probeActiveElementScript`, this
+ * does not use `document.activeElement`, so it still works after the node has been blurred.
  */
 export declare function elementStylesScript(el: Element | null, props: string[]): StyleSnapshot;
 /**
- * Remove the marker attribute from all elements, blur the active element, and
- * scroll back to the top. This is a best-effort attempt to reset state between
- * audits: the tab loop scrolls later elements into view as it walks the page
- * (see scrollToCenterScript), and nothing else undoes that once the session
- * ends.
+ * Remove the marker attribute from all elements, blur the active element, and scroll back to the
+ * top. This is a best-effort attempt to reset state between audits: the tab loop scrolls later
+ * elements into view as it walks the page (see scrollToCenterScript), and nothing else undoes that
+ * once the session ends.
  */
 export declare function clearMarkersScript(markerAttr: string): void;
 export type MeasureObscuringResult = {
@@ -93,9 +84,9 @@ export type MeasureObscuringResult = {
     hasObscurer: boolean;
 };
 /**
- * Hit-test whether author-created content entirely hides the focused element.
- * Marks a single covering element with `obscurerAttr` when containment confirms
- * a full cover, so the host can resolve its selector via getSelector.
+ * Hit-test whether author-created content entirely hides the focused element. Marks a single
+ * covering element with `obscurerAttr` when containment confirms a full cover, so the host can
+ * resolve its selector via getSelector.
  */
 export declare function measureObscuringScript(el: Element | null, obscurerAttr: string): MeasureObscuringResult;
 /** Return the element marked as the obscurer, if any. */
@@ -116,8 +107,8 @@ declare global {
     }
 }
 /**
- * Install once: wrap window.open (record + inert stub), capture-phase submit
- * (record + preventDefault), track focusin and soft URL changes.
+ * Install once: wrap window.open (record + inert stub), capture-phase submit (record +
+ * preventDefault), track focusin and soft URL changes.
  */
 export declare function installContextObserverScript(): void;
 export type DrainContextObserverResult = {
@@ -132,20 +123,23 @@ export type DrainContextObserverResult = {
     hasAttributed: boolean;
 };
 /**
- * Drain observer signals for the current tab stop and reset per-stop flags.
- * Classification of focus removal / redirection uses the post-Tab settle
- * activeElement and the focusin history from this stop only.
+ * Drain observer signals for the current tab stop and reset per-stop flags. Classification of focus
+ * removal / redirection uses the post-Tab settle activeElement and the focusin history from this
+ * stop only.
  */
 export declare function drainContextObserverScript(markerAttr: string): DrainContextObserverResult;
-/** Return the element marked as attributed by drainContextObserverScript (the
- * element that received a focus event this stop and then lost it), if any. */
+/**
+ * Return the element marked as attributed by drainContextObserverScript (the element that received
+ * a focus event this stop and then lost it), if any.
+ */
 export declare function attributedHandleScript(): Element | null;
 export declare function clearAttributedScript(): void;
 /**
- * Drop focusin history accumulated after drain (e.g. pixel-diff blur/refocus)
- * so the next tab stop does not mis-attribute F55 or redirects.
+ * Drop focusin history accumulated after drain (e.g. pixel-diff blur/refocus) so the next tab stop
+ * does not mis-attribute F55 or redirects.
  */
 export declare function clearContextFocusInsScript(): void;
 /** Current location.href for navigation comparison in the host. */
 export declare function locationHrefScript(): string;
+export declare function hasFocusScript(): boolean;
 export {};

package/dist/capture-screenshot.d.ts

@@ -4,7 +4,7 @@ export type CaptureScreenshotOptions = {
 };
 /**
  * Screenshot the element `handle` currently refers to, clipped to its box plus
- * `screenshotClipBuffer` padding. The caller owns `handle` and must dispose it
- * after this promise settles.
+ * `screenshotClipBuffer` padding. The caller owns `handle` and must dispose it after this promise
+ * settles.
  */
 export declare function captureScreenshot(adaptor: BrowserAdaptor, options: CaptureScreenshotOptions, handle: ElementRef): Promise<Uint8Array>;

package/dist/clip.d.ts

@@ -1,7 +1,7 @@
 import type { Rect } from "./adaptor";
 /**
- * A screenshot clip framing `rect` with up to `buffer` pixels of padding on each side, shrunk
- * where the page edges leave less room. The padding allows for indicators drawn just outside
- * the element box (outlines, shadows) and for anti-aliasing.
+ * A screenshot clip framing `rect` with up to `buffer` pixels of padding on each side, shrunk where
+ * the page edges leave less room. The padding allows for indicators drawn just outside the element
+ * box (outlines, shadows) and for anti-aliasing.
  */
 export declare function bufferedClip(rect: Rect, pageWidth: number, pageHeight: number, buffer: number): Rect;

package/dist/context-signals.d.ts

@@ -1,7 +1,6 @@
 /**
- * Whether focus destination Y is inside the subtree of intended focus X
- * (descendant or ancestor), which is legitimate delegation rather than theft.
- * Walks across open shadow roots so focusing into a host's shadow content is
- * same-subtree, not theft.
+ * Whether focus destination Y is inside the subtree of intended focus X (descendant or ancestor),
+ * which is legitimate delegation rather than theft. Walks across open shadow roots so focusing into
+ * a host's shadow content is same-subtree, not theft.
  */
 export declare function isSameFocusSubtree(intended: Element, settled: Element): boolean;

package/dist/get-selector.d.ts

@@ -5,7 +5,7 @@
  *
  * Mirrors axe-core's approach: each level contributes the fewest features that discriminate the
  * element (a unique id, the rarest single class, or an :nth-of-type position), and the walk stops
- * as soon as the joined selector matches exactly one element. Selectors stay short because of
- * that early stop, not because of truncation; the length budget is only a backstop.
+ * as soon as the joined selector matches exactly one element. Selectors stay short because of that
+ * early stop, not because of truncation; the length budget is only a backstop.
  */
 export declare function getSelector(root: Node | null): string;

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { BrowserAdaptor, ElementRef, Rect } from "./adaptor";
 export type { AuditSelfDisconnect, BaseAuditOptions, BaseAuditSummary, } from "./audit-scaffold";
 export { createAuditSelfDisconnect, DEFAULT_ELEMENT_LIMIT, DEFAULT_FAILED_ELEMENT_LIMIT, DEFAULT_SCREENSHOT_SETTLE_DELAY, DEFAULT_TIMEOUT, } from "./audit-scaffold";
 export type { ActiveElementBase, BaselinePayload } from "./browser-scripts";
-export { activeElementHandleScript, baselineScript, blurScript, clearMarkersScript, elementRectScript, elementStylesScript, focusScript, isCenterObscuredScript, pageDimensionsScript, probeActiveElementScript, scrollToCenterScript, } from "./browser-scripts";
+export { activeElementHandleScript, baselineScript, blurScript, clearMarkersScript, elementRectScript, elementStylesScript, focusScript, hasFocusScript, isCenterObscuredScript, pageDimensionsScript, probeActiveElementScript, scrollToCenterScript, } from "./browser-scripts";
 export { bufferedClip } from "./clip";
 export { FOCUS_STYLE_PROPERTIES } from "./focus-style";
 export { getSelector } from "./get-selector";