@atlaskit/ads-mcp 0.20.2 → 0.20.4

package/dist/cjs/tools/migration-guides/migrations/onboarding-with-motion.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.onboardingWithMotion = void 0;
+var additionalResources = 'Visit https://hello.atlassian.net/wiki/spaces/DST/pages/6069774593 or https://atlassian.design/components/spotlight for more context';
+var onboardingWithMotion = exports.onboardingWithMotion = {
+  id: 'motion',
+  title: 'Single Step Spotlight with Motion Migration',
+  description: 'Migrate a single step spotlight with entrance animation from @atlaskit/onboarding to @atlaskit/spotlight using @atlaskit/motion',
+  fromPackage: '@atlaskit/onboarding',
+  toPackage: '@atlaskit/spotlight',
+  examples: [{
+    title: 'Migrate spotlight with transition animation',
+    description: 'Replace SpotlightTransition with FadeIn from @atlaskit/motion wrapped around the SpotlightCard',
+    before: "import React, { useState } from 'react';\nimport Button from '@atlaskit/button/new';\nimport {\n  Spotlight,\n  SpotlightManager,\n  SpotlightTarget,\n  SpotlightTransition,\n} from '@atlaskit/onboarding';\n\nconst OnboardingSpotlightWithTransition = () => {\n  const [isSpotlightActive, setIsSpotlightActive] = useState(false);\n  const start = () => setIsSpotlightActive(true);\n  const end = () => setIsSpotlightActive(false);\n\n  return (\n    <SpotlightManager>\n      <SpotlightTarget name=\"my-target\">\n        <Button>Target Element</Button>\n      </SpotlightTarget>\n      <div>\n        <Button appearance=\"primary\" onClick={start}>\n          Show spotlight\n        </Button>\n      </div>\n      <SpotlightTransition>\n        {isSpotlightActive && (\n          <Spotlight\n            actions={[\n              {\n                onClick: end,\n                text: 'Got it',\n              },\n            ]}\n            heading=\"Feature Heading\"\n            target=\"my-target\"\n            key=\"my-target\"\n          >\n            This is the spotlight body content describing the feature.\n          </Spotlight>\n        )}\n      </SpotlightTransition>\n    </SpotlightManager>\n  );\n};",
+    after: "import React, { useState } from 'react';\nimport Button from '@atlaskit/button/new';\nimport { FadeIn } from '@atlaskit/motion';\nimport { Text } from '@atlaskit/primitives/compiled';\nimport {\n  PopoverContent,\n  PopoverProvider,\n  PopoverTarget,\n  SpotlightActions,\n  SpotlightBody,\n  SpotlightCard,\n  SpotlightControls,\n  SpotlightDismissControl,\n  SpotlightFooter,\n  SpotlightHeader,\n  SpotlightHeadline,\n  SpotlightPrimaryAction,\n} from '@atlaskit/spotlight';\n\nconst SpotlightWithMotion = () => {\n  const [isVisible, setIsVisible] = useState(false);\n  const dismiss = () => setIsVisible(false);\n  const done = () => setIsVisible(false);\n\n  return (\n    <PopoverProvider>\n      <PopoverTarget>\n        <Button onClick={() => setIsVisible(true)}>Target Element</Button>\n      </PopoverTarget>\n      <PopoverContent done={done} dismiss={dismiss} placement=\"bottom-start\" isVisible={isVisible}>\n        <FadeIn entranceDirection=\"left\">\n          {(props) => (\n            <div {...props}>\n              <SpotlightCard>\n                <SpotlightHeader>\n                  <SpotlightHeadline>Feature Heading</SpotlightHeadline>\n                  <SpotlightControls>\n                    <SpotlightDismissControl />\n                  </SpotlightControls>\n                </SpotlightHeader>\n                <SpotlightBody>\n                  <Text>This is the spotlight body content describing the feature.</Text>\n                </SpotlightBody>\n                <SpotlightFooter>\n                  <SpotlightActions>\n                    <SpotlightPrimaryAction onClick={done}>Got it</SpotlightPrimaryAction>\n                  </SpotlightActions>\n                </SpotlightFooter>\n              </SpotlightCard>\n            </div>\n          )}\n        </FadeIn>\n      </PopoverContent>\n    </PopoverProvider>\n  );\n};",
+    explanation: "Key changes when migrating a spotlight with transition animation:\n- Replace SpotlightTransition with FadeIn from @atlaskit/motion\n- Import FadeIn from '@atlaskit/motion' instead of SpotlightTransition from '@atlaskit/onboarding'\n- FadeIn uses a render props pattern - wrap content in {(props) => <div {...props}>...</div>}\n- The entranceDirection prop controls animation direction: 'left', 'right', 'top', or 'bottom'\n- All other migration changes from single step spotlight apply (PopoverProvider, compositional components, etc.)"
+  }],
+  bestPractices: ['Choose entranceDirection based on spotlight placement (e.g., "left" for right-placed spotlights)', 'Motion is optional - only add if the original onboarding spotlight used SpotlightTransition for entrance effects'],
+  additionalResources: additionalResources
+};

