@linktr.ee/arbor-mcp 0.9.0 → 0.10.0-rc.b7b2f343e.8215

package/dist/index.js

@@ -309,6 +309,80 @@ 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.'
+            }
+          ]
+        },
+        "blame-language": {
+          id: "blame-language",
+          name: "Blame language",
+          description: `Error copy shouldn't blame the Linker by calling their input "invalid". Name the specific requirement or the fix instead. ("invalid input" is handled by banned-phrases; this catches the general "invalid <thing>" shape.)`,
+          severity: "warning",
+          category: "content",
+          check: {
+            type: "regex",
+            description: 'Flags "invalid" used as blame ("invalid email", "invalid card"), excluding "invalid input(s)" which banned-phrases already covers'
+          },
+          phrases: [
+            {
+              pattern: "\\binvalid\\b(?!\\s+inputs?\\b)",
+              matchType: "regex",
+              label: "invalid",
+              reason: 'Calling input "invalid" blames the Linker and is vague.',
+              suggestion: 'Name the requirement or fix, e.g. "Double-check your email address" or "Email must include @".'
+            }
+          ]
+        },
         "word-count": {
           id: "word-count",
           name: "Word count limits",
@@ -1024,6 +1098,27 @@ 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 };
+      }
+    });
+    var compiledBlameLanguage = rules["blame-language"].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 +1172,49 @@ 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 checkBlameLanguage(text, issues) {
+      for (const phrase of compiledBlameLanguage) {
+        if (phrase._regex === null) continue;
+        const match = text.match(phrase._regex);
+        if (match) {
+          issues.push({
+            ruleId: "blame-language",
+            ruleName: "Blame language",
+            severity: "warning",
+            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 +1299,9 @@ var require_engine = __commonJS({
       if (!trimmed) return { score: 10, issues };
       checkSentenceCase(trimmed, issues);
       checkBannedPhrases(trimmed, contentType, issues);
+      checkDirectionalLanguage(trimmed, issues);
+      checkControlReference(trimmed, issues);
+      checkBlameLanguage(trimmed, issues);
       if (contentType === "button") checkGenericButtons(trimmed, issues);
       checkPassiveVoice(trimmed, issues);
       if (contentType) checkWordCount(trimmed, contentType, issues);
@@ -5943,7 +6084,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)")
@@ -7279,6 +7420,87 @@ var compositions_default = [
     name: "IndicatorBadge (custom color)",
     code: '<IndicatorBadge count={5} color="#7B61FF" />'
   },
+  // ── Chip ──
+  {
+    group: "Chip",
+    name: "Chip (filter row)",
+    code: `<div className="flex flex-wrap items-center gap-2">
+  <Chip selected onSelectedChange={() => {}}>Instagram</Chip>
+  <Chip onSelectedChange={() => {}}>TikTok</Chip>
+  <Chip onSelectedChange={() => {}}>YouTube</Chip>
+</div>`
+  },
+  {
+    group: "Chip",
+    name: "Chip (dismissible tags)",
+    code: `<div className="flex flex-wrap items-center gap-2">
+  <Chip removeLabel="Remove Design system" onRemove={() => {}}>Design system</Chip>
+  <Chip removeLabel="Remove Infrastructure" onRemove={() => {}}>Infrastructure</Chip>
+</div>`
+  },
+  {
+    group: "Chip",
+    name: "Chip (sizes)",
+    code: `<div className="flex flex-wrap items-center gap-2">
+  <Chip size="md">Music</Chip>
+  <Chip size="sm">Music</Chip>
+</div>`
+  },
+  {
+    group: "Chip",
+    name: "Chip (disabled)",
+    code: "<Chip disabled onSelectedChange={() => {}}>Top 5</Chip>"
+  },
+  // ── Combobox ──
+  // Imported via the @linktr.ee/arbor/components/Combobox sub-path (barrel-excluded
+  // — optional @base-ui/react peer dep); surfaced in components.ts like AppIcon/OTP.
+  {
+    group: "Combobox",
+    name: "Combobox (single)",
+    code: `<Field.Root>
+  <Combobox.Root items={["Design system", "Infrastructure", "Analytics", "Commerce"]}>
+    <Combobox.Control>
+      <Field.Label>Tag</Field.Label>
+      <Combobox.Input />
+      <Combobox.Trigger />
+    </Combobox.Control>
+    <Combobox.Content>
+      <Combobox.Empty>No tags found</Combobox.Empty>
+      <Combobox.List>
+        {(tag) => (
+          <Combobox.Item key={tag} value={tag}>
+            {tag}
+          </Combobox.Item>
+        )}
+      </Combobox.List>
+    </Combobox.Content>
+  </Combobox.Root>
+</Field.Root>`
+  },
+  {
+    group: "Combobox",
+    name: "Combobox (multiple with chips)",
+    code: `<Field.Root>
+  <Combobox.Root multiple defaultValue={["Design system"]} items={["Design system", "Infrastructure", "Analytics", "Commerce"]}>
+    <Combobox.Control>
+      <Combobox.Chips>
+        <Combobox.Input placeholder="Search tags" aria-label="Tags" />
+      </Combobox.Chips>
+      <Combobox.Trigger />
+    </Combobox.Control>
+    <Combobox.Content>
+      <Combobox.Empty>No tags found</Combobox.Empty>
+      <Combobox.List>
+        {(tag) => (
+          <Combobox.Item key={tag} value={tag}>
+            {tag}
+          </Combobox.Item>
+        )}
+      </Combobox.List>
+    </Combobox.Content>
+  </Combobox.Root>
+</Field.Root>`
+  },
   // ── Button ──
   {
     group: "Button",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@linktr.ee/arbor-mcp",
-  "version": "0.9.0",
+  "version": "0.10.0-rc.b7b2f343e.8215",
   "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",