@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,33 +1,16 @@
1
1
  import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
2
- import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
3
2
  import _regeneratorRuntime from "@babel/runtime/regenerator";
4
3
  /* eslint-disable-next-line import/extensions -- MCP SDK requires .js extensions for ESM imports */
5
4
 
6
5
  import Fuse from 'fuse.js';
7
6
  import { z } from 'zod';
8
- import { coreIconMetadata } from '@atlaskit/icon/metadata';
9
7
  import { cleanQuery, zodToJsonSchema } from '../../helpers';
8
+ import { icons } from '../get-all-icons/icons';
10
9
  export var searchIconsInputSchema = z.object({
11
10
  terms: z.array(z.string()).describe('An array of search terms to find icons by name, keywords, or categorization, eg. `["search", "folder", "user"]`'),
12
11
  limit: z.number().default(1).describe('Maximum number of results per search term in the array (default: 1)').optional(),
13
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()
14
13
  });
15
- var icons = Object.entries(coreIconMetadata).map(function (_ref) {
16
- var _ref2 = _slicedToArray(_ref, 2),
17
- _key = _ref2[0],
18
- icon = _ref2[1];
19
- return {
20
- componentName: icon.componentName,
21
- package: icon.package,
22
- categorization: icon.categorization,
23
- keywords: icon.keywords,
24
- status: icon.status,
25
- usage: icon.usage,
26
- shouldRecommendSmallIcon: icon.shouldRecommendSmallIcon
27
- };
28
- }).filter(function (icon) {
29
- return icon.status === 'published';
30
- });
31
14
  export var listSearchIconsTool = {
32
15
  name: 'ads_search_icons',
33
16
  description: "Search for Atlassian Design System icons.\n\nExample icon usage:\n```tsx\nimport AddIcon from '@atlaskit/icon/core/add';\n<AddIcon label=\"Add work item\" size=\"small\" />\n```",
@@ -41,7 +24,7 @@ export var listSearchIconsTool = {
41
24
  inputSchema: zodToJsonSchema(searchIconsInputSchema)
42
25
  };
43
26
  export var searchIconsTool = /*#__PURE__*/function () {
44
- var _ref3 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
27
+ var _ref = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(params) {
45
28
  var terms, _params$limit, limit, _params$exactName, exactName, searchTerms, exactNameMatches, fuse, results, uniqueResults, matchedIcons;
46
29
  return _regeneratorRuntime.wrap(function _callee$(_context) {
47
30
  while (1) switch (_context.prev = _context.next) {
@@ -156,6 +139,6 @@ export var searchIconsTool = /*#__PURE__*/function () {
156
139
  }, _callee);
157
140
  }));
158
141
  return function searchIconsTool(_x) {
159
- return _ref3.apply(this, arguments);
142
+ return _ref.apply(this, arguments);
160
143
  };
161
144
  }();
@@ -0,0 +1,11 @@
1
+ export type IconMCPSchema = {
2
+ keywords: string[];
3
+ componentName: string;
4
+ package: string;
5
+ categorization: 'single-purpose' | 'multi-purpose';
6
+ team: string;
7
+ status?: 'draft' | 'ready-to-publish' | 'published' | 'modified' | 'deprecated' | undefined;
8
+ usage?: string | undefined;
9
+ shouldRecommendSmallIcon?: boolean | undefined;
10
+ };
11
+ export declare const icons: IconMCPSchema[];
@@ -0,0 +1,7 @@
1
+ export type TokenMCPSchema = {
2
+ name: string;
3
+ path: string[];
4
+ description: string;
5
+ exampleValue: string;
6
+ };
7
+ export declare const tokens: TokenMCPSchema[];
@@ -0,0 +1,10 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content components from design-system *.docs.tsx files
5
+ *
6
+ * @codegen <<SignedSource::2ac59844fbf026b9d6d9f15c15b0635d>>
7
+ * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:structured-docs-components
8
+ */
9
+ import type { ComponentMcpPayload } from './types';
10
+ export declare const components: ComponentMcpPayload[];
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Generates TypeScript components data for AI tooling from offerings.json files
5
5
  *
6
- * @codegen <<SignedSource::1d781f4539138bf6cabcd8c01b207b06>>
6
+ * @codegen <<SignedSource::8e120a2eb2205e4c89f4bdddbf4e436f>>
7
7
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:prototyping
8
8
  */
9
9
  import type { Component } from './types';
@@ -0,0 +1,2 @@
1
+ import type { ComponentMcpPayload } from './types';
2
+ export declare function loadAllComponents(): ComponentMcpPayload[];
@@ -1,20 +1,26 @@
1
- interface Prop {
1
+ export type ComponentStatus = 'release-candidate' | 'early-access' | 'open-beta' | 'general-availability' | 'intent-to-deprecate' | 'deprecated' | 'unmaintained';
2
+ export type ComponentProps = {
2
3
  name: string;
3
- description: string;
4
4
  type: string;
5
- exampleValue?: string;
6
- }
7
- export interface Component {
5
+ description?: string;
6
+ isRequired?: boolean;
7
+ isDeprecated?: boolean;
8
+ defaultValue?: string;
9
+ };
10
+ export type ComponentMcpPayload = {
8
11
  name: string;
9
- package: `@${'atlaskit' | 'atlassian'}/${string}`;
10
- keywords: string[];
11
- category: string;
12
12
  description: string;
13
- status: string;
14
- examples: string[];
15
- accessibilityGuidelines?: string[];
13
+ status: ComponentStatus;
16
14
  usageGuidelines?: string[];
17
15
  contentGuidelines?: string[];
18
- props?: Prop[];
19
- }
20
- export {};
16
+ accessibilityGuidelines?: string[];
17
+ keywords: string[];
18
+ package: string;
19
+ examples: string[];
20
+ props: ComponentProps[] | undefined;
21
+ category: string;
22
+ };
23
+ /**
24
+ * Re-exported to save rebuilding existing codegen.
25
+ */
26
+ export type Component = ComponentMcpPayload;
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Structured content for content guidelines from design-system-docs foundations content.
5
5
  *
6
- * @codegen <<SignedSource::4f7efe5f3afd0bc4b8832adf32e729d9>>
6
+ * @codegen <<SignedSource::50b9bf501530f3bf94e6e4dece48d956>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface GuidelineStructuredContent {
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Structured content for MCP (JSON) for ESLint rule docs from constellation.
5
5
  *
6
- * @codegen <<SignedSource::31ccbe611e32ed18b0d8477d40030cbc>>
6
+ * @codegen <<SignedSource::44f41e29fce7b92fa79b280b7485ac56>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface LintRuleStructuredContent {
@@ -0,0 +1,11 @@
1
+ export type IconMCPSchema = {
2
+ keywords: string[];
3
+ componentName: string;
4
+ package: string;
5
+ categorization: 'single-purpose' | 'multi-purpose';
6
+ team: string;
7
+ status?: 'draft' | 'ready-to-publish' | 'published' | 'modified' | 'deprecated' | undefined;
8
+ usage?: string | undefined;
9
+ shouldRecommendSmallIcon?: boolean | undefined;
10
+ };
11
+ export declare const icons: IconMCPSchema[];
@@ -0,0 +1,7 @@
1
+ export type TokenMCPSchema = {
2
+ name: string;
3
+ path: string[];
4
+ description: string;
5
+ exampleValue: string;
6
+ };
7
+ export declare const tokens: TokenMCPSchema[];
@@ -0,0 +1,10 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content components from design-system *.docs.tsx files
5
+ *
6
+ * @codegen <<SignedSource::2ac59844fbf026b9d6d9f15c15b0635d>>
7
+ * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:structured-docs-components
8
+ */
9
+ import type { ComponentMcpPayload } from './types';
10
+ export declare const components: ComponentMcpPayload[];
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Generates TypeScript components data for AI tooling from offerings.json files
5
5
  *
6
- * @codegen <<SignedSource::1d781f4539138bf6cabcd8c01b207b06>>
6
+ * @codegen <<SignedSource::8e120a2eb2205e4c89f4bdddbf4e436f>>
7
7
  * @codegenCommand yarn workspace @af/ads-ai-tooling codegen:prototyping
8
8
  */
9
9
  import type { Component } from './types';
@@ -0,0 +1,2 @@
1
+ import type { ComponentMcpPayload } from './types';
2
+ export declare function loadAllComponents(): ComponentMcpPayload[];
@@ -1,20 +1,26 @@
1
- interface Prop {
1
+ export type ComponentStatus = 'release-candidate' | 'early-access' | 'open-beta' | 'general-availability' | 'intent-to-deprecate' | 'deprecated' | 'unmaintained';
2
+ export type ComponentProps = {
2
3
  name: string;
3
- description: string;
4
4
  type: string;
5
- exampleValue?: string;
6
- }
7
- export interface Component {
5
+ description?: string;
6
+ isRequired?: boolean;
7
+ isDeprecated?: boolean;
8
+ defaultValue?: string;
9
+ };
10
+ export type ComponentMcpPayload = {
8
11
  name: string;
9
- package: `@${'atlaskit' | 'atlassian'}/${string}`;
10
- keywords: string[];
11
- category: string;
12
12
  description: string;
13
- status: string;
14
- examples: string[];
15
- accessibilityGuidelines?: string[];
13
+ status: ComponentStatus;
16
14
  usageGuidelines?: string[];
17
15
  contentGuidelines?: string[];
18
- props?: Prop[];
19
- }
20
- export {};
16
+ accessibilityGuidelines?: string[];
17
+ keywords: string[];
18
+ package: string;
19
+ examples: string[];
20
+ props: ComponentProps[] | undefined;
21
+ category: string;
22
+ };
23
+ /**
24
+ * Re-exported to save rebuilding existing codegen.
25
+ */
26
+ export type Component = ComponentMcpPayload;
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Structured content for content guidelines from design-system-docs foundations content.
5
5
  *
6
- * @codegen <<SignedSource::4f7efe5f3afd0bc4b8832adf32e729d9>>
6
+ * @codegen <<SignedSource::50b9bf501530f3bf94e6e4dece48d956>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface GuidelineStructuredContent {
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Structured content for MCP (JSON) for ESLint rule docs from constellation.
5
5
  *
6
- * @codegen <<SignedSource::31ccbe611e32ed18b0d8477d40030cbc>>
6
+ * @codegen <<SignedSource::44f41e29fce7b92fa79b280b7485ac56>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface LintRuleStructuredContent {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlaskit/ads-mcp",
3
- "version": "0.17.1",
3
+ "version": "0.17.3",
4
4
  "description": "The official Atlassian Design System MCP server to develop apps and user interfaces matching the Atlassian style.",
5
5
  "author": "Atlassian Pty Ltd",
6
6
  "license": "Apache-2.0",
@@ -34,9 +34,10 @@
34
34
  }
35
35
  },
36
36
  "dependencies": {
37
- "@atlaskit/icon": "^32.0.0",
37
+ "@atlaskit/icon": "^33.0.0",
38
+ "@atlaskit/icon-lab": "^6.0.0",
38
39
  "@atlaskit/platform-feature-flags": "^1.1.0",
39
- "@atlaskit/tokens": "^11.0.0",
40
+ "@atlaskit/tokens": "^11.1.0",
40
41
  "@axe-core/playwright": "^4.8.0",
41
42
  "@axe-core/puppeteer": "^4.7.3",
42
43
  "@babel/runtime": "^7.0.0",
@@ -54,6 +55,7 @@
54
55
  "@atlassiansox/analytics-node-client": "^4.0.0"
55
56
  },
56
57
  "devDependencies": {
58
+ "@atlassian/feature-flags-test-utils": "^1.0.0",
57
59
  "ts-node": "^10.9.1"
58
60
  }
59
61
  }