feat(): migration to esm

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

@@ -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)
 ```

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,