@schematics/angular 20.2.0-next.2 → 20.2.0-rc.0

package/ai-config/files/__rulesName__.template

@@ -0,0 +1,49 @@
+<% if (frontmatter) { %><%= frontmatter %>
+
+<% } %>You are an expert in TypeScript, Angular, and scalable web application development. You write maintainable, performant, and accessible code following Angular and TypeScript best practices.
+
+## TypeScript Best Practices
+
+- Use strict type checking
+- Prefer type inference when the type is obvious
+- Avoid the `any` type; use `unknown` when type is uncertain
+
+## Angular Best Practices
+
+- Always use standalone components over NgModules
+- Must NOT set `standalone: true` inside Angular decorators. It's the default.
+- Use signals for state management
+- Implement lazy loading for feature routes
+- Do NOT use the `@HostBinding` and `@HostListener` decorators. Put host bindings inside the `host` object of the `@Component` or `@Directive` decorator instead
+- Use `NgOptimizedImage` for all static images.
+  - `NgOptimizedImage` does not work for inline base64 images.
+
+## Components
+
+- Keep components small and focused on a single responsibility
+- Use `input()` and `output()` functions instead of decorators
+- Use `computed()` for derived state
+- Set `changeDetection: ChangeDetectionStrategy.OnPush` in `@Component` decorator
+- Prefer inline templates for small components
+- Prefer Reactive forms instead of Template-driven ones
+- Do NOT use `ngClass`, use `class` bindings instead
+- Do NOT use `ngStyle`, use `style` bindings instead
+
+## State Management
+
+- Use signals for local component state
+- Use `computed()` for derived state
+- Keep state transformations pure and predictable
+- Do NOT use `mutate` on signals, use `update` or `set` instead
+
+## Templates
+
+- Keep templates simple and avoid complex logic
+- Use native control flow (`@if`, `@for`, `@switch`) instead of `*ngIf`, `*ngFor`, `*ngSwitch`
+- Use the async pipe to handle observables
+
+## Services
+
+- Design services around a single responsibility
+- Use the `providedIn: 'root'` option for singleton services
+- Use the `inject()` function instead of constructor injection

package/ai-config/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { Rule } from '@angular-devkit/schematics';
+import { Schema as ConfigOptions } from './schema';
+export default function ({ tool }: ConfigOptions): Rule;

package/ai-config/index.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const schematics_1 = require("@angular-devkit/schematics");
+const schema_1 = require("./schema");
+const AI_TOOLS = {
+    gemini: {
+        rulesName: 'GEMINI.md',
+        directory: '.gemini',
+    },
+    claude: {
+        rulesName: 'CLAUDE.md',
+        directory: '.claude',
+    },
+    copilot: {
+        rulesName: 'copilot-instructions.md',
+        directory: '.github',
+    },
+    windsurf: {
+        rulesName: 'guidelines.md',
+        directory: '.windsurf/rules',
+    },
+    jetbrains: {
+        rulesName: 'guidelines.md',
+        directory: '.junie',
+    },
+    // Cursor file has a front matter section.
+    cursor: {
+        rulesName: 'cursor.mdc',
+        directory: '.cursor/rules',
+        frontmatter: `---\ncontext: true\npriority: high\nscope: project\n---`,
+    },
+};
+function default_1({ tool }) {
+    if (!tool || tool.includes(schema_1.Tool.None)) {
+        return (0, schematics_1.noop)();
+    }
+    const files = tool.map((selectedTool) => AI_TOOLS[selectedTool]);
+    const rules = files.map(({ rulesName, directory, frontmatter }) => (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)('./files'), [
+        (0, schematics_1.applyTemplates)({
+            ...schematics_1.strings,
+            rulesName,
+            frontmatter,
+        }),
+        (0, schematics_1.move)(directory),
+    ])));
+    return (0, schematics_1.chain)(rules);
+}

