@atlaskit/ads-mcp 0.9.1 → 0.10.0

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

@@ -0,0 +1,133 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listGetIconsTool = exports.getIconsTool = exports.getIconsInputSchema = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _fuse = _interopRequireDefault(require("fuse.js"));
+var _zod = require("zod");
+var _helpers = require("../../helpers");
+var _iconStructuredContent = require("./icon-structured-content.codegen");
+var getIconsInputSchema = exports.getIconsInputSchema = _zod.z.object({
+  terms: _zod.z.array(_zod.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: _zod.z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
+  exactName: _zod.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()
+});
+var listGetIconsTool = exports.listGetIconsTool = {
+  name: 'ads_get_icons',
+  description: "Get Atlassian Design System icons with optional search functionality.\n\n- If search parameters are provided, searches for icons matching the criteria.\n- If no search parameters are provided, returns all icons.\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
+  annotations: {
+    title: 'Get ADS icons',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _helpers.zodToJsonSchema)(getIconsInputSchema)
+};
+var getIconsTool = exports.getIconsTool = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
+    var _params$terms, terms, _params$limit, limit, _params$exactName, exactName, searchTerms, iconDocs, allIconsMarkdown, exactNameMatches, _formattedIcons, fuse, results, uniqueResults, matchedIcons, formattedIcons;
+    return _regenerator.default.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _params$terms = params.terms, terms = _params$terms === void 0 ? [] : _params$terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
+          searchTerms = terms.filter(Boolean).map(_helpers.cleanQuery);
+          iconDocs = _iconStructuredContent.iconStructuredContent.filter(function (icon) {
+            return icon.status === 'published';
+          }); // If no search terms provided, return all icons formatted as Markdown
+          if (!(searchTerms.length === 0)) {
+            _context.next = 6;
+            break;
+          }
+          allIconsMarkdown = iconDocs.map(function (icon) {
+            return icon.content;
+          }).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: allIconsMarkdown
+            }]
+          });
+        case 6:
+          if (!exactName) {
+            _context.next = 10;
+            break;
+          }
+          // for each search term, search for the exact match
+          exactNameMatches = searchTerms.map(function (term) {
+            return iconDocs.find(function (icon) {
+              return icon.componentName.toLowerCase() === term.toLowerCase();
+            });
+          }).filter(function (icon) {
+            return icon !== undefined;
+          }); // Return exact matches if found, or empty result if exactName is true
+          _formattedIcons = exactNameMatches.map(function (icon) {
+            return icon.content;
+          }).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: _formattedIcons
+            }]
+          });
+        case 10:
+          // use Fuse.js to fuzzy-search for the icons
+          fuse = new _fuse.default(iconDocs, {
+            keys: [{
+              name: 'componentName',
+              weight: 3
+            }, {
+              name: 'keywords',
+              weight: 2
+            }, {
+              name: 'categorization',
+              weight: 1
+            }, {
+              name: 'usage',
+              weight: 1
+            }],
+            threshold: 0.4
+          });
+          results = searchTerms.map(function (term) {
+            // always search exact match from the icons
+            var exactNameMatch = iconDocs.find(function (icon) {
+              return icon.componentName.toLowerCase() === term.toLowerCase();
+            });
+            if (exactNameMatch) {
+              return [{
+                item: exactNameMatch
+              }];
+            }
+            return fuse.search(term).slice(0, limit);
+          }).flat(); // Remove duplicates based on componentName
+          uniqueResults = results.filter(function (result, index, arr) {
+            return arr.findIndex(function (r) {
+              return r.item.componentName === result.item.componentName;
+            }) === index;
+          });
+          matchedIcons = uniqueResults.map(function (result) {
+            return result.item;
+          });
+          formattedIcons = matchedIcons.map(function (icon) {
+            return icon.content;
+          }).join('\n\n');
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: formattedIcons
+            }]
+          });
+        case 16:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function getIconsTool(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();

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

@@ -9,23 +9,8 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 var _fuse = _interopRequireDefault(require("fuse.js"));
 var _zod = require("zod");
-var _zodToJsonSchema = require("zod-to-json-schema");
-var _tokenMetadata = require("@atlaskit/tokens/token-metadata");
 var _helpers = require("../../helpers");
-var _token = require("../../structured-content/formatters/token");
-// Transform Token[] from token-metadata to TokenSchema[] format
-function transformTokensToSchemas() {
-  return _tokenMetadata.tokens.map(function (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 : '')
-    };
-  });
-}
+var _tokenStructuredContent = require("./token-structured-content.codegen");
 var getTokensInputSchema = exports.getTokensInputSchema = _zod.z.object({
   terms: _zod.z.array(_zod.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: _zod.z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
@@ -41,7 +26,7 @@ var listGetTokensTool = exports.listGetTokensTool = {
     idempotentHint: true,
     openWorldHint: true
   },
-  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(getTokensInputSchema)
+  inputSchema: (0, _helpers.zodToJsonSchema)(getTokensInputSchema)
 };
 var getTokensTool = exports.getTokensTool = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(params) {
@@ -51,12 +36,14 @@ var getTokensTool = exports.getTokensTool = /*#__PURE__*/function () {
         case 0:
           _params$terms = params.terms, terms = _params$terms === void 0 ? [] : _params$terms, _params$limit = params.limit, limit = _params$limit === void 0 ? 1 : _params$limit, _params$exactName = params.exactName, exactName = _params$exactName === void 0 ? false : _params$exactName;
           searchTerms = terms.filter(Boolean).map(_helpers.cleanQuery);
-          tokenDocs = transformTokensToSchemas(); // If no search terms provided, return all tokens formatted as Markdown
+          tokenDocs = _tokenStructuredContent.tokenStructuredContent; // If no search terms provided, return all tokens formatted as Markdown
           if (!(searchTerms.length === 0)) {
             _context.next = 6;
             break;
           }
-          allTokensMarkdown = tokenDocs.map(_token.tokenToMarkdown).join('\n\n');
+          allTokensMarkdown = tokenDocs.map(function (token) {
+            return token.content;
+          }).join('\n\n');
           return _context.abrupt("return", {
             content: [{
               type: 'text',
@@ -73,12 +60,16 @@ var getTokensTool = exports.getTokensTool = /*#__PURE__*/function () {
             return tokenDocs.find(function (token) {
               return token.name.toLowerCase() === term.toLowerCase();
             });
-          }).filter(Boolean);
+          }).filter(function (token) {
+            return token !== undefined;
+          });
           if (!(exactNameMatches.length > 0)) {
             _context.next = 11;
             break;
           }
-          _formattedTokens = exactNameMatches.map(_token.tokenToMarkdown).join('\n\n');
+          _formattedTokens = exactNameMatches.map(function (token) {
+            return token.content;
+          }).join('\n\n');
           return _context.abrupt("return", {
             content: [{
               type: 'text',
@@ -111,7 +102,9 @@ var getTokensTool = exports.getTokensTool = /*#__PURE__*/function () {
           matchedTokens = uniqueResults.map(function (result) {
             return result.item;
           });
-          formattedTokens = matchedTokens.map(_token.tokenToMarkdown).join('\n\n');
+          formattedTokens = matchedTokens.map(function (token) {
+            return token.content;
+          }).join('\n\n');
           return _context.abrupt("return", {
             content: [{
               type: 'text',