feat(): migration to esm

.cursor/mcp.json

@@ -7,7 +7,7 @@
       "command": "node",
       "args": [
         "./packages/angular-mcp/dist/main.js",
-        "--workspaceRoot=/home/spoltorak/projects/x-mcp",
+        "--workspaceRoot=/Users/kyrylokarnaukhov/Documents/projects/angular-mcp-toolkit",
         "--ds.storybookDocsRoot=packages/minimal-repo/packages/design-system/storybook-host-app/src/components",
         "--ds.deprecatedCssClassesPath=packages/minimal-repo/packages/design-system/component-options.js",
         "--ds.uiRoot=packages/minimal-repo/packages/design-system/ui"

CONTRIBUTING.MD

@@ -73,7 +73,6 @@ This is an Nx monorepo with the following structure:
 │   ├── minimal-repo/          # Test fixtures and examples
 │   └── shared/                # Shared libraries
 │       ├── angular-ast-utils/     # Angular AST parsing
-│       ├── angular-cli-utils/     # Angular CLI utilities
 │       ├── ds-component-coverage/ # Design system analysis
 │       ├── models/               # Core types and schemas
 │       ├── styles-ast-utils/     # CSS/SCSS AST parsing

README.md

@@ -24,7 +24,7 @@ A Model Context Protocol (MCP) server that provides Angular project analysis and
 
 ### Prerequisites
 
-- Node.js (version 18 or higher)
+- Node.js (version 18 or higher) with ESM support
 
 ### Installation & Setup
 
@@ -96,6 +96,7 @@ const dsComponents = [
   }
 ];
 
+// Note: Use CommonJS export for configuration files
 module.exports = dsComponents;
 ```
 

docs/architecture-internal-design.md

@@ -83,7 +83,7 @@ packages/angular-mcp-server/
 | **Prompt** | `prompts/prompt-registry.ts` | 1. Append schema to `PROMPTS`. <br>2. Provide implementation in `PROMPTS_IMPL`. |
 | **Resource Provider** | `registerResources()` | Extend logic to aggregate custom docs or design-system assets. |
 
-All tools share the `ToolsConfig` interface (`@push-based/models`) that bundles:
+All tools share the `ToolsConfig` interface (`@code-pushup/models`) that bundles:
 - `schema` (name, description, arguments, return type)
 - `handler(request)` async function.
 
@@ -110,7 +110,6 @@ Validation is handled via **Zod** in `angular-mcp-server-options.schema.ts`.
 models  (types & schemas)
 ├─ utils
 ├─ styles-ast-utils
-├─ angular-cli-utils
 └─ angular-ast-utils
     └─ ds-component-coverage  (top-level plugin)
 ```

docs/writing-custom-tools.md