package/ai-config/schema.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Generates AI configuration files for Angular projects. This schematic creates
+ * configuration files that help AI tools follow Angular best practices, improving the
+ * quality of AI-generated code and suggestions.
+ */
+export type Schema = {
+    /**
+     * Specifies which AI tools to generate configuration files for. These file are used to
+     * improve the outputs of AI tools by following the best practices.
+     */
+    tool?: Tool[];
+};
+export declare enum Tool {
+    Claude = "claude",
+    Copilot = "copilot",
+    Cursor = "cursor",
+    Gemini = "gemini",
+    Jetbrains = "jetbrains",
+    None = "none",
+    Windsurf = "windsurf"
+}

package/ai-config/schema.js

@@ -0,0 +1,15 @@
+"use strict";
+// THIS FILE IS AUTOMATICALLY GENERATED. TO UPDATE THIS FILE YOU NEED TO CHANGE THE
+// CORRESPONDING JSON SCHEMA FILE, THEN RUN devkit-admin build (or bazel build ...).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tool = void 0;
+var Tool;
+(function (Tool) {
+    Tool["Claude"] = "claude";
+    Tool["Copilot"] = "copilot";
+    Tool["Cursor"] = "cursor";
+    Tool["Gemini"] = "gemini";
+    Tool["Jetbrains"] = "jetbrains";
+    Tool["None"] = "none";
+    Tool["Windsurf"] = "windsurf";
+})(Tool || (exports.Tool = Tool = {}));

package/ai-config/schema.json

@@ -0,0 +1,39 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema",
+  "$id": "SchematicsAngularAIConfig",
+  "title": "Angular AI Config File Options Schema",
+  "type": "object",
+  "additionalProperties": false,
+  "description": "Generates AI configuration files for Angular projects. This schematic creates configuration files that help AI tools follow Angular best practices, improving the quality of AI-generated code and suggestions.",
+  "properties": {
+    "tool": {
+      "type": "array",
+      "uniqueItems": true,
+      "default": "none",
+      "x-prompt": "Which AI tools do you want to configure with Angular best practices? https://angular.dev/ai/develop-with-ai",
+      "description": "Specifies which AI tools to generate configuration files for. These file are used to improve the outputs of AI tools by following the best practices.",
+      "minItems": 1,
+      "items": {
+        "type": "string",
+        "enum": ["none", "gemini", "copilot", "claude", "cursor", "jetbrains", "windsurf"]
+      }
+    }
+  },
+  "if": {
+    "properties": {
+      "tool": {
+        "contains": {
+          "const": "none"
+        }
+      }
+    },
+    "required": ["tool"]
+  },
+  "then": {
+    "properties": {
+      "tool": {
+        "maxItems": 1
+      }
+    }
+  }
+}

package/application/index.js

@@ -10,14 +10,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
 const core_1 = require("@angular-devkit/core");
 const schematics_1 = require("@angular-devkit/schematics");
-const tasks_1 = require("@angular-devkit/schematics/tasks");
-const dependencies_1 = require("../utility/dependencies");
+const dependency_1 = require("../utility/dependency");
 const json_file_1 = require("../utility/json-file");
 const latest_versions_1 = require("../utility/latest-versions");
 const paths_1 = require("../utility/paths");
 const workspace_1 = require("../utility/workspace");
 const workspace_models_1 = require("../utility/workspace-models");
 const schema_1 = require("./schema");
