docs(devtools-a11y): describe the plugin API that the package exports by AlemTuzlak · Pull Request #546 · TanStack/devtools · GitHub
Skip to content

docs(devtools-a11y): describe the plugin API that the package exports - #546

Open
AlemTuzlak wants to merge 1 commit into
mainfrom
docs/422-a11y-plugin-api
Open

AlemTuzlak wants to merge 1 commit into
mainfrom
docs/422-a11y-plugin-api

Conversation

@AlemTuzlak

Copy link
Copy Markdown
Collaborator

The accessibility plugin docs show createA11yPlugin, but @tanstack/devtools-a11y does not export it. This PR corrects the page so that every snippet uses an API that the package really exports.

🎯 Changes

  • Panel Configuration showed createA11yPlugin({ threshold, ruleSet, ... }). No helper takes options. The section now describes the panel's Settings view and the localStorage key.
  • Quick Start (Vue) used @tanstack/devtools-a11y/vue, which does not exist. It is now Quick Start (Angular), based on examples/angular/a11y-devtools.
  • Framework Support listed Preact and Vue. It now lists React, Solid, and Angular and their entry points.
  • Export Formats imported exportToJSON and exportToCSV from the package root. The root is not exported, and the helpers are internal. The section now points to the Export JSON and Export CSV buttons.
  • Troubleshooting mentioned an excludeSelectors option that does not exist.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested code changes locally with pnpm test:pr, or these tests do not apply to this pull request.
  • I fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Testing

Commands run

  • prettier --check docs/plugins/a11y.md: pass.
  • I compared each snippet with packages/devtools-a11y/package.json exports and the react, solid, and angular entry files.

Manual test

  1. Open docs/plugins/a11y.md.
  2. Make sure that each import path appears in the exports of packages/devtools-a11y/package.json.

How this PR makes testing easy

Docs only. The Angular snippet matches examples/angular/a11y-devtools/src/app/app.ts.

Linked issues

Fixes #422

Risk / rollback

None. Docs only. To undo, revert this PR.

🤖 Generated with Claude Code

The page showed createA11yPlugin with initial options, a Vue entry point,
and exportToJSON/exportToCSV from the package root. None of these exist:
the package exports only the react, solid, and angular entry points, the
plugin helpers take no options, and the export helpers are internal.

The page now shows an Angular quick start, describes the panel settings and
where they are saved, and points to the Export buttons.

Fixes #422
@coderabbitai

coderabbitai Bot commented Oct 2, 2026

Copy link
Copy Markdown

@nx-cloud

nx-cloud Bot commented Oct 2, 2026

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit eec8f8b

Command Status Duration Result
nx run-many --targets=build --exclude=examples/... ✅ Succeeded 2s View ↗

☁️ Nx Cloud last updated this comment at 2026-10-02 14:00:21 UTC

@nx-cloud

nx-cloud Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit eec8f8b

Command Status Duration Result
nx run-many --target=test:e2e --parallel=1 --pr... ✅ Succeeded 1m 16s View ↗
nx affected --targets=test:eslint,test:sherif,t... ✅ Succeeded 6s View ↗
nx run-many --targets=build --exclude=examples/... ✅ Succeeded 2s View ↗

☁️ Nx Cloud last updated this comment at 2026-10-02 14:02:07 UTC

@pkg-pr-new

pkg-pr-new Bot commented Oct 2, 2026

Copy link
Copy Markdown

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

createA11yPlugin Missing?

1 participant