@nx/angular 0.0.0-pr-22179-271588f

package/src/generators/library-secondary-entry-point/files/ng-package.json__tmpl__

@@ -0,0 +1,5 @@
+{
+  "lib": {
+    "entryFile": "src/index.ts"
+  }
+}

package/src/generators/library-secondary-entry-point/files/src/index.ts__tmpl__

@@ -0,0 +1 @@
+<% if (!skipModule) { %>export * from './lib/<%= fileName %>.module';<% } else { %>export const greeting = 'Hello World!';<% } %>

package/src/generators/library-secondary-entry-point/files/src/lib/__fileName__.module.ts__tmpl__

@@ -0,0 +1,7 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+
+@NgModule({
+  imports: [CommonModule],
+})
+export class <%= className %>Module {}

package/src/generators/library-secondary-entry-point/lib/add-files.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import { NormalizedGeneratorOptions } from '../schema';
+export declare function addFiles(tree: Tree, options: NormalizedGeneratorOptions): void;

package/src/generators/library-secondary-entry-point/lib/add-files.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addFiles = void 0;
+const devkit_1 = require("@nx/devkit");
+function addFiles(tree, options) {
+    const nameVariants = (0, devkit_1.names)(options.name);
+    (0, devkit_1.generateFiles)(tree, (0, devkit_1.joinPathFragments)(__dirname, '..', 'files'), options.entryPointDestination, {
+        ...options,
+        ...nameVariants,
+        tmpl: '',
+    });
+    if (options.skipModule) {
+        tree.delete((0, devkit_1.joinPathFragments)(options.entryPointDestination, `src/lib/${nameVariants.fileName}.module.ts`));
+    }
+}
+exports.addFiles = addFiles;

package/src/generators/library-secondary-entry-point/lib/add-path-mapping.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import { NormalizedGeneratorOptions } from '../schema';
+export declare function addPathMapping(tree: Tree, options: NormalizedGeneratorOptions): void;

package/src/generators/library-secondary-entry-point/lib/add-path-mapping.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPathMapping = void 0;
+const devkit_1 = require("@nx/devkit");
+const js_1 = require("@nx/js");
+function addPathMapping(tree, options) {
+    (0, devkit_1.updateJson)(tree, (0, js_1.getRootTsConfigPathInTree)(tree), (json) => {
+        const c = json.compilerOptions;
+        c.paths = c.paths || {};
+        c.paths[options.secondaryEntryPoint] = [
+            `${options.libraryProject.root}/${options.name}/src/index.ts`,
+        ];
+        return json;
+    });
+}
+exports.addPathMapping = addPathMapping;

package/src/generators/library-secondary-entry-point/lib/index.d.ts

@@ -0,0 +1,4 @@
+export * from './add-files';
+export * from './add-path-mapping';
+export * from './normalize-options';
+export * from './update-tsconfig-included-files';

package/src/generators/library-secondary-entry-point/lib/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./add-files"), exports);
+tslib_1.__exportStar(require("./add-path-mapping"), exports);
+tslib_1.__exportStar(require("./normalize-options"), exports);
+tslib_1.__exportStar(require("./update-tsconfig-included-files"), exports);

package/src/generators/library-secondary-entry-point/lib/normalize-options.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import { GeneratorOptions, NormalizedGeneratorOptions } from '../schema';
+export declare function normalizeOptions(tree: Tree, options: GeneratorOptions): NormalizedGeneratorOptions;