+const APPLICATION_DEV_DEPENDENCIES = [
+    { name: '@angular/compiler-cli', version: latest_versions_1.latestVersions.Angular },
+    { name: '@angular/build', version: latest_versions_1.latestVersions.AngularBuild },
+    { name: 'typescript', version: latest_versions_1.latestVersions['typescript'] },
+];
 function addTsProjectReference(...paths) {
     return (host) => {
         if (!host.exists('tsconfig.json')) {
@@ -104,43 +108,26 @@ function default_1(options) {
     };
 }
 function addDependenciesToPackageJson(options) {
-    return (host, context) => {
-        [
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: '@angular/compiler-cli',
-                version: latest_versions_1.latestVersions.Angular,
-            },
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: '@angular/build',
-                version: latest_versions_1.latestVersions.AngularBuild,
-            },
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: 'typescript',
-                version: latest_versions_1.latestVersions['typescript'],
-            },
-        ].forEach((dependency) => (0, dependencies_1.addPackageJsonDependency)(host, dependency));
-        if (!options.zoneless) {
-            (0, dependencies_1.addPackageJsonDependency)(host, {
-                type: dependencies_1.NodeDependencyType.Default,
-                name: 'zone.js',
-                version: latest_versions_1.latestVersions['zone.js'],
-            });
-        }
-        if (options.style === schema_1.Style.Less) {
-            (0, dependencies_1.addPackageJsonDependency)(host, {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: 'less',
-                version: latest_versions_1.latestVersions['less'],
-            });
-        }
-        if (!options.skipInstall) {
-            context.addTask(new tasks_1.NodePackageInstallTask());
-        }
-        return host;
-    };
+    const rules = APPLICATION_DEV_DEPENDENCIES.map((dependency) => (0, dependency_1.addDependency)(dependency.name, dependency.version, {
+        type: dependency_1.DependencyType.Dev,
+        existing: dependency_1.ExistingBehavior.Skip,
+        install: options.skipInstall ? dependency_1.InstallBehavior.None : dependency_1.InstallBehavior.Auto,
+    }));
+    if (!options.zoneless) {
+        rules.push((0, dependency_1.addDependency)('zone.js', latest_versions_1.latestVersions['zone.js'], {
+            type: dependency_1.DependencyType.Default,
+            existing: dependency_1.ExistingBehavior.Skip,
+            install: options.skipInstall ? dependency_1.InstallBehavior.None : dependency_1.InstallBehavior.Auto,
+        }));
+    }
+    if (options.style === schema_1.Style.Less) {
+        rules.push((0, dependency_1.addDependency)('less', latest_versions_1.latestVersions['less'], {
+            type: dependency_1.DependencyType.Dev,
+            existing: dependency_1.ExistingBehavior.Skip,
+            install: options.skipInstall ? dependency_1.InstallBehavior.None : dependency_1.InstallBehavior.Auto,
+        }));
+    }
+    return (0, schematics_1.chain)(rules);
 }
 function addAppToWorkspaceFile(options, appDir) {
     let projectRoot = appDir;

package/collection.json

@@ -131,6 +131,11 @@
       "factory": "./config",
       "schema": "./config/schema.json",
       "description": "Generates a configuration file."
+    },
+    "ai-config": {
+      "factory": "./ai-config",
+      "schema": "./ai-config/schema.json",
+      "description": "Generates an AI tool configuration file."
     }
   }
 }

package/library/index.js

@@ -9,14 +9,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = default_1;
 const schematics_1 = require("@angular-devkit/schematics");
-const tasks_1 = require("@angular-devkit/schematics/tasks");
 const posix_1 = require("node:path/posix");
-const dependencies_1 = require("../utility/dependencies");
+const dependency_1 = require("../utility/dependency");
 const json_file_1 = require("../utility/json-file");
 const latest_versions_1 = require("../utility/latest-versions");
 const paths_1 = require("../utility/paths");
 const workspace_1 = require("../utility/workspace");
 const workspace_models_1 = require("../utility/workspace-models");
