@atlaskit/ads-mcp 1.0.0 → 1.2.0

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

@@ -0,0 +1,102 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import Fuse from 'fuse.js';
+import { cleanQuery, mergeMultiTermFuseResults } from '../../helpers';
+import { atlaskitHooks } from '../get-atlaskit-hooks/atlaskit-hooks.codegen';
+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
+  };
+};
+export var searchAtlaskitHooksTool = /*#__PURE__*/function () {
+  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, hooks, fuse, matchedItems;
+    return _regeneratorRuntime.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 = _toConsumableArray(new Set(terms.filter(Boolean).map(cleanQuery)));
+          if (searchTerms.length) {
+            _context.next = 1;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: '[]'
+            }]
+          });
+        case 1:
+          hooks = atlaskitHooks;
+          fuse = new Fuse(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 = 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/esm/tools/search-atlaskit-utilities/list-search-atlaskit-utilities-tool.js

@@ -0,0 +1,16 @@
+/* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
+
+import { zodToJsonSchema } from '../../helpers';
+import { searchAtlaskitUtilitiesInputSchema } from './search-atlaskit-utilities-input-schema';
+export var 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: zodToJsonSchema(searchAtlaskitUtilitiesInputSchema)
+};

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

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export var searchAtlaskitUtilitiesInputSchema = z.object({
+  terms: z.array(z.string()).describe('Required: one or more search terms (fuzzy over name, package, category, description, keywords, usageGuidelines). Example: `["debounce", "a11y", "storage"]`.'),
+  limit: z.number().default(2).describe('Max matches **per term** (default 2).').optional()
+});

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

@@ -0,0 +1,106 @@
+import _toConsumableArray from "@babel/runtime/helpers/toConsumableArray";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+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) { _defineProperty(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 */
+
+import Fuse from 'fuse.js';
+import { cleanQuery, mergeMultiTermFuseResults } from '../../helpers';
+import { atlaskitUtilities } from '../get-atlaskit-utilities/atlaskit-utilities.codegen';
+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
+  } : {});
+};
+export var searchAtlaskitUtilitiesTool = /*#__PURE__*/function () {
+  var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(_ref) {
+    var terms, _ref$limit, limit, searchTerms, utilities, fuse, matchedItems;
+    return _regeneratorRuntime.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 = _toConsumableArray(new Set(terms.filter(Boolean).map(cleanQuery)));
+          if (searchTerms.length) {
+            _context.next = 1;
+            break;
+          }
+          return _context.abrupt("return", {
+            content: [{
+              type: 'text',
+              text: '[]'
+            }]
+          });
+        case 1:
+          utilities = atlaskitUtilities;
+          fuse = new Fuse(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 = 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/types/tools/get-all-components/components.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Structured content components from design-system *.docs.tsx files
  *
- * @codegen <<SignedSource::f011ef2e44bcfe53ddd263aceed05794>>
+ * @codegen <<SignedSource::5de3314ebec8c2ace33afef70122e6bd>>
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:ads-components
  */
 import type { ComponentMcpPayload } from './types';

package/dist/types/tools/get-all-components/types.d.ts

@@ -1,4 +1,5 @@
-export type ComponentStatus = 'release-candidate' | 'early-access' | 'open-beta' | 'general-availability' | 'intent-to-deprecate' | 'deprecated' | 'unmaintained';
+import { type Status } from '../types';
+export type ComponentStatus = Status;
 export type ComponentProps = {
     name: string;
     type: string;

package/dist/types/tools/get-atlaskit-components/atlaskit-components.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Structured content components from design-system *.docs.tsx files
  *
- * @codegen <<SignedSource::bd5b86ae65b6b9e48b637d6a463db4f9>>
+ * @codegen <<SignedSource::c074026b3760583a882b411542329528>>
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:atlaskit-components
  */
 import type { ComponentMcpPayload } from '../get-all-components/types';

package/dist/types/tools/get-atlaskit-hooks/atlaskit-hooks.codegen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Structured content hooks from design-system *.docs.tsx files
+ *
+ * @codegen <<SignedSource::54db052ad53f695704ea4e9666a1ee4d>>
+ * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:atlaskit-hooks
+ */
+import type { HookMcpPayload } from './types';
+export declare const atlaskitHooks: HookMcpPayload[];

package/dist/types/tools/get-atlaskit-hooks/get-atlaskit-hooks-tool.d.ts

@@ -0,0 +1,6 @@
+export declare const getAtlaskitHooksTool: () => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types/tools/get-atlaskit-hooks/list-get-atlaskit-hooks-tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const listGetAtlaskitHooksTool: Tool;

package/dist/types/tools/get-atlaskit-hooks/types.d.ts

@@ -0,0 +1,14 @@
+import { type DocsParameter, type DocsReturns, type Status } from '../types';
+export type HookMcpPayload = {
+    name: string;
+    description: string;
+    status: Status;
+    usageGuidelines?: string[];
+    accessibilityGuidelines?: string[];
+    keywords: string[];
+    category?: string;
+    package: string;
+    examples: string[];
+    parameters?: DocsParameter[];
+    returns?: DocsReturns;
+};

package/dist/types/tools/get-atlaskit-utilities/atlaskit-utilities.codegen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
+ *
+ * Structured content utilities from design-system *.docs.tsx files
+ *
+ * @codegen <<SignedSource::5377d3666260be828ea690f4b3ef04b7>>
+ * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:atlaskit-utilities
+ */
+import type { UtilityMcpPayload } from './types';
+export declare const atlaskitUtilities: UtilityMcpPayload[];

package/dist/types/tools/get-atlaskit-utilities/get-atlaskit-utilities-tool.d.ts

@@ -0,0 +1,6 @@
+export declare const getAtlaskitUtilitiesTool: () => Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;

package/dist/types/tools/get-atlaskit-utilities/list-get-atlaskit-utilities-tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const listGetAtlaskitUtilitiesTool: Tool;

package/dist/types/tools/get-atlaskit-utilities/types.d.ts

@@ -0,0 +1,41 @@
+import { type DocsParameter, type DocsReturns, type Status } from '../types';
+export type UtilityMcpPayload = {
+    kind: 'function';
+    name: string;
+    description: string;
+    status: Status;
+    usageGuidelines?: string[];
+    accessibilityGuidelines?: string[];
+    keywords: string[];
+    category?: string;
+    package: string;
+    examples: string[];
+    parameters?: DocsParameter[];
+    returns?: DocsReturns;
+    signature?: string;
+} | {
+    kind: 'constant';
+    name: string;
+    description: string;
+    status: Status;
+    usageGuidelines?: string[];
+    accessibilityGuidelines?: string[];
+    keywords: string[];
+    category?: string;
+    package: string;
+    examples: string[];
+    type?: string;
+    value?: string;
+} | {
+    kind: 'type';
+    name: string;
+    description: string;
+    status: Status;
+    usageGuidelines?: string[];
+    accessibilityGuidelines?: string[];
+    keywords: string[];
+    category?: string;
+    package: string;
+    examples: string[];
+    definition?: string;
+};

package/dist/types/tools/get-guidelines/guidelines-structured-content.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Structured content for content guidelines from design-system-docs foundations content.
  *
- * @codegen <<SignedSource::172be2830ddae4adfd4b9c4a11d5b54a>>
+ * @codegen <<SignedSource::613be582db295e634b62c0f119c15494>>
  * @codegenCommand yarn build structured-docs
  */
 export interface GuidelineStructuredContent {

package/dist/types/tools/get-lint-rules/lint-rules-structured-content.codegen.d.ts

@@ -3,7 +3,7 @@
  *
  * Structured content for MCP (JSON) for ESLint rule docs from constellation.
  *
- * @codegen <<SignedSource::ec87e0b1e121242b7bd900e58c42ea14>>
+ * @codegen <<SignedSource::ef9c19eed4e720ce7570ee24935c3476>>
  * @codegenCommand yarn build structured-docs
  */
 export interface LintRuleStructuredContent {

package/dist/types/tools/search-atlaskit-hooks/list-search-atlaskit-hooks-tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const listSearchAtlaskitHooksTool: Tool;

package/dist/types/tools/search-atlaskit-hooks/search-atlaskit-hooks-input-schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const searchAtlaskitHooksInputSchema: z.ZodObject<{
+    terms: z.ZodArray<z.ZodString, 'many'>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, 'strip', z.ZodTypeAny, {
+    terms: string[];
+    limit?: number | undefined;
+}, {
+    terms: string[];
+    limit?: number | undefined;
+}>;

package/dist/types/tools/search-atlaskit-hooks/search-atlaskit-hooks-tool.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type z } from 'zod';
+import type { searchAtlaskitHooksInputSchema } from './search-atlaskit-hooks-input-schema';
+export declare const searchAtlaskitHooksTool: ({ terms, limit, }: z.infer<typeof searchAtlaskitHooksInputSchema>) => Promise<CallToolResult>;

package/dist/types/tools/search-atlaskit-utilities/list-search-atlaskit-utilities-tool.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const listSearchAtlaskitUtilitiesTool: Tool;

package/dist/types/tools/search-atlaskit-utilities/search-atlaskit-utilities-input-schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export declare const searchAtlaskitUtilitiesInputSchema: z.ZodObject<{
+    terms: z.ZodArray<z.ZodString, 'many'>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, 'strip', z.ZodTypeAny, {
+    terms: string[];
+    limit?: number | undefined;
+}, {
+    terms: string[];
+    limit?: number | undefined;
+}>;

package/dist/types/tools/search-atlaskit-utilities/search-atlaskit-utilities-tool.d.ts

@@ -0,0 +1,4 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type z } from 'zod';
+import type { searchAtlaskitUtilitiesInputSchema } from './search-atlaskit-utilities-input-schema';
+export declare const searchAtlaskitUtilitiesTool: ({ terms, limit, }: z.infer<typeof searchAtlaskitUtilitiesInputSchema>) => Promise<CallToolResult>;

package/dist/types/tools/types.d.ts

@@ -0,0 +1,12 @@
+export type Status = 'release-candidate' | 'early-access' | 'open-beta' | 'general-availability' | 'intent-to-deprecate' | 'deprecated' | 'unmaintained';
+export type DocsParameter = {
+    name: string;
+    type: string;
+    description?: string;
+    defaultValue?: string;
+    isOptional?: boolean;
+};
+export type DocsReturns = {
+    type: string;
+    description?: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/ads-mcp",
-	"version": "1.0.0",
+	"version": "1.2.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",
@@ -22,9 +22,9 @@
 	"atlaskit:src": "src/index.tsx",
 	"dependencies": {
 		"@atlaskit/icon": "^36.0.0",
-		"@atlaskit/icon-lab": "^7.0.0",
+		"@atlaskit/icon-lab": "^7.1.0",
 		"@atlaskit/platform-feature-flags": "^2.0.0",
-		"@atlaskit/tokens": "^14.0.0",
+		"@atlaskit/tokens": "^15.0.0",
 		"@axe-core/playwright": "^4.11.1",
 		"@axe-core/puppeteer": "^4.11.1",
 		"@babel/runtime": "^7.0.0",