@tanstack/devtools-a11y 0.0.1 → 0.1.1

package/dist/esm/core/types/types.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Severity threshold for filtering issues
+ */
+export type SeverityThreshold = 'critical' | 'serious' | 'moderate' | 'minor';
+/**
+ * Rule set presets
+ */
+export type RuleSetPreset = 'wcag2a' | 'wcag2aa' | 'wcag21aa' | 'wcag22aa' | 'section508' | 'best-practice' | 'all';
+/**
+ * Rule categories (axe-core tags)
+ */
+export type RuleCategory = 'all' | 'cat.aria' | 'cat.color' | 'cat.forms' | 'cat.keyboard' | 'cat.language' | 'cat.name-role-value' | 'cat.parsing' | 'cat.semantics' | 'cat.sensory-and-visual-cues' | 'cat.structure' | 'cat.tables' | 'cat.text-alternatives' | 'cat.time-and-media';
+/**
+ * Represents a single node affected by an accessibility issue
+ */
+export interface A11yNode {
+    /** CSS selector for the element */
+    selector: string;
+    /** HTML snippet of the element */
+    html: string;
+    /** XPath to the element (optional) */
+    xpath?: string;
+    /** Failure summary for this specific node */
+    failureSummary?: string;
+}
+/**
+ * Represents a single accessibility issue
+ */
+export interface A11yIssue {
+    /** Unique identifier for this issue instance */
+    id: string;
+    /** The axe-core rule ID */
+    ruleId: string;
+    /** Impact severity level */
+    impact: SeverityThreshold;
+    /** Human-readable description of the issue */
+    message: string;
+    /** Detailed help text */
+    help: string;
+    /** URL to learn more about this issue */
+    helpUrl: string;
+    /** WCAG tags associated with this rule */
+    wcagTags: Array<string>;
+    /** DOM nodes affected by this issue */
+    nodes: Array<A11yNode>;
+    /** Whether this issue meets the current severity threshold */
+    meetsThreshold: boolean;
+    /** Timestamp when this issue was detected */
+    timestamp: number;
+}
+/**
+ * Summary statistics for an audit
+ */
+export interface A11ySummary {
+    total: number;
+    critical: number;
+    serious: number;
+    moderate: number;
+    minor: number;
+    passes: number;
+    incomplete: number;
+}
+/**
+ * Result of an accessibility audit
+ */
+export interface A11yAuditResult {
+    /** All issues found */
+    issues: Array<A11yIssue>;
+    /** Summary statistics */
+    summary: A11ySummary;
+    /** Timestamp when the audit was run */
+    timestamp: number;
+    /** URL of the page audited */
+    url: string;
+    /** Description of the context (document, selector, or element) */
+    context: string;
+    /** Time taken to run the audit in ms */
+    duration: number;
+}
+/**
+ * Configuration for custom rules
+ */
+export interface CustomRulesConfig {
+    /** Enable click-handler-on-non-interactive rule (default: true) */
+    clickHandlerOnNonInteractive?: boolean;
+    /** Enable mouse-only-event-handlers rule (default: true) */
+    mouseOnlyEventHandlers?: boolean;
+    /** Enable static-element-interaction rule (default: true) */
+    staticElementInteraction?: boolean;
+}
+/**
+ * Options for running an audit
+ */
+export interface A11yAuditOptions {
+    /** Minimum severity to report (default: 'serious') */
+    threshold?: SeverityThreshold;
+    /** DOM context to audit (default: document) */
+    context?: Document | Element | string;
+    /** Rule set preset to use (default: 'wcag21aa') */
+    ruleSet?: RuleSetPreset;
+    /** Specific rules to enable (overrides ruleSet) */
+    enabledRules?: Array<string>;
+    /** Specific rules to disable */
+    disabledRules?: Array<string>;
+    /** Selectors to exclude from auditing */
+    exclude?: Array<string>;
+    /** Configuration for custom rules (default: all enabled) */
+    customRules?: CustomRulesConfig;
+}
+/**
+ * Options for the A11y plugin
+ */
+export interface A11yPluginOptions {
+    /** Minimum severity threshold (default: 'serious') */
+    threshold?: SeverityThreshold;
+    /** Rule set preset (default: 'wcag21aa') */
+    ruleSet?: RuleSetPreset;
+    /** Show visual overlays on page (default: true) */
+    showOverlays?: boolean;
+    /** Persist settings to localStorage (default: true) */
+    persistSettings?: boolean;
+    /** Rules to disable (by rule ID) */
+    disabledRules?: Array<string>;
+}
+/**
+ * Export format options
+ */
+export type ExportFormat = 'json' | 'csv';
+/**
+ * Export options
+ */
+export interface ExportOptions {
+    /** Export format */
+    format: ExportFormat;
+    /** Include passing rules in export */
+    includePasses?: boolean;
+    /** Include incomplete rules in export */
+    includeIncomplete?: boolean;
+    /** Custom filename (without extension) */
+    filename?: string;
+}

