@synergy-design-system/mcp 1.41.1 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## 2.0.0
+
+### Major Changes
+
+- [#1160](https://github.com/synergy-design-system/synergy-design-system/pull/1160) [`669cbcb`](https://github.com/synergy-design-system/synergy-design-system/commit/669cbcb9cccce72134beac99ac12a2591f3e3c74) Thanks [@schilchSICKAG](https://github.com/schilchSICKAG)! - Released on: 2026-02-02
+
+  feat: 💥 Enhanced migration support and SICK 2025 defaults
+
+  This release enhances the MCP server with improved migration guidance and updates default iconset to SICK 2025.
+
+  **Key Changes:**
+  - **Breaking:** Migration endpoint now requires package specification - the migration endpoint has been updated to accept a package parameter (e.g., components, styles, assets, tokens) to provide package-specific breaking changes documentation
+  - **Breaking:** Default iconset changed to SICK 2025 - asset info endpoint now returns SICK 2025 iconset information by default instead of SICK 2018
+
+  **Migration Steps:**
+  - Update any calls to the migration endpoint to specify the target package
+  - Review asset integrations as the default iconset has changed to SICK 2025
+
+  \*\*New tool `migration-list`
+  - Provides a new tool that gives information about available migrations for packages (e.g. for components how to migrate from v2 sick2018 to v3 sick2025)
+
+### Patch Changes
+
+- Updated dependencies [[`669cbcb`](https://github.com/synergy-design-system/synergy-design-system/commit/669cbcb9cccce72134beac99ac12a2591f3e3c74)]:
+  - @synergy-design-system/assets@2.0.0
+
+## 1.41.2
+
+### Patch Changes
+
+- [#1148](https://github.com/synergy-design-system/synergy-design-system/pull/1148) [`73b7011`](https://github.com/synergy-design-system/synergy-design-system/commit/73b70118ae21bc58c83cbfeb9e2e8447873803a6) Thanks [@schilchSICKAG](https://github.com/schilchSICKAG)! - Released on: 2026-01-08
+
+  fix: 🐛 Minor dependency updates (#258)
+
+- Updated dependencies [[`73b7011`](https://github.com/synergy-design-system/synergy-design-system/commit/73b70118ae21bc58c83cbfeb9e2e8447873803a6)]:
+  - @synergy-design-system/assets@1.25.1
+
 ## 1.41.1
 
 ### Patch Changes

package/README.md

@@ -238,20 +238,52 @@ The MCP server provides the following tools that can be invoked by AI assistants
 - "What's needed to use Synergy with Vue?"
 - "How do I install Synergy for vanilla JavaScript?"
 
-### 13. `migration-info`
+### 13. `migration-list`
 
-**Description:** Get information about migrations available in the Synergy Design System, including breaking changes between major versions.
+**Description:** List available migration documents for a specific Synergy package in a compact, token‑efficient format.
 
-**Parameters:** None
+**Parameters:**
+
+- `synergyPackage` (string, optional): The package to list migration documents for (`assets`, `components`, `styles`, `tokens`). Defaults to `components`.
+
+**Notes:**
+
+- For the `components` package this returns an index of:
+  - High‑level overview docs (e.g. migration overview)
+  - Path‑specific guides (e.g. v2‑2018 → v3‑2018)
+  - Package‑level docs (e.g. `BREAKING_CHANGES.md`, `CHANGELOG.md`)
+- Each entry contains at least the filename and package name. For component paths, additional metadata such as `from`, `to`, `fromTheme`, `toTheme`, and a short `summary` is included where possible.
+
+**Example prompts:**
+
+- "List all Synergy component migration guides"
+- "Show me available migration docs for tokens"
+- "What migration paths exist from Synergy 2 to Synergy 3?"
+
+### 14. `migration-info`
+
+**Description:** Get detailed migration documentation for a Synergy package. Use this together with `migration-list` to fetch only the documents you need.
+
+**Parameters:**
+
+- `filename` (string, optional): Specific migration document filename to return. Strongly recommended for the `components` package to avoid fetching all path guides at once.
+- `synergyPackage` (string, optional): The package to get migration information about (`assets`, `components`, `styles`, `tokens`). Defaults to `components`.
+
+**Behavior:**
+
+- For `components`:
+  - With `filename`: returns exactly that migration document (e.g. a specific v2‑to‑v3 path guide).
+  - Without `filename`: returns only the migration overview and high‑level package docs (such as `BREAKING_CHANGES` and `CHANGELOG`), **not** every path‑specific guide.
+- For other packages (`assets`, `styles`, `tokens`):
+  - Returns all migration‑related documents for the selected package (typically `BREAKING_CHANGES` and `CHANGELOG`).
 
 **Example prompts:**
 
-- "What migrations are available in Synergy?"
-- "How do I migrate from Synergy v1 to v2?"
-- "Show me breaking changes between versions"
-- "What changed in the latest Synergy version?"
+- "List the available Synergy component migrations" (first call `migration-list`)
+- "Show me the migration guide from Synergy 2 (SICK 2018) to Synergy 3 (SICK 2018)"
+- "Give me the breaking changes for the tokens package between major versions"
 
-### 14. `version`
+### 15. `version`
 
 **Description:** Get version and basic information about the Synergy Design System MCP Server.
 
@@ -288,7 +320,10 @@ src/
 │   ├── component-info.ts # Individual component details
 │   ├── component-list.ts # List all components
 │   ├── davinci-migration.ts # Migration guides
+│   ├── font-info.ts      # Font and prerequisites information
 │   ├── framework-info.ts # Framework-specific information
+│   ├── migration-info.ts # Package migration documentation
+│   ├── migration-list.ts # Package migration index (filenames + metadata)
 │   ├── styles-info.ts    # CSS utilities information
 │   ├── styles-list.ts    # List all styles
 │   ├── template-info.ts  # Template details

package/dist/bin/create-checksum.js

@@ -1,6 +1,5 @@
 #!/usr/bin/env node
 /* eslint-disable import/no-extraneous-dependencies */
-/* eslint-disable @typescript-eslint/no-unused-vars */
 import ora from 'ora';
 import { createFolderChecksum, metaDataPath, } from '../utilities/index.js';
 async function run() {
@@ -16,8 +15,10 @@ async function run() {
         spinner.succeed(`Written to: ${metaDataPath}/checksum.txt`);
     }
     catch (error) {
+        // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
         spinner.fail(`Failed to generate checksum: ${error}`);
         process.exit(1);
     }
 }
+// eslint-disable-next-line @typescript-eslint/no-floating-promises
 run();

package/dist/build/assets.js

@@ -11,6 +11,7 @@ import { assetsPath, createPath, } from '../utilities/index.js';
 const filesToCopy = [
     'README.md',
     'CHANGELOG.md',
+    'BREAKING_CHANGES.md',
 ];
 /**
  * Sets up all wanted data from the assets package and adds it to the static metadata.
@@ -36,7 +37,6 @@ export const buildAssets = async () => {
         const modulePath = fileURLToPath(moduleUrl);
         const moduleDir = path.join(path.dirname(modulePath), '../');
         // Process the files (placeholder for actual logic)
-        // eslint-disable-next-line no-console
         const contents = await globby(filesToCopy, {
             cwd: moduleDir,
             onlyFiles: true,

package/dist/build/components.js

@@ -103,6 +103,7 @@ export const buildComponents = async () => {
                 return copyFile(source, targetFileName);
             });
         });
+        // eslint-disable-next-line @typescript-eslint/await-thenable
         await Promise.all(componentMetadata);
         spinner.succeed('Components metadata generated successfully.');
         spinner.text = 'Generating static metadata...';

package/dist/build/static.js

@@ -1,8 +1,8 @@
 import { existsSync } from 'node:fs';
-import { copyFile } from 'node:fs/promises';
+import { copyFile, readdir } from 'node:fs/promises';
 import { basename, join } from 'node:path';
 import ora from 'ora';
-import { componentMigrationPath, createPath, getAbsolutePath, setupPath, } from '../utilities/index.js';
+import { componentMigrationPath, createPath, getAbsolutePath, setupPath, staticMigrationPath, } from '../utilities/index.js';
 /**
  * List of static files that should be copied to the static metadata directory.
  */
@@ -22,11 +22,6 @@ const staticFilesToCopy = [
         getAbsolutePath('../../../../packages/components/BREAKING_CHANGES.md'),
         componentMigrationPath,
     ],
-    // Copy the v3 migration guide
-    [
-        getAbsolutePath('../../../../packages/docs/src/static/migration-synergy-v3.md'),
-        componentMigrationPath,
-    ],
 ];
 /**
  * Sets up all data from the components and framework packages and adds them to the static metadata.
@@ -47,6 +42,19 @@ export const buildStaticFiles = async () => {
             return copyFile(staticFile, targetFileName);
         });
         await Promise.all(staticFiles);
+        // Copy all migration guides from the docs package into the static
+        // migration metadata directory so they can be consumed by the MCP server.
+        const migrationSourceDir = getAbsolutePath('../../../../packages/docs/src/static/migration');
+        if (existsSync(migrationSourceDir)) {
+            await createPath(staticMigrationPath);
+            const migrationFiles = await readdir(migrationSourceDir);
+            const migrationCopies = migrationFiles.map((file) => {
+                const source = join(migrationSourceDir, file);
+                const target = join(staticMigrationPath, file);
+                return copyFile(source, target);
+            });
+            await Promise.all(migrationCopies);
+        }
         spinner.succeed('Static metadata generated successfully.');
         spinner.succeed('Generation of metadata generated successfully.');
     }

package/dist/build/styles.js

@@ -11,6 +11,7 @@ import { createPath, stylesPath, } from '../utilities/index.js';
 const filesToCopy = [
     'README.md',
     'CHANGELOG.md',
+    'BREAKING_CHANGES.md',
     'dist/*.css',
 ];
 /**
@@ -37,7 +38,6 @@ export const buildStyles = async () => {
         const modulePath = fileURLToPath(moduleUrl);
         const moduleDir = path.join(path.dirname(modulePath), '../');
         // Process the files (placeholder for actual logic)
-        // eslint-disable-next-line no-console
         const contents = await globby(filesToCopy, {
             cwd: moduleDir,
             onlyFiles: true,

package/dist/build/tokens.js

@@ -11,6 +11,7 @@ import { createPath, tokensPath, } from '../utilities/index.js';
 const filesToCopy = [
     'README.md',
     'CHANGELOG.md',
+    'BREAKING_CHANGES.md',
     'dist/js/*.js',
     'dist/themes/*.css',
 ];
@@ -38,7 +39,6 @@ export const buildTokens = async () => {
         const modulePath = fileURLToPath(moduleUrl);
         const moduleDir = path.join(path.dirname(modulePath), '../../');
         // Process the files (placeholder for actual logic)
-        // eslint-disable-next-line no-console
         const contents = await globby(filesToCopy, {
             cwd: moduleDir,
             onlyFiles: true,

package/dist/tools/asset-info.js

@@ -1,11 +1,8 @@
-/* eslint-disable complexity */
 import { z } from 'zod';
 import * as availableIconsets from '@synergy-design-system/assets';
 import { getAssetsMetaData, getStructuredMetaData, } from '../utilities/index.js';
 const iconsetListAliases = {
     sick2018Icons: [
-        'current',
-        'default',
         'legacy',
         'v2',
         'synergy2018',
@@ -13,7 +10,9 @@ const iconsetListAliases = {
         'sick2018',
     ],
     sick2025Icons: [
+        'current',
         'synergy2025',
+        'default',
         'new',
         'next',
         'brand2025',
@@ -62,13 +61,16 @@ export const assetInfoTool = (server) => {
                 .describe(`The maximum number of icons to return. Defaults to ${DEFAULT_LIMIT}. When using multiple filters (pipe-separated), this limit applies per filter term.`),
         },
         title: 'Available Icons',
-    }, async ({ filter, iconset, limit, }) => {
+    }, async ({ filter, iconset, limit,
+    // eslint-disable-next-line complexity
+     }) => {
         // Get the iconset that should be used by key/value of iconsetListAliases
         const setToUse = iconset
             ? Object
                 .entries(iconsetListAliases)
-                .find(([, aliases]) => aliases.includes(iconset))?.[0] || 'sick2018Icons'
-            : 'sick2018Icons';
+                .find(([, aliases]) => aliases.includes(iconset))?.[0] || 'sick2025Icons'
+            : 'sick2025Icons';
+        // eslint-disable-next-line no-constant-binary-expression, valid-typeof
         const foundIconSet = typeof availableIconsets[setToUse] !== undefined
             ? availableIconsets[setToUse]
             : availableIconsets.sick2018Icons;

package/dist/tools/component-info.js

@@ -1,4 +1,3 @@
-/* eslint-disable complexity */
 import { z } from 'zod';
 import { getInfoForComponent, getStructuredMetaData, } from '../utilities/index.js';
 /**

package/dist/tools/framework-info.js

@@ -1,4 +1,3 @@
-/* eslint-disable complexity */
 import { z } from 'zod';
 import { getDynamicMetaDataForFramework, getStaticMetaDataForFramework, getStructuredMetaData, setupPath, } from '../utilities/index.js';
 /**

package/dist/tools/index.d.ts

@@ -6,6 +6,7 @@ export * from './davinci-migration.js';
 export * from './font-info.js';
 export * from './framework-info.js';
 export * from './migration-info.js';
+export * from './migration-list.js';
 export * from './styles-info.js';
 export * from './styles-list.js';
 export * from './template-list.js';

package/dist/tools/index.js

@@ -6,6 +6,7 @@ export * from './davinci-migration.js';
 export * from './font-info.js';
 export * from './framework-info.js';
 export * from './migration-info.js';
+export * from './migration-list.js';
 export * from './styles-info.js';
 export * from './styles-list.js';
 export * from './template-list.js';

package/dist/tools/migration-info.d.ts

@@ -1,6 +1,15 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 /**
- * Simple tool to list all available migration in the Synergy Design System.
+ * Tool to retrieve concrete migration documentation for a given package.
+ *
+ * For Synergy components this tool is designed to be used together with
+ * `migration-list`:
+ *   1. Call `migration-list` to discover available documents (filenames).
+ *   2. Call `migration-info` with a specific filename to fetch only that
+ *      document instead of all migration guides at once.
+ *
+ * For other packages (assets/styles/tokens) you can continue to omit the
+ * filename to receive all available migration‑related documents.
  * @param server - The MCP server instance to register the tool on.
  */
 export declare const migrationInfoTool: (server: McpServer) => void;

package/dist/tools/migration-info.js

@@ -1,26 +1,88 @@
-import { componentStaticPath, getMigrationMetaData, getStructuredMetaData, } from '../utilities/index.js';
+import { z } from 'zod';
+import { getMigrationMetaData } from '../utilities/index.js';
 /**
- * Simple tool to list all available migration in the Synergy Design System.
+ * Tool to retrieve concrete migration documentation for a given package.
+ *
+ * For Synergy components this tool is designed to be used together with
+ * `migration-list`:
+ *   1. Call `migration-list` to discover available documents (filenames).
+ *   2. Call `migration-info` with a specific filename to fetch only that
+ *      document instead of all migration guides at once.
+ *
+ * For other packages (assets/styles/tokens) you can continue to omit the
+ * filename to receive all available migration‑related documents.
  * @param server - The MCP server instance to register the tool on.
  */
 export const migrationInfoTool = (server) => {
     server.registerTool('migration-info', {
-        description: 'Get information about migrations available in the Synergy Design System',
-        inputSchema: {},
-        title: 'Migration info',
-    }, async () => {
-        const metadata = await getMigrationMetaData();
-        const changelog = await getStructuredMetaData(componentStaticPath, fileName => fileName.toLowerCase().includes('changelog'));
+        description: 'Get detailed migration documentation for a Synergy package. Use together with `migration-list` to fetch only the documents you need.',
+        inputSchema: {
+            filename: z.string().optional().describe('Optional filename of the migration document to return. Especially recommended for the components package to avoid fetching all guides at once.'),
+            synergyPackage: z.enum([
+                'assets',
+                'components',
+                'styles',
+                'tokens',
+            ]).default('components').optional().describe('The package to get migration information about.'),
+        },
+        title: 'Package Migration Information',
+    }, async ({ filename, synergyPackage, }) => {
+        const selectedPackage = (synergyPackage ?? 'components');
+        const metadata = await getMigrationMetaData(selectedPackage);
+        // For components, strongly prefer a specific filename so we do not
+        // send all path guides at once.
+        if (selectedPackage === 'components' && filename) {
+            const match = metadata.find(file => file && file.filename === filename);
+            if (!match) {
+                return {
+                    content: [
+                        {
+                            text: `No migration document named "${filename}" found for package "${selectedPackage}". Call the 'migration-list' tool first to see the available filenames.",`,
+                            type: 'text',
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        text: JSON.stringify(match, null, 2),
+                        type: 'text',
+                    },
+                ],
+            };
+        }
+        // If no filename is given for components, return only the overview
+        // index and the high‑level package docs (BREAKING_CHANGES / CHANGELOG)
+        // instead of all path‑specific guides.
+        if (selectedPackage === 'components' && !filename) {
+            const filtered = metadata.filter((file) => {
+                if (!file)
+                    return false;
+                const { filename: name } = file;
+                const isOverview = name === 'index.md';
+                const isPathGuide = name.startsWith('v2-') && name.endsWith('.md');
+                // Keep overview and any non path‑guide docs
+                return isOverview || !isPathGuide;
+            });
+            return {
+                content: [
+                    {
+                        text: JSON.stringify(filtered, null, 2),
+                        type: 'text',
+                    },
+                ],
+            };
+        }
+        // For non‑components packages, or when a filename is not used,
+        // fall back to returning all documents. These sets are small
+        // (typically CHANGELOG + BREAKING_CHANGES).
         return {
             content: [
                 {
                     text: JSON.stringify(metadata, null, 2),
                     type: 'text',
                 },
-                {
-                    text: JSON.stringify(changelog, null, 2),
-                    type: 'text',
-                },
             ],
         };
     });

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

@@ -0,0 +1,10 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Tool to list available migration documents for a given package in a
+ * token‑efficient way. It returns only a compact index (filenames and
+ * simple kinds), not the full markdown content.
+ *
+ * Use this together with `migration-info` to first discover what documents
+ * exist and then fetch the relevant one.
+ */
+export declare const migrationListTool: (server: McpServer) => void;

package/dist/tools/migration-list.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { getMigrationMetaData } from '../utilities/index.js';
+const extractHeadingMetadata = (content) => {
+    const result = {};
+    // Try to find the first level‑1 heading.
+    const headingMatch = content.match(/^#\s+(.+)$/m);
+    const headingText = headingMatch?.[1]?.trim();
+    if (!headingText) {
+        return result;
+    }
+    result.title = headingText;
+    // Heuristic: headings follow the pattern
+    // "Migrating from <FROM> → <TO>" for path guides.
+    const pathMatch = headingText.match(/^Migrating from\s+(.+?)\s*→\s*(.+)$/);
+    if (!pathMatch) {
+        return result;
+    }
+    const fromLabel = pathMatch[1].trim();
+    const toLabel = pathMatch[2].trim();
+    result.from = fromLabel;
+    result.to = toLabel;
+    const fromThemeMatch = fromLabel.match(/\(([^)]+)\)/);
+    const toThemeMatch = toLabel.match(/\(([^)]+)\)/);
+    if (fromThemeMatch) {
+        result.fromTheme = fromThemeMatch[1].trim();
+    }
+    if (toThemeMatch) {
+        result.toTheme = toThemeMatch[1].trim();
+    }
+    return result;
+};
+const extractSummaryMetadata = (content) => {
+    const result = {};
+    const headingMatch = content.match(/^#\s+(.+)$/m);
+    if (!headingMatch) {
+        return result;
+    }
+    const startIndex = content.indexOf(headingMatch[0]) + headingMatch[0].length;
+    const rest = content.slice(startIndex);
+    const lines = rest.split('\n');
+    const buffer = lines.reduce((acc, rawLine) => {
+        if (acc.length >= 3) {
+            return acc;
+        }
+        const line = rawLine.trim();
+        if (!line) {
+            return acc.length > 0 ? acc : acc;
+        }
+        if (line.startsWith('#')) {
+            return acc;
+        }
+        if (line === '---') {
+            return acc;
+        }
+        return [...acc, line];
+    }, []);
+    if (buffer.length > 0) {
+        result.summary = buffer.join(' ');
+    }
+    return result;
+};
+/**
+ * Tool to list available migration documents for a given package in a
+ * token‑efficient way. It returns only a compact index (filenames and
+ * simple kinds), not the full markdown content.
+ *
+ * Use this together with `migration-info` to first discover what documents
+ * exist and then fetch the relevant one.
+ */
+export const migrationListTool = (server) => {
+    server.registerTool('migration-list', {
+        description: 'List available migration documents for a Synergy package in a compact, token-efficient format.',
+        inputSchema: {
+            synergyPackage: z.enum([
+                'assets',
+                'components',
+                'styles',
+                'tokens',
+            ]).default('components').optional().describe('The package to list migration documents for.'),
+        },
+        title: 'Package Migration Document Index',
+    }, async ({ synergyPackage }) => {
+        const selectedPackage = (synergyPackage ?? 'components');
+        const metadata = await getMigrationMetaData(selectedPackage);
+        const index = metadata
+            .filter(Boolean)
+            .map((file) => {
+            const { content, filename } = file;
+            // Derive a simple kind for components to distinguish
+            // between migration paths, overview, and package-level docs.
+            let kind = 'package-doc';
+            if (selectedPackage === 'components') {
+                if (filename === 'index.md') {
+                    kind = 'overview';
+                }
+                else if (filename.startsWith('v2-') && filename.endsWith('.md')) {
+                    kind = 'path';
+                }
+            }
+            const extra = selectedPackage === 'components'
+                ? {
+                    ...extractHeadingMetadata(content),
+                    ...extractSummaryMetadata(content),
+                }
+                : {};
+            return {
+                filename,
+                kind,
+                package: selectedPackage,
+                ...extra,
+            };
+        });
+        return {
+            content: [
+                {
+                    text: JSON.stringify(index, null, 2),
+                    type: 'text',
+                },
+            ],
+        };
+    });
+};

package/dist/tools/template-info.js

@@ -1,4 +1,3 @@
-/* eslint-disable complexity */
 import { z } from 'zod';
 import { getInfoForTemplate, getStructuredMetaData, } from '../utilities/index.js';
 /**

package/dist/tools/version.js

@@ -9,7 +9,9 @@ export const versionTool = (server) => {
         description: 'Get version and basic information about the Synergy Design System MCP Server',
         inputSchema: {},
         title: 'Synergy MCP Version Information',
-    }, async () => {
+    }, 
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async () => {
         const packageJson = getPackageInfo();
         const versionInfo = {
             author: packageJson.author,

package/dist/utilities/checksum.js

@@ -1,3 +1,4 @@
+/* eslint-disable no-restricted-syntax */
 import { createHash } from 'node:crypto';
 import { readFile, writeFile } from 'node:fs/promises';
 import { join, relative } from 'node:path';
@@ -34,7 +35,6 @@ export async function createFolderChecksum(folderPath, options = {}) {
         const hash = createHash(algorithm);
         // Read and concatenate all file contents (equivalent to xargs -0 cat)
         // Note: Sequential reading to maintain order consistency with shell script
-        // eslint-disable-next-line no-await-in-loop
         for (const filePath of sortedFiles) {
             // eslint-disable-next-line no-await-in-loop
             const content = await readFile(filePath);
@@ -72,6 +72,7 @@ export async function verifyFolderChecksum(folderPath, options = {}) {
             outputFile: undefined, // Don't write to file during verification
         });
         return storedChecksum === currentChecksum;
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
     }
     catch (error) {
         // If we can't read the checksum file, consider it invalid

package/dist/utilities/migration.d.ts

@@ -1 +1,3 @@
-export declare const getMigrationMetaData: () => Promise<(import("./metadata.js").MetadataFile | null)[]>;
+type AvailablePackages = 'assets' | 'components' | 'tokens' | 'styles';
+export declare const getMigrationMetaData: (requestedPackage?: AvailablePackages) => Promise<(import("./metadata.js").MetadataFile | null)[]>;
+export {};

package/dist/utilities/migration.js

@@ -1,10 +1,33 @@
-import { componentMigrationPath, staticMigrationPath, } from './config.js';
+import { assetsPath, componentBasePath, componentMigrationPath, staticMigrationPath, stylesPath, tokensPath, } from './config.js';
 import { getStructuredMetaData, } from './metadata.js';
-export const getMigrationMetaData = async () => {
+/**
+ * Low level utility to get migration metadata for a specific package.
+ * @param path The path to retreive the information from
+ * @param fileList A list of filenames that should be included
+ */
+const getBaseMigrationMetaData = async (path, fileList = [
+    'CHANGELOG.md',
+    'BREAKING_CHANGES.md',
+]) => getStructuredMetaData(path, item => fileList.includes(item));
+const getAssetsMigrationMetaData = async () => getBaseMigrationMetaData(assetsPath);
+const getStylesMigrationMetaData = async () => getBaseMigrationMetaData(stylesPath);
+const getTokensMigrationMetaData = async () => getBaseMigrationMetaData(tokensPath);
+const getComponentsMigrationMetaData = async () => {
     const data = await getStructuredMetaData(componentMigrationPath);
     const additionalData = await getStructuredMetaData(staticMigrationPath);
+    const changelog = await getStructuredMetaData(componentBasePath, item => ['CHANGELOG.md'].includes(item));
     return [
         ...data,
         ...additionalData,
+        ...changelog,
     ];
 };
+export const getMigrationMetaData = async (requestedPackage = 'components') => {
+    switch (requestedPackage) {
+        case 'assets': return getAssetsMigrationMetaData();
+        case 'tokens': return getTokensMigrationMetaData();
+        case 'styles': return getStylesMigrationMetaData();
+        case 'components':
+        default: return getComponentsMigrationMetaData();
+    }
+};

package/dist/utilities/storybook/build-docs.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-/* eslint-disable no-console */
+/* eslint-disable @typescript-eslint/no-misused-promises */
 import { runDocsScraper } from './docs-scraper.js';
 import { StaticServerManager } from './storybook-manager.js';
 // Parse command line arguments
@@ -39,4 +39,5 @@ process.on('SIGTERM', async () => {
     await serverManager.stop();
     process.exit(0);
 });
+// eslint-disable-next-line @typescript-eslint/no-floating-promises
 main();