@reticular/speakable 1.1.0 → 1.2.0

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

@@ -240,8 +240,15 @@ var ParsingError = class extends Error {
     this.name = "ParsingError";
   }
 };
+var MAX_INPUT_SIZE = 10 * 1024 * 1024;
 function parseHTML(html) {
   const warnings = [];
+  const inputSize = Buffer.byteLength(html, "utf-8");
+  if (inputSize > MAX_INPUT_SIZE) {
+    throw new ParsingError(
+      `Input exceeds maximum size of ${MAX_INPUT_SIZE / (1024 * 1024)} MB (received ${(inputSize / (1024 * 1024)).toFixed(1)} MB). Use CSS selectors to analyze specific sections of large documents.`
+    );
+  }
   try {
     const dom = new JSDOM(html, {
       contentType: "text/html",
@@ -2554,14 +2561,22 @@ function processHTML(html, options, diffHTML) {
     }
     return processNormal(html, options, warnings, colorize);
   } catch (error) {
-    if (error instanceof Error) {
+    if (error instanceof ParsingError) {
       return {
-        output: `Error: ${error.message}`,
+        output: `Parse error: ${error.message}`,
         exitCode: 2,
         // Content error
         warnings
       };
     }
+    if (error instanceof Error) {
+      return {
+        output: `Error: ${error.message}`,
+        exitCode: 3,
+        // System error
+        warnings
+      };
+    }
     throw error;
   }
 }