package/dist/esm/core/utils/ally-audit.utils.d.ts

@@ -0,0 +1,19 @@
+import { A11yAuditOptions, A11yAuditResult, A11yIssue, SeverityThreshold } from '../types/types.js';
+/**
+ * Check if an impact level meets or exceeds the threshold
+ */
+export declare function meetsThreshold(impact: SeverityThreshold | null | undefined, threshold: SeverityThreshold): boolean;
+/**
+ * Run an accessibility audit using axe-core
+ */
+export declare function runAudit(options?: A11yAuditOptions): Promise<A11yAuditResult>;
+/**
+ * Get a list of all available axe-core rules plus custom rules
+ */
+export declare function getAvailableRules(): Array<{
+    id: string;
+    description: string;
+    tags: Array<string>;
+}>;
+export declare const IMPACTS: readonly ["critical", "serious", "moderate", "minor"];
+export declare const filterIssuesAboveThreshold: (issues: A11yAuditResult["issues"], threshold: SeverityThreshold) => A11yIssue[];

package/dist/esm/core/utils/ally-audit.utils.js

@@ -0,0 +1,226 @@
+import { getCustomRules, runCustomRules } from "./custom-audit.utils.js";
+import { SEVERITY_ORDER } from "./ui.utils.js";
+import axe from "axe-core";
+//#region src/core/utils/ally-audit.utils.ts
+/**
+* Severity levels mapped to numeric values for comparison
+*/
+var IMPACT_SEVERITY = {
+	critical: 4,
+	serious: 3,
+	moderate: 2,
+	minor: 1
+};
+/**
+* Rule set configurations for different presets
+*/
+var RULE_SET_CONFIGS = {
+	wcag2a: { runOnly: {
+		type: "tag",
+		values: ["wcag2a"]
+	} },
+	wcag2aa: { runOnly: {
+		type: "tag",
+		values: ["wcag2a", "wcag2aa"]
+	} },
+	wcag21aa: { runOnly: {
+		type: "tag",
+		values: [
+			"wcag2a",
+			"wcag2aa",
+			"wcag21a",
+			"wcag21aa"
+		]
+	} },
+	wcag22aa: { runOnly: {
+		type: "tag",
+		values: [
+			"wcag2a",
+			"wcag2aa",
+			"wcag21a",
+			"wcag21aa",
+			"wcag22aa"
+		]
+	} },
+	section508: { runOnly: {
+		type: "tag",
+		values: ["section508"]
+	} },
+	"best-practice": { runOnly: {
+		type: "tag",
+		values: ["best-practice"]
+	} },
+	all: {}
+};
+/**
+* Check if an impact level meets or exceeds the threshold
+*/
+function meetsThreshold(impact, threshold) {
+	if (!impact) return false;
+	return IMPACT_SEVERITY[impact] >= IMPACT_SEVERITY[threshold];
+}
+/**
+* Convert axe-core results to our issue format
+*/
+function convertToIssues(results, threshold) {
+	const issues = [];
+	for (const violation of results.violations) {
+		const impact = violation.impact;
+		for (let i = 0; i < violation.nodes.length; i++) {
+			const node = violation.nodes[i];
+			const a11yNode = {
+				selector: node.target.join(", "),
+				html: node.html,
+				xpath: node.xpath?.join(" > "),
+				failureSummary: node.failureSummary
+			};
+			issues.push({
+				id: `${violation.id}-${i}-${Date.now()}`,
+				ruleId: violation.id,
+				impact: impact || "minor",
+				message: node.failureSummary || violation.description,
+				help: violation.help,
+				helpUrl: violation.helpUrl,
+				wcagTags: violation.tags.filter((tag) => tag.startsWith("wcag") || tag.startsWith("section508")),
+				nodes: [a11yNode],
+				meetsThreshold: meetsThreshold(impact, threshold),
+				timestamp: Date.now()
+			});
+		}
+	}
+	return issues;
+}
+/**
+* Create summary statistics from issues array
+* Used when combining axe-core results with custom rule results
+*/
+function createSummary(axeResults, issues) {
+	const summary = {
+		total: issues.length,
+		critical: 0,
+		serious: 0,
+		moderate: 0,
+		minor: 0,
+		passes: axeResults.passes.length,
+		incomplete: axeResults.incomplete.length
+	};
+	for (const issue of issues) {
+		const impact = issue.impact;
+		if (impact === "critical") summary.critical++;
+		else if (impact === "serious") summary.serious++;
+		else if (impact === "moderate") summary.moderate++;
+		else summary.minor++;
+	}
+	return summary;
+}
+/**
+* Get the context description for logging
+*/
+function getContextDescription(context) {
+	if (typeof context === "string") return context;
+	if (context instanceof Document) return "document";
+	if (context instanceof Element) return context.tagName.toLowerCase() + (context.id ? `#${context.id}` : "");
+	return "unknown";
+}
+/**
+* Default selectors to exclude from auditing (devtools panels, overlays, etc.)
+*/
+var DEFAULT_EXCLUDE_SELECTORS = [
+	"[data-testid=\"tanstack_devtools\"]",
+	"[data-a11y-overlay]",
+	"[data-devtools]",
+	"[data-devtools-panel]"
+];
+/**
+* Run an accessibility audit using axe-core
+*/
+async function runAudit(options = {}) {
+	const { threshold = "serious", context = document, ruleSet = "wcag21aa", enabledRules, disabledRules, exclude = [], customRules = {} } = options;
+	const allExclusions = [...DEFAULT_EXCLUDE_SELECTORS, ...exclude];
+	const startTime = performance.now();
+	const contextDescription = getContextDescription(context);
+	try {
+		const axeOptions = {
+			resultTypes: [
+				"violations",
+				"passes",
+				"incomplete"
+			],
+			...RULE_SET_CONFIGS[ruleSet]
+		};
+		if (enabledRules && enabledRules.length > 0) axeOptions.runOnly = {
+			type: "rule",
+			values: enabledRules
+		};
+		if (disabledRules && disabledRules.length > 0) {
+			const rules = {};
+			for (const ruleId of disabledRules) rules[ruleId] = { enabled: false };
+			axeOptions.rules = rules;
+		}
+		let auditContext = context;
+		if (allExclusions.length > 0) auditContext = {
+			include: [auditContext],
+			exclude: allExclusions.map((sel) => [sel])
+		};
+		const results = await axe.run(auditContext, axeOptions);
+		const axeIssues = convertToIssues(results, threshold);
+		const customRulesConfig = {
+			clickHandlerOnNonInteractive: customRules.clickHandlerOnNonInteractive !== false && !disabledRules?.includes("click-handler-on-non-interactive"),
+			mouseOnlyEventHandlers: customRules.mouseOnlyEventHandlers !== false && !disabledRules?.includes("mouse-only-event-handlers"),
+			staticElementInteraction: customRules.staticElementInteraction !== false && !disabledRules?.includes("static-element-interaction")
+		};
+		const customIssues = runCustomRules(typeof context === "string" ? document.querySelector(context) || document : context, customRulesConfig, threshold);
+		const allIssues = [...axeIssues, ...customIssues];
+		const duration = performance.now() - startTime;
+		return {
+			issues: allIssues,
+			summary: createSummary(results, allIssues),
+			timestamp: Date.now(),
+			url: typeof window !== "undefined" ? window.location.href : "",
+			context: contextDescription,
+			duration
+		};
+	} catch (error) {
+		const duration = performance.now() - startTime;
+		console.error("[A11y Audit] Error running axe-core:", error);
+		return {
+			issues: [],
+			summary: {
+				total: 0,
+				critical: 0,
+				serious: 0,
+				moderate: 0,
+				minor: 0,
+				passes: 0,
+				incomplete: 0
+			},
+			timestamp: Date.now(),
+			url: typeof window !== "undefined" ? window.location.href : "",
+			context: contextDescription,
+			duration
+		};
+	}
+}
+/**
+* Get a list of all available axe-core rules plus custom rules
+*/
+function getAvailableRules() {
+	const axeRules = axe.getRules().map((rule) => ({
+		id: rule.ruleId,
+		description: rule.description,
+		tags: rule.tags
+	}));
+	const customRules = getCustomRules();
+	return [...axeRules, ...customRules];
+}
+var IMPACTS = [
+	"critical",
+	"serious",
+	"moderate",
+	"minor"
+];
+var filterIssuesAboveThreshold = (issues, threshold) => issues.filter((issue) => SEVERITY_ORDER[issue.impact] >= SEVERITY_ORDER[threshold]);
+//#endregion
+export { IMPACTS, filterIssuesAboveThreshold, getAvailableRules, meetsThreshold, runAudit };
+
+//# sourceMappingURL=ally-audit.utils.js.map

