@primer/mcp 0.3.1 → 0.3.2-rc.1104ba2c2

package/dist/index.js

@@ -1,4 +1,4 @@
-export { s as server } from './server-owUZMSeG.js';
+export { s as server } from './server-CGPYmiEJ.js';
 import '@modelcontextprotocol/sdk/server/mcp.js';
 import 'cheerio';
 import 'zod';

package/dist/{server-owUZMSeG.js → server-CGPYmiEJ.js}

@@ -420,7 +420,7 @@ function getDesignTokenSpecsText(groups) {
 * **Shorthand**: MUST use \`font: var(...)\`. NEVER split size/weight. 
 * **Shorthand Fallback**: If no shorthand exists (e.g. Monospace), use individual tokens for font-size, family, and line-height. NEVER raw 1.5.
 * **States**: Define 5: Rest, Hover, Focus-visible, Active, Disabled.
-* **Focus**: \`:focus-visible\` MUST use \`outline: var(--focus-outline)\` AND \`outline-offset: var(--outline-focus-offset)\`.
+* **Focus**: \`:focus-visible\` MUST use \`outline: var(--focus-outline)\` AND \`outline-offset: var(--focus-outline-offset, var(--outline-focus-offset))\`.
 * **Validation**: CALL \`lint_css\` after any CSS change. Task is incomplete without a success message.
 * **Self-Correction**: Adopt autofixes immediately. Report unfixable errors to the user.
 
@@ -491,7 +491,7 @@ function getTokenUsagePatternsText() {
 
 .btn-primary:focus-visible {
   outline: var(--focus-outline);
-  outline-offset: var(--outline-focus-offset);
+  outline-offset: var(--focus-outline-offset, var(--outline-focus-offset));
 }
 
 .btn-primary:active {
@@ -736,7 +736,7 @@ function runStylelint(css) {
   });
 }
 
-var version = "0.3.1";
+var version = "0.3.2";
 var packageJson = {
 	version: version};
 
@@ -833,10 +833,10 @@ server.registerTool('get_component', {
       content: []
     };
   }
-  const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, 'https://primer.style');
-  const llmsResponse = await fetch(llmsUrl);
-  if (llmsResponse.ok) {
-    try {
+  try {
+    const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, 'https://primer.style');
+    const llmsResponse = await fetch(llmsUrl);
+    if (llmsResponse.ok) {
       const llmsText = await llmsResponse.text();
       return {
         content: [{
@@ -844,35 +844,14 @@ server.registerTool('get_component', {
           text: llmsText
         }]
       };
-    } catch (_) {
-      // If there's an error fetching or processing the llms.txt, we fall back to the regular documentation
     }
+  } catch (_) {
+    // If there's an error fetching or processing the llms.txt, we fall back to a generic error message.
   }
-  const url = new URL(`/product/components/${match.slug}`, 'https://primer.style');
-  const response = await fetch(url);
-  if (!response.ok) {
-    throw new Error(`Failed to fetch ${url}: ${response.statusText}`);
-  }
-  const html = await response.text();
-  if (!html) {
-    return {
-      content: []
-    };
-  }
-  const $ = cheerio.load(html);
-  const source = $('main').html();
-  if (!source) {
-    return {
-      content: []
-    };
-  }
-  const text = turndownService.turndown(source);
   return {
-    content: [{
-      type: 'text',
-      text: `Here is the documentation for the \`${name}\` component from the @primer/react package:
-${text}`
-    }]
+    isError: true,
+    errorMessage: `There was an error fetching documentation for ${name}. Ensure the component exists.`,
+    content: []
   };
 });
 server.registerTool('get_component_examples', {

package/dist/stdio.js

@@ -1,5 +1,5 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { s as server } from './server-owUZMSeG.js';
+import { s as server } from './server-CGPYmiEJ.js';
 import '@modelcontextprotocol/sdk/server/mcp.js';
 import 'cheerio';
 import 'zod';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@primer/mcp",
   "description": "An MCP server that connects AI tools to the Primer Design System",
-  "version": "0.3.1",
+  "version": "0.3.2-rc.1104ba2c2",
   "type": "module",
   "bin": {
     "mcp": "./bin/mcp.js"
@@ -37,7 +37,7 @@
     "@modelcontextprotocol/sdk": "^1.24.0",
     "@primer/octicons": "^19.15.5",
     "@primer/primitives": "10.x || 11.x",
-    "@primer/react": "^38.15.0",
+    "@primer/react": "^38.20.0",
     "cheerio": "^1.0.0",
     "turndown": "^7.2.0",
     "zod": "^4.3.5"

package/src/primitives.ts

@@ -437,7 +437,7 @@ function getDesignTokenSpecsText(groups: TokenGroups): string {
 * **Shorthand**: MUST use \`font: var(...)\`. NEVER split size/weight. 
 * **Shorthand Fallback**: If no shorthand exists (e.g. Monospace), use individual tokens for font-size, family, and line-height. NEVER raw 1.5.
 * **States**: Define 5: Rest, Hover, Focus-visible, Active, Disabled.
-* **Focus**: \`:focus-visible\` MUST use \`outline: var(--focus-outline)\` AND \`outline-offset: var(--outline-focus-offset)\`.
+* **Focus**: \`:focus-visible\` MUST use \`outline: var(--focus-outline)\` AND \`outline-offset: var(--focus-outline-offset, var(--outline-focus-offset))\`.
 * **Validation**: CALL \`lint_css\` after any CSS change. Task is incomplete without a success message.
 * **Self-Correction**: Adopt autofixes immediately. Report unfixable errors to the user.
 
@@ -508,7 +508,7 @@ function getTokenUsagePatternsText(): string {
 
 .btn-primary:focus-visible {
   outline: var(--focus-outline);
-  outline-offset: var(--outline-focus-offset);
+  outline-offset: var(--focus-outline-offset, var(--outline-focus-offset));
 }
 
 .btn-primary:active {

package/src/server.ts

@@ -133,11 +133,10 @@ server.registerTool(
         content: [],
       }
     }
-
-    const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, 'https://primer.style')
-    const llmsResponse = await fetch(llmsUrl)
-    if (llmsResponse.ok) {
-      try {
+    try {
+      const llmsUrl = new URL(`/product/components/${match.slug}/llms.txt`, 'https://primer.style')
+      const llmsResponse = await fetch(llmsUrl)
+      if (llmsResponse.ok) {
         const llmsText = await llmsResponse.text()
         return {
           content: [
@@ -147,42 +146,15 @@ server.registerTool(
             },
           ],
         }
-      } catch (_: unknown) {
-        // If there's an error fetching or processing the llms.txt, we fall back to the regular documentation
-      }
-    }
-
-    const url = new URL(`/product/components/${match.slug}`, 'https://primer.style')
-    const response = await fetch(url)
-    if (!response.ok) {
-      throw new Error(`Failed to fetch ${url}: ${response.statusText}`)
-    }
-
-    const html = await response.text()
-    if (!html) {
-      return {
-        content: [],
-      }
-    }
-
-    const $ = cheerio.load(html)
-    const source = $('main').html()
-    if (!source) {
-      return {
-        content: [],
       }
+    } catch (_: unknown) {
+      // If there's an error fetching or processing the llms.txt, we fall back to a generic error message.
     }
 
-    const text = turndownService.turndown(source)
-
     return {
-      content: [
-        {
-          type: 'text',
-          text: `Here is the documentation for the \`${name}\` component from the @primer/react package:
-${text}`,
-        },
-      ],
+      isError: true,
+      errorMessage: `There was an error fetching documentation for ${name}. Ensure the component exists.`,
+      content: [],
     }
   },
 )

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-export { server } from './server';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAA"}

