@atlaskit/ads-mcp 1.0.0 → 1.2.0

package/dist/cjs/tools/search-atlaskit-hooks/search-atlaskit-hooks-tool.js

@@ -0,0 +1,109 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchAtlaskitHooksTool = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _fuse = _interopRequireDefault(require("fuse.js"));
+var _helpers = require("../../helpers");
+var _atlaskitHooks = require("../get-atlaskit-hooks/atlaskit-hooks.codegen");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var buildHookResult = function buildHookResult(result) {
+  return {
+    name: result.name,
+    package: result.package,
+    description: result.description,
+    usageGuidelines: result.usageGuidelines,
+    keywords: result.keywords,
+    category: result.category,
+    parameters: result.parameters,
+    returns: result.returns
+  };
+};
+var searchAtlaskitHooksTool = exports.searchAtlaskitHooksTool = /*#__PURE__*/function () {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, hooks, fuse, matchedItems;
+    return _regenerator.default.wrap(function (_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_helpers.cleanQuery)));
+          if (searchTerms.length) {
+            _context.next = 1;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: '[]'
+            }]
+          });
+        case 1:
+          hooks = _atlaskitHooks.atlaskitHooks;
+          fuse = new _fuse.default(hooks, {
+            keys: [{
+              name: 'name',
+              weight: 5
+            }, {
+              name: 'package',
+              weight: 3
+            }, {
+              name: 'category',
+              weight: 2
+            }, {
+              name: 'description',
+              weight: 2
+            }, {
+              name: 'keywords',
+              weight: 2
+            }, {
+              name: 'usageGuidelines',
+              weight: 2
+            }],
+            threshold: 0.4,
+            distance: 80,
+            minMatchCharLength: 3,
+            ignoreFieldNorm: true,
+            includeScore: true
+          });
+          matchedItems = (0, _helpers.mergeMultiTermFuseResults)({
+            searchTerms: searchTerms,
+            limit: limit,
+            search: function search(query) {
+              return fuse.search(query, {
+                limit: limit * searchTerms.length
+              });
+            }
+          });
+          if (matchedItems.length) {
+            _context.next = 2;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: "Error: No Atlaskit hooks found for '".concat(terms.join(', '), "'.")
+            }]
+          });
+        case 2:
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: JSON.stringify(matchedItems.map(buildHookResult))
+            }]
+          });
+        case 3:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function searchAtlaskitHooksTool(_x) {
+    return _ref2.apply(this, arguments);
+  };
+}();

package/dist/cjs/tools/search-atlaskit-utilities/list-search-atlaskit-utilities-tool.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listSearchAtlaskitUtilitiesTool = void 0;
+var _helpers = require("../../helpers");
+var _searchAtlaskitUtilitiesInputSchema = require("./search-atlaskit-utilities-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listSearchAtlaskitUtilitiesTool = exports.listSearchAtlaskitUtilitiesTool = {
+  name: 'atlaskit_search_utilities',
+  description: "Search for atlaskit utilities (functions, constants, types) by name, package, category, description, or keywords.\n\nWHEN TO USE:\nUse this when you want to find a utility but don't know its exact name or package.",
+  annotations: {
+    title: 'Search Atlaskit utilities',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _helpers.zodToJsonSchema)(_searchAtlaskitUtilitiesInputSchema.searchAtlaskitUtilitiesInputSchema)
+};

package/dist/cjs/tools/search-atlaskit-utilities/search-atlaskit-utilities-input-schema.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchAtlaskitUtilitiesInputSchema = void 0;
+var _zod = require("zod");
+var searchAtlaskitUtilitiesInputSchema = exports.searchAtlaskitUtilitiesInputSchema = _zod.z.object({
+  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, usageGuidelines). Example: `["debounce", "a11y", "storage"]`.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/cjs/tools/search-atlaskit-utilities/search-atlaskit-utilities-tool.js

@@ -0,0 +1,111 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchAtlaskitUtilitiesTool = void 0;
+var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
+var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers/toConsumableArray"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _fuse = _interopRequireDefault(require("fuse.js"));
+var _helpers = require("../../helpers");
+var _atlaskitUtilities = require("../get-atlaskit-utilities/atlaskit-utilities.codegen");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; } /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+var buildUtilityResult = function buildUtilityResult(result) {
+  return _objectSpread({
+    name: result.name,
+    package: result.package,
+    description: result.description,
+    usageGuidelines: result.usageGuidelines,
+    keywords: result.keywords,
+    category: result.category,
+    kind: result.kind
+  }, result.kind === 'function' ? {
+    signature: result.signature
+  } : {});
+};
+var searchAtlaskitUtilitiesTool = exports.searchAtlaskitUtilitiesTool = /*#__PURE__*/function () {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, utilities, fuse, matchedItems;
+    return _regenerator.default.wrap(function (_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_helpers.cleanQuery)));
+          if (searchTerms.length) {
+            _context.next = 1;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: '[]'
+            }]
+          });
+        case 1:
+          utilities = _atlaskitUtilities.atlaskitUtilities;
+          fuse = new _fuse.default(utilities, {
+            keys: [{
+              name: 'name',
+              weight: 5
+            }, {
+              name: 'package',
+              weight: 3
+            }, {
+              name: 'category',
+              weight: 2
+            }, {
+              name: 'description',
+              weight: 2
+            }, {
+              name: 'keywords',
+              weight: 2
+            }, {
+              name: 'usageGuidelines',
+              weight: 2
+            }],
+            threshold: 0.4,
+            distance: 80,
+            minMatchCharLength: 3,
+            ignoreFieldNorm: true,
+            includeScore: true
+          });
+          matchedItems = (0, _helpers.mergeMultiTermFuseResults)({
+            searchTerms: searchTerms,
+            limit: limit,
+            search: function search(query) {
+              return fuse.search(query, {
+                limit: limit * searchTerms.length
+              });
+            }
+          });
+          if (matchedItems.length) {
+            _context.next = 2;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: "Error: No Atlaskit utilities found for '".concat(terms.join(', '), "'.")
+            }]
+          });
+        case 2:
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: JSON.stringify(matchedItems.map(buildUtilityResult))
+            }]
+          });
+        case 3:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function searchAtlaskitUtilitiesTool(_x) {
+    return _ref2.apply(this, arguments);
+  };
+}();

