fix(a11y): update default configuration and remove live monitoring options

Author: LadyBluenotes

docs/plugins/a11y.md

@@ -9,7 +9,6 @@ The TanStack Devtools Accessibility (A11y) Plugin provides real-time accessibili
 
 - **Full Page Scanning** - Audit your entire page for accessibility violations
 - **Component-Level Scanning** - Scope audits to specific components using React hooks
-- **Live Monitoring** - Automatically re-scan when the DOM changes
 - **Visual Overlays** - Highlight problematic elements with severity-based colors
 - **Click-to-Navigate** - Click on an issue to automatically scroll to and highlight the element
 - **Dark Mode Support** - Automatically adapts to the devtools theme
@@ -87,25 +86,21 @@ Initial configuration can be provided via the vanilla plugin API:
 import { createA11yPlugin } from '@tanstack/devtools-a11y'
 
 const plugin = createA11yPlugin({
+  threshold: 'serious',
   ruleSet: 'wcag21aa',
-  threshold: 'moderate',
-  runOnMount: true,
-  liveMonitoring: true,
-  liveMonitoringDelay: 1000,
   showOverlays: true,
+  persistSettings: true,
+  disabledRules: [],
 })
 ```
 
 Common `options` fields:
 
 - `threshold`: minimum impact level to show
 - `ruleSet`: rule preset (`'wcag2a' | 'wcag2aa' | 'wcag21aa' | 'wcag22aa' | 'section508' | 'best-practice' | 'all'`)
-- `disabledRules`: rule IDs to ignore
 - `showOverlays`: highlight issues in the page
-- `runOnMount`: auto-scan when panel mounts
 - `persistSettings`: store config in localStorage
-- `liveMonitoring`: watch DOM mutations and re-scan automatically
-- `liveMonitoringDelay`: debounce delay (ms)
+- `disabledRules`: rule IDs to ignore
 
 If you don't need to provide initial configuration, you can use the framework plugin helpers
 directly (the settings UI persists changes to localStorage by default).
@@ -126,36 +121,6 @@ Issues are categorized by impact level with corresponding overlay colors:
 The panel UI is implemented in Solid and wrapped for React, Solid, Preact, and Vue
 using `@tanstack/devtools-utils`.
 
-## Vanilla JavaScript API
-
-For non-React applications, `createA11yPlugin()` exposes a small programmatic API in addition to the TanStack Devtools `render()` integration:
-
-```ts
-import { createA11yPlugin } from '@tanstack/devtools-a11y'
-
-const plugin = createA11yPlugin({
-  ruleSet: 'wcag21aa',
-  liveMonitoring: true,
-  showOverlays: true,
-})
-
-// Run a scan
-const result = await plugin.scan?.()
-
-// Subscribe to scan results (manual or live)
-const unsubscribe = plugin.onScan?.((next) => {
-  console.log('Issues found:', next.issues.length)
-})
-
-// Control live monitoring
-plugin.startLiveMonitoring?.()
-plugin.stopLiveMonitoring?.()
-
-// Clean up
-unsubscribe?.()
-plugin.destroy?.()
-```
-
 ## Export Formats
 
 ### JSON Export
@@ -184,52 +149,6 @@ The plugin supports the following accessibility standards:
 - **Section 508**
 - **Best Practices** (non-standard recommendations)
 
-## Types
-
-```ts
-interface A11yIssue {
-  id: string
-  ruleId: string
-  impact: 'critical' | 'serious' | 'moderate' | 'minor'
-  description: string
-  help: string
-  helpUrl: string
-  selector: string
-  html: string
-  failureSummary: string
-  tags: string[]
-}
-
-interface A11yAuditResult {
-  timestamp: number
-  url: string
-  standard: string
-  issues: A11yIssue[]
-  passes: number
-  violations: number
-  incomplete: number
-  scanDuration: number
-}
-
-interface A11yConfig {
-  standard: string
-  liveMonitoring: boolean
-  showOverlays: boolean
-  scopedMode: boolean
-  scopeSelector?: string
-  excludeSelectors: string[]
-  includeRules: string[]
-  excludeRules: string[]
-}
-```
-
-## Performance Considerations
-
-- **Live monitoring** uses a debounced MutationObserver to avoid excessive re-scanning
-- **Scoped scanning** is recommended for large pages to reduce scan time
-- **Exclude selectors** can skip third-party widgets or known-good sections
-- The first scan may be slower as axe-core initializes
-
 ## Troubleshooting
 
 ### Issues not appearing
@@ -244,12 +163,6 @@ interface A11yConfig {
 2. Check for CSS conflicts with `z-index` or `pointer-events`
 3. Ensure the container element exists in the DOM
 
-### Performance issues
-
-1. Disable live monitoring for large/complex pages
-2. Use scoped scanning to limit the audit area
-3. Increase the debounce delay for live monitoring
-
 ## Example
 
 See the full working example at:

packages/devtools-a11y/src/core/types/types.ts

@@ -144,9 +144,6 @@ export interface A11yPluginOptions {
   /** Minimum severity threshold (default: 'serious') */
   threshold?: SeverityThreshold
 
-  /** Run audit automatically on mount (default: false) */
-  runOnMount?: boolean
-
   /** Rule set preset (default: 'wcag21aa') */
   ruleSet?: RuleSetPreset
 

packages/devtools-a11y/src/core/utils/config.utils.ts

@@ -7,7 +7,6 @@ const STORAGE_KEY = 'tanstack-devtools-a11y-config'
  */
 export const DEFAULT_CONFIG: Required<A11yPluginOptions> = {
   threshold: 'serious',
-  runOnMount: false,
   ruleSet: 'wcag21aa',
   showOverlays: true,
   persistSettings: true,

packages/devtools-a11y/tests/config.test.ts

@@ -36,7 +36,6 @@ describe('config', () => {
   describe('DEFAULT_CONFIG', () => {
     it('should have expected default values', () => {
       expect(DEFAULT_CONFIG.threshold).toBe('serious')
-      expect(DEFAULT_CONFIG.runOnMount).toBe(false)
       expect(DEFAULT_CONFIG.ruleSet).toBe('wcag21aa')
       expect(DEFAULT_CONFIG.showOverlays).toBe(true)
       expect(DEFAULT_CONFIG.persistSettings).toBe(true)