package/dist/cjs/tools/plan/list-plan-tool.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listPlanTool = void 0;
+var _zodToJsonSchema = require("../../helpers/zod-to-json-schema");
+var _planInputSchema = require("./plan-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listPlanTool = exports.listPlanTool = {
+  name: 'ads_plan',
+  description: "Runs **ads_search_tokens**, **ads_search_icons**, **ads_search_components**, and **ads_search_atlaskit_components** in one call and returns a single JSON payload (each section only if that list was non-empty). Use this as the default way to discover ADS **tokens**, **icons**, and **components** (including legacy/broader Atlaskit) for a UI task.\n\nWHEN TO USE:\n**Implementing or iterating on a UI**\u2014new screen, feature, or polish\u2014and you need candidate **token** names, **icon** imports, and **component** packages/props in one pass. Also use when exploring ADS building blocks before you write code.\n\nAt least one of `tokens`, `icons`, `components`, or `atlaskitComponents` must contain search terms (use `[]` for lists you do not need).\n\nPrefer supplying **multiple** terms per non-empty array when you know them\u2014broader queries improve recall. Some queries return no rows where metadata is thin; try alternate wording.\n\nThis is equivalent to calling the individual search tools; there are no extra merge semantics beyond concatenating results.\n\nExample request:\n```json\n{\n\t\"tokens\": [\"spacing\", \"inverted text\", \"background primary\", \"animation\"],\n\t\"icons\": [\"search\", \"folder\", \"user\"],\n\t\"components\": [\"button\", \"input\", \"select\", \"heading\"],\n\t\"atlaskitComponents\": [\"inline-dialog\", \"onboarding\", \"page-layout\"]\n}\n```\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
+  annotations: {
+    title: 'Search ADS tokens, icons, and components to plan what to build',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_planInputSchema.planInputSchema)
+};

package/dist/cjs/tools/plan/plan-input-schema.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.planInputSchema = void 0;
+var _zod = require("zod");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var planInputSchema = exports.planInputSchema = _zod.z.object({
+  tokens: _zod.z.array(_zod.z.string()).describe('Search terms for ADS design tokens (fuzzy by default). Use `[]` if you only need icons or components. Prefer **at least two** terms per non-empty list when you know what you need.'),
+  icons: _zod.z.array(_zod.z.string()).describe('Search terms for ADS icons. Use `[]` if you only need tokens or components. Prefer **at least two** terms per non-empty list when known.'),
+  components: _zod.z.array(_zod.z.string()).describe('Search terms for ADS components. Use `[]` if you only need tokens or icons. Prefer **at least two** terms per non-empty list when known.'),
+  atlaskitComponents: _zod.z.array(_zod.z.string()).describe('Search terms for Atlaskit components. Use `[]` if you only need core ADS components. Prefer **at least two** terms per non-empty list when known.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** for each non-empty list (default 2). Same limit applies to tokens, icons, and both ADS and atlaskit component searches.').optional()
+});

