@atlaskit/ads-mcp 1.13.1 → 2.0.0
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.
- package/CHANGELOG.md +21 -0
- package/dist/cjs/tools/get-all-components/components.codegen.js +2 -2
- package/dist/cjs/tools/get-atlaskit-components/atlaskit-components.codegen.js +2 -2
- package/dist/cjs/tools/plan/list-plan-tool.js +1 -1
- package/dist/cjs/tools/search-atlaskit-components/search-atlaskit-components-tool.js +1 -1
- package/dist/cjs/tools/search-components/list-search-components-tool.js +1 -1
- package/dist/cjs/tools/search-components/search-components-tool.js +1 -1
- package/dist/es2019/tools/get-all-components/components.codegen.js +2 -2
- package/dist/es2019/tools/get-atlaskit-components/atlaskit-components.codegen.js +2 -2
- package/dist/es2019/tools/plan/list-plan-tool.js +1 -1
- package/dist/es2019/tools/search-atlaskit-components/search-atlaskit-components-tool.js +1 -1
- package/dist/es2019/tools/search-components/list-search-components-tool.js +1 -1
- package/dist/es2019/tools/search-components/search-components-tool.js +1 -1
- package/dist/esm/tools/get-all-components/components.codegen.js +2 -2
- package/dist/esm/tools/get-atlaskit-components/atlaskit-components.codegen.js +2 -2
- package/dist/esm/tools/plan/list-plan-tool.js +1 -1
- package/dist/esm/tools/search-atlaskit-components/search-atlaskit-components-tool.js +1 -1
- package/dist/esm/tools/search-components/list-search-components-tool.js +1 -1
- package/dist/esm/tools/search-components/search-components-tool.js +1 -1
- package/dist/types/tools/get-all-components/components.codegen.d.ts +1 -1
- package/dist/types/tools/get-all-components/types.d.ts +1 -1
- package/dist/types/tools/get-atlaskit-components/atlaskit-components.codegen.d.ts +1 -1
- package/package.json +2 -2
|
@@ -4,7 +4,7 @@ import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
|
|
|
4
4
|
import { planInputSchema } from './plan-input-schema';
|
|
5
5
|
export var listPlanTool = {
|
|
6
6
|
name: 'ads_plan',
|
|
7
|
-
description: "Runs **ads_search_tokens**, **ads_search_icons**, **ads_search_components**, and optionally **atlaskit_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. Component results preserve optional `
|
|
7
|
+
description: "Runs **ads_search_tokens**, **ads_search_icons**, **ads_search_components**, and optionally **atlaskit_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. Component results preserve optional `references.figmaUrl`; for Figma work, follow the canonical-source and property-verification guidance in `ads_search_components`.\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 **ADS component** packages/props in one pass. Also use when exploring ADS building blocks before you write code.\n\nADS-FIRST ROUTING:\nUse `components` for canonical ADS components. Use `atlaskitComponents` only as explicit fallback research for public `@atlaskit/*` packages outside the ADS catalog, or after ADS component search has no useful match. This tool does not auto-populate `atlaskitComponents` from `components`.\n\nEach of `tokens`, `icons`, `components`, and `atlaskitComponents` accepts a search term or an array of terms. A string is treated as one search term, equivalent to a one-item array. Omit unused fields or use `[]`; omitted fields default to empty arrays. At least one field must contain a nonblank search term. Categories containing only blank terms are skipped.\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\": [\"editor-core\", \"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```",
|
|
8
8
|
annotations: {
|
|
9
9
|
title: 'Search ADS tokens, icons, and components to plan what to build',
|
|
10
10
|
readOnlyHint: true,
|
|
@@ -13,7 +13,7 @@ var buildComponentResult = function buildComponentResult(result) {
|
|
|
13
13
|
description: result.description,
|
|
14
14
|
examples: result.examples,
|
|
15
15
|
props: result.props,
|
|
16
|
-
|
|
16
|
+
references: result.references
|
|
17
17
|
};
|
|
18
18
|
};
|
|
19
19
|
export var searchAtlaskitComponentsTool = /*#__PURE__*/function () {
|
|
@@ -4,7 +4,7 @@ import { zodToJsonSchema } from '../../helpers/zod-to-json-schema';
|
|
|
4
4
|
import { searchComponentsInputSchema } from './search-components-input-schema';
|
|
5
5
|
export var listSearchComponentsTool = {
|
|
6
6
|
name: 'ads_search_components',
|
|
7
|
-
description: "Searches the bundled Atlassian Design System (ADS) component catalog. Returns JSON objects with **name**, **package**, **examples**, **props**, and optional **
|
|
7
|
+
description: "Searches the bundled Atlassian Design System (ADS) component catalog. Returns JSON objects with **name**, **package**, **examples**, **props**, and optional **references.figmaUrl** for each match (trimmed payload). When `references.figmaUrl` is present, inspect the canonical Figma source before building or implementing the component. Reuse library instances/variables, verify Figma properties against code props, and report unresolved mappings or access; do not infer a missing source.\n\nWHEN TO USE:\n**Selecting which canonical 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.\n\nIf you are looking for a public `@atlaskit/*` or internal `@atlassian/*` Platform scoped package that is not part of the ADS component catalog, use `atlaskit_search_components` for fallback research instead of this ADS-only search.",
|
|
8
8
|
annotations: {
|
|
9
9
|
title: 'Search ADS components',
|
|
10
10
|
readOnlyHint: true,
|
|
@@ -13,7 +13,7 @@ var buildComponentResult = function buildComponentResult(result) {
|
|
|
13
13
|
package: result.package,
|
|
14
14
|
examples: result.examples,
|
|
15
15
|
props: result.props,
|
|
16
|
-
|
|
16
|
+
references: result.references
|
|
17
17
|
};
|
|
18
18
|
};
|
|
19
19
|
export var searchComponentsTool = /*#__PURE__*/function () {
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Structured content components from design-system *.docs.tsx files
|
|
5
5
|
*
|
|
6
|
-
* @codegen <<SignedSource::
|
|
6
|
+
* @codegen <<SignedSource::cd6623f66030a4722bbaed56bbabf1c9>>
|
|
7
7
|
* @codegenCommand afm workspace @af/ads-ai-tooling codegen
|
|
8
8
|
*/
|
|
9
9
|
import type { ComponentMcpPayload } from './types';
|
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
*
|
|
4
4
|
* Structured content components from *.docs.tsx files outside of design-system
|
|
5
5
|
*
|
|
6
|
-
* @codegen <<SignedSource::
|
|
6
|
+
* @codegen <<SignedSource::1f08ff68770184b0ad06cfb34f0cd659>>
|
|
7
7
|
* @codegenCommand afm workspace @af/ads-ai-tooling codegen
|
|
8
8
|
*/
|
|
9
9
|
import type { ComponentMcpPayload } from '../get-all-components/types';
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@atlaskit/ads-mcp",
|
|
3
|
-
"version": "
|
|
3
|
+
"version": "2.0.0",
|
|
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",
|
|
@@ -24,7 +24,7 @@
|
|
|
24
24
|
"@atlaskit/icon": "^38.1.0",
|
|
25
25
|
"@atlaskit/icon-lab": "^7.11.0",
|
|
26
26
|
"@atlaskit/platform-feature-flags": "^2.2.0",
|
|
27
|
-
"@atlaskit/tokens": "^20.
|
|
27
|
+
"@atlaskit/tokens": "^20.14.0",
|
|
28
28
|
"@axe-core/playwright": "^4.11.1",
|
|
29
29
|
"@axe-core/puppeteer": "^4.11.1",
|
|
30
30
|
"@babel/runtime": "^7.0.0",
|