package/src/generators/library-secondary-entry-point/lib/normalize-options.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeOptions = void 0;
+const devkit_1 = require("@nx/devkit");
+function normalizeOptions(tree, options) {
+    const name = (0, devkit_1.names)(options.name).fileName;
+    const projects = (0, devkit_1.getProjects)(tree);
+    const libraryProject = projects.get(options.library);
+    if (!libraryProject) {
+        throw new Error(`The specified library "${options.library}" couldn't be found in the workspace.`);
+    }
+    if (libraryProject.projectType !== 'library') {
+        throw new Error(`The specified project "${options.library}" is not a library.`);
+    }
+    const entryPointDestination = (0, devkit_1.joinPathFragments)(libraryProject.root, options.name);
+    if (tree.exists(entryPointDestination)) {
+        throw new Error(`The folder for the secondary entry point "${entryPointDestination}" already exists.`);
+    }
+    const { name: mainEntryPoint } = (0, devkit_1.readJson)(tree, (0, devkit_1.joinPathFragments)(libraryProject.root, 'package.json'));
+    const secondaryEntryPoint = `${mainEntryPoint}/${options.name}`;
+    return {
+        ...options,
+        entryPointDestination,
+        mainEntryPoint,
+        name,
+        libraryProject,
+        secondaryEntryPoint,
+        skipModule: options.skipModule ?? false,
+    };
+}
+exports.normalizeOptions = normalizeOptions;

package/src/generators/library-secondary-entry-point/lib/update-tsconfig-included-files.d.ts

@@ -0,0 +1,3 @@
+import { type Tree } from '@nx/devkit';
+import type { NormalizedGeneratorOptions } from '../schema';
+export declare function updateTsConfigIncludedFiles(tree: Tree, options: NormalizedGeneratorOptions): void;