package/dist/primer.d.ts

@@ -1,20 +0,0 @@
-type Component = {
-    id: string;
-    name: string;
-    importPath: string;
-    slug: string;
-};
-declare function listComponents(): Array<Component>;
-type Pattern = {
-    id: string;
-    name: string;
-};
-declare function listPatterns(): Array<Pattern>;
-type Icon = {
-    name: string;
-    keywords: Array<string>;
-    heights: Array<string>;
-};
-declare function listIcons(): Array<Icon>;
-export { listComponents, listPatterns, listIcons };
-//# sourceMappingURL=primer.d.ts.map

package/dist/primer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"primer.d.ts","sourceRoot":"","sources":["../src/primer.ts"],"names":[],"mappings":"AAGA,KAAK,SAAS,GAAG;IACf,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AA2BD,iBAAS,cAAc,IAAI,KAAK,CAAC,SAAS,CAAC,CAE1C;AAED,KAAK,OAAO,GAAG;IACb,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AA6CD,iBAAS,YAAY,IAAI,KAAK,CAAC,OAAO,CAAC,CAEtC;AAED,KAAK,IAAI,GAAG;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACvB,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CACvB,CAAA;AAUD,iBAAS,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAEhC;AAED,OAAO,EAAC,cAAc,EAAE,YAAY,EAAE,SAAS,EAAC,CAAA"}

