@atlaskit/ads-mcp 0.15.1 → 0.17.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.
Files changed (47) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/dist/cjs/index.js +6 -0
  3. package/dist/cjs/tools/get-guidelines/guidelines-structured-content.codegen.js +49 -0
  4. package/dist/cjs/tools/get-guidelines/index.js +99 -0
  5. package/dist/cjs/tools/get-icons/icon-mcp-structured-content.codegen.js +8 -0
  6. package/dist/cjs/tools/get-icons/icon-structured-content.codegen.js +2 -2
  7. package/dist/cjs/tools/get-icons/index.js +13 -13
  8. package/dist/cjs/tools/get-lint-rules/index.js +11 -11
  9. package/dist/cjs/tools/get-lint-rules/lint-rules-structured-content.codegen.js +94 -86
  10. package/dist/cjs/tools/get-tokens/index.js +12 -12
  11. package/dist/cjs/tools/get-tokens/token-mcp-structured-content.codegen.js +2356 -0
  12. package/dist/cjs/tools/i18n-conversion/guide.js +1 -1
  13. package/dist/es2019/index.js +6 -0
  14. package/dist/es2019/tools/get-guidelines/guidelines-structured-content.codegen.js +43 -0
  15. package/dist/es2019/tools/get-guidelines/index.js +78 -0
  16. package/dist/es2019/tools/get-icons/icon-mcp-structured-content.codegen.js +8 -0
  17. package/dist/es2019/tools/get-icons/icon-structured-content.codegen.js +2 -2
  18. package/dist/es2019/tools/get-icons/index.js +9 -9
  19. package/dist/es2019/tools/get-lint-rules/index.js +9 -9
  20. package/dist/es2019/tools/get-lint-rules/lint-rules-structured-content.codegen.js +93 -85
  21. package/dist/es2019/tools/get-tokens/index.js +9 -9
  22. package/dist/es2019/tools/get-tokens/token-mcp-structured-content.codegen.js +2350 -0
  23. package/dist/es2019/tools/i18n-conversion/guide.js +1 -1
  24. package/dist/esm/index.js +6 -0
  25. package/dist/esm/tools/get-guidelines/guidelines-structured-content.codegen.js +43 -0
  26. package/dist/esm/tools/get-guidelines/index.js +92 -0
  27. package/dist/esm/tools/get-icons/icon-mcp-structured-content.codegen.js +8 -0
  28. package/dist/esm/tools/get-icons/icon-structured-content.codegen.js +2 -2
  29. package/dist/esm/tools/get-icons/index.js +13 -13
  30. package/dist/esm/tools/get-lint-rules/index.js +12 -12
  31. package/dist/esm/tools/get-lint-rules/lint-rules-structured-content.codegen.js +93 -85
  32. package/dist/esm/tools/get-tokens/index.js +12 -12
  33. package/dist/esm/tools/get-tokens/token-mcp-structured-content.codegen.js +2350 -0
  34. package/dist/esm/tools/i18n-conversion/guide.js +1 -1
  35. package/dist/types/tools/get-guidelines/guidelines-structured-content.codegen.d.ts +13 -0
  36. package/dist/types/tools/get-guidelines/index.d.ts +13 -0
  37. package/dist/types/tools/get-icons/icon-mcp-structured-content.codegen.d.ts +13 -0
  38. package/dist/types/tools/get-icons/icon-structured-content.codegen.d.ts +1 -1
  39. package/dist/types/tools/get-lint-rules/lint-rules-structured-content.codegen.d.ts +4 -4
  40. package/dist/types/tools/get-tokens/token-mcp-structured-content.codegen.d.ts +13 -0
  41. package/dist/types-ts4.5/tools/get-guidelines/guidelines-structured-content.codegen.d.ts +13 -0
  42. package/dist/types-ts4.5/tools/get-guidelines/index.d.ts +13 -0
  43. package/dist/types-ts4.5/tools/get-icons/icon-mcp-structured-content.codegen.d.ts +13 -0
  44. package/dist/types-ts4.5/tools/get-icons/icon-structured-content.codegen.d.ts +1 -1
  45. package/dist/types-ts4.5/tools/get-lint-rules/lint-rules-structured-content.codegen.d.ts +4 -4
  46. package/dist/types-ts4.5/tools/get-tokens/token-mcp-structured-content.codegen.d.ts +13 -0
  47. package/package.json +1 -1
@@ -47,6 +47,6 @@ export var i18nConversionGuide = {
47
47
  explanation: "Use formatMessage() for prop values (labels, placeholders, aria-labels), computed values, event handlers, and non-JSX contexts. Use <FormattedMessage> for JSX content where you'd otherwise write {formatMessage(...)}. In this example, label and placeholder props use formatMessage(), while button text and content use FormattedMessage."
48
48
  }],
