@atlaskit/ads-mcp 0.17.1 → 0.17.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (88) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +88 -0
  3. package/dist/cjs/index.js +19 -40
  4. package/dist/cjs/tools/get-all-icons/icons.js +43 -0
  5. package/dist/cjs/tools/get-all-icons/index.js +4 -19
  6. package/dist/cjs/tools/get-all-tokens/index.js +3 -6
  7. package/dist/cjs/tools/get-all-tokens/tokens.js +18 -0
  8. package/dist/cjs/tools/get-components/components.codegen.js +8 -0
  9. package/dist/cjs/tools/get-components/components.js +423 -235
  10. package/dist/cjs/tools/get-components/index.js +2 -2
  11. package/dist/cjs/tools/get-components/load-all-components.js +16 -0
  12. package/dist/cjs/tools/get-guidelines/guidelines-structured-content.codegen.js +72 -6
  13. package/dist/cjs/tools/get-lint-rules/lint-rules-structured-content.codegen.js +111 -7
  14. package/dist/cjs/tools/search-components/index.js +13 -12
  15. package/dist/cjs/tools/search-icons/index.js +7 -24
  16. package/dist/es2019/index.js +13 -31
  17. package/dist/es2019/tools/get-all-icons/icons.js +25 -0
  18. package/dist/es2019/tools/get-all-icons/index.js +1 -10
  19. package/dist/es2019/tools/get-all-tokens/index.js +2 -5
  20. package/dist/es2019/tools/get-all-tokens/tokens.js +13 -0
  21. package/dist/es2019/tools/get-components/components.codegen.js +8 -0
  22. package/dist/es2019/tools/get-components/components.js +423 -235
  23. package/dist/es2019/tools/get-components/index.js +11 -9
  24. package/dist/es2019/tools/get-components/load-all-components.js +10 -0
  25. package/dist/es2019/tools/get-guidelines/guidelines-structured-content.codegen.js +72 -6
  26. package/dist/es2019/tools/get-lint-rules/lint-rules-structured-content.codegen.js +111 -7
  27. package/dist/es2019/tools/search-components/index.js +2 -1
  28. package/dist/es2019/tools/search-icons/index.js +1 -10
  29. package/dist/esm/index.js +19 -40
  30. package/dist/esm/tools/get-all-icons/icons.js +37 -0
  31. package/dist/esm/tools/get-all-icons/index.js +3 -18
  32. package/dist/esm/tools/get-all-tokens/index.js +2 -5
  33. package/dist/esm/tools/get-all-tokens/tokens.js +13 -0
  34. package/dist/esm/tools/get-components/components.codegen.js +8 -0
  35. package/dist/esm/tools/get-components/components.js +423 -235
  36. package/dist/esm/tools/get-components/index.js +2 -2
  37. package/dist/esm/tools/get-components/load-all-components.js +10 -0
  38. package/dist/esm/tools/get-guidelines/guidelines-structured-content.codegen.js +72 -6
  39. package/dist/esm/tools/get-lint-rules/lint-rules-structured-content.codegen.js +111 -7
  40. package/dist/esm/tools/search-components/index.js +9 -8
  41. package/dist/esm/tools/search-icons/index.js +3 -20
  42. package/dist/types/tools/get-all-icons/icons.d.ts +11 -0
  43. package/dist/types/tools/get-all-tokens/tokens.d.ts +7 -0
  44. package/dist/types/tools/get-components/components.codegen.d.ts +10 -0
  45. package/dist/types/tools/get-components/components.d.ts +1 -1
  46. package/dist/types/tools/get-components/load-all-components.d.ts +2 -0
  47. package/dist/types/tools/get-components/types.d.ts +20 -14
  48. package/dist/types/tools/get-guidelines/guidelines-structured-content.codegen.d.ts +1 -1
  49. package/dist/types/tools/get-lint-rules/lint-rules-structured-content.codegen.d.ts +1 -1
  50. package/dist/types-ts4.5/tools/get-all-icons/icons.d.ts +11 -0
  51. package/dist/types-ts4.5/tools/get-all-tokens/tokens.d.ts +7 -0
  52. package/dist/types-ts4.5/tools/get-components/components.codegen.d.ts +10 -0
  53. package/dist/types-ts4.5/tools/get-components/components.d.ts +1 -1
  54. package/dist/types-ts4.5/tools/get-components/load-all-components.d.ts +2 -0
  55. package/dist/types-ts4.5/tools/get-components/types.d.ts +20 -14
  56. package/dist/types-ts4.5/tools/get-guidelines/guidelines-structured-content.codegen.d.ts +1 -1
  57. package/dist/types-ts4.5/tools/get-lint-rules/lint-rules-structured-content.codegen.d.ts +1 -1
  58. package/package.json +5 -3
  59. package/dist/cjs/tools/get-icons/icon-mcp-structured-content.codegen.js +0 -8
  60. package/dist/cjs/tools/get-icons/icon-structured-content.codegen.js +0 -8
  61. package/dist/cjs/tools/get-icons/index.js +0 -135
  62. package/dist/cjs/tools/get-tokens/index.js +0 -125
  63. package/dist/cjs/tools/get-tokens/token-mcp-structured-content.codegen.js +0 -2356
  64. package/dist/cjs/tools/get-tokens/token-structured-content.codegen.js +0 -2356
  65. package/dist/es2019/tools/get-icons/icon-mcp-structured-content.codegen.js +0 -8
  66. package/dist/es2019/tools/get-icons/icon-structured-content.codegen.js +0 -8
  67. package/dist/es2019/tools/get-icons/index.js +0 -110
  68. package/dist/es2019/tools/get-tokens/index.js +0 -100
  69. package/dist/es2019/tools/get-tokens/token-mcp-structured-content.codegen.js +0 -2350
  70. package/dist/es2019/tools/get-tokens/token-structured-content.codegen.js +0 -2350
  71. package/dist/esm/tools/get-icons/icon-mcp-structured-content.codegen.js +0 -8
  72. package/dist/esm/tools/get-icons/icon-structured-content.codegen.js +0 -8
  73. package/dist/esm/tools/get-icons/index.js +0 -128
  74. package/dist/esm/tools/get-tokens/index.js +0 -118
  75. package/dist/esm/tools/get-tokens/token-mcp-structured-content.codegen.js +0 -2350
  76. package/dist/esm/tools/get-tokens/token-structured-content.codegen.js +0 -2350
  77. package/dist/types/tools/get-icons/icon-mcp-structured-content.codegen.d.ts +0 -13
  78. package/dist/types/tools/get-icons/icon-structured-content.codegen.d.ts +0 -13
  79. package/dist/types/tools/get-icons/index.d.ts +0 -35
  80. package/dist/types/tools/get-tokens/index.d.ts +0 -35
  81. package/dist/types/tools/get-tokens/token-mcp-structured-content.codegen.d.ts +0 -13
  82. package/dist/types/tools/get-tokens/token-structured-content.codegen.d.ts +0 -13
  83. package/dist/types-ts4.5/tools/get-icons/icon-mcp-structured-content.codegen.d.ts +0 -13
  84. package/dist/types-ts4.5/tools/get-icons/icon-structured-content.codegen.d.ts +0 -13
  85. package/dist/types-ts4.5/tools/get-icons/index.d.ts +0 -35
  86. package/dist/types-ts4.5/tools/get-tokens/index.d.ts +0 -35
  87. package/dist/types-ts4.5/tools/get-tokens/token-mcp-structured-content.codegen.d.ts +0 -13
  88. package/dist/types-ts4.5/tools/get-tokens/token-structured-content.codegen.d.ts +0 -13