package/dist/esm/core/utils/ally-audit.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ally-audit.utils.js","names":[],"sources":["../../../../src/core/utils/ally-audit.utils.ts"],"sourcesContent":["import axe from 'axe-core'\nimport {\n  getCustomRules as getCustomRulesInternal,\n  runCustomRules,\n} from './custom-audit.utils.js'\nimport { SEVERITY_ORDER } from './ui.utils.js'\n\n// types\nimport type { AxeResults, RuleObject, RunOptions } from 'axe-core'\nimport type {\n  A11yAuditOptions,\n  A11yAuditResult,\n  A11yIssue,\n  A11yNode,\n  A11ySummary,\n  CustomRulesConfig,\n  RuleSetPreset,\n  SeverityThreshold,\n} from '../types/types.js'\n\n/**\n * Severity levels mapped to numeric values for comparison\n */\nconst IMPACT_SEVERITY: Record<SeverityThreshold, number> = {\n  critical: 4,\n  serious: 3,\n  moderate: 2,\n  minor: 1,\n}\n\n/**\n * Rule set configurations for different presets\n */\nconst RULE_SET_CONFIGS: Record<RuleSetPreset, Partial<RunOptions>> = {\n  wcag2a: {\n    runOnly: {\n      type: 'tag',\n      values: ['wcag2a'],\n    },\n  },\n  wcag2aa: {\n    runOnly: {\n      type: 'tag',\n      values: ['wcag2a', 'wcag2aa'],\n    },\n  },\n  wcag21aa: {\n    runOnly: {\n      type: 'tag',\n      values: ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa'],\n    },\n  },\n  wcag22aa: {\n    runOnly: {\n      type: 'tag',\n      values: ['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa'],\n    },\n  },\n  section508: {\n    runOnly: {\n      type: 'tag',\n      values: ['section508'],\n    },\n  },\n  'best-practice': {\n    runOnly: {\n      type: 'tag',\n      values: ['best-practice'],\n    },\n  },\n  all: {\n    // Run all rules\n  },\n}\n\n/**\n * Check if an impact level meets or exceeds the threshold\n */\nexport function meetsThreshold(\n  impact: SeverityThreshold | null | undefined,\n  threshold: SeverityThreshold,\n): boolean {\n  if (!impact) return false\n  return IMPACT_SEVERITY[impact] >= IMPACT_SEVERITY[threshold]\n}\n\n/**\n * Convert axe-core results to our issue format\n */\nfunction convertToIssues(\n  results: AxeResults,\n  threshold: SeverityThreshold,\n): Array<A11yIssue> {\n  const issues: Array<A11yIssue> = []\n\n  for (const violation of results.violations) {\n    const impact = violation.impact as SeverityThreshold | undefined\n\n    for (let i = 0; i < violation.nodes.length; i++) {\n      const node = violation.nodes[i]!\n      const selector = node.target.join(', ')\n\n      const a11yNode: A11yNode = {\n        selector,\n        html: node.html,\n        xpath: node.xpath?.join(' > '),\n        failureSummary: node.failureSummary,\n      }\n\n      issues.push({\n        id: `${violation.id}-${i}-${Date.now()}`,\n        ruleId: violation.id,\n        impact: impact || 'minor',\n        message: node.failureSummary || violation.description,\n        help: violation.help,\n        helpUrl: violation.helpUrl,\n        wcagTags: violation.tags.filter(\n          (tag) => tag.startsWith('wcag') || tag.startsWith('section508'),\n        ),\n        nodes: [a11yNode],\n        meetsThreshold: meetsThreshold(impact, threshold),\n        timestamp: Date.now(),\n      })\n    }\n  }\n\n  return issues\n}\n\n/**\n * Create summary statistics from issues array\n * Used when combining axe-core results with custom rule results\n */\nfunction createSummary(\n  axeResults: AxeResults,\n  issues: Array<A11yIssue>,\n): A11ySummary {\n  const summary: A11ySummary = {\n    total: issues.length,\n    critical: 0,\n    serious: 0,\n    moderate: 0,\n    minor: 0,\n    passes: axeResults.passes.length,\n    incomplete: axeResults.incomplete.length,\n  }\n\n  for (const issue of issues) {\n    const impact = issue.impact\n    if (impact === 'critical') summary.critical++\n    else if (impact === 'serious') summary.serious++\n    else if (impact === 'moderate') summary.moderate++\n    else {\n      summary.minor++\n    }\n  }\n\n  return summary\n}\n\n/**\n * Get the context description for logging\n */\nfunction getContextDescription(context: Document | Element | string): string {\n  if (typeof context === 'string') {\n    return context\n  }\n  if (context instanceof Document) {\n    return 'document'\n  }\n  if (context instanceof Element) {\n    return context.tagName.toLowerCase() + (context.id ? `#${context.id}` : '')\n  }\n  return 'unknown'\n}\n\n/**\n * Default selectors to exclude from auditing (devtools panels, overlays, etc.)\n */\nconst DEFAULT_EXCLUDE_SELECTORS = [\n  // TanStack Devtools root container\n  '[data-testid=\"tanstack_devtools\"]',\n  // A11y overlay elements\n  '[data-a11y-overlay]',\n  // Common devtools patterns\n  '[data-devtools]',\n  '[data-devtools-panel]',\n]\n\n/**\n * Run an accessibility audit using axe-core\n */\nexport async function runAudit(\n  options: A11yAuditOptions = {},\n): Promise<A11yAuditResult> {\n  const {\n    threshold = 'serious',\n    context = document,\n    ruleSet = 'wcag21aa',\n    enabledRules,\n    disabledRules,\n    exclude = [],\n    customRules = {},\n  } = options\n\n  // Merge user exclusions with default devtools exclusions\n  const allExclusions = [...DEFAULT_EXCLUDE_SELECTORS, ...exclude]\n\n  const startTime = performance.now()\n  const contextDescription = getContextDescription(context)\n\n  try {\n    // Build axe-core options\n    const axeOptions: RunOptions = {\n      resultTypes: ['violations', 'passes', 'incomplete'],\n      ...RULE_SET_CONFIGS[ruleSet],\n    }\n\n    // Handle specific rule configurations\n    if (enabledRules && enabledRules.length > 0) {\n      axeOptions.runOnly = {\n        type: 'rule',\n        values: enabledRules,\n      }\n    }\n\n    // Build rules configuration for disabled rules\n    if (disabledRules && disabledRules.length > 0) {\n      const rules: RuleObject = {}\n      for (const ruleId of disabledRules) {\n        rules[ruleId] = { enabled: false }\n      }\n      axeOptions.rules = rules\n    }\n\n    // Determine the context to audit\n    let auditContext: axe.ElementContext = context as axe.ElementContext\n\n    // Add exclusions if specified (always include devtools exclusions)\n    if (allExclusions.length > 0) {\n      auditContext = {\n        include: [auditContext as Element],\n        exclude: allExclusions.map((sel) => [sel]),\n      } as axe.ElementContext\n    }\n\n    // Run the axe-core audit\n    const results = await axe.run(auditContext, axeOptions)\n\n    // Convert axe-core results to our format\n    const axeIssues = convertToIssues(results, threshold)\n\n    // Run custom rules (if not all disabled)\n    const customRulesConfig: CustomRulesConfig = {\n      clickHandlerOnNonInteractive:\n        customRules.clickHandlerOnNonInteractive !== false &&\n        !disabledRules?.includes('click-handler-on-non-interactive'),\n      mouseOnlyEventHandlers:\n        customRules.mouseOnlyEventHandlers !== false &&\n        !disabledRules?.includes('mouse-only-event-handlers'),\n      staticElementInteraction:\n        customRules.staticElementInteraction !== false &&\n        !disabledRules?.includes('static-element-interaction'),\n    }\n\n    const contextElement =\n      typeof context === 'string'\n        ? document.querySelector(context) || document\n        : context\n\n    const customIssues = runCustomRules(\n      contextElement,\n      customRulesConfig,\n      threshold,\n    )\n\n    // Merge all issues\n    const allIssues = [...axeIssues, ...customIssues]\n\n    const duration = performance.now() - startTime\n\n    // Create summary from combined issues\n    const summary = createSummary(results, allIssues)\n\n    return {\n      issues: allIssues,\n      summary,\n      timestamp: Date.now(),\n      url: typeof window !== 'undefined' ? window.location.href : '',\n      context: contextDescription,\n      duration,\n    }\n  } catch (error) {\n    const duration = performance.now() - startTime\n    console.error('[A11y Audit] Error running axe-core:', error)\n\n    return {\n      issues: [],\n      summary: {\n        total: 0,\n        critical: 0,\n        serious: 0,\n        moderate: 0,\n        minor: 0,\n        passes: 0,\n        incomplete: 0,\n      },\n      timestamp: Date.now(),\n      url: typeof window !== 'undefined' ? window.location.href : '',\n      context: contextDescription,\n      duration,\n    }\n  }\n}\n\n/**\n * Get a list of all available axe-core rules plus custom rules\n */\nexport function getAvailableRules(): Array<{\n  id: string\n  description: string\n  tags: Array<string>\n}> {\n  // Get axe-core rules\n  const axeRules = axe.getRules().map((rule) => ({\n    id: rule.ruleId,\n    description: rule.description,\n    tags: rule.tags,\n  }))\n\n  // Get custom rules\n  const customRules = getCustomRulesInternal()\n\n  return [...axeRules, ...customRules]\n}\n\nexport const IMPACTS = ['critical', 'serious', 'moderate', 'minor'] as const\n\nexport const filterIssuesAboveThreshold = (\n  issues: A11yAuditResult['issues'],\n  threshold: SeverityThreshold,\n) =>\n  issues.filter(\n    (issue) => SEVERITY_ORDER[issue.impact] >= SEVERITY_ORDER[threshold],\n  )\n"],"mappings":"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"}

