@linktr.ee/arbor-mcp 0.9.0 → 0.10.0

package/dist/index.js

@@ -309,6 +309,60 @@ var require_rules = __commonJS({
             ]
           }
         },
+        "directional-language": {
+          id: "directional-language",
+          name: "Directional language",
+          description: "Copy shouldn't rely on spatial directions. Element position changes across screen sizes and surfaces, and directional words are meaningless to screen-reader users.",
+          severity: "info",
+          category: "accessibility",
+          check: {
+            type: "regex",
+            description: "Flags spatial/directional references that don't survive layout changes across surfaces"
+          },
+          phrases: [
+            {
+              pattern: "\\b(?:(?:the|this|that|these|those)\\s+\\w+|see|shown|listed|described|mentioned|noted|explained|outlined)\\s+above\\b",
+              matchType: "regex",
+              label: "above",
+              reason: `"Above" is a spatial reference; element position changes across surfaces and it's meaningless to screen-reader users.`,
+              suggestion: 'Name the thing instead of its position, e.g. "in Settings" or "the previous step".'
+            },
+            {
+              pattern: "\\b(?:(?:the|this|that|these|those)\\s+\\w+|see|shown|listed|described|mentioned|noted|explained|outlined)\\s+below\\b",
+              matchType: "regex",
+              label: "below",
+              reason: `"Below" is a spatial reference; element position changes across surfaces and it's meaningless to screen-reader users.`,
+              suggestion: 'Name the thing instead of its position, e.g. "in Settings" or "the next step".'
+            },
+            {
+              pattern: "\\b(?:tap|press|go|see)\\s+here\\b",
+              matchType: "regex",
+              label: "directional 'here'",
+              reason: `Directional "here" gives weak information scent and doesn't work for screen readers.`,
+              suggestion: 'Use a specific action, e.g. "View pricing" or "Open settings".'
+            }
+          ]
+        },
+        "control-reference": {
+          id: "control-reference",
+          name: "Control reference",
+          description: `Copy shouldn't tell people to act on a control by its type ("click the button", "tap the link"). Screen-reader users don't perceive the control the same way, and the phrasing is redundant \u2014 label or hyperlink the action itself.`,
+          severity: "info",
+          category: "accessibility",
+          check: {
+            type: "regex",
+            description: "Flags instructions that reference a UI control by type instead of hyperlinking or labelling the action"
+          },
+          phrases: [
+            {
+              pattern: "\\b(?:clicking|click|tapping|tap|pressing|press|hitting|hit)\\s+(?:on\\s+)?(?:(?:the|this|that)\\s+)?(?:[\\w-]+\\s+){0,2}(?:button|link)\\b",
+              matchType: "regex",
+              label: "click the button",
+              reason: "Referencing a control by type is meaningless to screen-reader users and redundant on screen.",
+              suggestion: 'Hyperlink or label the action itself, e.g. make "Reset your password" the button or link text.'
+            }
+          ]
+        },
         "word-count": {
           id: "word-count",
           name: "Word count limits",
@@ -1024,6 +1078,20 @@ var require_engine = __commonJS({
         return { ...phrase, _regex: null };
       }
     });
+    var compiledDirectional = rules["directional-language"].phrases.map((phrase) => {
+      try {
+        return { ...phrase, _regex: new RegExp(phrase.pattern, "i") };
+      } catch {
+        return { ...phrase, _regex: null };
+      }
+    });
+    var compiledControlReference = rules["control-reference"].phrases.map((phrase) => {
+      try {
+        return { ...phrase, _regex: new RegExp(phrase.pattern, "i") };
+      } catch {
+        return { ...phrase, _regex: null };
+      }
+    });
     function countSyllables(word) {
       const w = word.toLowerCase().replace(/[^a-z]/g, "");
       if (w.length <= 3) return 1;
@@ -1077,6 +1145,34 @@ var require_engine = __commonJS({
         });
       }
     }
+    function checkDirectionalLanguage(text, issues) {
+      for (const phrase of compiledDirectional) {
+        if (phrase._regex !== null && phrase._regex.test(text)) {
+          issues.push({
+            ruleId: "directional-language",
+            ruleName: "Directional language",
+            severity: "info",
+            message: `"${phrase.label}" \u2014 ${phrase.reason}`,
+            suggestion: phrase.suggestion
+          });
+        }
+      }
+    }
+    function checkControlReference(text, issues) {
+      for (const phrase of compiledControlReference) {
+        if (phrase._regex === null) continue;
+        const match = text.match(phrase._regex);
+        if (match) {
+          issues.push({
+            ruleId: "control-reference",
+            ruleName: "Control reference",
+            severity: "info",
+            message: `"${match[0] || phrase.label}" \u2014 ${phrase.reason}`,
+            suggestion: phrase.suggestion
+          });
+        }
+      }
+    }
     function checkGenericButtons(text, issues) {
       for (const entry of rules["generic-buttons"].bannedLabels) {
         if (entry.notes) continue;
@@ -1161,6 +1257,8 @@ var require_engine = __commonJS({
       if (!trimmed) return { score: 10, issues };
       checkSentenceCase(trimmed, issues);
       checkBannedPhrases(trimmed, contentType, issues);
+      checkDirectionalLanguage(trimmed, issues);
+      checkControlReference(trimmed, issues);
       if (contentType === "button") checkGenericButtons(trimmed, issues);
       checkPassiveVoice(trimmed, issues);
       if (contentType) checkWordCount(trimmed, contentType, issues);
@@ -5943,7 +6041,7 @@ var CONTENT_TYPES = [
 var MAX_TEXT_LENGTH = 5e3;
 var TOOL_NAME2 = "arbor_check_ux_writing";
 var TOOL_TITLE2 = "Check UX writing against Arbor voice rules";
-var TOOL_DESCRIPTION2 = `Lint a UI string against Arbor's voice and UX-writing rules (sentence case, banned/generic phrases, passive voice, word count, error structure, readability) and return a 0\u201310 score plus structured issues with suggestions. Deterministic and offline \u2014 the same engine behind the Slack /ux-check command. Pass contentType (e.g. "button", "error-system") to enable context-specific checks. This judges copy quality; it does NOT rewrite the text.`;
+var TOOL_DESCRIPTION2 = `Lint a UI string against Arbor's voice and UX-writing rules (sentence case, banned/generic phrases, passive voice, word count, error structure, readability, accessibility checks like directional language and control references) and return a 0\u201310 score plus structured issues with suggestions. Deterministic and offline \u2014 the same engine behind the Slack /ux-check command. Pass contentType (e.g. "button", "error-system") to enable context-specific checks. This judges copy quality; it does NOT rewrite the text.`;
 var inputSchema2 = external_exports.object({
   text: external_exports.string().trim().min(1, "text is required and must be a non-empty string").max(MAX_TEXT_LENGTH, `text must be ${MAX_TEXT_LENGTH} characters or fewer`).describe("The UI string to lint"),
   contentType: external_exports.enum(CONTENT_TYPES).optional().describe("What kind of UI text this is \u2014 enables context-specific rules (omit for content-agnostic checks)")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/arbor-mcp",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Model Context Protocol server exposing Arbor design system tools: Playroom snippets, Figma→code sync health, UX-writing checks, decision-log lookup, and federated component/version metadata.",
   "keywords": [
     "arbor",