+const LIBRARY_DEV_DEPENDENCIES = [
+    { name: '@angular/compiler-cli', version: latest_versions_1.latestVersions.Angular },
+    { name: '@angular/build', version: latest_versions_1.latestVersions.AngularBuild },
+    { name: 'ng-packagr', version: latest_versions_1.latestVersions.NgPackagr },
+    { name: 'typescript', version: latest_versions_1.latestVersions['typescript'] },
+];
 function updateTsConfig(packageName, ...paths) {
     return (host) => {
         if (!host.exists('tsconfig.json')) {
@@ -40,37 +45,19 @@ function addTsProjectReference(...paths) {
         file.modify(jsonPath, Array.isArray(value) ? [...value, ...newReferences] : newReferences);
     };
 }
-function addDependenciesToPackageJson() {
-    return (host) => {
-        [
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: '@angular/compiler-cli',
-                version: latest_versions_1.latestVersions.Angular,
-            },
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: '@angular/build',
-                version: latest_versions_1.latestVersions.AngularBuild,
-            },
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: 'ng-packagr',
-                version: latest_versions_1.latestVersions.NgPackagr,
-            },
-            {
-                type: dependencies_1.NodeDependencyType.Default,
-                name: 'tslib',
-                version: latest_versions_1.latestVersions['tslib'],
-            },
-            {
-                type: dependencies_1.NodeDependencyType.Dev,
-                name: 'typescript',
-                version: latest_versions_1.latestVersions['typescript'],
-            },
-        ].forEach((dependency) => (0, dependencies_1.addPackageJsonDependency)(host, dependency));
-        return host;
-    };
+function addDependenciesToPackageJson(skipInstall) {
+    return (0, schematics_1.chain)([
+        ...LIBRARY_DEV_DEPENDENCIES.map((dependency) => (0, dependency_1.addDependency)(dependency.name, dependency.version, {
+            type: dependency_1.DependencyType.Dev,
+            existing: dependency_1.ExistingBehavior.Skip,
+            install: skipInstall ? dependency_1.InstallBehavior.None : dependency_1.InstallBehavior.Auto,
+        })),
+        (0, dependency_1.addDependency)('tslib', latest_versions_1.latestVersions['tslib'], {
+            type: dependency_1.DependencyType.Default,
+            existing: dependency_1.ExistingBehavior.Skip,
+            install: skipInstall ? dependency_1.InstallBehavior.None : dependency_1.InstallBehavior.Auto,
+        }),
+    ]);
 }
 function addLibToWorkspaceFile(options, projectRoot, projectName, hasZoneDependency) {
     return (0, workspace_1.updateWorkspace)((workspace) => {
@@ -139,11 +126,11 @@ function default_1(options) {
             }),
             (0, schematics_1.move)(libDir),
         ]);
-        const hasZoneDependency = (0, dependencies_1.getPackageJsonDependency)(host, 'zone.js') !== null;
+        const hasZoneDependency = (0, dependency_1.getDependency)(host, 'zone.js') !== null;
         return (0, schematics_1.chain)([
             (0, schematics_1.mergeWith)(templateSource),
             addLibToWorkspaceFile(options, libDir, packageName, hasZoneDependency),
-            options.skipPackageJson ? (0, schematics_1.noop)() : addDependenciesToPackageJson(),
+            options.skipPackageJson ? (0, schematics_1.noop)() : addDependenciesToPackageJson(!!options.skipInstall),
             options.skipTsConfig ? (0, schematics_1.noop)() : updateTsConfig(packageName, './' + distRoot),
             options.skipTsConfig
                 ? (0, schematics_1.noop)()
@@ -156,6 +143,9 @@ function default_1(options) {
                     flat: true,
                     path: sourceDir,
                     project: packageName,
+                    // Explicitly set the `typeSeparator` this also ensures that the generated files are valid even if the `module` schematic
+                    // inherits its `typeSeparator` from the workspace.
+                    typeSeparator: '-',
                 }),
             (0, schematics_1.schematic)('component', {
                 name: options.name,
@@ -172,11 +162,6 @@ function default_1(options) {
                 // inherits its `type` from the workspace.
                 type: '',
             }),
-            (_tree, context) => {
-                if (!options.skipPackageJson && !options.skipInstall) {
-                    context.addTask(new tasks_1.NodePackageInstallTask());
-                }
-            },
         ]);
     };
 }

package/migrations/karma/karma-config-analyzer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+export interface RequireInfo {
+    module: string;
+    export?: string;
+    isCall?: boolean;
+    arguments?: KarmaConfigValue[];
+}
+export type KarmaConfigValue = string | boolean | number | KarmaConfigValue[] | {
+    [key: string]: KarmaConfigValue;
+} | RequireInfo | undefined;
+export interface KarmaConfigAnalysis {
+    settings: Map<string, KarmaConfigValue>;
+    hasUnsupportedValues: boolean;
+}
+/**
+ * Analyzes the content of a Karma configuration file to extract its settings.
+ *
+ * @param content The string content of the `karma.conf.js` file.
+ * @returns An object containing the configuration settings and a flag indicating if unsupported values were found.
+ */
+export declare function analyzeKarmaConfig(content: string): KarmaConfigAnalysis;

package/migrations/karma/karma-config-analyzer.js