package/dist/esm/core/utils/config.utils.d.ts

@@ -0,0 +1,17 @@
+import { A11yPluginOptions } from '../types/types.js';
+/**
+ * Default plugin configuration
+ */
+export declare const DEFAULT_CONFIG: Required<A11yPluginOptions>;
+/**
+ * Load configuration from localStorage
+ */
+export declare function loadConfig(): Required<A11yPluginOptions>;
+/**
+ * Save configuration to localStorage
+ */
+export declare function saveConfig(config: Partial<A11yPluginOptions>): void;
+/**
+ * Merge user options with defaults
+ */
+export declare function mergeConfig(options?: A11yPluginOptions): Required<A11yPluginOptions>;

package/dist/esm/core/utils/config.utils.js

@@ -0,0 +1,63 @@
+//#region src/core/utils/config.utils.ts
+var STORAGE_KEY = "tanstack-devtools-a11y-config";
+/**
+* Default plugin configuration
+*/
+var DEFAULT_CONFIG = {
+	threshold: "serious",
+	ruleSet: "wcag21aa",
+	showOverlays: true,
+	persistSettings: true,
+	disabledRules: []
+};
+/**
+* Load configuration from localStorage
+*/
+function loadConfig() {
+	if (typeof localStorage === "undefined") return DEFAULT_CONFIG;
+	try {
+		const stored = localStorage.getItem(STORAGE_KEY);
+		if (stored) {
+			const parsed = JSON.parse(stored);
+			return {
+				...DEFAULT_CONFIG,
+				...parsed
+			};
+		}
+	} catch (error) {
+		console.warn("[A11y Config] Failed to load config from localStorage:", error);
+	}
+	return DEFAULT_CONFIG;
+}
+/**
+* Save configuration to localStorage
+*/
+function saveConfig(config) {
+	if (typeof localStorage === "undefined") return;
+	try {
+		const updated = {
+			...loadConfig(),
+			...config
+		};
+		localStorage.setItem(STORAGE_KEY, JSON.stringify(updated));
+	} catch (error) {
+		console.warn("[A11y Config] Failed to save config to localStorage:", error);
+	}
+}
+/**
+* Merge user options with defaults
+*/
+function mergeConfig(options = {}) {
+	if (options.persistSettings !== false) return {
+		...loadConfig(),
+		...options
+	};
+	return {
+		...DEFAULT_CONFIG,
+		...options
+	};
+}
+//#endregion
+export { mergeConfig, saveConfig };
+
+//# sourceMappingURL=config.utils.js.map

