screen-reader-mirror 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Lanzon and screen-reader-mirror contributors
+
+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

@@ -1,3 +1,122 @@
-# Temporary Holding Version
+# screen-reader-mirror
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> See what a screen reader interprets from your UI — zero install, client-side, no data leaves the
+> machine.
+
+The shared engine behind [screen-reader-mirror](https://github.com/Koshux/screen-reader-mirror).
+`linearize(element)` walks a DOM subtree and returns the **reading order a screen reader would
+traverse**: each node's WAI-ARIA role and accessible name, with assistive-tech-hidden content
+removed and the common encoding mistakes flagged (a styled `<span>` that only *looks* like a
+heading, a button with no name, an image with no `alt`). A sighted developer can see the
+screen-reader view without a screen reader installed.
+
+## Install
+
+```bash
+npm install screen-reader-mirror
+# or
+pnpm add screen-reader-mirror
+```
+
+Or straight from a CDN — ESM, no build step, no account:
+
+```html
+<script type="module">
+  import { linearize } from "https://cdn.jsdelivr.net/npm/screen-reader-mirror/+esm";
+  // or: https://unpkg.com/screen-reader-mirror?module
+  console.table(linearize(document.body));
+</script>
+```
+
+## Quickstart
+
+```html
+<main>
+  <h1>Orders</h1>
+  <p>3 open, 1 overdue</p>
+  <span class="h2">Recent</span>
+  <button><svg aria-hidden="true"></svg></button>
+  <img src="chart.png">
+  <a href="/orders/42">Details</a>
+</main>
+```
+
+```ts
+import { linearize } from "screen-reader-mirror";
+
+const nodes = linearize(document.querySelector("main")!);
+```
+
+`nodes` is plain, serialisable data — one entry per thing a screen reader would land on, in order:
+
+```jsonc
+[
+  { "role": "main",    "name": "",                 "ref": { "tag": "main" } },
+  { "role": "heading", "name": "Orders",           "ref": { "tag": "h1" }, "level": 1 },
+  { "role": "text",    "name": "3 open, 1 overdue" },
+  { "role": "text",    "name": "Recent" },                         // ← styled span: NOT a heading
+  { "role": "button",  "name": "",  "ref": { "tag": "button" }, "flags": { "unnamed": true } },
+  { "role": "img",     "name": "",  "ref": { "tag": "img" },    "flags": { "missingAlt": true } },
+  { "role": "link",    "name": "Details",          "ref": { "tag": "a" } }
+]
+```
+
+Reading it:
+
+- **`role`** is the computed WAI-ARIA role (explicit `role` wins; otherwise the *conditional*
+  implicit role — `<a>` is a `link` only with `href`, `<li>` is a `listitem` only inside a list,
+  an unnamed `<section>` is not a landmark). Bare text runs are `"text"`.
+- **`name`** is the accessible name per AccName 1.2. An element whose name comes from its content
+  (heading, link, cell…) carries that text in `name`; it is not read twice. Nested elements
+  (the link inside a heading, the image inside a button) are still emitted after their parent.
+- **`level`** is the heading level (`<h1>`–`<h6>`, or `aria-level`; `role="heading"` defaults to 2).
+- **`flags.unnamed`** — an interactive control with no accessible name.
+  **`flags.missingAlt`** — an `<img>` with no `alt` attribute at all (`alt=""` is treated as
+  decorative and omitted, as a screen reader would).
+- Content hidden from assistive tech (`aria-hidden="true"`, `hidden`, `display:none`,
+  `visibility:hidden`) is excluded along with its subtree.
+
+## API
+
+```ts
+function linearize(root: Element, options?: LinearizeOptions): InterpretationNode[];
+
+interface InterpretationNode {
+  role: string;                 // computed ARIA role, or "text"
+  name: string;                 // accessible name (may be "")
+  level?: number;               // headings only
+  flags?: { unnamed?: boolean; missingAlt?: boolean };
+  ref?: { tag: string };        // serialisable pointer — never a live node
+}
+
+interface LinearizeOptions {
+  /** Override the computed-style source (for jsdom/happy-dom or non-browser hosts). */
+  getComputedStyle?: (el: Element) => CSSStyleDeclaration | null | undefined;
+}
+```
+
+Reading order follows **DOM order**, as screen readers do — CSS reordering (`flex`/`grid` `order`,
+positioning) is intentionally not reflected. Shadow DOM, iframes, live regions and per-screen-reader
+phrasing (NVDA / JAWS / VoiceOver verbosity) are tracked follow-ups on the
+[roadmap](https://github.com/Koshux/screen-reader-mirror/blob/main/docs/project/board.md).
+
+## Guarantees
+
+- **No network calls — ever.** The engine is pure computation over the `Element` you pass in,
+  enforced by lint and a commit-time hook. Safe for regulated, EU and internal pages.
+- **Tree-shakeable ESM**, `sideEffects: false`, TypeScript types included. Two runtime
+  dependencies, both permissively licensed: [`dom-accessibility-api`](https://github.com/eps1lon/dom-accessibility-api)
+  (MIT, the AccName implementation Testing Library trusts) and
+  [`aria-query`](https://github.com/A11yance/aria-query) (Apache-2.0, the WAI-ARIA role data).
+- **MIT licensed**, public npm registry only, no account or API key.
+
+## Status
+
+`0.1.x` implements [SPEC-001](https://github.com/Koshux/screen-reader-mirror/blob/main/docs/specs/SPEC-001-core-linearize-foundation.md)
+(reading order, roles, names, levels, flags, hidden-content exclusion) with a golden HTML fixture
+per behaviour. The pure-JS role/name computation is the portable path; hosts that can reach a real
+browser accessibility tree (the upcoming extension) will use it as the higher-fidelity oracle.
+
+## License
+
+[MIT](https://github.com/Koshux/screen-reader-mirror/blob/main/LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The interpretation model — what a screen reader would encounter, as plain serialisable data.
+ *
+ * Every node is plain, JSON-serialisable data with **no live DOM references**, so the output can
+ * cross a boundary (content-script → side panel, CLI → report file, worker → UI) without leaking a
+ * node handle. This model is the public contract from SPEC-001 §3 (spec-reviewed 2026-06-15).
+ */
+/**
+ * Conditions worth surfacing to the developer about a node. Each flag is omitted unless true, so an
+ * absent `flags` (or `flags.x`) means "not applicable / fine".
+ */
+interface NodeFlags {
+    /** An interactive (widget-role) element with no accessible name. SPEC-001 AC-5. */
+    unnamed?: boolean;
+    /** An `<img>` with no `alt` attribute at all — distinct from an intentional `alt=""`. SPEC-001 AC-6. */
+    missingAlt?: boolean;
+}
+/**
+ * One entry in the linearized, screen-reader reading order.
+ *
+ * A node is either an **element** (with its computed `role` and accessible `name`) or a **bare run
+ * of text** (`role: "text"`). Per the "no double-read" rule (SPEC-001 §3), an element whose role
+ * takes its name from content carries that text in `name` and does *not* also produce `text` nodes
+ * for the same subtree.
+ */
+interface InterpretationNode {
+    /**
+     * Computed WAI-ARIA role (e.g. `"heading"`, `"link"`, `"button"`), or the literal `"text"` for a
+     * bare text run. Resolved per SPEC-001 §3 — an explicit `role` wins; otherwise the *conditional*
+     * implicit role (e.g. `<a>` is only a `link` with an `href`) — never a naive tag→role map.
+     */
+    role: string;
+    /** Accessible name per AccName 1.2. May be an empty string (see {@link NodeFlags.unnamed}). */
+    name: string;
+    /**
+     * Heading level, present only when the node is a heading: 1–6 from `<h1>`–`<h6>`, any integer
+     * ≥ 1 from an author `aria-level` (which wins over the tag), 2 when neither is given.
+     */
+    level?: number;
+    /** Notable conditions; omitted entirely when there are none. */
+    flags?: NodeFlags;
+    /** Minimal, serialisable pointer back to the source element — a tag name only, never a live node. */
+    ref?: {
+        tag: string;
+    };
+}
+
+/**
+ * AT-visibility predicate — SPEC-001 §3 / AC-3.
+ *
+ * Returns `true` when an element is excluded from the accessibility tree, so the linearizer skips
+ * it (and, for the MVP, its subtree). The four exclusion conditions:
+ *   - `aria-hidden="true"`
+ *   - the `hidden` attribute (except `hidden="until-found"`, which stays in the tree)
+ *   - `display: none`
+ *   - `visibility: hidden` / `collapse`
+ *
+ * Attribute conditions (`aria-hidden`, `hidden`) are reliable everywhere. The CSS conditions need
+ * `getComputedStyle`, which jsdom implements only partially — pass inline styles in tests or use
+ * happy-dom / a real browser (SPEC-001 §5). Style is read **defensively**: if it can't be computed
+ * (detached node, no view, throwing impl), the element is treated as visible so we never wrongly
+ * drop content.
+ *
+ * Host-agnostic by design: the computed-style source comes from the element's own
+ * `ownerDocument.defaultView`, never a global `window` (core makes no global/network assumptions).
+ *
+ * Note: `visibility:hidden` can be overridden by a descendant (`visibility:visible`); honouring that
+ * per-descendant is a deferred refinement (SPEC-001 non-goals) — the MVP treats it as hidden here.
+ */
+interface VisibilityOptions {
+    /** Override the computed-style source (defaults to the element's own document view). */
+    getComputedStyle?: (el: Element) => CSSStyleDeclaration | null | undefined;
+}
+
+type LinearizeOptions = VisibilityOptions;
+/**
+ * Linearize a DOM subtree into the ordered sequence a screen reader would traverse (SPEC-001).
+ *
+ * Each element is one of three kinds:
+ *  - **transparent** (no role, or a silent structural role) — emits nothing, recurses so its text
+ *    and descendants surface.
+ *  - **leaf** — a form control / image, or a role whose children are presentational *and* whose
+ *    name cannot come from content (img, slider, separator, progressbar, …): emits one node and
+ *    does **not** recurse, because nothing below it is exposed.
+ *  - **container** — everything else (landmark, list, table, row, cell, link, heading, and also
+ *    the content widgets button/tab/option/switch whose descendants browsers do keep in the tree):
+ *    emits a node *and* recurses, so nested elements — the link inside a heading, the missing-alt
+ *    image inside a button, the button inside a table cell — stay in the reading order.
+ *
+ * The **no-double-read rule** (SPEC-001 §3): a role that takes its name from content (heading,
+ * link, cell, row, button, …) has already consumed its descendant *text* into `name`, so bare
+ * text runs inside it are not emitted again — but descendant *elements* with roles of their own
+ * still are, and each emitted container starts a fresh text context: an author-named container
+ * (list, listitem, group, landmark) nested in a consumed subtree surfaces its own text.
+ * Elements hidden from assistive tech are skipped along with their subtree.
+ */
+declare function linearize(root: Element, options?: LinearizeOptions): InterpretationNode[];
+
+export { linearize };
+export type { InterpretationNode, LinearizeOptions, NodeFlags };

package/dist/index.js

@@ -0,0 +1,313 @@
+import { roles } from 'aria-query';
+import { computeAccessibleName } from 'dom-accessibility-api';
+
+// src/visibility.ts
+function isHiddenFromAT(el, options = {}) {
+  if (el.getAttribute("aria-hidden")?.toLowerCase() === "true") return true;
+  const hidden = el.getAttribute("hidden");
+  if (hidden !== null && hidden.toLowerCase() !== "until-found") return true;
+  const style = resolveStyle(el, options);
+  if (style) {
+    if (style.display === "none") return true;
+    if (style.visibility === "hidden" || style.visibility === "collapse") return true;
+  }
+  return false;
+}
+function resolveStyle(el, options) {
+  try {
+    if (options.getComputedStyle) return options.getComputedStyle(el) ?? null;
+    const view = el.ownerDocument?.defaultView;
+    return view ? view.getComputedStyle(el) : null;
+  } catch {
+    return null;
+  }
+}
+var roleMap = roles;
+var NAME_FROM_CONTENT_OVERRIDES = { rowgroup: false };
+var PRESENTATIONAL = /* @__PURE__ */ new Set(["presentation", "none"]);
+function resolveRole(el) {
+  const explicit = el.getAttribute("role");
+  if (explicit) {
+    for (const token of explicit.trim().toLowerCase().split(/\s+/)) {
+      const def = roleMap.get(token);
+      if (!def || def.abstract) continue;
+      if (PRESENTATIONAL.has(token) && presentationIsOverridden(el)) return implicitRole(el);
+      return token;
+    }
+  }
+  return implicitRole(el);
+}
+function implicitRole(el) {
+  const tag = el.tagName.toLowerCase();
+  switch (tag) {
+    case "a":
+    case "area":
+      return el.hasAttribute("href") ? "link" : null;
+    // generic without href
+    case "button":
+      return "button";
+    case "h1":
+    case "h2":
+    case "h3":
+    case "h4":
+    case "h5":
+    case "h6":
+      return "heading";
+    case "nav":
+      return "navigation";
+    case "main":
+      return "main";
+    case "header":
+      return scopeOf(el) === "body" ? "banner" : null;
+    case "footer":
+      return scopeOf(el) === "body" ? "contentinfo" : null;
+    case "aside":
+      return scopeOf(el) !== "sectioning" || hasAccessibleName(el) ? "complementary" : null;
+    case "ul":
+    case "ol":
+    case "menu":
+      return "list";
+    case "li":
+      return el.parentElement && resolveRole(el.parentElement) === "list" ? "listitem" : null;
+    case "p":
+      return "paragraph";
+    case "img":
+      return el.getAttribute("alt") === "" && !presentationIsOverridden(el) ? "presentation" : "img";
+    case "svg":
+      return hasAccessibleName(el) ? "img" : null;
+    case "input":
+      return inputRole(el);
+    case "textarea":
+      return "textbox";
+    case "select":
+      return el.hasAttribute("multiple") || numericSize(el) > 1 ? "listbox" : "combobox";
+    case "table":
+      return "table";
+    case "thead":
+    case "tbody":
+    case "tfoot":
+      return tableIsPresentational(el) ? null : "rowgroup";
+    case "tr":
+      return tableIsPresentational(el) ? null : "row";
+    case "td": {
+      const table = ancestorTableRole(el);
+      if (table && PRESENTATIONAL.has(table)) return null;
+      return table === "grid" || table === "treegrid" ? "gridcell" : "cell";
+    }
+    case "th": {
+      if (tableIsPresentational(el)) return null;
+      const scope = el.getAttribute("scope")?.toLowerCase();
+      return scope === "row" || scope === "rowgroup" ? "rowheader" : "columnheader";
+    }
+    case "article":
+      return "article";
+    case "section":
+      return hasAccessibleName(el) ? "region" : null;
+    case "form":
+      return hasAccessibleName(el) ? "form" : null;
+    case "fieldset":
+      return "group";
+    case "figure":
+      return "figure";
+    case "dialog":
+      return "dialog";
+    case "hr":
+      return "separator";
+    default:
+      return null;
+  }
+}
+function inputRole(el) {
+  const type = (el.getAttribute("type") ?? "text").toLowerCase();
+  switch (type) {
+    case "button":
+    case "submit":
+    case "reset":
+    case "image":
+    case "file":
+      return "button";
+    case "checkbox":
+      return "checkbox";
+    case "radio":
+      return "radio";
+    case "range":
+      return "slider";
+    case "number":
+      return "spinbutton";
+    case "search":
+      return el.hasAttribute("list") ? "combobox" : "searchbox";
+    // HTML-AAM: datalist → combobox
+    case "email":
+    case "tel":
+    case "url":
+    case "text":
+      return el.hasAttribute("list") ? "combobox" : "textbox";
+    case "password":
+      return "textbox";
+    case "hidden":
+      return null;
+    // not in the accessibility tree at all
+    default:
+      return "textbox";
+  }
+}
+var GLOBAL_ARIA_ATTRIBUTES = [
+  "aria-atomic",
+  "aria-busy",
+  "aria-controls",
+  "aria-current",
+  "aria-describedby",
+  "aria-details",
+  "aria-disabled",
+  "aria-dropeffect",
+  "aria-errormessage",
+  "aria-flowto",
+  "aria-grabbed",
+  "aria-haspopup",
+  "aria-hidden",
+  "aria-invalid",
+  "aria-keyshortcuts",
+  "aria-label",
+  "aria-labelledby",
+  "aria-live",
+  "aria-owns",
+  "aria-relevant",
+  "aria-roledescription"
+];
+function presentationIsOverridden(el) {
+  return isFocusable(el) || GLOBAL_ARIA_ATTRIBUTES.some((a) => el.hasAttribute(a));
+}
+function isFocusable(el) {
+  if (el.hasAttribute("tabindex") || el.hasAttribute("contenteditable")) return true;
+  const tag = el.tagName.toLowerCase();
+  if ((tag === "a" || tag === "area") && el.hasAttribute("href")) return true;
+  if (tag === "button" || tag === "select" || tag === "textarea") return !el.hasAttribute("disabled");
+  if (tag === "input") {
+    return !el.hasAttribute("disabled") && (el.getAttribute("type") ?? "").toLowerCase() !== "hidden";
+  }
+  return tag === "summary" || tag === "iframe";
+}
+function ancestorTableRole(el) {
+  const table = el.parentElement?.closest("table");
+  return table ? resolveRole(table) : null;
+}
+function tableIsPresentational(el) {
+  const role = ancestorTableRole(el);
+  return role !== null && PRESENTATIONAL.has(role);
+}
+var SECTIONING_CONTENT_TAGS = /* @__PURE__ */ new Set(["article", "aside", "nav", "section"]);
+var SECTIONING_CONTENT_ROLES = /* @__PURE__ */ new Set(["article", "complementary", "navigation", "region"]);
+var SECTIONING_ROOT_TAGS = /* @__PURE__ */ new Set(["blockquote", "details", "dialog", "fieldset", "figure", "td"]);
+function scopeOf(el) {
+  for (let p = el.parentElement; p; p = p.parentElement) {
+    const tag = p.tagName.toLowerCase();
+    if (tag === "body") return "body";
+    if (SECTIONING_CONTENT_TAGS.has(tag) || SECTIONING_ROOT_TAGS.has(tag)) return "sectioning";
+    if (tag === "main") return "main";
+    if (p.hasAttribute("role")) {
+      const role = resolveRole(p);
+      if (role === "main") return "main";
+      if (role && SECTIONING_CONTENT_ROLES.has(role)) return "sectioning";
+    }
+  }
+  return "body";
+}
+function numericSize(el) {
+  const n = Number(el.getAttribute("size"));
+  return Number.isFinite(n) ? n : 0;
+}
+function accessibleName(el) {
+  try {
+    return computeAccessibleName(el).replace(/\s+/g, " ").trim();
+  } catch {
+    return "";
+  }
+}
+function hasAccessibleName(el) {
+  return accessibleName(el) !== "";
+}
+function takesNameFromContent(role) {
+  if (!role) return false;
+  const override = NAME_FROM_CONTENT_OVERRIDES[role];
+  if (override !== void 0) return override;
+  return roleMap.get(role)?.nameFrom?.includes("contents") ?? false;
+}
+function isChildrenPresentational(role) {
+  if (!role) return false;
+  return roleMap.get(role)?.childrenPresentational ?? false;
+}
+var DUAL_INHERITANCE_WIDGETS = /* @__PURE__ */ new Set(["slider", "spinbutton", "tab", "treeitem", "listbox", "tree"]);
+function isWidget(role) {
+  if (!role) return false;
+  if (DUAL_INHERITANCE_WIDGETS.has(role)) return true;
+  const chains = roleMap.get(role)?.superClass;
+  return !!chains && chains.length > 0 && chains.every((chain) => chain.includes("widget") && !chain.includes("composite"));
+}
+
+// src/linearize.ts
+var ELEMENT_NODE = 1;
+var TEXT_NODE = 3;
+var LEAF_TAGS = /* @__PURE__ */ new Set(["img", "input", "textarea", "select", "hr"]);
+var TRANSPARENT_ROLES = /* @__PURE__ */ new Set(["paragraph", "presentation", "none", "generic"]);
+var SVG_NS = "http://www.w3.org/2000/svg";
+var SVG_METADATA_TAGS = /* @__PURE__ */ new Set(["title", "desc", "metadata"]);
+function linearize(root, options = {}) {
+  const out = [];
+  emitElement(root, out, options, false);
+  return out;
+}
+function emitElement(el, out, options, textConsumed) {
+  if (isHiddenFromAT(el, options)) return;
+  const tag = el.tagName.toLowerCase();
+  if (el.namespaceURI === SVG_NS && SVG_METADATA_TAGS.has(tag)) return;
+  const role = resolveRole(el);
+  if (role === "presentation" && tag === "img") return;
+  if (role === null || TRANSPARENT_ROLES.has(role)) {
+    walkChildren(el, out, options, textConsumed);
+    return;
+  }
+  out.push(buildNode(el, role, tag));
+  const consumesText = takesNameFromContent(role);
+  if (LEAF_TAGS.has(tag) || isChildrenPresentational(role) && !consumesText) return;
+  walkChildren(el, out, options, consumesText);
+}
+function walkChildren(node, out, options, textConsumed) {
+  node.childNodes.forEach((child) => {
+    if (child.nodeType === TEXT_NODE) {
+      if (textConsumed) return;
+      const text = collapseWhitespace(child.textContent ?? "");
+      if (text) out.push({ role: "text", name: text });
+      return;
+    }
+    if (child.nodeType === ELEMENT_NODE) emitElement(child, out, options, textConsumed);
+  });
+}
+function buildNode(el, role, tag) {
+  const name = accessibleName(el);
+  const node = { role, name, ref: { tag } };
+  const level = headingLevel(el, role);
+  if (level !== void 0) node.level = level;
+  const flags = computeFlags(el, role, tag, name);
+  if (flags) node.flags = flags;
+  return node;
+}
+function headingLevel(el, role) {
+  if (role !== "heading") return void 0;
+  const ariaLevel = Number(el.getAttribute("aria-level"));
+  if (Number.isInteger(ariaLevel) && ariaLevel >= 1) return ariaLevel;
+  const tagMatch = /^h([1-6])$/.exec(el.tagName.toLowerCase());
+  return tagMatch ? Number(tagMatch[1]) : 2;
+}
+function computeFlags(el, role, tag, name) {
+  const flags = {};
+  if (isWidget(role) && name === "") flags.unnamed = true;
+  if (tag === "img" && !el.hasAttribute("alt")) flags.missingAlt = true;
+  return Object.keys(flags).length > 0 ? flags : void 0;
+}
+function collapseWhitespace(s) {
+  return s.replace(/\s+/g, " ").trim();
+}
+
+export { linearize };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/visibility.ts","../src/roles.ts","../src/linearize.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * AT-visibility predicate — SPEC-001 §3 / AC-3.\n *\n * Returns `true` when an element is excluded from the accessibility tree, so the linearizer skips\n * it (and, for the MVP, its subtree). The four exclusion conditions:\n *   - `aria-hidden=\"true\"`\n *   - the `hidden` attribute (except `hidden=\"until-found\"`, which stays in the tree)\n *   - `display: none`\n *   - `visibility: hidden` / `collapse`\n *\n * Attribute conditions (`aria-hidden`, `hidden`) are reliable everywhere. The CSS conditions need\n * `getComputedStyle`, which jsdom implements only partially — pass inline styles in tests or use\n * happy-dom / a real browser (SPEC-001 §5). Style is read **defensively**: if it can't be computed\n * (detached node, no view, throwing impl), the element is treated as visible so we never wrongly\n * drop content.\n *\n * Host-agnostic by design: the computed-style source comes from the element's own\n * `ownerDocument.defaultView`, never a global `window` (core makes no global/network assumptions).\n *\n * Note: `visibility:hidden` can be overridden by a descendant (`visibility:visible`); honouring that\n * per-descendant is a deferred refinement (SPEC-001 non-goals) — the MVP treats it as hidden here.\n */\nexport interface VisibilityOptions {\n  /** Override the computed-style source (defaults to the element's own document view). */\n  getComputedStyle?: (el: Element) => CSSStyleDeclaration | null | undefined;\n}\n\nexport function isHiddenFromAT(el: Element, options: VisibilityOptions = {}): boolean {\n  // 1. aria-hidden — case-insensitive \"true\" token (matches browser/Blink behaviour; any non-\"true\"\n  //    value, including \"false\" and the empty string, does not hide).\n  if (el.getAttribute(\"aria-hidden\")?.toLowerCase() === \"true\") return true;\n\n  // 2. the `hidden` attribute, except hidden=\"until-found\" (visually hidden but still in the tree).\n  const hidden = el.getAttribute(\"hidden\");\n  if (hidden !== null && hidden.toLowerCase() !== \"until-found\") return true;\n\n  // 3 & 4. CSS-based hiding, read defensively.\n  const style = resolveStyle(el, options);\n  if (style) {\n    if (style.display === \"none\") return true;\n    if (style.visibility === \"hidden\" || style.visibility === \"collapse\") return true;\n  }\n  return false;\n}\n\nfunction resolveStyle(el: Element, options: VisibilityOptions): CSSStyleDeclaration | null {\n  try {\n    if (options.getComputedStyle) return options.getComputedStyle(el) ?? null;\n    const view = el.ownerDocument?.defaultView;\n    return view ? view.getComputedStyle(el) : null;\n  } catch {\n    return null; // fail-open: can't compute → treat as visible\n  }\n}\n","import { roles } from \"aria-query\";\nimport { computeAccessibleName } from \"dom-accessibility-api\";\n\n/**\n * Role resolution for the interpretation (SPEC-001 §3).\n *\n * `dom-accessibility-api` computes the *name*, not the role. `aria-query` gives role *definitions*\n * (used here for the name-from-content, children-presentational, abstract and widget\n * determinations), but the implicit role of an HTML element is **conditional** — so the tag→role\n * mapping below applies those conditions (e.g. `<a>` is a link only with `href`, `<li>` is a\n * `listitem` only inside a list, `<section>` is a `region` only when named, `<header>` is a\n * `banner` only when scoped to the body) rather than a naive lookup. This is a **curated** resolver\n * covering the elements the engine exercises today; broadening it to the full HTML-AAM mapping\n * (and using `Element.getComputedRole()` as a host oracle) is a tracked follow-up.\n */\n\ntype RoleDef = {\n  abstract?: boolean;\n  childrenPresentational?: boolean;\n  nameFrom?: readonly string[];\n  superClass?: ReadonlyArray<readonly string[]>;\n};\nconst roleMap = roles as unknown as { get(key: string): RoleDef | undefined };\n\n/**\n * Where `aria-query` (5.x) still carries ARIA 1.1 data, ARIA 1.2 wins. `rowgroup` is\n * \"Name From: author\" in ARIA 1.2; with the 1.1 value, bare text directly inside a\n * `role=\"rowgroup\"` container would be wrongly suppressed as \"already in the name\".\n */\nconst NAME_FROM_CONTENT_OVERRIDES: Readonly<Record<string, boolean>> = { rowgroup: false };\n\nconst PRESENTATIONAL = new Set([\"presentation\", \"none\"]);\n\n/**\n * Resolve an element's role: explicit `role` wins; else the conditional implicit role; else null\n * (generic / no role).\n *\n * WAI-ARIA 1.2 role-attribute processing: the value is a space-separated list of fallback tokens\n * and the user agent uses the **first token that names a non-abstract role** — so `role=\"foo\n * button\"` is a button, and an abstract role like `role=\"widget\"` is ignored.\n */\nexport function resolveRole(el: Element): string | null {\n  const explicit = el.getAttribute(\"role\");\n  if (explicit) {\n    for (const token of explicit.trim().toLowerCase().split(/\\s+/)) {\n      const def = roleMap.get(token);\n      if (!def || def.abstract) continue;\n      // ARIA 1.2 presentation-role conflict resolution: a focusable element, or one carrying a\n      // global ARIA attribute, ignores `presentation`/`none` and keeps its implicit role.\n      if (PRESENTATIONAL.has(token) && presentationIsOverridden(el)) return implicitRole(el);\n      return token;\n    }\n  }\n  return implicitRole(el);\n}\n\nfunction implicitRole(el: Element): string | null {\n  const tag = el.tagName.toLowerCase();\n  switch (tag) {\n    case \"a\":\n    case \"area\":\n      return el.hasAttribute(\"href\") ? \"link\" : null; // generic without href\n    case \"button\":\n      return \"button\";\n    case \"h1\":\n    case \"h2\":\n    case \"h3\":\n    case \"h4\":\n    case \"h5\":\n    case \"h6\":\n      return \"heading\";\n    case \"nav\":\n      return \"navigation\";\n    case \"main\":\n      return \"main\";\n    case \"header\":\n      // ARIA in HTML: banner only when scoped to the body — not inside main, sectioning content\n      // (article/aside/nav/section or those roles) or a sectioning root (dialog, figure, td, …).\n      return scopeOf(el) === \"body\" ? \"banner\" : null;\n    case \"footer\":\n      return scopeOf(el) === \"body\" ? \"contentinfo\" : null;\n    case \"aside\":\n      // ARIA in HTML: complementary when scoped to body or main; inside sectioning content or a\n      // sectioning root only when it has an accessible name, else generic.\n      return scopeOf(el) !== \"sectioning\" || hasAccessibleName(el) ? \"complementary\" : null;\n    case \"ul\":\n    case \"ol\":\n    case \"menu\":\n      return \"list\";\n    case \"li\":\n      // HTML-AAM / ARIA in HTML: `listitem` only as the child of an element exposed as a list\n      // (`<ul>`/`<ol>`/`<menu>` or `role=\"list\"`); an orphan `<li>` is generic. Going through\n      // `resolveRole` on the parent also honours `<ul role=\"presentation\">` (ARIA presentation\n      // inheritance for required owned elements).\n      return el.parentElement && resolveRole(el.parentElement) === \"list\" ? \"listitem\" : null;\n    case \"p\":\n      return \"paragraph\";\n    case \"img\":\n      // alt=\"\" = decorative (presentation) — unless focusable / global ARIA re-exposes it.\n      return el.getAttribute(\"alt\") === \"\" && !presentationIsOverridden(el) ? \"presentation\" : \"img\";\n    case \"svg\":\n      // SVG-AAM: the root is an image-like object named by its <title> / aria-label. Without a\n      // name it is treated as decorative here (its <title>/<desc> are never read as text).\n      return hasAccessibleName(el) ? \"img\" : null;\n    case \"input\":\n      return inputRole(el);\n    case \"textarea\":\n      return \"textbox\";\n    case \"select\":\n      return el.hasAttribute(\"multiple\") || numericSize(el) > 1 ? \"listbox\" : \"combobox\";\n    case \"table\":\n      return \"table\";\n    case \"thead\":\n    case \"tbody\":\n    case \"tfoot\":\n      return tableIsPresentational(el) ? null : \"rowgroup\";\n    case \"tr\":\n      return tableIsPresentational(el) ? null : \"row\";\n    case \"td\": {\n      const table = ancestorTableRole(el);\n      if (table && PRESENTATIONAL.has(table)) return null;\n      return table === \"grid\" || table === \"treegrid\" ? \"gridcell\" : \"cell\"; // HTML-AAM\n    }\n    case \"th\": {\n      if (tableIsPresentational(el)) return null;\n      // HTML-AAM: scope=\"row\"/\"rowgroup\" → rowheader; otherwise columnheader (the HTML-AAM\n      // \"in a thead / first cell\" heuristics for scope-less <th> are a simplification here).\n      const scope = el.getAttribute(\"scope\")?.toLowerCase();\n      return scope === \"row\" || scope === \"rowgroup\" ? \"rowheader\" : \"columnheader\";\n    }\n    case \"article\":\n      return \"article\";\n    case \"section\":\n      // ARIA in HTML: `region` only with an accessible name, otherwise generic.\n      return hasAccessibleName(el) ? \"region\" : null;\n    case \"form\":\n      // HTML-AAM: an unnamed `<form>` is not exposed as a landmark.\n      return hasAccessibleName(el) ? \"form\" : null;\n    case \"fieldset\":\n      return \"group\";\n    case \"figure\":\n      return \"figure\";\n    case \"dialog\":\n      return \"dialog\";\n    case \"hr\":\n      return \"separator\";\n    default:\n      return null; // generic / no implicit role\n  }\n}\n\nfunction inputRole(el: Element): string | null {\n  const type = (el.getAttribute(\"type\") ?? \"text\").toLowerCase();\n  switch (type) {\n    case \"button\":\n    case \"submit\":\n    case \"reset\":\n    case \"image\":\n    case \"file\": // HTML-AAM: no ARIA role; browsers expose the upload control as a button\n      return \"button\";\n    case \"checkbox\":\n      return \"checkbox\";\n    case \"radio\":\n      return \"radio\";\n    case \"range\":\n      return \"slider\";\n    case \"number\":\n      return \"spinbutton\";\n    case \"search\":\n      return el.hasAttribute(\"list\") ? \"combobox\" : \"searchbox\"; // HTML-AAM: datalist → combobox\n    case \"email\":\n    case \"tel\":\n    case \"url\":\n    case \"text\":\n      return el.hasAttribute(\"list\") ? \"combobox\" : \"textbox\";\n    case \"password\": // no ARIA role *name*, but every platform exposes it as a (protected) textbox\n      return \"textbox\";\n    case \"hidden\":\n      return null; // not in the accessibility tree at all\n    default:\n      return \"textbox\"; // date/time/color/month/week: HTML-AAM \"no corresponding role\" — approximation\n  }\n}\n\n/** Global ARIA states/properties (ARIA 1.2 §6.5) — any of these re-exposes a presentational element. */\nconst GLOBAL_ARIA_ATTRIBUTES = [\n  \"aria-atomic\",\n  \"aria-busy\",\n  \"aria-controls\",\n  \"aria-current\",\n  \"aria-describedby\",\n  \"aria-details\",\n  \"aria-disabled\",\n  \"aria-dropeffect\",\n  \"aria-errormessage\",\n  \"aria-flowto\",\n  \"aria-grabbed\",\n  \"aria-haspopup\",\n  \"aria-hidden\",\n  \"aria-invalid\",\n  \"aria-keyshortcuts\",\n  \"aria-label\",\n  \"aria-labelledby\",\n  \"aria-live\",\n  \"aria-owns\",\n  \"aria-relevant\",\n  \"aria-roledescription\",\n];\n\nfunction presentationIsOverridden(el: Element): boolean {\n  return isFocusable(el) || GLOBAL_ARIA_ATTRIBUTES.some((a) => el.hasAttribute(a));\n}\n\n/** Host-language focusability (the cases that matter for conflict resolution, not a full tabbing model). */\nfunction isFocusable(el: Element): boolean {\n  if (el.hasAttribute(\"tabindex\") || el.hasAttribute(\"contenteditable\")) return true;\n  const tag = el.tagName.toLowerCase();\n  if ((tag === \"a\" || tag === \"area\") && el.hasAttribute(\"href\")) return true;\n  if (tag === \"button\" || tag === \"select\" || tag === \"textarea\") return !el.hasAttribute(\"disabled\");\n  if (tag === \"input\") {\n    return !el.hasAttribute(\"disabled\") && (el.getAttribute(\"type\") ?? \"\").toLowerCase() !== \"hidden\";\n  }\n  return tag === \"summary\" || tag === \"iframe\";\n}\n\n/** Resolved role of the closest ancestor `<table>`, or null when there is none. */\nfunction ancestorTableRole(el: Element): string | null {\n  const table = el.parentElement?.closest(\"table\");\n  return table ? resolveRole(table) : null;\n}\n\n/**\n * ARIA 1.2 presentation inheritance: when a `table` is presentational, its required owned\n * structure (`thead`/`tbody`/`tfoot`/`tr`/`td`/`th`) without an explicit role is presentational\n * too — the classic layout table. (`<li>` under a presentational list is handled by the `li` case.)\n */\nfunction tableIsPresentational(el: Element): boolean {\n  const role = ancestorTableRole(el);\n  return role !== null && PRESENTATIONAL.has(role);\n}\n\n// HTML sectioning content, the landmark roles ARIA in HTML scopes the same way, and the sectioning\n// roots other than body (HTML §4.3.11).\nconst SECTIONING_CONTENT_TAGS = new Set([\"article\", \"aside\", \"nav\", \"section\"]);\nconst SECTIONING_CONTENT_ROLES = new Set([\"article\", \"complementary\", \"navigation\", \"region\"]);\nconst SECTIONING_ROOT_TAGS = new Set([\"blockquote\", \"details\", \"dialog\", \"fieldset\", \"figure\", \"td\"]);\n\n/**\n * ARIA in HTML scoping for `<header>`/`<footer>`/`<aside>`: the nearest scoping ancestor is the\n * body, `<main>` (or `role=\"main\"`), or sectioning content / a sectioning root.\n */\nfunction scopeOf(el: Element): \"body\" | \"main\" | \"sectioning\" {\n  for (let p = el.parentElement; p; p = p.parentElement) {\n    const tag = p.tagName.toLowerCase();\n    if (tag === \"body\") return \"body\";\n    if (SECTIONING_CONTENT_TAGS.has(tag) || SECTIONING_ROOT_TAGS.has(tag)) return \"sectioning\";\n    if (tag === \"main\") return \"main\";\n    if (p.hasAttribute(\"role\")) {\n      const role = resolveRole(p);\n      if (role === \"main\") return \"main\";\n      if (role && SECTIONING_CONTENT_ROLES.has(role)) return \"sectioning\";\n    }\n  }\n  return \"body\";\n}\n\nfunction numericSize(el: Element): number {\n  const n = Number(el.getAttribute(\"size\"));\n  return Number.isFinite(n) ? n : 0;\n}\n\n/**\n * Accessible name per AccName 1.2 via `dom-accessibility-api` (never hand-rolled),\n * whitespace-collapsed. Read defensively: a name-computation hiccup must never drop a node or\n * promote/demote a role by accident, so it yields \"\" instead of throwing.\n */\nexport function accessibleName(el: Element): string {\n  try {\n    return computeAccessibleName(el).replace(/\\s+/g, \" \").trim();\n  } catch {\n    return \"\";\n  }\n}\n\nfunction hasAccessibleName(el: Element): boolean {\n  return accessibleName(el) !== \"\";\n}\n\n/** True if the role takes its accessible name from its descendant content (AccName step 2F). */\nexport function takesNameFromContent(role: string | null): boolean {\n  if (!role) return false;\n  const override = NAME_FROM_CONTENT_OVERRIDES[role];\n  if (override !== undefined) return override;\n  return roleMap.get(role)?.nameFrom?.includes(\"contents\") ?? false;\n}\n\n/**\n * True if the role's DOM descendants are presentational (WAI-ARIA \"Children Presentational: True\"\n * — button, img, checkbox, tab, slider, …): user agents are not expected to expose them.\n */\nexport function isChildrenPresentational(role: string | null): boolean {\n  if (!role) return false;\n  return roleMap.get(role)?.childrenPresentational ?? false;\n}\n\n/**\n * Dual-inheritance roles (structure *and* widget in ARIA's superclass graph) that are genuinely\n * operable controls and so count as widgets for the \"unnamed control\" flag. The other\n * dual-inheritance roles — `row`, `gridcell`, `columnheader`, `rowheader`, `grid`, `progressbar`,\n * `scrollbar` — are table/structure roles a screen reader does not present as controls, and an\n * empty `<th>` corner cell or spacer `<tr>` must not be reported as an unnamed control.\n */\nconst DUAL_INHERITANCE_WIDGETS = new Set([\"slider\", \"spinbutton\", \"tab\", \"treeitem\", \"listbox\", \"tree\"]);\n\n/**\n * True if the role is an interactive widget — used for the \"unnamed control\" flag (AC-5). Pure\n * widget roles (every superclass chain goes through `widget`) count, except composite containers\n * such as `tablist` whose name is optional; the operable dual-inheritance roles above are added.\n */\nexport function isWidget(role: string | null): boolean {\n  if (!role) return false;\n  if (DUAL_INHERITANCE_WIDGETS.has(role)) return true;\n  const chains = roleMap.get(role)?.superClass;\n  return (\n    !!chains &&\n    chains.length > 0 &&\n    chains.every((chain) => chain.includes(\"widget\") && !chain.includes(\"composite\"))\n  );\n}\n","import type { InterpretationNode, NodeFlags } from \"./types\";\nimport { isHiddenFromAT, type VisibilityOptions } from \"./visibility\";\nimport {\n  resolveRole,\n  accessibleName,\n  takesNameFromContent,\n  isChildrenPresentational,\n  isWidget,\n} from \"./roles\";\n\nexport type LinearizeOptions = VisibilityOptions;\n\nconst ELEMENT_NODE = 1;\nconst TEXT_NODE = 3;\n\n// Host-language leaves: form controls and images have no exposed DOM children (an <input> has none;\n// a <select>'s options and a <textarea>'s text are its *value*), so they emit one node.\nconst LEAF_TAGS = new Set([\"img\", \"input\", \"textarea\", \"select\", \"hr\"]);\n\n// Roles with no announcement value of their own — emit nothing, just surface their content. (A\n// `<p>` and a generic `<div>` both read as their text; the screen reader doesn't announce them.)\nconst TRANSPARENT_ROLES = new Set([\"paragraph\", \"presentation\", \"none\", \"generic\"]);\n\n// SVG <title>/<desc>/<metadata> are name/description metadata (SVG-AAM), never rendered text.\nconst SVG_NS = \"http://www.w3.org/2000/svg\";\nconst SVG_METADATA_TAGS = new Set([\"title\", \"desc\", \"metadata\"]);\n\n/**\n * Linearize a DOM subtree into the ordered sequence a screen reader would traverse (SPEC-001).\n *\n * Each element is one of three kinds:\n *  - **transparent** (no role, or a silent structural role) — emits nothing, recurses so its text\n *    and descendants surface.\n *  - **leaf** — a form control / image, or a role whose children are presentational *and* whose\n *    name cannot come from content (img, slider, separator, progressbar, …): emits one node and\n *    does **not** recurse, because nothing below it is exposed.\n *  - **container** — everything else (landmark, list, table, row, cell, link, heading, and also\n *    the content widgets button/tab/option/switch whose descendants browsers do keep in the tree):\n *    emits a node *and* recurses, so nested elements — the link inside a heading, the missing-alt\n *    image inside a button, the button inside a table cell — stay in the reading order.\n *\n * The **no-double-read rule** (SPEC-001 §3): a role that takes its name from content (heading,\n * link, cell, row, button, …) has already consumed its descendant *text* into `name`, so bare\n * text runs inside it are not emitted again — but descendant *elements* with roles of their own\n * still are, and each emitted container starts a fresh text context: an author-named container\n * (list, listitem, group, landmark) nested in a consumed subtree surfaces its own text.\n * Elements hidden from assistive tech are skipped along with their subtree.\n */\nexport function linearize(root: Element, options: LinearizeOptions = {}): InterpretationNode[] {\n  const out: InterpretationNode[] = [];\n  emitElement(root, out, options, false);\n  return out;\n}\n\nfunction emitElement(\n  el: Element,\n  out: InterpretationNode[],\n  options: LinearizeOptions,\n  textConsumed: boolean,\n): void {\n  if (isHiddenFromAT(el, options)) return; // skip element AND its subtree\n\n  const tag = el.tagName.toLowerCase();\n  if (el.namespaceURI === SVG_NS && SVG_METADATA_TAGS.has(tag)) return;\n\n  const role = resolveRole(el);\n\n  // Decorative image (alt=\"\") — excluded from the reading order entirely.\n  if (role === \"presentation\" && tag === \"img\") return;\n\n  // Transparent: surface descendant content, no node of our own.\n  if (role === null || TRANSPARENT_ROLES.has(role)) {\n    walkChildren(el, out, options, textConsumed);\n    return;\n  }\n\n  out.push(buildNode(el, role, tag));\n\n  const consumesText = takesNameFromContent(role);\n\n  // Leaf: nothing below is exposed.\n  if (LEAF_TAGS.has(tag) || (isChildrenPresentational(role) && !consumesText)) return;\n\n  // Container: fresh text context — suppressed only if this node's own name came from content.\n  walkChildren(el, out, options, consumesText);\n}\n\nfunction walkChildren(\n  node: Node,\n  out: InterpretationNode[],\n  options: LinearizeOptions,\n  textConsumed: boolean,\n): void {\n  node.childNodes.forEach((child) => {\n    if (child.nodeType === TEXT_NODE) {\n      if (textConsumed) return;\n      const text = collapseWhitespace(child.textContent ?? \"\");\n      if (text) out.push({ role: \"text\", name: text });\n      return;\n    }\n    if (child.nodeType === ELEMENT_NODE) emitElement(child as Element, out, options, textConsumed);\n  });\n}\n\nfunction buildNode(el: Element, role: string, tag: string): InterpretationNode {\n  const name = accessibleName(el);\n  const node: InterpretationNode = { role, name, ref: { tag } };\n  const level = headingLevel(el, role);\n  if (level !== undefined) node.level = level;\n  const flags = computeFlags(el, role, tag, name);\n  if (flags) node.flags = flags;\n  return node;\n}\n\nfunction headingLevel(el: Element, role: string): number | undefined {\n  if (role !== \"heading\") return undefined;\n  // An author `aria-level` wins, on <h1>–<h6> too (browsers honour it over the tag).\n  const ariaLevel = Number(el.getAttribute(\"aria-level\"));\n  if (Number.isInteger(ariaLevel) && ariaLevel >= 1) return ariaLevel;\n  const tagMatch = /^h([1-6])$/.exec(el.tagName.toLowerCase());\n  return tagMatch ? Number(tagMatch[1]) : 2; // WAI-ARIA 1.2: implicit aria-level of a heading is 2\n}\n\nfunction computeFlags(el: Element, role: string, tag: string, name: string): NodeFlags | undefined {\n  const flags: NodeFlags = {};\n  if (isWidget(role) && name === \"\") flags.unnamed = true; // interactive control, no name (AC-5)\n  if (tag === \"img\" && !el.hasAttribute(\"alt\")) flags.missingAlt = true; // missing alt (AC-6)\n  return Object.keys(flags).length > 0 ? flags : undefined;\n}\n\nfunction collapseWhitespace(s: string): string {\n  return s.replace(/\\s+/g, \" \").trim();\n}\n"]}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "screen-reader-mirror",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "See what a screen reader interprets from your UI — a zero-install, client-side accessibility-tree linearization engine. No data leaves the machine.",
+  "license": "MIT",
+  "author": "James Lanzon",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "accessibility",
+    "a11y",
+    "screen-reader",
+    "aria",
+    "wcag",
+    "accessibility-tree",
+    "ax-tree",
+    "accname",
+    "testing",
+    "semantics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Koshux/screen-reader-mirror.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://github.com/Koshux/screen-reader-mirror#readme",
+  "bugs": {
+    "url": "https://github.com/Koshux/screen-reader-mirror/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@types/aria-query": "^5.0.4",
+    "tsup": "^9.0.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "aria-query": "^5.3.2",
+    "dom-accessibility-api": "^0.7.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }