@atlaskit/ads-mcp 0.2.5 → 0.4.0

package/dist/types/tools/analyze-accessibility/index.d.ts

@@ -0,0 +1,56 @@
+export declare const listAnalyzeAccessibilityTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const listAnalyzeLocalhostAccessibilityTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const analyzeAccessibilityTool: (params: {
+    code: string;
+    componentName?: string;
+    context?: string;
+    includePatternAnalysis?: boolean;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare const analyzeLocalhostAccessibilityTool: (params: {
+    url: string;
+    componentName?: string;
+    context?: string;
+    selector?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types/tools/get-accessibility-guidelines/index.d.ts

@@ -0,0 +1,26 @@
+export declare const listGetAccessibilityGuidelinesTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const getAccessibilityGuidelinesTool: (params: {
+    topic?: string;
+    component?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/{types-ts4.5/tools/get-tokens → types/tools/get-all-icons}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listGetTokensTool: {
+export declare const listGetAllIconsTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listGetTokensTool: {
         } | undefined;
     };
 };
-export declare const getTokensTool: () => Promise<{
+export declare const getAllIconsTool: () => Promise<{
     content: {
         type: string;
         text: string;

package/dist/types/tools/{get-tokens → get-all-tokens}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listGetTokensTool: {
+export declare const listGetAllTokensTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listGetTokensTool: {
         } | undefined;
     };
 };
-export declare const getTokensTool: () => Promise<{
+export declare const getAllTokensTool: () => Promise<{
     content: {
         type: string;
         text: string;

package/dist/types/tools/search-icons/index.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    terms: z.ZodArray<z.ZodString, "many">;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    exactName: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    terms: string[];
+    limit: number;
+    exactName: boolean;
+}, {
+    terms: string[];
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}>;
+export declare const listSearchIconsTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const searchIconsTool: (params: z.infer<typeof inputSchema>) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export {};

package/dist/types/tools/search-tokens/index.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    terms: z.ZodArray<z.ZodString, "many">;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    exactName: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    terms: string[];
+    limit: number;
+    exactName: boolean;
+}, {
+    terms: string[];
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}>;
+export declare const listSearchTokensTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const searchTokensTool: (params: z.infer<typeof inputSchema>) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export {};

package/dist/types/tools/suggest-accessibility-fixes/fixes.d.ts

@@ -0,0 +1,17 @@
+export interface FixSuggestion {
+    title: string;
+    description: string;
+    before: string;
+    after: string;
+    explanation: string;
+}
+export interface AccessibilityFix {
+    title: string;
+    description: string;
+    fixes: FixSuggestion[];
+    bestPractices: string[];
+}
+export interface AccessibilityFixCategory {
+    [key: string]: AccessibilityFix;
+}
+export declare const accessibilityFixes: AccessibilityFixCategory;

package/dist/types/tools/suggest-accessibility-fixes/index.d.ts

@@ -0,0 +1,28 @@
+export declare const listSuggestAccessibilityFixesTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const suggestAccessibilityFixesTool: (params: {
+    violation: string;
+    code: string;
+    component?: string;
+    context?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types/tools/suggest-accessibility-fixes/keywords.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Violation keywords mapping for fuzzy matching accessibility violations
+ *
+ * This file contains keyword synonyms and variations that users might use
+ * when describing accessibility violations. The keys should match the exact
+ * violation types defined in fixes.ts
+ *
+ * Each violation type has an array of keywords that help identify when a user
+ * is describing that particular type of accessibility issue, even if they
+ * don't use the exact technical terminology.
+ */
+export declare const violationKeywords: Record<string, string[]>;

package/dist/types-ts4.5/instructions.d.ts

@@ -1 +1 @@
-export declare const instructions = "\nYou are an expert in the Atlassian Design System (aka ADS). You are able to answer questions about the design system and provide guidance on what offerings to use when building user interfaces.\n\nYou are able to use the provided tools to help answer your questions, but may also access https://atlassian.design/llms.txt or https://atlassian.design/ directly for deeper research and information.\n";
+export declare const instructions = "\nYou are an expert in the Atlassian Design System (aka ADS). You are able to answer questions about the design system and provide guidance on what offerings to use when building user interfaces.\n\nYou have special expertise in accessibility and can help ensure that interfaces built with ADS components are accessible to all users. You can analyze code for accessibility violations, provide specific fix suggestions, and offer guidance on accessibility best practices.\n\nYou are able to use the provided tools to help answer your questions, but may also access https://atlassian.design/llms.txt, https://atlassian.design/llms-a11y.txt, or https://atlassian.design/ directly for deeper research and information.\n\nAccessibility Tools Available:\n- analyze_accessibility: Analyze React component code for accessibility violations\n- get_accessibility_guidelines: Get specific accessibility guidelines and best practices\n- suggest_accessibility_fixes: Get specific fix suggestions for accessibility violations\n- get_all_tokens: Get all tokens and their example values\n- search_tokens: Search for token(s) and their example value(s)\n- get_all_icons: Get all icons and their usage\n- search_icons: Search for icon(s) and their usage\n";

package/dist/types-ts4.5/tools/analyze-accessibility/index.d.ts

@@ -0,0 +1,56 @@
+export declare const listAnalyzeAccessibilityTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const listAnalyzeLocalhostAccessibilityTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const analyzeAccessibilityTool: (params: {
+    code: string;
+    componentName?: string;
+    context?: string;
+    includePatternAnalysis?: boolean;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare const analyzeLocalhostAccessibilityTool: (params: {
+    url: string;
+    componentName?: string;
+    context?: string;
+    selector?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types-ts4.5/tools/get-accessibility-guidelines/index.d.ts

@@ -0,0 +1,26 @@
+export declare const listGetAccessibilityGuidelinesTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const getAccessibilityGuidelinesTool: (params: {
+    topic?: string;
+    component?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types-ts4.5/tools/{get-icons → get-all-icons}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listGetIconsTool: {
+export declare const listGetAllIconsTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listGetIconsTool: {
         } | undefined;
     };
 };
-export declare const getIconsTool: () => Promise<{
+export declare const getAllIconsTool: () => Promise<{
     content: {
         type: string;
         text: string;

package/dist/{types/tools/get-icons → types-ts4.5/tools/get-all-tokens}/index.d.ts

@@ -1,4 +1,4 @@
-export declare const listGetIconsTool: {
+export declare const listGetAllTokensTool: {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +15,7 @@ export declare const listGetIconsTool: {
         } | undefined;
     };
 };
-export declare const getIconsTool: () => Promise<{
+export declare const getAllTokensTool: () => Promise<{
     content: {
         type: string;
         text: string;

package/dist/types-ts4.5/tools/search-icons/index.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    terms: z.ZodArray<z.ZodString, "many">;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    exactName: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    terms: string[];
+    limit: number;
+    exactName: boolean;
+}, {
+    terms: string[];
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}>;
+export declare const listSearchIconsTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const searchIconsTool: (params: z.infer<typeof inputSchema>) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export {};

package/dist/types-ts4.5/tools/search-tokens/index.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+declare const inputSchema: z.ZodObject<{
+    terms: z.ZodArray<z.ZodString, "many">;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    exactName: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    terms: string[];
+    limit: number;
+    exactName: boolean;
+}, {
+    terms: string[];
+    limit?: number | undefined;
+    exactName?: boolean | undefined;
+}>;
+export declare const listSearchTokensTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const searchTokensTool: (params: z.infer<typeof inputSchema>) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export {};

package/dist/types-ts4.5/tools/suggest-accessibility-fixes/fixes.d.ts

@@ -0,0 +1,17 @@
+export interface FixSuggestion {
+    title: string;
+    description: string;
+    before: string;
+    after: string;
+    explanation: string;
+}
+export interface AccessibilityFix {
+    title: string;
+    description: string;
+    fixes: FixSuggestion[];
+    bestPractices: string[];
+}
+export interface AccessibilityFixCategory {
+    [key: string]: AccessibilityFix;
+}
+export declare const accessibilityFixes: AccessibilityFixCategory;

package/dist/types-ts4.5/tools/suggest-accessibility-fixes/index.d.ts

@@ -0,0 +1,28 @@
+export declare const listSuggestAccessibilityFixesTool: {
+    name: string;
+    description: string;
+    annotations: {
+        title: string;
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+    };
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+};
+export declare const suggestAccessibilityFixesTool: (params: {
+    violation: string;
+    code: string;
+    component?: string;
+    context?: string;
+}) => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types-ts4.5/tools/suggest-accessibility-fixes/keywords.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Violation keywords mapping for fuzzy matching accessibility violations
+ *
+ * This file contains keyword synonyms and variations that users might use
+ * when describing accessibility violations. The keys should match the exact
+ * violation types defined in fixes.ts
+ *
+ * Each violation type has an array of keywords that help identify when a user
+ * is describing that particular type of accessibility issue, even if they
+ * don't use the exact technical terminology.
+ */
+export declare const violationKeywords: Record<string, string[]>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "0.2.5",
+	"version": "0.4.0",
 	"description": "The official Atlassian Design System MCP server to develop apps and user interfaces matching the Atlassian style.",
 	"author": "Atlassian Pty Ltd",
 	"license": "Apache-2.0",
@@ -29,10 +29,17 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
-		"@atlaskit/icon": "^28.0.0",
-		"@atlaskit/tokens": "^6.0.0",
+		"@atlaskit/icon": "^28.1.0",
+		"@atlaskit/tokens": "^6.3.0",
+		"@axe-core/playwright": "^4.8.0",
+		"@axe-core/puppeteer": "^4.7.3",
 		"@babel/runtime": "^7.0.0",
 		"@modelcontextprotocol/sdk": "^1.8.0",
+		"axe-core": "^4.10.2",
+		"fuse.js": "^6.6.2",
+		"jsdom": "root:*",
+		"playwright": "1.44.1",
+		"puppeteer": "13.7.0",
 		"zod": "^3.23.8",
 		"zod-to-json-schema": "^3.24.5"
 	},

package/dist/es2019/tools/get-tokens/index.js

@@ -1,35 +0,0 @@
-import { z } from 'zod';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { tokens } from '@atlaskit/tokens/token-metadata';
-const inputSchema = z.object({});
-export const listGetTokensTool = {
-  name: 'get_tokens',
-  description: `You MUST use this to fetch all Atlassian Design System tokens and parse their names and descriptions (provided in JSON format) before working with tokens.
-These tokens are used in place of hardcoded values; you should never use a hardcoded value where a token value is appropriate.
-The resulting token name is used inside of the \`token()\` function, eg.:
-\`\`\`tsx
-import { token } from '@atlaskit/tokens';
-const styles = css({ color: token('color.text') });
-\`\`\`
-`,
-  annotations: {
-    title: 'Get ADS tokens',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: zodToJsonSchema(inputSchema)
-};
-export const getTokensTool = async () => ({
-  content: tokens.map(token => ({
-    // NOTE: Ideally one day the MCP would support structured content…
-    // eg. `type: 'object', data: token`
-    type: 'text',
-    text: JSON.stringify({
-      name: token.name,
-      description: token.description,
-      exampleValue: token.exampleValue
-    }, null, 2)
-  }))
-});