@@ -1,128 +0,0 @@
1
- import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
2
- import _regeneratorRuntime from "@babel/runtime/regenerator";
3
- /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
4
-
5
- import Fuse from 'fuse.js';
6
- import { z } from 'zod';
7
- import { cleanQuery, zodToJsonSchema } from '../../helpers';
8
- import { iconMcpStructuredContent } from './icon-mcp-structured-content.codegen';
9
- export var getIconsInputSchema = z.object({
10
- 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(),
11
- limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
12
- 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()
13
- });
14
- export var listGetIconsTool = {
15
- name: 'ads_get_icons',
16
- 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```",
17
- annotations: {
18
- title: 'Get ADS icons',
19
- readOnlyHint: true,
20
- destructiveHint: false,
21
- idempotentHint: true,
22
- openWorldHint: true
23
- },
24
- inputSchema: zodToJsonSchema(getIconsInputSchema)
25
- };
26
- export var getIconsTool = /*#__PURE__*/function () {
27
- var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
28
- var _params$terms, terms, _params$limit, limit, _params$exactName, exactName, searchTerms, iconDocs, _payload, exactNameMatches, _payload2, fuse, results, uniqueResults, matchedIcons, payload;
29
- return _regeneratorRuntime.wrap(function _callee$(_context) {
30
- while (1) switch (_context.prev = _context.next) {
31
- case 0:
32
- _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;
33
- searchTerms = terms.filter(Boolean).map(cleanQuery);
34
- iconDocs = iconMcpStructuredContent.filter(function (icon) {
35
- return icon.status === 'published';
36
- }); // If no search terms provided, return all icons as JSON array
37
- if (!(searchTerms.length === 0)) {
38
- _context.next = 6;
39
- break;
40
- }
41
- _payload = iconDocs.map(function (icon) {
42
- return icon.content;
43
- });
44
- return _context.abrupt("return", {
45
- content: [{
46
- type: 'text',
47
- text: JSON.stringify(_payload)
48
- }]
49
- });
50
- case 6:
51
- if (!exactName) {
52
- _context.next = 10;
53
- break;
54
- }
55
- // for each search term, search for the exact match
56
- exactNameMatches = searchTerms.map(function (term) {
57
- return iconDocs.find(function (icon) {
58
- return icon.componentName.toLowerCase() === term.toLowerCase();
59
- });
60
- }).filter(function (icon) {
61
- return icon !== undefined;
62
- }); // Return exact matches if found, or empty result if exactName is true
63
- _payload2 = exactNameMatches.length === 1 ? exactNameMatches[0].content : exactNameMatches.map(function (icon) {
64
- return icon.content;
65
- });
66
- return _context.abrupt("return", {
67
- content: [{
68
- type: 'text',
69
- text: JSON.stringify(_payload2)
70
- }]
71
- });
72
- case 10:
73
- // use Fuse.js to fuzzy-search for the icons
74
- fuse = new Fuse(iconDocs, {
75
- keys: [{
76
- name: 'componentName',
77
- weight: 3
78
- }, {
79
- name: 'keywords',
80
- weight: 2
81
- }, {
82
- name: 'categorization',
83
- weight: 1
84
- }, {
85
- name: 'usage',
86
- weight: 1
87
- }],
88
- threshold: 0.4
89
- });
90
- results = searchTerms.map(function (term) {
91
- // always search exact match from the icons
92
- var exactNameMatch = iconDocs.find(function (icon) {
93
- return icon.componentName.toLowerCase() === term.toLowerCase();
94
- });
95
- if (exactNameMatch) {
96
- return [{
97
- item: exactNameMatch
98
- }];
99
- }
100
- return fuse.search(term).slice(0, limit);
101
- }).flat(); // Remove duplicates based on componentName
102
- uniqueResults = results.filter(function (result, index, arr) {
103
- return arr.findIndex(function (r) {
104
- return r.item.componentName === result.item.componentName;
105
- }) === index;
106
- });
107
- matchedIcons = uniqueResults.map(function (result) {
108
- return result.item;
109
- });
110
- payload = matchedIcons.length === 1 ? matchedIcons[0].content : matchedIcons.map(function (icon) {
111
- return icon.content;
112
- });
113
- return _context.abrupt("return", {
114
- content: [{
115
- type: 'text',
116
- text: JSON.stringify(payload)
117
- }]
118
- });
119
- case 16:
120
- case "end":
121
- return _context.stop();
122
- }
123
- }, _callee);
124
- }));
125
- return function getIconsTool(_x) {
126
- return _ref.apply(this, arguments);
127
- };
128
- }();
@@ -1,118 +0,0 @@
1
- import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
2
- import _regeneratorRuntime from "@babel/runtime/regenerator";
3
- /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
4
-
5
- import Fuse from 'fuse.js';
6
- import { z } from 'zod';
7
- import { cleanQuery, zodToJsonSchema } from '../../helpers';
8
- import { tokenMcpStructuredContent } from './token-mcp-structured-content.codegen';
9
- export var getTokensInputSchema = z.object({
10
- 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(),
11
- limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
12
- exactName: z.boolean().default(false).describe('Enable to explicitly search tokens by the exact name match (when you know the name, but need more details)').optional()
13
- });
14
- export var listGetTokensTool = {
15
- name: 'ads_get_tokens',
16
- description: "Get Atlassian Design System tokens with optional search functionality.\n\n- If search parameters are provided, searches for tokens matching the criteria.\n- If no search parameters are provided, returns all tokens.\n\nExample token usage:\n```tsx\nimport { token } from '@atlaskit/tokens';\nconst styles = css({ color: token('color.text'), padding: token('space.100') });\n```",
17
- annotations: {
18
- title: 'Get ADS tokens',
19
- readOnlyHint: true,
20
- destructiveHint: false,
21
- idempotentHint: true,
22
- openWorldHint: true
23
- },
24
- inputSchema: zodToJsonSchema(getTokensInputSchema)
25
- };
26
- export var getTokensTool = /*#__PURE__*/function () {
27
- var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
28
- var _params$terms, terms, _params$limit, limit, _params$exactName, exactName, searchTerms, tokenDocs, _payload, exactNameMatches, _payload2, fuse, results, uniqueResults, matchedTokens, payload;
29
- return _regeneratorRuntime.wrap(function _callee$(_context) {
30
- while (1) switch (_context.prev = _context.next) {
31
- case 0:
32
- _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;
33
- searchTerms = terms.filter(Boolean).map(cleanQuery);
34
- tokenDocs = tokenMcpStructuredContent; // If no search terms provided, return all tokens as JSON array
35
- if (!(searchTerms.length === 0)) {
36
- _context.next = 6;
37
- break;
38
- }
39
- _payload = tokenDocs.map(function (token) {
40
- return token.content;
41
- });
42
- return _context.abrupt("return", {
43
- content: [{
44
- type: 'text',
45
- text: JSON.stringify(_payload)
46
- }]
47
- });
48
- case 6:
49
- if (!exactName) {
50
- _context.next = 11;
51
- break;
52
- }
53
- // for each search term, search for the exact match
54
- exactNameMatches = searchTerms.map(function (term) {
55
- return tokenDocs.find(function (token) {
56
- return token.name.toLowerCase() === term.toLowerCase();
57
- });
58
- }).filter(function (token) {
59
- return token !== undefined;
60
- });
61
- if (!(exactNameMatches.length > 0)) {
62
- _context.next = 11;
63
- break;
64
- }
65
- _payload2 = exactNameMatches.length === 1 ? exactNameMatches[0].content : exactNameMatches.map(function (token) {
66
- return token.content;
67
- });
68
- return _context.abrupt("return", {
69
- content: [{
70
- type: 'text',
71
- text: JSON.stringify(_payload2)
72
- }]
73
- });
74
- case 11:
75
- // use Fuse.js to fuzzy-search for the tokens
76
- fuse = new Fuse(tokenDocs, {
77
- keys: [{
78
- name: 'name',
79
- weight: 3
80
- }, {
81
- name: 'description',
82
- weight: 2
83
- }, {
84
- name: 'exampleValue',
85
- weight: 1
86
- }],
87
- threshold: 0.4
88
- });
89
- results = searchTerms.map(function (term) {
90
- return fuse.search(term).slice(0, limit);
91
- }).flat(); // Remove duplicates based on token name
92
- uniqueResults = results.filter(function (result, index, arr) {
93
- return arr.findIndex(function (r) {
94
- return r.item.name === result.item.name;
95
- }) === index;
96
- });
97
- matchedTokens = uniqueResults.map(function (result) {
98
- return result.item;
99
- });
100
- payload = matchedTokens.length === 1 ? matchedTokens[0].content : matchedTokens.map(function (token) {
101
- return token.content;
102
- });
103
- return _context.abrupt("return", {
104
- content: [{
105
- type: 'text',
106
- text: JSON.stringify(payload)
107
- }]
108
- });
109
- case 17:
110
- case "end":
111
- return _context.stop();
112
- }
113
- }, _callee);
114
- }));
115
- return function getTokensTool(_x) {
116
- return _ref.apply(this, arguments);
117
- };
118
- }();