package/dist/esm/core/utils/config.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.utils.js","names":[],"sources":["../../../../src/core/utils/config.utils.ts"],"sourcesContent":["import type { A11yPluginOptions } from '../types/types'\n\nconst STORAGE_KEY = 'tanstack-devtools-a11y-config'\n\n/**\n * Default plugin configuration\n */\nexport const DEFAULT_CONFIG: Required<A11yPluginOptions> = {\n  threshold: 'serious',\n  ruleSet: 'wcag21aa',\n  showOverlays: true,\n  persistSettings: true,\n  disabledRules: [],\n}\n\n/**\n * Load configuration from localStorage\n */\nexport function loadConfig(): Required<A11yPluginOptions> {\n  if (typeof localStorage === 'undefined') {\n    return DEFAULT_CONFIG\n  }\n\n  try {\n    const stored = localStorage.getItem(STORAGE_KEY)\n    if (stored) {\n      const parsed = JSON.parse(stored) as Partial<A11yPluginOptions>\n      return { ...DEFAULT_CONFIG, ...parsed }\n    }\n  } catch (error) {\n    console.warn(\n      '[A11y Config] Failed to load config from localStorage:',\n      error,\n    )\n  }\n\n  return DEFAULT_CONFIG\n}\n\n/**\n * Save configuration to localStorage\n */\nexport function saveConfig(config: Partial<A11yPluginOptions>): void {\n  if (typeof localStorage === 'undefined') {\n    return\n  }\n\n  try {\n    const current = loadConfig()\n    const updated = { ...current, ...config }\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(updated))\n  } catch (error) {\n    console.warn('[A11y Config] Failed to save config to localStorage:', error)\n  }\n}\n\n/**\n * Merge user options with defaults\n */\nexport function mergeConfig(\n  options: A11yPluginOptions = {},\n): Required<A11yPluginOptions> {\n  if (options.persistSettings !== false) {\n    const saved = loadConfig()\n    return { ...saved, ...options }\n  }\n  return { ...DEFAULT_CONFIG, ...options }\n}\n"],"mappings":";AAEA,IAAM,cAAc;;;;AAKpB,IAAa,iBAA8C;CACzD,WAAW;CACX,SAAS;CACT,cAAc;CACd,iBAAiB;CACjB,eAAe,EAAE;CAClB;;;;AAKD,SAAgB,aAA0C;AACxD,KAAI,OAAO,iBAAiB,YAC1B,QAAO;AAGT,KAAI;EACF,MAAM,SAAS,aAAa,QAAQ,YAAY;AAChD,MAAI,QAAQ;GACV,MAAM,SAAS,KAAK,MAAM,OAAO;AACjC,UAAO;IAAE,GAAG;IAAgB,GAAG;IAAQ;;UAElC,OAAO;AACd,UAAQ,KACN,0DACA,MACD;;AAGH,QAAO;;;;;AAMT,SAAgB,WAAW,QAA0C;AACnE,KAAI,OAAO,iBAAiB,YAC1B;AAGF,KAAI;EAEF,MAAM,UAAU;GAAE,GADF,YAAY;GACE,GAAG;GAAQ;AACzC,eAAa,QAAQ,aAAa,KAAK,UAAU,QAAQ,CAAC;UACnD,OAAO;AACd,UAAQ,KAAK,wDAAwD,MAAM;;;;;;AAO/E,SAAgB,YACd,UAA6B,EAAE,EACF;AAC7B,KAAI,QAAQ,oBAAoB,MAE9B,QAAO;EAAE,GADK,YAAY;EACP,GAAG;EAAS;AAEjC,QAAO;EAAE,GAAG;EAAgB,GAAG;EAAS"}

package/dist/esm/core/utils/custom-audit.utils.d.ts

@@ -0,0 +1,13 @@
+import { A11yIssue, CustomRulesConfig, SeverityThreshold } from '../types/types.js';
+/**
+ * Run all enabled custom rules
+ */
+export declare function runCustomRules(context?: Document | Element, config?: CustomRulesConfig, threshold?: SeverityThreshold): Array<A11yIssue>;
+/**
+ * Get list of custom rule metadata (for UI display)
+ */
+export declare function getCustomRules(): Array<{
+    id: string;
+    description: string;
+    tags: Array<string>;
+}>;