package/dist/cjs/tools/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/es2019/index.js

@@ -22,6 +22,10 @@ import { getAllTokensTool } from './tools/get-all-tokens/get-all-tokens-tool';
 import { listGetAllTokensTool } from './tools/get-all-tokens/list-get-all-tokens-tool';
 import { getAtlaskitComponentsTool } from './tools/get-atlaskit-components/get-atlaskit-components-tool';
 import { listGetAtlaskitComponentsTool } from './tools/get-atlaskit-components/list-get-atlaskit-components-tool';
+import { getAtlaskitHooksTool } from './tools/get-atlaskit-hooks/get-atlaskit-hooks-tool';
+import { listGetAtlaskitHooksTool } from './tools/get-atlaskit-hooks/list-get-atlaskit-hooks-tool';
+import { getAtlaskitUtilitiesTool } from './tools/get-atlaskit-utilities/get-atlaskit-utilities-tool';
+import { listGetAtlaskitUtilitiesTool } from './tools/get-atlaskit-utilities/list-get-atlaskit-utilities-tool';
 import { getGuidelinesInputSchema } from './tools/get-guidelines/get-guidelines-input-schema';
 import { getGuidelinesTool } from './tools/get-guidelines/get-guidelines-tool';
 import { listGetGuidelinesTool } from './tools/get-guidelines/list-get-guidelines-tool';
@@ -40,6 +44,12 @@ import { planTool } from './tools/plan/plan-tool';
 import { listSearchAtlaskitComponentsTool } from './tools/search-atlaskit-components/list-search-atlaskit-components-tool';
 import { searchAtlaskitComponentsInputSchema } from './tools/search-atlaskit-components/search-atlaskit-components-input-schema';
 import { searchAtlaskitComponentsTool } from './tools/search-atlaskit-components/search-atlaskit-components-tool';
+import { listSearchAtlaskitHooksTool } from './tools/search-atlaskit-hooks/list-search-atlaskit-hooks-tool';
+import { searchAtlaskitHooksInputSchema } from './tools/search-atlaskit-hooks/search-atlaskit-hooks-input-schema';
+import { searchAtlaskitHooksTool } from './tools/search-atlaskit-hooks/search-atlaskit-hooks-tool';
+import { listSearchAtlaskitUtilitiesTool } from './tools/search-atlaskit-utilities/list-search-atlaskit-utilities-tool';
+import { searchAtlaskitUtilitiesInputSchema } from './tools/search-atlaskit-utilities/search-atlaskit-utilities-input-schema';
+import { searchAtlaskitUtilitiesTool } from './tools/search-atlaskit-utilities/search-atlaskit-utilities-tool';
 import { listSearchComponentsTool } from './tools/search-components/list-search-components-tool';
 import { searchComponentsInputSchema } from './tools/search-components/search-components-input-schema';
 import { searchComponentsTool } from './tools/search-components/search-components-tool';
@@ -167,6 +177,26 @@ export const getToolRegistry = () => {
       handler: searchAtlaskitComponentsTool,
       inputSchema: searchAtlaskitComponentsInputSchema,
       tool: listSearchAtlaskitComponentsTool
+    },
+    [listGetAtlaskitUtilitiesTool.name]: {
+      handler: getAtlaskitUtilitiesTool,
+      inputSchema: null,
+      tool: listGetAtlaskitUtilitiesTool
+    },
+    [listSearchAtlaskitUtilitiesTool.name]: {
+      handler: searchAtlaskitUtilitiesTool,
+      inputSchema: searchAtlaskitUtilitiesInputSchema,
+      tool: listSearchAtlaskitUtilitiesTool
+    },
+    [listGetAtlaskitHooksTool.name]: {
+      handler: getAtlaskitHooksTool,
+      inputSchema: null,
+      tool: listGetAtlaskitHooksTool
+    },
+    [listSearchAtlaskitHooksTool.name]: {
+      handler: searchAtlaskitHooksTool,
+      inputSchema: searchAtlaskitHooksInputSchema,
+      tool: listSearchAtlaskitHooksTool
     }
   };
   return registry;