package/src/generators/library-secondary-entry-point/lib/update-tsconfig-included-files.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateTsConfigIncludedFiles = void 0;
+const devkit_1 = require("@nx/devkit");
+function updateTsConfigIncludedFiles(tree, options) {
+    const candidateTsConfigPaths = [
+        options.libraryProject.targets?.build?.options?.tsConfig,
+        (0, devkit_1.joinPathFragments)(options.libraryProject.root, 'tsconfig.lib.json'),
+        (0, devkit_1.joinPathFragments)(options.libraryProject.root, 'tsconfig.json'),
+    ];
+    const tsConfigPath = candidateTsConfigPaths.find((path) => path && tree.exists(path));
+    if (!tsConfigPath) {
+        // ignore if the library has a custom tsconfig setup
+        return;
+    }
+    (0, devkit_1.updateJson)(tree, tsConfigPath, (json) => {
+        if (json.include?.length) {
+            json.include = json.include.map((path) => path.replace(/^(?:\.\/)?src\//, ''));
+        }
+        if (json.exclude?.length) {
+            json.exclude = json.exclude.map((path) => path.replace(/^(?:\.\/)?src\//, ''));
+        }
+        return json;
+    });
+}
+exports.updateTsConfigIncludedFiles = updateTsConfigIncludedFiles;

package/src/generators/library-secondary-entry-point/library-secondary-entry-point.d.ts

@@ -0,0 +1,4 @@
+import { Tree } from '@nx/devkit';
+import { GeneratorOptions } from './schema';
+export declare function librarySecondaryEntryPointGenerator(tree: Tree, rawOptions: GeneratorOptions): Promise<void>;
+export default librarySecondaryEntryPointGenerator;

package/src/generators/library-secondary-entry-point/library-secondary-entry-point.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.librarySecondaryEntryPointGenerator = void 0;
+const devkit_1 = require("@nx/devkit");
+const lib_1 = require("./lib");
+async function librarySecondaryEntryPointGenerator(tree, rawOptions) {
+    const options = (0, lib_1.normalizeOptions)(tree, rawOptions);
+    (0, lib_1.addFiles)(tree, options);
+    (0, lib_1.addPathMapping)(tree, options);
+    (0, lib_1.updateTsConfigIncludedFiles)(tree, options);
+    if (!options.skipFormat) {
+        await (0, devkit_1.formatFiles)(tree);
+    }
+}
+exports.librarySecondaryEntryPointGenerator = librarySecondaryEntryPointGenerator;
+exports.default = librarySecondaryEntryPointGenerator;

package/src/generators/library-secondary-entry-point/schema.d.ts

@@ -0,0 +1,16 @@
+import { ProjectConfiguration } from '@nx/devkit';
+
+export interface GeneratorOptions {
+  library: string;
+  name: string;
+  skipModule?: boolean;
+  skipFormat?: boolean;
+}
+
+export interface NormalizedGeneratorOptions extends GeneratorOptions {
+  entryPointDestination: string;
+  libraryProject: ProjectConfiguration;
+  mainEntryPoint: string;
+  secondaryEntryPoint: string;
+  skipModule: boolean;
+}

package/src/generators/library-secondary-entry-point/schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "NxAngularLibrarySecondaryEntryPoint",
+  "title": "Creates a secondary entry point for a library",
+  "description": "Creates a secondary entry point for an Angular publishable library.",
+  "type": "object",
+  "cli": "nx",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "The name of the secondary entry point.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What name would you like to use for the secondary entry point?",
+      "pattern": "(?:^@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*(?:\\/[a-zA-Z0-9-~][a-zA-Z0-9-._~]*)+|^[a-zA-Z][^:]*)$",
+      "x-priority": "important"
+    },
+    "library": {
+      "type": "string",
+      "description": "The name of the library to create the secondary entry point for.",
+      "x-prompt": "What library would you like to create the secondary entry point for?",
+      "pattern": "(?:^@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*\\/[a-zA-Z0-9-~][a-zA-Z0-9-._~]*|^[a-zA-Z][^:]*)$",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "skipModule": {
+      "type": "boolean",
+      "description": "Skip generating a module for the secondary entry point.",
+      "default": false
+    },
+    "skipFormat": {
+      "description": "Skip formatting files.",
+      "type": "boolean",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "additionalProperties": false,
+  "required": ["name", "library"],
+  "examplesFile": "../../../docs/library-secondary-entry-point-examples.md"
+}

package/src/generators/move/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './update-module-name';
+export * from './update-ng-package';
+export * from './update-secondary-entry-points';

package/src/generators/move/lib/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./update-module-name"), exports);
+tslib_1.__exportStar(require("./update-ng-package"), exports);
+tslib_1.__exportStar(require("./update-secondary-entry-points"), exports);

package/src/generators/move/lib/types.d.ts

@@ -0,0 +1,4 @@
+export type MoveImplOptions = {
+    oldProjectName: string;
+    newProjectName: string;
+};

package/src/generators/move/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/src/generators/move/lib/update-module-name.d.ts

@@ -0,0 +1,11 @@
+import { Tree } from '@nx/devkit';
+import type { MoveImplOptions } from './types';
+/**
+ * Updates the Angular module name (including the spec file and index.ts)
+ *
+ * Again, if the user has deviated from the expected folder
+ * structure, they are very much on their own.
+ *
+ * @param schema The options provided to the schematic
+ */
+export declare function updateModuleName(tree: Tree, { oldProjectName, newProjectName }: MoveImplOptions): void;

package/src/generators/move/lib/update-module-name.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateModuleName = void 0;
+const devkit_1 = require("@nx/devkit");
+/**
+ * Updates the Angular module name (including the spec file and index.ts)
+ *
+ * Again, if the user has deviated from the expected folder
+ * structure, they are very much on their own.
+ *
+ * @param schema The options provided to the schematic
+ */
+function updateModuleName(tree, { oldProjectName, newProjectName }) {
+    const unscopedNewProjectName = newProjectName.startsWith('@')
+        ? newProjectName.split('/')[1]
+        : newProjectName;
+    if (oldProjectName === unscopedNewProjectName) {
+        return;
+    }
+    const project = (0, devkit_1.readProjectConfiguration)(tree, newProjectName);
+    if (project.projectType === 'application') {
+        // Expect the module to be something like 'app.module.ts' regardless of the folder name,
+        // Therefore, nothing to do.
+        return;
+    }
+    const moduleName = {
+        from: `${(0, devkit_1.names)(oldProjectName).className}Module`,
+        to: `${(0, devkit_1.names)(unscopedNewProjectName).className}Module`,
+    };
+    const findModuleName = new RegExp(`\\b${moduleName.from}`, 'g');
+    const moduleFile = {
+        from: `${oldProjectName}.module`,
+        to: `${unscopedNewProjectName}.module`,
+    };
+    const findFileName = new RegExp(`\\b${moduleFile.from}`, 'g');
+    const filesToRename = [
+        {
+            from: `${project.sourceRoot}/lib/${moduleFile.from}.ts`,
+            to: `${project.sourceRoot}/lib/${moduleFile.to}.ts`,
+        },
+        {
+            from: `${project.sourceRoot}/lib/${moduleFile.from}.spec.ts`,
+            to: `${project.sourceRoot}/lib/${moduleFile.to}.spec.ts`,
+        },
+    ].filter((rename) => rename.from !== rename.to);
+    if (filesToRename.length === 0) {
+        return;
+    }
+    const replacements = [
+        {
+            regex: findFileName,
+            replaceWith: moduleFile.to,
+        },
+        {
+            regex: findModuleName,
+            replaceWith: moduleName.to,
+        },
+    ];
+    // Update the module file and its spec file
+    filesToRename.forEach((file) => {
+        if (tree.exists(file.from)) {
+            updateFileContent(tree, replacements, file.from, file.to);
+            tree.delete(file.from);
+        }
+    });
+    // update index file
+    const indexFile = (0, devkit_1.joinPathFragments)(project.sourceRoot, 'index.ts');
+    if (tree.exists(indexFile)) {
+        updateFileContent(tree, replacements, indexFile);
+    }
+    const skipFiles = [...filesToRename.map((file) => file.to), indexFile];
+    // Update any files which import the module
+    for (const [, definition] of (0, devkit_1.getProjects)(tree)) {
+        (0, devkit_1.visitNotIgnoredFiles)(tree, definition.root, (file) => {
+            const normalizedFile = (0, devkit_1.normalizePath)(file);
+            // skip files that were already modified
+            if (skipFiles.includes(normalizedFile)) {
+                return;
+            }
+            updateFileContent(tree, replacements, normalizedFile);
+        });
+    }
+}
+exports.updateModuleName = updateModuleName;
+function updateFileContent(tree, replacements, fileName, newFileName) {
+    let content = tree.read(fileName, 'utf-8');
+    if (content) {
+        let updated = false;
+        replacements.forEach((replacement) => {
+            if (replacement.regex.test(content)) {
+                content = content.replace(replacement.regex, replacement.replaceWith);
+                updated = true;
+            }
+        });
+        if (updated) {
+            tree.write(newFileName ?? fileName, content);
+        }
+    }
+}

package/src/generators/move/lib/update-ng-package.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+import type { MoveImplOptions } from './types';
+export declare function updateNgPackage(tree: Tree, schema: MoveImplOptions): void;

package/src/generators/move/lib/update-ng-package.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateNgPackage = void 0;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+function updateNgPackage(tree, schema) {
+    const project = (0, devkit_1.readProjectConfiguration)(tree, schema.newProjectName);
+    if (project.projectType === 'application') {
+        return;
+    }
+    const ngPackagePath = `${project.root}/ng-package.json`;
+    if (!tree.exists(ngPackagePath)) {
+        return;
+    }
+    const rootOffset = (0, devkit_1.normalizePath)((0, path_1.relative)((0, path_1.join)(devkit_1.workspaceRoot, project.root), devkit_1.workspaceRoot));
+    const outputs = (0, devkit_1.getOutputsForTargetAndConfiguration)({
+        project: schema.newProjectName,
+        target: 'build',
+    }, {}, {
+        name: schema.newProjectName,
+        type: 'lib',
+        data: {
+            root: project.root,
+            targets: project.targets,
+        },
+    });
+    const output = outputs[0] ?? `dist/${project.root}`;
+    (0, devkit_1.updateJson)(tree, ngPackagePath, (json) => {
+        json.dest = `${rootOffset}/${output}`;
+        return json;
+    });
+}
+exports.updateNgPackage = updateNgPackage;

package/src/generators/move/lib/update-secondary-entry-points.d.ts

@@ -0,0 +1,3 @@
+import type { Tree } from '@nx/devkit';
+import type { MoveImplOptions } from './types';
+export declare function updateSecondaryEntryPoints(tree: Tree, schema: MoveImplOptions): void;

package/src/generators/move/lib/update-secondary-entry-points.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateSecondaryEntryPoints = void 0;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+const libraryExecutors = [
+    '@angular-devkit/build-angular:ng-packagr',
+    '@nx/angular:ng-packagr-lite',
+    '@nx/angular:package',
+    // TODO(v17): remove when @nrwl/* scope is removed
+    '@nrwl/angular:ng-packagr-lite',
+    '@nrwl/angular:package',
+];
+function updateSecondaryEntryPoints(tree, schema) {
+    if (schema.oldProjectName === schema.newProjectName) {
+        return;
+    }
+    const project = (0, devkit_1.readProjectConfiguration)(tree, schema.newProjectName);
+    if (project.projectType !== 'library') {
+        return;
+    }
+    if (!Object.values(project.targets ?? {}).some((target) => libraryExecutors.includes(target.executor))) {
+        return;
+    }
+    (0, devkit_1.visitNotIgnoredFiles)(tree, project.root, (filePath) => {
+        if ((0, path_1.basename)(filePath) !== 'ng-package.json' ||
+            (0, devkit_1.normalizePath)(filePath) ===
+                (0, devkit_1.joinPathFragments)(project.root, 'ng-package.json')) {
+            return;
+        }
+        updateReadme(tree, (0, path_1.dirname)(filePath), schema.oldProjectName, schema.newProjectName);
+    });
+}
+exports.updateSecondaryEntryPoints = updateSecondaryEntryPoints;
+function updateReadme(tree, dir, oldProjectName, newProjectName) {
+    const readmePath = (0, devkit_1.joinPathFragments)(dir, 'README.md');
+    if (!tree.exists(readmePath)) {
+        return;
+    }
+    const findName = new RegExp(`${oldProjectName}`, 'g');
+    const oldContent = tree.read(readmePath, 'utf-8');
+    const newContent = oldContent.replace(findName, newProjectName);
+    tree.write(readmePath, newContent);
+}

package/src/generators/move/move-impl.d.ts

@@ -0,0 +1,7 @@
+import { type Tree } from '@nx/devkit';
+import type { MoveImplOptions } from './lib/types';
+/**
+ * Angular-specific logic to move a project to another directory.
+ * This is invoked by the `@nx/workspace:move` generator.
+ */
+export declare function move(tree: Tree, options: MoveImplOptions): Promise<void>;

package/src/generators/move/move-impl.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.move = void 0;
+const devkit_1 = require("@nx/devkit");
+const lib_1 = require("./lib");
+/**
+ * Angular-specific logic to move a project to another directory.
+ * This is invoked by the `@nx/workspace:move` generator.
+ */
+async function move(tree, options) {
+    // while the project has already being moved at this point, the changes are
+    // still in the virtual tree and haven't been committed, so the project graph
+    // still contains the old project name
+    if (!(await isAngularProject(options.oldProjectName))) {
+        return;
+    }
+    (0, lib_1.updateModuleName)(tree, options);
+    (0, lib_1.updateNgPackage)(tree, options);
+    (0, lib_1.updateSecondaryEntryPoints)(tree, options);
+}
+exports.move = move;
+async function isAngularProject(project) {
+    const projectGraph = await (0, devkit_1.createProjectGraphAsync)();
+    return projectGraph.dependencies[project]?.some((dependency) => dependency.target === 'npm:@angular/core');
+}

package/src/generators/move/move.d.ts

@@ -0,0 +1,4 @@
+import type { Tree } from '@nx/devkit';
+import type { Schema } from './schema';
+export declare function angularMoveGenerator(tree: Tree, schema: Schema): Promise<void>;
+export declare function angularMoveGeneratorInternal(tree: Tree, schema: Schema): Promise<void>;

package/src/generators/move/move.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.angularMoveGeneratorInternal = exports.angularMoveGenerator = void 0;
+const move_1 = require("@nx/workspace/src/generators/move/move");
+async function angularMoveGenerator(tree, schema) {
+    await angularMoveGeneratorInternal(tree, {
+        projectNameAndRootFormat: 'derived',
+        ...schema,
+    });
+}
+exports.angularMoveGenerator = angularMoveGenerator;
+async function angularMoveGeneratorInternal(tree, schema) {
+    process.env.NX_ANGULAR_MOVE_INVOKED = 'true';
+    await (0, move_1.moveGeneratorInternal)(tree, schema);
+}
+exports.angularMoveGeneratorInternal = angularMoveGeneratorInternal;

package/src/generators/move/schema.d.ts

@@ -0,0 +1,11 @@
+import { ProjectNameAndRootFormat } from '@nx/devkit/src/generators/project-name-and-root-utils';
+
+export interface Schema {
+  projectName: string;
+  destination: string;
+  updateImportPath: boolean;
+  importPath?: string;
+  skipFormat?: boolean;
+  newProjectName?: string;
+  projectNameAndRootFormat?: ProjectNameAndRootFormat;
+}

package/src/generators/move/schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "NxAngularMove",
+  "cli": "nx",
+  "title": "Nx Angular Move",
+  "description": "Move an Angular project to another folder in the workspace.",
+  "type": "object",
+  "examples": [
+    {
+      "command": "nx g @nx/angular:move --project my-feature-lib --destination shared/my-feature-lib",
+      "description": "Move libs/my-feature-lib to libs/shared/my-feature-lib."
+    }
+  ],
+  "properties": {
+    "projectName": {
+      "type": "string",
+      "alias": "project",
+      "description": "The name of the Angular project to move.",
+      "x-dropdown": "projects",
+      "x-priority": "important"
+    },
+    "newProjectName": {
+      "type": "string",
+      "alias": "project",
+      "description": "The new name of the project after the move.",
+      "pattern": "(?:^@[a-zA-Z0-9-*~][a-zA-Z0-9-*._~]*\\/[a-zA-Z0-9-~][a-zA-Z0-9-._~]*|^[a-zA-Z][^:]*)$",
+      "x-priority": "important"
+    },
+    "destination": {
+      "type": "string",
+      "description": "The folder to move the Angular project into.",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-priority": "important"
+    },
+    "projectNameAndRootFormat": {
+      "description": "Whether to generate the new project name and destination as provided (`as-provided`) or generate them composing their values and taking the configured layout into account (`derived`).",
+      "type": "string",
+      "enum": ["as-provided", "derived"]
+    },
+    "importPath": {
+      "type": "string",
+      "description": "The new import path to use in the `tsconfig.base.json`."
+    },
+    "updateImportPath": {
+      "type": "boolean",
+      "description": "Update the import path to reflect the new location.",
+      "default": true
+    },
+    "skipFormat": {
+      "type": "boolean",
+      "aliases": ["skip-format"],
+      "description": "Skip formatting files.",
+      "default": false,
+      "x-priority": "internal"
+    }
+  },
+  "required": ["projectName", "destination"]
+}

package/src/generators/ng-add/files/root/tools/tsconfig.tools.json__tmpl__

@@ -0,0 +1,12 @@
+{
+  "extends": "../<%= rootTsConfigPath %>",
+  "compilerOptions": {
+    "outDir": "../dist/out-tsc/tools",
+    "rootDir": ".",
+    "module": "commonjs",
+    "target": "es5",
+    "types": ["node"],
+    "importHelpers": false
+  },
+  "include": ["**/*.ts"]
+}