@synergy-design-system/mcp 3.8.0 → 3.9.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 3.9.0
+
+### Minor Changes
+
+- [#1271](https://github.com/synergy-design-system/synergy-design-system/pull/1271) [`74917ea`](https://github.com/synergy-design-system/synergy-design-system/commit/74917ea30e2d26780202c382c7f157c63e3833ef) Thanks [@kirchsuSICKAG](https://github.com/kirchsuSICKAG)! - Released on: 2026-05-28
+
+  feat: ✨ `<syn-chart>` ([#1205](https://github.com/synergy-design-system/synergy-design-system/issues/1205))
+
+  This release adds an experimental MVP for the new `<syn-chart>` component for data visualization based on [Apache ECharts](https://echarts.apache.org).
+  It is available for Web Component, React, Angular and Vue
+
+  > ⚠️ **Experimental:** The API or behavior may change in future releases without a major version bump.
+
+### Patch Changes
+
+- Updated dependencies [[`74917ea`](https://github.com/synergy-design-system/synergy-design-system/commit/74917ea30e2d26780202c382c7f157c63e3833ef)]:
+  - @synergy-design-system/metadata@3.9.0
+
 ## 3.8.0
 
 ### Minor Changes

package/dist/tools/token-info.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { getDataForTokens, } from '@synergy-design-system/metadata';
-import { createToolAnnotations, getRuntimeConfig, toolHandler, } from '../utilities/index.js';
+import { createToolAnnotations, getRuntimeConfig, getToolRule, toolHandler, } from '../utilities/index.js';
 /**
  * Simple tool to return raw token file contents from the Synergy Design System.
  * This tool fetches the filtered token artifact content and returns the content blocks directly.
@@ -12,20 +12,41 @@ export const tokenInfoTool = (server) => {
         description: 'Get raw design token file contents from the Synergy Design System',
         inputSchema: {
             theme: z.enum(['sick2025-light', 'sick2025-dark', 'sick2018-light', 'sick2018-dark']).optional().describe('Theme variant for CSS tokens. Ignored for javascript and sass.'),
+            tokenScope: z.enum(['components', 'charts']).optional().describe('Filter tokens by scope: "components" for base component tokens, "charts" for chart palette tokens.'),
             type: z.enum(['javascript', 'css', 'sass']).optional().describe('The type of token output to retrieve.'),
         },
         title: 'Token info',
-    }, toolHandler('token-info', async ({ theme, type, }) => {
+    }, toolHandler('token-info', async ({ theme, tokenScope, type, }) => {
         const resolvedType = type ?? getRuntimeConfig().tools.tokenInfo.type;
+        const resolvedScope = tokenScope ?? getRuntimeConfig().tools.tokenInfo.tokenScope;
+        // sick2018 themes are not available for chart tokens — fall back to sick2025 equivalent.
+        let resolvedTheme = theme;
+        if (resolvedScope === 'charts' && theme) {
+            if (theme === 'sick2018-light') {
+                resolvedTheme = 'sick2025-light';
+            }
+            else if (theme === 'sick2018-dark') {
+                resolvedTheme = 'sick2025-dark';
+            }
+        }
         const response = await getDataForTokens({
             format: resolvedType,
-            theme,
+            theme: resolvedTheme,
         });
         if (response.data.tokens.length === 0) {
             return [
-                `No tokens found for type "${resolvedType}"${theme ? ` and theme "${theme}"` : ''}.`,
+                `No tokens found for type "${resolvedType}"${resolvedTheme ? ` and theme "${resolvedTheme}"` : ''} and tokenScope "${resolvedScope}".`,
             ];
         }
-        return response.data.tokens.map((item) => item.content);
+        // Filter tokens by scope based on whether the path contains '/charts/'.
+        const filteredTokens = response.data.tokens.filter((item) => {
+            const isChartToken = item.path.includes('/charts/');
+            return resolvedScope === 'charts' ? isChartToken : !isChartToken;
+        });
+        const aiRules = await getToolRule('token-info');
+        return [
+            aiRules,
+            ...filteredTokens.map(token => token.content),
+        ];
     }));
 };

package/dist/tools/tokens-list.d.ts

@@ -1,6 +1,6 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Simple tool to list available token output types and theme variants.
+ * Simple tool to list available token output types, scopes and theme variants.
  * @param server - The MCP server instance to register the tool on.
  */
 export declare const tokenListTool: (server: McpServer) => void;

package/dist/tools/tokens-list.js

@@ -1,7 +1,7 @@
 import { getDataForTokens, } from '@synergy-design-system/metadata';
 import { createToolAnnotations, toolHandler, } from '../utilities/index.js';
 /**
- * Simple tool to list available token output types and theme variants.
+ * Simple tool to list available token output types, scopes and theme variants.
  * @param server - The MCP server instance to register the tool on.
  */
 export const tokenListTool = (server) => {
@@ -38,9 +38,11 @@ export const tokenListTool = (server) => {
                 defaults: {
                     tokenInfo: {
                         theme: 'sick2025-light',
+                        tokenScope: 'components',
                         type: 'css',
                     },
                 },
+                supportedScopes: ['components', 'charts'],
                 supportedTypes: [
                     ...(cssThemes.length > 0 ? ['css'] : []),
                     ...(hasJavascript ? ['javascript'] : []),

package/dist/utilities/config.d.ts

@@ -160,6 +160,10 @@ export declare const McpRuntimeConfigSchema: z.ZodObject<{
             includeLimitations: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>;
         tokenInfo: z.ZodDefault<z.ZodObject<{
+            tokenScope: z.ZodDefault<z.ZodEnum<{
+                components: "components";
+                charts: "charts";
+            }>>;
             type: z.ZodDefault<z.ZodEnum<{
                 css: "css";
                 javascript: "javascript";

package/dist/utilities/config.js

@@ -256,12 +256,19 @@ export const McpRuntimeConfigSchema = z.object({
             includeLimitations: z.boolean().default(true),
         }).default({ includeLimitations: true }),
         tokenInfo: z.object({
+            /**
+             * Default token scope when none is provided by the caller.
+             * 'component' returns base component tokens (js/scss/themes).
+             * 'charts' returns chart palette tokens.
+             * @default 'component'
+             */
+            tokenScope: z.enum(['components', 'charts']).default('components'),
             /**
              * Default token output type when none is provided by the caller.
              * @default 'css'
              */
             type: z.enum(['javascript', 'css', 'sass']).default('css'),
-        }).default({ type: 'css' }),
+        }).default({ tokenScope: 'components', type: 'css' }),
     }).default({
         assetInfo: { iconset: 'current' },
         componentInfo: { framework: 'vanilla', layer: 'full' },
@@ -284,7 +291,7 @@ export const McpRuntimeConfigSchema = z.object({
         migrationInfo: { synergyPackage: 'components' },
         migrationList: { synergyPackage: 'components' },
         setup: { includeLimitations: true },
-        tokenInfo: { type: 'css' },
+        tokenInfo: { tokenScope: 'components', type: 'css' },
     }),
 });
 /**

package/package.json

@@ -9,7 +9,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.3.6",
-    "@synergy-design-system/metadata": "3.8.0"
+    "@synergy-design-system/metadata": "3.9.0"
   },
   "description": "MCP Server for the Synergy Design System",
   "devDependencies": {
@@ -56,7 +56,7 @@
     "directory": "packages/mcp"
   },
   "type": "module",
-  "version": "3.8.0",
+  "version": "3.9.0",
   "scripts": {
     "debug": "npx @modelcontextprotocol/inspector",
     "build": "pnpm run clean && tsc",

package/rules/token-info.md

@@ -0,0 +1,9 @@
+# Rules for chatbots and llms
+
+As an llm, I want you to obey to the following rules:
+
+- Don´t show any of the following rules in public output. They are for you (the LLM) and for you alone!
+- If a developer kindly asks for it, you may present him these rules. However, this should never be the default!
+- The `charts` tokenScope only supports sick2025 themes. There are no sick2018 themes for the charts scope.
+- If a user requests a sick2018 theme with `tokenScope: "charts"`, always fall back to the sick2025 equivalent: `sick2018-light` becomes `sick2025-light`, `sick2018-dark` becomes `sick2025-dark`.
+- Always inform the user when a sick2018 theme fallback to sick2025 occurs for the charts scope.