49
49
  bestPractices: ['Use descriptive names (userNameLabel not label) and placeholders (userName not value)', 'Use ICU plural format for numeric values: {count, plural, one {...} other {...}}', 'When using formatMessage pattern: Place message constants at top of file. When using FormattedMessage pattern: Define messages inline in JSX.', "Use formatMessage() for prop values (labels, placeholders, aria-labels), computed values, event handlers, and non-JSX contexts. Use <FormattedMessage> for JSX content where you'd otherwise write {formatMessage(...)}.", 'Convert arrow functions to body form if needed for hooks'],
50
- commonPitfalls: ["**CRITICAL**: Converting strings that don't have eslint-disable comments - only convert strings with @atlassian/i18n/no-literal-string-in-jsx eslint-disable comments. Field labels and other strings without these comments should remain as-is.", '**CRITICAL**: Converting/removing eslint-disable for strings matching ignore patterns - technical/non-user-facing strings should remain hardcoded', '**CRITICAL**: Forgetting to remove eslint-disable comments after conversion - once a string is converted to use formatMessage/FormattedMessage, the eslint-disable comment must be removed', 'Using wrong import path - "jira" path needs @atlassian/jira-intl (with eslint-disable), others use react-intl-next', 'Adding eslint-disable for defineMessage in non-Jira files or forgetting it in Jira files', 'Missing useIntl hook when using formatMessage pattern, generic placeholder names, descriptions < 40 chars, or descriptions that do not follow the translator guidelines (missing UI element location, missing action explanation, etc.)', 'Using placeholder names that don\'t match variable names - placeholder names in defaultMessage must exactly match the keys in the values object or formatMessage parameters', 'Modifying pre-existing messages or working outside specified path scope'],
50
+ commonPitfalls: ["**CRITICAL**: Converting strings that don't have eslint-disable comments - only convert strings with @atlassian/i18n/no-literal-string-in-jsx eslint-disable comments. Field labels and other strings without these comments should remain as-is.", '**CRITICAL**: Converting/removing eslint-disable for strings matching ignore patterns - technical/non-user-facing strings should remain hardcoded', '**CRITICAL**: Forgetting to remove eslint-disable comments after conversion - once a string is converted to use formatMessage/FormattedMessage, the eslint-disable comment must be removed', 'Using wrong import path - "jira" path needs @atlassian/jira-intl (with eslint-disable), others use react-intl-next', 'Adding eslint-disable for defineMessage in non-Jira files or forgetting it in Jira files', 'Missing useIntl hook when using formatMessage pattern, generic placeholder names, descriptions < 40 chars, or descriptions that do not follow the translator guidelines (missing UI element location, missing action explanation, etc.)', "Using placeholder names that don't match variable names - placeholder names in defaultMessage must exactly match the keys in the values object or formatMessage parameters", 'Modifying pre-existing messages or working outside specified path scope'],
51
51
  additionalResources: ['ESLint rule @atlassian/i18n/no-literal-string-in-jsx defines ignore patterns for technical strings (URLs, product names, symbols, etc.)']
52
52
  };
@@ -0,0 +1,13 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content for content guidelines from design-system-docs foundations content.
5
+ *
6
+ * @codegen <<SignedSource::4f7efe5f3afd0bc4b8832adf32e729d9>>
7
+ * @codegenCommand yarn build structured-docs
8
+ */
9
+ export interface GuidelineStructuredContent {
10
+ content: string;
11
+ [key: string]: any;
12
+ }
13
+ export declare const guidelinesStructuredContent: GuidelineStructuredContent[];
@@ -0,0 +1,13 @@
1
+ import type { Tool } from '@modelcontextprotocol/sdk/types.js';
2
+ import { z } from 'zod';
3
+ export declare const getGuidelinesInputSchema: z.ZodObject<{
4
+ terms: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, 'many'>>>;
5
+ limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
6
+ }>;
7
+ export declare const listGetGuidelinesTool: Tool;
8
+ export declare const getGuidelinesTool: (params: z.infer<typeof getGuidelinesInputSchema>) => Promise<{
9
+ content: {
10
+ type: string;
11
+ text: string;
12
+ }[];
13
+ }>;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content for MCP (JSON) for icons from icon-metadata.
5
+ *
6
+ * @codegen <<SignedSource::b64fcae3e8dbbabb3ffce9c06d07150b>>
7
+ * @codegenCommand yarn build structured-docs
8
+ */
9
+ export interface IconStructuredContent {
10
+ content: any;
11
+ [key: string]: any;
12
+ }
13
+ export declare const iconMcpStructuredContent: IconStructuredContent[];
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Structured content for icons generated from icon-metadata.
5
5
  *
