@reticular/speakable 1.0.3 → 1.1.1

package/README.md

@@ -159,6 +159,35 @@ Verify that the accessibility model serializes and deserializes consistently:
 speakable page.html --validate
 ```
 
+## MCP Integration (AI Assistants)
+
+Speakable includes a Model Context Protocol (MCP) server that lets AI coding assistants analyze accessibility in real-time. Ask your assistant "check if this component is accessible" and it calls Speakable automatically.
+
+### Setup
+
+Add to your MCP config (Kiro, VS Code, Cursor, Claude Desktop, Windsurf):
+
+```json
+{
+  "mcpServers": {
+    "speakable": {
+      "command": "npx",
+      "args": ["-y", "@reticular/speakable-mcp"]
+    }
+  }
+}
+```
+
+### Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `analyze_html` | Predict screen reader output for NVDA, JAWS, and VoiceOver |
+| `audit_html` | Generate accessibility audit report with issues and remediation |
+| `diff_html` | Compare two HTML versions for accessibility regressions |
+
+All tools run locally — no network requests, no data leaves your machine. See the [MCP Integration docs](https://getspeakable.dev/docs/mcp-integration) for full setup instructions.
+
 ## CI/CD Integration
 
 ### GitHub Actions

package/dist/cli.js

@@ -1402,6 +1402,12 @@ function renderNodeNVDA(node, announcements, c) {
     announcements.push(announcement);
   }
   for (const child of node.children) {
+    if (child.name && child.name === node.name && node.children.length === 1) {
+      for (const grandchild of child.children) {
+        renderNodeNVDA(grandchild, announcements, c);
+      }
+      continue;
+    }
     renderNodeNVDA(child, announcements, c);
   }
 }
@@ -1591,6 +1597,12 @@ function renderNodeJAWS(node, announcements, c) {
     announcements.push(announcement);
   }
   for (const child of node.children) {
+    if (child.name && child.name === node.name && node.children.length === 1) {
+      for (const grandchild of child.children) {
+        renderNodeJAWS(grandchild, announcements, c);
+      }
+      continue;
+    }
     renderNodeJAWS(child, announcements, c);
   }
 }
@@ -1800,6 +1812,12 @@ function renderNodeVoiceOver(node, announcements, c) {
     announcements.push(announcement);
   }
   for (const child of node.children) {
+    if (child.name && child.name === node.name && node.children.length === 1) {
+      for (const grandchild of child.children) {
+        renderNodeVoiceOver(grandchild, announcements, c);
+      }
+      continue;
+    }
     renderNodeVoiceOver(child, announcements, c);
   }
 }