@atlaskit/ads-mcp 0.9.0 → 0.10.0

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

@@ -0,0 +1,108 @@
+import Fuse from 'fuse.js';
+import { z } from 'zod';
+import { cleanQuery, zodToJsonSchema } from '../../helpers';
+import { iconStructuredContent } from './icon-structured-content.codegen';
+export const getIconsInputSchema = z.object({
+  terms: z.array(z.string()).default([]).describe('An array of search terms to find icons by name, keywords, or categorization, eg. `["search", "folder", "user"]`. If empty or not provided, returns all icons.').optional(),
+  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: z.boolean().default(false).describe('Enable to explicitly search icons by the exact name match (when you know the name, but need more details)').optional()
+});
+export const listGetIconsTool = {
+  name: 'ads_get_icons',
+  description: `Get Atlassian Design System icons with optional search functionality.
+
+- If search parameters are provided, searches for icons matching the criteria.
+- If no search parameters are provided, returns all icons.
+
+Example icon usage:
+\`\`\`tsx
+import AddIcon from '@atlaskit/icon/core/add';
+<AddIcon label="Add work item" size="small" />
+\`\`\``,
+  annotations: {
+    title: 'Get ADS icons',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: zodToJsonSchema(getIconsInputSchema)
+};
+export const getIconsTool = async params => {
+  const {
+    terms = [],
+    limit = 1,
+    exactName = false
+  } = params;
+  const searchTerms = terms.filter(Boolean).map(cleanQuery);
+  const iconDocs = iconStructuredContent.filter(icon => icon.status === 'published');
+
+  // If no search terms provided, return all icons formatted as Markdown
+  if (searchTerms.length === 0) {
+    const allIconsMarkdown = iconDocs.map(icon => icon.content).join('\n\n');
+    return {
+      content: [{
+        type: 'text',
+        text: allIconsMarkdown
+      }]
+    };
+  }
+
+  // Search logic (similar to search-icons)
+  if (exactName) {
+    // for each search term, search for the exact match
+    const exactNameMatches = searchTerms.map(term => {
+      return iconDocs.find(icon => icon.componentName.toLowerCase() === term.toLowerCase());
+    }).filter(icon => icon !== undefined);
+
+    // Return exact matches if found, or empty result if exactName is true
+    const formattedIcons = exactNameMatches.map(icon => icon.content).join('\n\n');
+    return {
+      content: [{
+        type: 'text',
+        text: formattedIcons
+      }]
+    };
+  }
+
+  // use Fuse.js to fuzzy-search for the icons
+  const fuse = new Fuse(iconDocs, {
+    keys: [{
+      name: 'componentName',
+      weight: 3
+    }, {
+      name: 'keywords',
+      weight: 2
+    }, {
+      name: 'categorization',
+      weight: 1
+    }, {
+      name: 'usage',
+      weight: 1
+    }],
+    threshold: 0.4
+  });
+  const results = searchTerms.map(term => {
+    // always search exact match from the icons
+    const exactNameMatch = iconDocs.find(icon => icon.componentName.toLowerCase() === term.toLowerCase());
+    if (exactNameMatch) {
+      return [{
+        item: exactNameMatch
+      }];
+    }
+    return fuse.search(term).slice(0, limit);
+  }).flat();
+
+  // Remove duplicates based on componentName
+  const uniqueResults = results.filter((result, index, arr) => {
+    return arr.findIndex(r => r.item.componentName === result.item.componentName) === index;
+  });
+  const matchedIcons = uniqueResults.map(result => result.item);
+  const formattedIcons = matchedIcons.map(icon => icon.content).join('\n\n');
+  return {
+    content: [{
+      type: 'text',
+      text: formattedIcons
+    }]
+  };
+};

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

@@ -1,22 +1,7 @@
 import Fuse from 'fuse.js';
 import { z } from 'zod';
-import { zodToJsonSchema } from 'zod-to-json-schema';
-import { tokens } from '@atlaskit/tokens/token-metadata';
-import { cleanQuery } from '../../helpers';
-import { tokenToMarkdown } from '../../structured-content/formatters/token';
-// Transform Token[] from token-metadata to TokenSchema[] format
-function transformTokensToSchemas() {
-  return tokens.map(token => {
-    var _token$exampleValue;
-    return {
-      contentType: 'token',
-      name: token.name,
-      path: token.path,
-      description: token.description,
-      exampleValue: String((_token$exampleValue = token.exampleValue) !== null && _token$exampleValue !== void 0 ? _token$exampleValue : '')
-    };
-  });
-}
+import { cleanQuery, zodToJsonSchema } from '../../helpers';
+import { tokenStructuredContent } from './token-structured-content.codegen';
 export const getTokensInputSchema = z.object({
   terms: z.array(z.string()).default([]).describe('An array of search terms to find tokens by name or description, eg. `["spacing", "inverted text", "background primary"]`. If empty or not provided, returns all tokens.').optional(),
   limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
@@ -50,11 +35,11 @@ export const getTokensTool = async params => {
     exactName = false
   } = params;
   const searchTerms = terms.filter(Boolean).map(cleanQuery);
-  const tokenDocs = transformTokensToSchemas();
+  const tokenDocs = tokenStructuredContent;
 
   // If no search terms provided, return all tokens formatted as Markdown
   if (searchTerms.length === 0) {
-    const allTokensMarkdown = tokenDocs.map(tokenToMarkdown).join('\n\n');
+    const allTokensMarkdown = tokenDocs.map(token => token.content).join('\n\n');
     return {
       content: [{
         type: 'text',
@@ -68,9 +53,9 @@ export const getTokensTool = async params => {
     // for each search term, search for the exact match
     const exactNameMatches = searchTerms.map(term => {
       return tokenDocs.find(token => token.name.toLowerCase() === term.toLowerCase());
-    }).filter(Boolean);
+    }).filter(token => token !== undefined);
     if (exactNameMatches.length > 0) {
-      const formattedTokens = exactNameMatches.map(tokenToMarkdown).join('\n\n');
+      const formattedTokens = exactNameMatches.map(token => token.content).join('\n\n');
       return {
         content: [{
           type: 'text',
@@ -103,7 +88,7 @@ export const getTokensTool = async params => {
     return arr.findIndex(r => r.item.name === result.item.name) === index;
   });
   const matchedTokens = uniqueResults.map(result => result.item);
-  const formattedTokens = matchedTokens.map(tokenToMarkdown).join('\n\n');
+  const formattedTokens = matchedTokens.map(token => token.content).join('\n\n');
   return {
     content: [{
       type: 'text',