6
- * @codegen <<SignedSource::6232931cb337024e8c763a9415f28dce>>
6
+ * @codegen <<SignedSource::ac3161ec5b8e571e1aeb6cb1dcddd43e>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface IconStructuredContent {
@@ -1,13 +1,13 @@
1
1
  /**
2
2
  * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
3
  *
4
- * Structured content for ESLint rule docs from constellation.
4
+ * Structured content for MCP (JSON) for ESLint rule docs from constellation.
5
5
  *
6
- * @codegen <<SignedSource::d1d3c0706fd041eaa66d5ba1a4568c46>>
6
+ * @codegen <<SignedSource::31ccbe611e32ed18b0d8477d40030cbc>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface LintRuleStructuredContent {
10
- content: string;
10
+ content: any;
11
11
  [key: string]: any;
12
12
  }
13
- export declare const lintRulesStructuredContent: LintRuleStructuredContent[];
13
+ export declare const lintRulesMcpStructuredContent: LintRuleStructuredContent[];
@@ -0,0 +1,13 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content for MCP (JSON) for tokens from token-metadata.
5
+ *
6
+ * @codegen <<SignedSource::1373abb13616c49e336b0e694b149fe8>>
7
+ * @codegenCommand yarn build structured-docs
8
+ */
9
+ export interface TokenStructuredContent {
10
+ content: any;
11
+ [key: string]: any;
12
+ }
13
+ export declare const tokenMcpStructuredContent: TokenStructuredContent[];
@@ -0,0 +1,13 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content for content guidelines from design-system-docs foundations content.
5
+ *
6
+ * @codegen <<SignedSource::4f7efe5f3afd0bc4b8832adf32e729d9>>
7
+ * @codegenCommand yarn build structured-docs
8
+ */
9
+ export interface GuidelineStructuredContent {
10
+ content: string;
11
+ [key: string]: any;
12
+ }
13
+ export declare const guidelinesStructuredContent: GuidelineStructuredContent[];
@@ -0,0 +1,13 @@
1
+ import type { Tool } from '@modelcontextprotocol/sdk/types.js';
2
+ import { z } from 'zod';
3
+ export declare const getGuidelinesInputSchema: z.ZodObject<{
4
+ terms: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, 'many'>>>;
5
+ limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
6
+ }>;
7
+ export declare const listGetGuidelinesTool: Tool;
8
+ export declare const getGuidelinesTool: (params: z.infer<typeof getGuidelinesInputSchema>) => Promise<{
9
+ content: {
10
+ type: string;
11
+ text: string;
12
+ }[];
13
+ }>;
@@ -0,0 +1,13 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content for MCP (JSON) for icons from icon-metadata.
5
+ *
6
+ * @codegen <<SignedSource::b64fcae3e8dbbabb3ffce9c06d07150b>>
7
+ * @codegenCommand yarn build structured-docs
8
+ */
9
+ export interface IconStructuredContent {
10
+ content: any;
11
+ [key: string]: any;
12
+ }
13
+ export declare const iconMcpStructuredContent: IconStructuredContent[];
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * Structured content for icons generated from icon-metadata.
5
5
  *
6
- * @codegen <<SignedSource::6232931cb337024e8c763a9415f28dce>>
6
+ * @codegen <<SignedSource::ac3161ec5b8e571e1aeb6cb1dcddd43e>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface IconStructuredContent {
@@ -1,13 +1,13 @@
1
1
  /**
2
2
  * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
3
  *
4
- * Structured content for ESLint rule docs from constellation.
4
+ * Structured content for MCP (JSON) for ESLint rule docs from constellation.
5
5
  *
6
- * @codegen <<SignedSource::d1d3c0706fd041eaa66d5ba1a4568c46>>
6
+ * @codegen <<SignedSource::31ccbe611e32ed18b0d8477d40030cbc>>
7
7
  * @codegenCommand yarn build structured-docs
8
8
  */
9
9
  export interface LintRuleStructuredContent {
10
- content: string;
10
+ content: any;
11
11
  [key: string]: any;
12
12
  }
13
- export declare const lintRulesStructuredContent: LintRuleStructuredContent[];
13
+ export declare const lintRulesMcpStructuredContent: LintRuleStructuredContent[];
@@ -0,0 +1,13 @@
1
+ /**
2
+ * THIS FILE WAS CREATED VIA CODEGEN DO NOT MODIFY {@see http://go/af-codegen}
3
+ *
4
+ * Structured content for MCP (JSON) for tokens from token-metadata.
5
+ *
6
+ * @codegen <<SignedSource::1373abb13616c49e336b0e694b149fe8>>
7
+ * @codegenCommand yarn build structured-docs
8
+ */
9
+ export interface TokenStructuredContent {
10
+ content: any;
11
+ [key: string]: any;
12
+ }
13
+ export declare const tokenMcpStructuredContent: TokenStructuredContent[];
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlaskit/ads-mcp",
3
- "version": "0.15.1",
3
+ "version": "0.17.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",