package/dist/primitives.d.ts

@@ -1,184 +0,0 @@
-declare const categories: {
-    readonly base: {
-        readonly motion: {
-            name: string;
-            type: string;
-            value: number[] | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            } | {
-                value: number;
-                unit: string;
-            };
-        }[];
-        readonly size: {
-            name: string;
-            type: string;
-            value: string;
-        }[];
-        readonly typography: {
-            name: string;
-            type: string;
-            value: string | number;
-        }[];
-    };
-    readonly functional: {
-        readonly border: {
-            name: string;
-            type: string;
-            value: string;
-        }[];
-        readonly radius: {
-            name: string;
-            type: string;
-            value: string;
-        }[];
-        readonly sizeCoarse: {
-            name: string;
-            type: string;
-            value: string;
-        }[];
-        readonly sizeFine: {
-            name: string;
-            type: string;
-            value: string;
-        }[];
-        readonly size: {
-            name: string;
-            type: string;
-            value: string;
-        }[];
-        readonly themes: {
-            readonly light: {
-                name: string;
-                type: string;
-                value: string;
-            }[];
-        };
-        readonly typography: {
-            name: string;
-            type: string;
-            value: string | number;
-        }[];
-    };
-};
-declare const tokens: ({
-    name: string;
-    type: string;
-    value: number[] | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    } | {
-        value: number;
-        unit: string;
-    };
-} | {
-    name: string;
-    type: string;
-    value: string | number;
-})[];
-declare function serialize(value: typeof tokens): string;
-type TokenGroup = {
-    name: string;
-    count: number;
-    subGroups?: string[];
-};
-type TokenGroups = {
-    semantic: TokenGroup[];
-    component: TokenGroup[];
-};
-declare function listTokenGroups(): TokenGroups;
-export { categories, tokens, serialize, listTokenGroups, type TokenGroups };
-type TokenWithGuidelines = {
-    name: string;
-    value: string;
-    useCase: string;
-    rules: string;
-    group: string;
-};
-declare function parseDesignTokensSpec(markdown: string): TokenWithGuidelines[];
-declare const GROUP_LABELS: Record<string, string>;
-declare function buildAllTokens(guidelinesTokens: TokenWithGuidelines[]): TokenWithGuidelines[];
-declare function findTokens(allTokens: TokenWithGuidelines[], query: string, group?: string): TokenWithGuidelines[];
-declare function expandTokenPattern(token: TokenWithGuidelines): TokenWithGuidelines[];
-declare function loadAllTokensWithGuidelines(): TokenWithGuidelines[];
-declare function loadDesignTokensGuide(): string;
-declare function loadDesignTokensSpec(): string;
-declare function getDesignTokenSpecsText(groups: TokenGroups): string;
-declare function getTokenUsagePatternsText(): string;
-declare function searchTokens(allTokens: TokenWithGuidelines[], query: string, group?: string): TokenWithGuidelines[];
-declare const GROUP_ALIASES: Record<string, string>;
-declare function tokenMatchesGroup(token: TokenWithGuidelines, resolvedGroup: string): boolean;
-declare function formatBundle(bundleTokens: TokenWithGuidelines[]): string;
-/**
- * Generates a sorted, unique list of group names from the current token cache.
- * Used for "Healing" error messages and the Design System Search Map.
- */
-declare function getValidGroupsList(validTokens: TokenWithGuidelines[]): string;
-declare const groupHints: Record<string, string>;
-declare function runStylelint(css: string): Promise<{
-    stdout: string;
-    stderr: string;
-}>;
-export { parseDesignTokensSpec, findTokens, buildAllTokens, expandTokenPattern, loadAllTokensWithGuidelines, loadDesignTokensGuide, loadDesignTokensSpec, getDesignTokenSpecsText, getTokenUsagePatternsText, getValidGroupsList, searchTokens, formatBundle, groupHints, GROUP_ALIASES, GROUP_LABELS, tokenMatchesGroup, runStylelint, type TokenWithGuidelines, };
-//# sourceMappingURL=primitives.d.ts.map

package/dist/primitives.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../src/primitives.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -1,4 +0,0 @@
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-declare const server: McpServer;
-export { server };
-//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAC,MAAM,yCAAyC,CAAA;AAwBjE,QAAA,MAAM,MAAM,WAGV,CAAA;AA27BF,OAAO,EAAC,MAAM,EAAC,CAAA"}

package/dist/transports/stdio.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=stdio.d.ts.map

package/dist/transports/stdio.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transports/stdio.ts"],"names":[],"mappings":""}