@@ -0,0 +1,131 @@
+"use strict";
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.analyzeKarmaConfig = analyzeKarmaConfig;
+const typescript_1 = __importDefault(require("../../third_party/github.com/Microsoft/TypeScript/lib/typescript"));
+function isRequireInfo(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) && 'module' in value;
+}
+function isSupportedPropertyAssignment(prop) {
+    return (typescript_1.default.isPropertyAssignment(prop) && (typescript_1.default.isIdentifier(prop.name) || typescript_1.default.isStringLiteral(prop.name)));
+}
+/**
+ * Analyzes the content of a Karma configuration file to extract its settings.
+ *
+ * @param content The string content of the `karma.conf.js` file.
+ * @returns An object containing the configuration settings and a flag indicating if unsupported values were found.
+ */
+function analyzeKarmaConfig(content) {
+    const sourceFile = typescript_1.default.createSourceFile('karma.conf.js', content, typescript_1.default.ScriptTarget.Latest, true);
+    const settings = new Map();
+    let hasUnsupportedValues = false;
+    function visit(node) {
+        // The Karma configuration is defined within a `config.set({ ... })` call.
+        if (typescript_1.default.isCallExpression(node) &&
+            typescript_1.default.isPropertyAccessExpression(node.expression) &&
+            node.expression.expression.getText(sourceFile) === 'config' &&
+            node.expression.name.text === 'set' &&
+            node.arguments.length === 1 &&
+            typescript_1.default.isObjectLiteralExpression(node.arguments[0])) {
+            // We found `config.set`, now we extract the properties from the object literal.
+            for (const prop of node.arguments[0].properties) {
+                if (isSupportedPropertyAssignment(prop)) {
+                    const key = prop.name.text;
+                    const value = extractValue(prop.initializer);
+                    settings.set(key, value);
+                }
+                else {
+                    hasUnsupportedValues = true;
+                }
+            }
+        }
+        else {
+            typescript_1.default.forEachChild(node, visit);
+        }
+    }
+    function extractValue(node) {
+        switch (node.kind) {
+            case typescript_1.default.SyntaxKind.StringLiteral:
+                return node.text;
+            case typescript_1.default.SyntaxKind.NumericLiteral:
+                return Number(node.text);
+            case typescript_1.default.SyntaxKind.TrueKeyword:
+                return true;
+            case typescript_1.default.SyntaxKind.FalseKeyword:
+                return false;
+            case typescript_1.default.SyntaxKind.Identifier: {
+                const identifier = node.text;
+                if (identifier === '__dirname' || identifier === '__filename') {
+                    return identifier;
+                }
+                break;
+            }
+            case typescript_1.default.SyntaxKind.CallExpression: {
+                const callExpr = node;
+                // Handle require('...')
+                if (typescript_1.default.isIdentifier(callExpr.expression) &&
+                    callExpr.expression.text === 'require' &&
+                    callExpr.arguments.length === 1 &&
+                    typescript_1.default.isStringLiteral(callExpr.arguments[0])) {
+                    return { module: callExpr.arguments[0].text };
+                }
+                // Handle calls on a require, e.g. require('path').join()
+                const calleeValue = extractValue(callExpr.expression);
+                if (isRequireInfo(calleeValue)) {
+                    return {
+                        ...calleeValue,
+                        isCall: true,
+                        arguments: callExpr.arguments.map(extractValue),
+                    };
+                }
+                break;
+            }
+            case typescript_1.default.SyntaxKind.PropertyAccessExpression: {
+                const propAccessExpr = node;
+                // Handle config constants like `config.LOG_INFO`
+                if (typescript_1.default.isIdentifier(propAccessExpr.expression) &&
+                    propAccessExpr.expression.text === 'config') {
+                    return `config.${propAccessExpr.name.text}`;
+                }
+                const value = extractValue(propAccessExpr.expression);
+                if (isRequireInfo(value)) {
+                    const currentExport = value.export
+                        ? `${value.export}.${propAccessExpr.name.text}`
+                        : propAccessExpr.name.text;
+                    return { ...value, export: currentExport };
+                }
+                break;
+            }
+            case typescript_1.default.SyntaxKind.ArrayLiteralExpression:
+                return node.elements.map(extractValue);
+            case typescript_1.default.SyntaxKind.ObjectLiteralExpression: {
+                const obj = {};
+                for (const prop of node.properties) {
+                    if (isSupportedPropertyAssignment(prop)) {
+                        // Recursively extract values for nested objects.
+                        obj[prop.name.text] = extractValue(prop.initializer);
+                    }
+                    else {
+                        hasUnsupportedValues = true;
+                    }
+                }
+                return obj;
+            }
+        }
+        // For complex expressions (like variables) that we don't need to resolve,
+        // we mark the analysis as potentially incomplete.
+        hasUnsupportedValues = true;
+        return undefined;
+    }
+    visit(sourceFile);
+    return { settings, hasUnsupportedValues };
+}