package/dist/cjs/tools/plan/{index.js → plan-tool.js}

@@ -4,43 +4,24 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.planTool = exports.planInputSchema = exports.listPlanTool = void 0;
+exports.planTool = void 0;
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
-var _zod = require("zod");
-var _helpers = require("../../helpers");
-var _searchComponents = require("../search-components");
-var _searchIcons = require("../search-icons");
-var _searchTokens = require("../search-tokens");
+var _searchAtlaskitComponentsTool = require("../search-atlaskit-components/search-atlaskit-components-tool");
+var _searchComponentsTool = require("../search-components/search-components-tool");
+var _searchIconsTool = require("../search-icons/search-icons-tool");
+var _searchTokensTool = require("../search-tokens/search-tokens-tool");
 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 planInputSchema = exports.planInputSchema = _zod.z.object({
-  tokens: _zod.z.array(_zod.z.string()).describe('Search terms for ADS design tokens (fuzzy by default). Use `[]` if you only need icons or components. Prefer **at least two** terms per non-empty list when you know what you need.'),
-  icons: _zod.z.array(_zod.z.string()).describe('Search terms for ADS icons. Use `[]` if you only need tokens or components. Prefer **at least two** terms per non-empty list when known.'),
-  components: _zod.z.array(_zod.z.string()).describe('Search terms for ADS components. Use `[]` if you only need tokens or icons. Prefer **at least two** terms per non-empty list when known.'),
-  limit: _zod.z.number().default(2).describe('Max matches **per term** for each non-empty list (default 2). Same limit applies to tokens, icons, and components searches.').optional()
-});
-var listPlanTool = exports.listPlanTool = {
-  name: 'ads_plan',
-  description: "Runs **ads_search_tokens**, **ads_search_icons**, and **ads_search_components** in one call and returns a single JSON payload (each section only if that list was non-empty). Use this as the default way to discover ADS **tokens**, **icons**, and **components** for a UI task.\n\nWHEN TO USE:\n**Implementing or iterating on a UI**\u2014new screen, feature, or polish\u2014and you need candidate **token** names, **icon** imports, and **component** packages/props in one pass. Also use when exploring ADS building blocks before you write code.\n\nAt least one of `tokens`, `icons`, or `components` must contain search terms (use `[]` for lists you do not need).\n\nPrefer supplying **multiple** terms per non-empty array when you know them\u2014broader queries improve recall. Some queries return no rows where metadata is thin; try alternate wording.\n\nThis is equivalent to calling the individual search tools; there are no extra merge semantics beyond concatenating results.\n\nExample request:\n```json\n{\n\t\"tokens\": [\"spacing\", \"inverted text\", \"background primary\", \"animation\"],\n\t\"icons\": [\"search\", \"folder\", \"user\"],\n\t\"components\": [\"button\", \"input\", \"select\", \"heading\"]\n}\n```\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
-  annotations: {
-    title: 'Search ADS tokens, icons, and components to plan what to build',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: (0, _helpers.zodToJsonSchema)(planInputSchema)
-};
 var planTool = exports.planTool = /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
-    var tokens_search, icons_search, components_search, limit, results, searchPromises, getResultCount, consolidatedResult;
+    var tokens_search, icons_search, components_search, atlaskit_components_search, limit, results, searchPromises, getResultCount, consolidatedResult;
     return _regenerator.default.wrap(function _callee$(_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
-          tokens_search = _ref.tokens, icons_search = _ref.icons, components_search = _ref.components, limit = _ref.limit;
-          if (!(!(tokens_search !== null && tokens_search !== void 0 && tokens_search.length) && !(icons_search !== null && icons_search !== void 0 && icons_search.length) && !(components_search !== null && components_search !== void 0 && components_search.length))) {
+          tokens_search = _ref.tokens, icons_search = _ref.icons, components_search = _ref.components, atlaskit_components_search = _ref.atlaskitComponents, limit = _ref.limit;
+          if (!(!(tokens_search !== null && tokens_search !== void 0 && tokens_search.length) && !(icons_search !== null && icons_search !== void 0 && icons_search.length) && !(components_search !== null && components_search !== void 0 && components_search.length) && !(atlaskit_components_search !== null && atlaskit_components_search !== void 0 && atlaskit_components_search.length))) {
             _context.next = 3;
             break;
           }
@@ -48,14 +29,14 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
             isError: true,
             content: [{
               type: 'text',
-              text: 'Error: At least one search type (tokens_search, icons_search, or components_search) must be provided with search terms'
+              text: 'Error: At least one search type (tokens_search, icons_search, components_search, or atlaskit_components_search) must be provided with search terms'
             }]
           });
         case 3:
           results = {}; // Execute searches in parallel
           searchPromises = [];
           if (tokens_search !== null && tokens_search !== void 0 && tokens_search.length) {
-            searchPromises.push((0, _searchTokens.searchTokensTool)({
+            searchPromises.push((0, _searchTokensTool.searchTokensTool)({
               terms: tokens_search,
               limit: limit
             }).then(function (result) {
@@ -63,7 +44,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
             }));
           }
           if (icons_search !== null && icons_search !== void 0 && icons_search.length) {
-            searchPromises.push((0, _searchIcons.searchIconsTool)({
+            searchPromises.push((0, _searchIconsTool.searchIconsTool)({
               terms: icons_search,
               limit: limit
             }).then(function (result) {
@@ -71,18 +52,26 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
             }));
           }
           if (components_search !== null && components_search !== void 0 && components_search.length) {
-            searchPromises.push((0, _searchComponents.searchComponentsTool)({
+            searchPromises.push((0, _searchComponentsTool.searchComponentsTool)({
               terms: components_search,
               limit: limit
             }).then(function (result) {
               results.components = result;
             }));
           }
+          if (atlaskit_components_search !== null && atlaskit_components_search !== void 0 && atlaskit_components_search.length) {
+            searchPromises.push((0, _searchAtlaskitComponentsTool.searchAtlaskitComponentsTool)({
+              terms: atlaskit_components_search,
+              limit: limit
+            }).then(function (result) {
+              results.atlaskitComponents = result;
+            }));
+          }
 
           // Wait for all searches to complete
-          _context.next = 10;
+          _context.next = 11;
           return Promise.all(searchPromises);
-        case 10:
+        case 11:
           // Helper function to safely count results
           getResultCount = function getResultCount(result) {
             var _result$content;
@@ -101,17 +90,20 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
             }
           }; // Format the consolidated results
           consolidatedResult = {
-            searchResults: _objectSpread(_objectSpread(_objectSpread({}, results.tokens && {
+            searchResults: _objectSpread(_objectSpread(_objectSpread(_objectSpread({}, results.tokens && {
               tokens: results.tokens
             }), results.icons && {
               icons: results.icons
             }), results.components && {
               components: results.components
+            }), results.atlaskitComponents && {
+              atlaskitComponents: results.atlaskitComponents
             }),
             summary: {
               tokensFound: getResultCount(results.tokens),
               iconsFound: getResultCount(results.icons),
-              componentsFound: getResultCount(results.components)
+              componentsFound: getResultCount(results.components),
+              atlaskitComponentsFound: getResultCount(results.atlaskitComponents)
             }
           };
           return _context.abrupt("return", {
@@ -120,7 +112,7 @@ var planTool = exports.planTool = /*#__PURE__*/function () {
               text: JSON.stringify(consolidatedResult, null, 2)
             }]
           });
-        case 13:
+        case 14:
         case "end":
           return _context.stop();
       }

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

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listSearchAtlaskitComponentsTool = void 0;
+var _zodToJsonSchema = require("../../helpers/zod-to-json-schema");
+var _searchAtlaskitComponentsInputSchema = require("./search-atlaskit-components-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listSearchAtlaskitComponentsTool = exports.listSearchAtlaskitComponentsTool = {
+  name: 'atlaskit_search_components',
+  description: "Searches the bundled Atlaskit component catalog. Returns JSON objects with **name**, **package**, **examples**, and **props** for each match (trimmed payload).\n\nWHEN TO USE:\n**Selecting which Atlaskit component to use**\u2014package name, examples, and props\u2014before implementation. Use when searching for specific Atlaskit components that might not be in the core ADS catalog.",
+  annotations: {
+    title: 'Search Atlaskit components',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_searchAtlaskitComponentsInputSchema.searchAtlaskitComponentsInputSchema)
+};

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

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

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

@@ -0,0 +1,114 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchAtlaskitComponentsTool = 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 _atlaskitComponents = require("../get-atlaskit-components/atlaskit-components.codegen");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var buildComponentResult = function buildComponentResult(result) {
+  return {
+    name: result.name,
+    package: result.package,
+    examples: result.examples,
+    props: result.props
+  };
+};
+var searchAtlaskitComponentsTool = exports.searchAtlaskitComponentsTool = /*#__PURE__*/function () {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, components, fuse, matchedItems;
+    return _regenerator.default.wrap(function _callee$(_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 = 4;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: '[]'
+            }]
+          });
+        case 4:
+          components = _atlaskitComponents.atlaskitComponents;
+          fuse = new _fuse.default(components, {
+            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
+            }, {
+              name: 'contentGuidelines',
+              weight: 1
+            }, {
+              name: 'accessibilityGuidelines',
+              weight: 1
+            }, {
+              name: 'examples',
+              weight: 1
+            }],
+            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 = 9;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: "Error: No Atlaskit components found for '".concat(terms.join(', '), "'.")
+            }]
+          });
+        case 9:
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: JSON.stringify(matchedItems.map(buildComponentResult))
+            }]
+          });
+        case 10:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function searchAtlaskitComponentsTool(_x) {
+    return _ref2.apply(this, arguments);
+  };
+}();

package/dist/cjs/tools/search-components/list-search-components-tool.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listSearchComponentsTool = void 0;
+var _zodToJsonSchema = require("../../helpers/zod-to-json-schema");
+var _searchComponentsInputSchema = require("./search-components-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listSearchComponentsTool = exports.listSearchComponentsTool = {
+  name: 'ads_search_components',
+  description: "Searches the bundled Atlassian Design System (ADS) component catalog. Returns JSON objects with **name**, **package**, **examples**, and **props** for each match (trimmed payload).\n\nWHEN TO USE:\n**Selecting which ADS component to use**\u2014package name, examples, and props\u2014before implementation. Use when composing a new view or swapping a primitive. Prefer `ads_plan` when you also need token and icon discovery in one shot.",
+  annotations: {
+    title: 'Search ADS components',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_searchComponentsInputSchema.searchComponentsInputSchema)
+};

package/dist/cjs/tools/search-components/search-components-input-schema.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchComponentsInputSchema = void 0;
+var _zod = require("zod");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var searchComponentsInputSchema = exports.searchComponentsInputSchema = _zod.z.object({
+  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, examples). Example: `["button", "modal", "select"]`.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/cjs/tools/search-components/{index.js → search-components-tool.js}

@@ -4,32 +4,16 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.searchComponentsTool = exports.searchComponentsInputSchema = exports.listSearchComponentsTool = void 0;
+exports.searchComponentsTool = 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 _zod = require("zod");
 var _helpers = require("../../helpers");
+var _cleanQuery = require("../../helpers/clean-query");
 var _loadAllComponents = require("../get-all-components/load-all-components");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-var searchComponentsInputSchema = exports.searchComponentsInputSchema = _zod.z.object({
-  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, examples). Example: `["button", "modal", "select"]`.'),
-  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
-});
-var listSearchComponentsTool = exports.listSearchComponentsTool = {
-  name: 'ads_search_components',
-  description: "Searches the bundled Atlassian Design System (ADS) component catalog. Returns JSON objects with **name**, **package**, **examples**, and **props** for each match (trimmed payload).\n\nWHEN TO USE:\n**Selecting which ADS component to use**\u2014package name, examples, and props\u2014before implementation. Use when composing a new view or swapping a primitive. Prefer `ads_plan` when you also need token and icon discovery in one shot.",
-  annotations: {
-    title: 'Search ADS components',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: (0, _helpers.zodToJsonSchema)(searchComponentsInputSchema)
-};
 var buildComponentResult = function buildComponentResult(result) {
   return {
     name: result.name,
@@ -45,7 +29,7 @@ var searchComponentsTool = exports.searchComponentsTool = /*#__PURE__*/function
       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)));
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_cleanQuery.cleanQuery)));
           if (searchTerms.length) {
             _context.next = 4;
             break;

package/dist/cjs/tools/search-icons/list-search-icons-tool.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listSearchIconsTool = void 0;
+var _zodToJsonSchema = require("../../helpers/zod-to-json-schema");
+var _searchIconsInputSchema = require("./search-icons-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listSearchIconsTool = exports.listSearchIconsTool = {
+  name: 'ads_search_icons',
+  description: "Searches the bundled Atlassian Design System **icon** catalog. Returns JSON with **componentName**, **package**, and **usage** for each match.\n\nWHEN TO USE:\n**Choosing an icon** for a control, nav item, empty state, or illustration\u2014find `@atlaskit/icon` import paths and usage notes. Prefer `ads_plan` when you also need tokens and components together.\n\nExample:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
+  annotations: {
+    title: 'Search ADS icons',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_searchIconsInputSchema.searchIconsInputSchema)
+};

package/dist/cjs/tools/search-icons/search-icons-input-schema.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchIconsInputSchema = void 0;
+var _zod = require("zod");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var searchIconsInputSchema = exports.searchIconsInputSchema = _zod.z.object({
+  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more terms; fuzzy match on icon **componentName**, **iconName**, **keywords**, **categorization**, **type**, and **usage**. Example: `["search", "folder", "user"]`.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/cjs/tools/search-icons/{index.js → search-icons-tool.js}

@@ -4,20 +4,16 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.searchIconsTool = exports.searchIconsInputSchema = exports.listSearchIconsTool = void 0;
+exports.searchIconsTool = 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 _zod = require("zod");
 var _helpers = require("../../helpers");
+var _cleanQuery = require("../../helpers/clean-query");
 var _icons = require("../get-all-icons/icons");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-var searchIconsInputSchema = exports.searchIconsInputSchema = _zod.z.object({
-  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more terms; fuzzy match on icon **componentName**, **iconName**, **keywords**, **categorization**, **type**, and **usage**. Example: `["search", "folder", "user"]`.'),
-  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
-});
 var buildIconResult = function buildIconResult(icon) {
   return {
     componentName: icon.componentName,
@@ -25,18 +21,6 @@ var buildIconResult = function buildIconResult(icon) {
     usage: icon.usage
   };
 };
-var listSearchIconsTool = exports.listSearchIconsTool = {
-  name: 'ads_search_icons',
-  description: "Searches the bundled Atlassian Design System **icon** catalog. Returns JSON with **componentName**, **package**, and **usage** for each match.\n\nWHEN TO USE:\n**Choosing an icon** for a control, nav item, empty state, or illustration\u2014find `@atlaskit/icon` import paths and usage notes. Prefer `ads_plan` when you also need tokens and components together.\n\nExample:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
-  annotations: {
-    title: 'Search ADS icons',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: (0, _helpers.zodToJsonSchema)(searchIconsInputSchema)
-};
 var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
     var terms, _ref$limit, limit, searchTerms, fuse, matchedItems;
@@ -44,7 +28,7 @@ var searchIconsTool = exports.searchIconsTool = /*#__PURE__*/function () {
       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)));
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_cleanQuery.cleanQuery)));
           if (searchTerms.length) {
             _context.next = 4;
             break;

package/dist/cjs/tools/search-tokens/list-search-tokens-tool.js

@@ -0,0 +1,22 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.listSearchTokensTool = void 0;
+var _zodToJsonSchema = require("../../helpers/zod-to-json-schema");
+var _searchTokensInputSchema = require("./search-tokens-input-schema");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var listSearchTokensTool = exports.listSearchTokensTool = {
+  name: 'ads_search_tokens',
+  description: "Searches Atlassian Design System **design tokens** from bundled metadata. Returns JSON objects with **name** and **exampleValue** for each match (search also considers description, usage guidelines, and CSS property hints in metadata).\n\nWHEN TO USE:\n**Styling or theming in code**\u2014you need the right `token('\u2026')` names for colors, space, typography, etc. Use during layout and visual work when tokens must match ADS. Prefer `ads_plan` when you also need icons and components in the same step.\n\nExample:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
+  annotations: {
+    title: 'Search ADS tokens',
+    readOnlyHint: true,
+    destructiveHint: false,
+    idempotentHint: true,
+    openWorldHint: true
+  },
+  inputSchema: (0, _zodToJsonSchema.zodToJsonSchema)(_searchTokensInputSchema.searchTokensInputSchema)
+};

package/dist/cjs/tools/search-tokens/search-tokens-input-schema.js

@@ -0,0 +1,13 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.searchTokensInputSchema = void 0;
+var _zod = require("zod");
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+var searchTokensInputSchema = exports.searchTokensInputSchema = _zod.z.object({
+  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more terms; fuzzy match on token **name**, **description**, **exampleValue**, **usageGuidelines.usage**, and **usageGuidelines.cssProperties**. Example: `["spacing", "color.text", "background"]`.'),
+  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

package/dist/cjs/tools/search-tokens/{index.js → search-tokens-tool.js}

@@ -4,32 +4,16 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.searchTokensTool = exports.searchTokensInputSchema = exports.listSearchTokensTool = void 0;
+exports.searchTokensTool = 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 _zod = require("zod");
 var _tokenMetadata = require("@atlaskit/tokens/token-metadata");
 var _helpers = require("../../helpers");
+var _cleanQuery = require("../../helpers/clean-query");
 /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
 
-var searchTokensInputSchema = exports.searchTokensInputSchema = _zod.z.object({
-  terms: _zod.z.array(_zod.z.string()).describe('Required: one or more terms; fuzzy match on token **name**, **description**, **exampleValue**, **usageGuidelines.usage**, and **usageGuidelines.cssProperties**. Example: `["spacing", "color.text", "background"]`.'),
-  limit: _zod.z.number().default(2).describe('Max matches **per term** (default 2).').optional()
-});
-var listSearchTokensTool = exports.listSearchTokensTool = {
-  name: 'ads_search_tokens',
-  description: "Searches Atlassian Design System **design tokens** from bundled metadata. Returns JSON objects with **name** and **exampleValue** for each match (search also considers description, usage guidelines, and CSS property hints in metadata).\n\nWHEN TO USE:\n**Styling or theming in code**\u2014you need the right `token('\u2026')` names for colors, space, typography, etc. Use during layout and visual work when tokens must match ADS. Prefer `ads_plan` when you also need icons and components in the same step.\n\nExample:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
-  annotations: {
-    title: 'Search ADS tokens',
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true
-  },
-  inputSchema: (0, _helpers.zodToJsonSchema)(searchTokensInputSchema)
-};
 var searchTokensTool = exports.searchTokensTool = /*#__PURE__*/function () {
   var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(_ref) {
     var terms, _ref$limit, limit, searchTerms, fuse, matchedItems, matchedTokens;
@@ -38,7 +22,7 @@ var searchTokensTool = exports.searchTokensTool = /*#__PURE__*/function () {
         case 0:
           terms = _ref.terms, _ref$limit = _ref.limit, limit = _ref$limit === void 0 ? 2 : _ref$limit;
           // Unique cleaned terms (order preserved) so duplicates don't concatenate into a bogus query.
-          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_helpers.cleanQuery)));
+          searchTerms = (0, _toConsumableArray2.default)(new Set(terms.filter(Boolean).map(_cleanQuery.cleanQuery)));
           if (searchTerms.length) {
             _context.next = 4;
             break;