@@ -24,7 +24,7 @@ File name **must** end with `.tool.ts` so tests & registries can auto-discover i
 
 ```ts
 import { z } from 'zod';
-import { ToolSchemaOptions, ToolsConfig } from '@push-based/models';
+import { ToolSchemaOptions, ToolsConfig } from '@code-pushup/models';
 import { createHandler, RESULT_FORMATTERS } from '../shared/utils/handler-helpers.js';
 
 // 1️⃣ Schema

jest.preset.mjs

@@ -0,0 +1,3 @@
+import nxPreset from '@nx/jest/preset';
+
+export default { ...nxPreset };

package.json

@@ -1,6 +1,7 @@
 {
   "name": "@push-based/source",
   "version": "0.0.0",
+  "type": "module",
   "license": "MIT",
   "scripts": {},
   "private": true,
@@ -61,12 +62,11 @@
     "@angular-devkit/schematics": "~19.2.0",
     "@angular/cli": "~19.2.0",
     "@angular/compiler": "~19.2.0",
-    "@code-pushup/core": "^0.69.0",
-    "@code-pushup/eslint-plugin": "^0.69.0",
-    "@code-pushup/models": "^0.69.0",
-    "@code-pushup/utils": "^0.69.0",
+    "@code-pushup/core": "^0.75.0",
+    "@code-pushup/eslint-plugin": "^0.75.0",
+    "@code-pushup/models": "^0.75.0",
+    "@code-pushup/utils": "^0.75.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "@push-based/angular-cli-utils": "^0.0.1",
     "@push-based/ds-component-coverage": "^0.0.1",
     "@push-based/models": "^0.0.1",
     "@push-based/utils": "^0.0.1",

packages/angular-mcp-server/package.json

@@ -2,7 +2,7 @@
   "name": "@push-based/angular-mcp-server",
   "version": "0.0.1",
   "private": true,
-  "type": "commonjs",
+  "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",

packages/angular-mcp-server/src/index.ts

@@ -1 +1 @@
-export * from './lib/angular-mcp-server';
+export * from './lib/angular-mcp-server.js';

packages/angular-mcp-server/src/lib/angular-mcp-server.ts

@@ -11,16 +11,16 @@ import {
   ListResourcesResult,
   ListToolsRequestSchema,
 } from '@modelcontextprotocol/sdk/types.js';
-import { TOOLS } from './tools/tools';
-import { toolNotFound } from './tools/utils';
+import { TOOLS } from './tools/tools.js';
+import { toolNotFound } from './tools/utils.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import {
   AngularMcpServerOptionsSchema,
   AngularMcpServerOptions,
-} from './validation/angular-mcp-server-options.schema';
-import { validateAngularMcpServerFilesExist } from './validation/file-existence';
-import { validateDeprecatedCssClassesFile } from './validation/ds-components-file.validation';
+} from './validation/angular-mcp-server-options.schema.js';
+import { validateAngularMcpServerFilesExist } from './validation/file-existence.js';
+import { validateDeprecatedCssClassesFile } from './validation/ds-components-file.validation.js';
 
 export class AngularMcpServerWrapper {
   private readonly mcpServer: McpServer;

packages/angular-mcp-server/src/lib/tools/ds/component-contract/builder/models/schema.ts

@@ -2,7 +2,7 @@ import { ToolSchemaOptions } from '@push-based/models';
 import {
   COMMON_ANNOTATIONS,
   createProjectAnalysisSchema,
-} from '../../../shared';
+} from '../../../shared/index.js';
 
 /**
  * Schema for building component contracts

packages/angular-mcp-server/src/lib/tools/ds/component-contract/diff/models/schema.ts

@@ -2,7 +2,7 @@ import { ToolSchemaOptions } from '@push-based/models';
 import {
   createProjectAnalysisSchema,
   COMMON_ANNOTATIONS,
-} from '../../../shared';
+} from '../../../shared/index.js';
 
 /**
  * Schema for diffing component contracts

packages/angular-mcp-server/src/lib/tools/ds/component-usage-graph/models/types.ts

@@ -1,4 +1,4 @@
-import { SourceFileLocation } from '@push-based/models';
+import { SourceFileLocation } from '@code-pushup/models';
 
 export interface DependencyInfo {
   path: string;

packages/angular-mcp-server/src/lib/tools/ds/component-usage-graph/utils/component-helpers.ts

@@ -1,6 +1,6 @@
 import * as path from 'path';
-import { toUnixPath } from '@push-based/utils';
-import { buildText } from '../../shared/utils/output.utils';
+import { toUnixPath } from '@code-pushup/utils';
+import { buildText } from '../../shared/utils/output.utils.js';
 import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import {
   DependencyGraphResult,

packages/angular-mcp-server/src/lib/tools/ds/component-usage-graph/utils/component-usage-graph-builder.ts

@@ -1,5 +1,6 @@
 import * as path from 'path';
-import { toUnixPath, findAllFiles } from '@push-based/utils';
+import { toUnixPath } from '@code-pushup/utils';
+import { findAllFiles } from '@push-based/utils';
 import {
   BuildComponentUsageGraphOptions,
   ComponentUsageGraphResult,

packages/angular-mcp-server/src/lib/tools/ds/component-usage-graph/utils/path-resolver.ts

@@ -1,6 +1,6 @@
 import * as fs from 'fs';
 import * as path from 'path';
-import { toUnixPath } from '@push-based/utils';
+import { toUnixPath } from '@code-pushup/utils';
 import { DEPENDENCY_ANALYSIS_CONFIG } from '../models/config.js';
 
 const { resolveExtensions, indexFiles } = DEPENDENCY_ANALYSIS_CONFIG;

packages/angular-mcp-server/src/lib/tools/ds/component-usage-graph/utils/unified-ast-analyzer.ts

@@ -1,7 +1,7 @@
 import * as fs from 'fs';
 import * as path from 'path';
 import * as ts from 'typescript';
-import { toUnixPath } from '@push-based/utils';
+import { toUnixPath } from '@code-pushup/utils';
 
 import {
   DependencyInfo,

packages/angular-mcp-server/src/lib/tools/ds/component/get-deprecated-css-classes.tool.ts

@@ -28,7 +28,7 @@ export const getDeprecatedCssClassesHandler = createHandler<
 >(
   getDeprecatedCssClassesSchema.name,
   async ({ componentName }, { cwd, deprecatedCssClassesPath }) => {
-    return getDeprecatedCssClasses(
+    return await getDeprecatedCssClasses(
       componentName,
       deprecatedCssClassesPath,
       cwd,

packages/angular-mcp-server/src/lib/tools/ds/component/utils/deprecated-css-helpers.ts

@@ -14,11 +14,11 @@ export interface DeprecatedCssComponent {
  * @returns Array of deprecated CSS classes for the component
  * @throws Error if file not found, invalid format, or component not found
  */
-export function getDeprecatedCssClasses(
+export async function getDeprecatedCssClasses(
   componentName: string,
   deprecatedCssClassesPath: string,
   cwd: string,
-): string[] {
+): Promise<string[]> {
   if (
     !deprecatedCssClassesPath ||
     typeof deprecatedCssClassesPath !== 'string'
@@ -31,11 +31,10 @@ export function getDeprecatedCssClasses(
     throw new Error(`File not found at deprecatedCssClassesPath: ${absPath}`);
   }
 
-  const module = require(absPath);
+  const module = await import(absPath);
 
-  // Handle both ES modules (export default) and CommonJS (module.exports)
-  // Support: export default dsComponents, module.exports = { dsComponents }, or direct module.exports = dsComponents
-  const dsComponents = module.default || module.dsComponents || module;
+  // Pure ESM: use export default
+  const dsComponents = module.default;
 
   if (!Array.isArray(dsComponents)) {
     throw new Error('Invalid export: expected dsComponents to be an array');