package/migrations/karma/karma-config-comparer.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright Google LLC All Rights Reserved.
+ *
+ * Use of this source code is governed by an MIT-style license that can be
+ * found in the LICENSE file at https://angular.dev/license
+ */
+import { KarmaConfigAnalysis, KarmaConfigValue } from './karma-config-analyzer';
+/**
+ * Represents the difference between two Karma configurations.
+ */
+export interface KarmaConfigDiff {
+    /** A map of settings that were added in the project's configuration. */
+    added: Map<string, KarmaConfigValue>;
+    /** A map of settings that were removed from the project's configuration. */
+    removed: Map<string, KarmaConfigValue>;
+    /** A map of settings that were modified between the two configurations. */
+    modified: Map<string, {
+        projectValue: KarmaConfigValue;
+        defaultValue: KarmaConfigValue;
+    }>;
+    /** A boolean indicating if the comparison is reliable (i.e., no unsupported values were found). */
+    isReliable: boolean;
+}
+/**
+ * Generates the default Karma configuration file content as a string.
+ * @param relativePathToWorkspaceRoot The relative path from the Karma config file to the workspace root.
+ * @param projectName The name of the project.
+ * @param needDevkitPlugin A boolean indicating if the devkit plugin is needed.
+ * @returns The content of the default `karma.conf.js` file.
+ */
+export declare function generateDefaultKarmaConfig(relativePathToWorkspaceRoot: string, projectName: string, needDevkitPlugin: boolean): Promise<string>;
+/**
+ * Compares two Karma configuration analyses and returns the difference.
+ * @param projectAnalysis The analysis of the project's configuration.
+ * @param defaultAnalysis The analysis of the default configuration to compare against.
+ * @returns A diff object representing the changes between the two configurations.
+ */
+export declare function compareKarmaConfigs(projectAnalysis: KarmaConfigAnalysis, defaultAnalysis: KarmaConfigAnalysis): KarmaConfigDiff;
+/**
+ * Checks if there are any differences in the provided Karma configuration diff.
+ * @param diff The Karma configuration diff object to check.
+ * @returns True if there are any differences; false otherwise.
+ */
+export declare function hasDifferences(diff: KarmaConfigDiff): boolean;
+/**
+ * Compares a project's Karma configuration with the default configuration.
+ * @param projectConfigContent The content of the project's `karma.conf.js` file.
+ * @param projectRoot The root directory of the project.
+ * @param needDevkitPlugin A boolean indicating if the devkit plugin is needed for the default config.
+ * @param karmaConfigPath The path to the Karma configuration file, used to resolve relative paths.
+ * @returns A diff object representing the changes.
+ */
+export declare function compareKarmaConfigToDefault(projectConfigContent: string, projectName: string, karmaConfigPath: string, needDevkitPlugin: boolean): Promise<KarmaConfigDiff>;
+/**
+ * Compares a project's Karma configuration with the default configuration.
+ * @param projectAnalysis The analysis of the project's configuration.
+ * @param projectRoot The root directory of the project.
+ * @param needDevkitPlugin A boolean indicating if the devkit plugin is needed for the default config.
+ * @param karmaConfigPath The path to the Karma configuration file, used to resolve relative paths.
+ * @returns A diff object representing the changes.
+ */
+export declare function compareKarmaConfigToDefault(projectAnalysis: KarmaConfigAnalysis, projectName: string, karmaConfigPath: string, needDevkitPlugin: boolean): Promise<KarmaConfigDiff>;