@nx/react-native 0.0.0-pr-22179-271588f

package/src/migrations/update-18-0-0/add-web-configuration.spec.ts

@@ -0,0 +1,39 @@
+import { addProjectConfiguration, getProjects, Tree } from '@nx/devkit';
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import update from './add-web-configuration';
+
+describe('add-web-configuration', () => {
+  let tree: Tree;
+
+  beforeEach(async () => {
+    tree = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+    addProjectConfiguration(tree, 'product', {
+      root: 'apps/product',
+      sourceRoot: 'apps/product/src',
+      targets: {
+        start: {
+          executor: '@nx/react-native:start',
+          options: {},
+        },
+        serve: {
+          executor: 'nx:run-commands',
+          options: {
+            command: 'nx start product',
+          },
+        },
+      },
+    });
+  });
+
+  it(`should add web configuration`, async () => {
+    await update(tree);
+
+    tree.exists('apps/product/webpack.config.js');
+    getProjects(tree).forEach((project) => {
+      expect(project.targets['build'].executor).toEqual('@nx/webpack:webpack');
+      expect(project.targets['serve'].executor).toEqual(
+        '@nx/webpack:dev-server'
+      );
+    });
+  });
+});

package/src/migrations/update-18-0-0/change-storybook-targets.d.ts

@@ -0,0 +1,5 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+/**
+ * Upgrade react native storybook target to use web
+ */
+export default function changeStorybookTargets(tree: Tree): Promise<GeneratorCallback>;

package/src/migrations/update-18-0-0/change-storybook-targets.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devkit_1 = require("@nx/devkit");
+const output_1 = require("nx/src/utils/output");
+const migrate_7_1 = require("@nx/storybook/src/generators/migrate-7/migrate-7");
+const utilities_1 = require("@nx/storybook/src/utils/utilities");
+const configuration_1 = require("@nx/react/src/generators/storybook-configuration/configuration");
+/**
+ * Upgrade react native storybook target to use web
+ */
+async function changeStorybookTargets(tree) {
+    const tasks = [];
+    // update the storybook target
+    const projects = (0, devkit_1.getProjects)(tree);
+    let hasStorybookTarget = false;
+    for (const [projectName, config] of projects.entries()) {
+        if (config.targets?.['storybook']?.executor === '@nx/react-native:storybook') {
+            hasStorybookTarget = true;
+            delete config.targets['storybook'];
+            (0, devkit_1.updateProjectConfiguration)(tree, projectName, config);
+            tasks.push(await (0, configuration_1.default)(tree, {
+                project: projectName,
+            }));
+        }
+    }
+    /**
+     * This just checks if Storybook is installed in the workspace.
+     * The thing here is that during the previous step of the migration,
+     * during packageJsonUpdates, Nx has already set Storybook
+     * to version 7, if Storybook exists in the workspace.
+     * So, it makes no sense here to check if the version is
+     * 7, because it will always be.
+     */
+    const storybookVersion = (0, utilities_1.storybookMajorVersion)();
+    if (!hasStorybookTarget || !storybookVersion) {
+        return;
+    }
+    output_1.output.log({
+        title: 'Migrating Storybook to v7',
+        bodyLines: [
+            `🚀 This migration will update your Storybook configuration to v7.`,
+            `It will call the @nx/storybook:migrate-7 generator for you.`,
+            `You can read more about the migration and how this generator works here:`,
+            `https://nx.dev/packages/storybook/generators/migrate-7`,
+        ],
+    });
+    tasks.push(await (0, migrate_7_1.default)(tree, { autoAcceptAllPrompts: true }));
+    tasks.push((0, devkit_1.removeDependenciesFromPackageJson)(tree, [], [
+        '@storybook/react-native',
+        '@storybook/addon-ondevice-actions',
+        '@storybook/addon-ondevice-backgrounds',
+        '@storybook/addon-ondevice-controls',
+        '@storybook/addon-ondevice-notes',
+    ]));
+    return (0, devkit_1.runTasksInSerial)(...tasks);
+}
+exports.default = changeStorybookTargets;

package/src/migrations/update-18-0-0/remove-block-list.d.ts

@@ -0,0 +1,6 @@
+import { Tree } from '@nx/devkit';
+/**
+ * This migration removes blockList in metro.config.js.
+ * It is now excluding dist folder in watchFolders in withNxMetro.
+ */
+export default function update(tree: Tree): Promise<void>;

package/src/migrations/update-18-0-0/remove-block-list.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devkit_1 = require("@nx/devkit");
+/**
+ * This migration removes blockList in metro.config.js.
+ * It is now excluding dist folder in watchFolders in withNxMetro.
+ */
+async function update(tree) {
+    const projects = (0, devkit_1.getProjects)(tree);
+    for (const [_, config] of projects.entries()) {
+        if (config.targets?.['start']?.executor === '@nx/react-native:start') {
+            if (tree.exists((0, devkit_1.joinPathFragments)(config.root, 'metro.config.js'))) {
+                let content = tree
+                    .read((0, devkit_1.joinPathFragments)(config.root, 'metro.config.js'))
+                    .toString();
+                content = content.replace(/blockList: exclusionList(.+?(?=\n))/, '');
+                content = content.replace('// unstable_enableSymlinks: true,', '');
+                content = content.replace('// unstable_enablePackageExports: true,', '');
+                content = content.replace('unstable_enableSymlinks: true,', '');
+                content = content.replace('unstable_enablePackageExports: true,', '');
+                content = content.replace(`const exclusionList = require('metro-config/src/defaults/exclusionList');`, '');
+                tree.write((0, devkit_1.joinPathFragments)(config.root, 'metro.config.js'), content);
+                await (0, devkit_1.formatFiles)(tree);
+            }
+        }
+    }
+}
+exports.default = update;

package/src/migrations/update-18-0-0/remove-block-list.spec.ts

@@ -0,0 +1,68 @@
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import { Tree, addProjectConfiguration } from '@nx/devkit';
+import update from './remove-block-list';
+
+describe('remove-block-list', () => {
+  let tree: Tree;
+
+  beforeEach(() => {
+    tree = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+    addProjectConfiguration(tree, 'product', {
+      root: 'apps/product',
+      targets: {
+        start: {
+          executor: '@nx/react-native:start',
+        },
+      },
+    });
+    tree.write(
+      'apps/product/metro.config.js',
+      `
+const { withNxMetro } = require('@nx/expo');
+const { getDefaultConfig } = require('@expo/metro-config');
+const { mergeConfig } = require('metro-config');
+const exclusionList = require('metro-config/src/defaults/exclusionList');
+
+const defaultConfig = getDefaultConfig(__dirname);
+const { assetExts, sourceExts } = defaultConfig.resolver;
+
+/**
+ * Metro configuration
+ * https://facebook.github.io/metro/docs/configuration
+ *
+ * @type {import('metro-config').MetroConfig}
+ */
+const customConfig = {
+  transformer: {
+    babelTransformerPath: require.resolve('react-native-svg-transformer'),
+  },
+  resolver: {
+    assetExts: assetExts.filter((ext) => ext !== 'svg'),
+    sourceExts: [...sourceExts, 'svg'],
+    blockList: exclusionList([/^(?!.*node_modules).*\/dist\/.*/]),
+    unstable_enableSymlinks: true,
+    unstable_enablePackageExports: true,
+  },
+};
+
+
+module.exports = withNxMetro(mergeConfig(defaultConfig, customConfig), {
+  // Change this to true to see debugging info.
+  // Useful if you have issues resolving modules
+  debug: false,
+  // all the file extensions used for imports other than 'ts', 'tsx', 'js', 'jsx', 'json'
+  extensions: [],
+  // Specify folders to watch, in addition to Nx defaults (workspace libraries and node_modules)
+  watchFolders: [],
+});`
+    );
+  });
+
+  it('should remove blockList', async () => {
+    await update(tree);
+    const metroConfig = tree.read(`apps/product/metro.config.js`).toString();
+    expect(metroConfig).not.toContain('blockList');
+    expect(metroConfig).not.toContain('unstable_enableSymlinks');
+    expect(metroConfig).not.toContain('unstable_enablePackageExports');
+  });
+});

package/src/migrations/update-18-0-0/remove-metro.d.ts

@@ -0,0 +1,14 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Remove metro-* package since it is no longer explicity required in package.json.
+ * react-native has dependency of @react-native/community-cli-plugin
+ * @react-native/community-cli-plugin has dependency of metro
+ *
+ * Also remove @react-native-community/cli-* since it is a dependency of react-native.
+ * (excpet reactNativeCommunityCliPlatformAndroidVersion because android files refer it by path)
+ *
+ * https://react-native-community.github.io/upgrade-helper/?from=0.72.6&to=0.73.1#RnDiffApp-package.json
+ * @param tree
+ * @returns
+ */
+export default function update(tree: Tree): Promise<void>;

package/src/migrations/update-18-0-0/remove-metro.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devkit_1 = require("@nx/devkit");
+/**
+ * Remove metro-* package since it is no longer explicity required in package.json.
+ * react-native has dependency of @react-native/community-cli-plugin
+ * @react-native/community-cli-plugin has dependency of metro
+ *
+ * Also remove @react-native-community/cli-* since it is a dependency of react-native.
+ * (excpet reactNativeCommunityCliPlatformAndroidVersion because android files refer it by path)
+ *
+ * https://react-native-community.github.io/upgrade-helper/?from=0.72.6&to=0.73.1#RnDiffApp-package.json
+ * @param tree
+ * @returns
+ */
+async function update(tree) {
+    (0, devkit_1.removeDependenciesFromPackageJson)(tree, [], [
+        'metro',
+        'metro-resolver',
+        'metro-config',
+        'metro-react-native-babel-preset',
+        'metro-babel-register',
+        'metro-react-native-babel-transformer',
+        '@react-native-community/cli',
+        '@react-native-community/cli-platform-ios',
+    ]);
+    await (0, devkit_1.formatFiles)(tree);
+}
+exports.default = update;

package/src/migrations/update-18-0-0/remove-symlink-target.d.ts

@@ -0,0 +1,6 @@
+import { Tree } from '@nx/devkit';
+/**
+ * Remove ensure-symlink target.
+ * It is going to be supported by react-native version 0.73 by default.
+ */
+export default function update(tree: Tree): Promise<void>;

package/src/migrations/update-18-0-0/remove-symlink-target.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const devkit_1 = require("@nx/devkit");
+const fs_extra_1 = require("fs-extra");
+/**
+ * Remove ensure-symlink target.
+ * It is going to be supported by react-native version 0.73 by default.
+ */
+async function update(tree) {
+    const projects = (0, devkit_1.getProjects)(tree);
+    for (const [projectName, config] of projects.entries()) {
+        if (config.targets?.['ensure-symlink']?.executor ===
+            '@nx/react-native:ensure-symlink') {
+            removeTargets(config.targets, 'ensure-symlink');
+            (0, devkit_1.updateProjectConfiguration)(tree, projectName, config);
+            (0, fs_extra_1.removeSync)(`${config.root}/node_modules`);
+        }
+    }
+}
+exports.default = update;
+function removeTargets(targets, targetNameToRemove) {
+    for (const targetName in targets) {
+        if (targetName === targetNameToRemove) {
+            delete targets[targetName];
+        }
+        if (targets[targetName]?.dependsOn?.length) {
+            targets[targetName].dependsOn = targets[targetName].dependsOn.filter((dependsOn) => dependsOn !== targetNameToRemove);
+        }
+    }
+}

package/src/migrations/update-18-0-0/remove-symlink-target.spec.ts

@@ -0,0 +1,40 @@
+import { addProjectConfiguration, getProjects, Tree } from '@nx/devkit';
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import update from './remove-symlink-target';
+
+describe('remove-symlink-target', () => {
+  let tree: Tree;
+
+  beforeEach(async () => {
+    tree = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+    addProjectConfiguration(tree, 'product', {
+      root: 'apps/product',
+      sourceRoot: 'apps/product/src',
+      targets: {
+        'ensure-symlink': {
+          executor: '@nx/react-native:ensure-symlink',
+          options: {},
+        },
+        'bundle-android': {
+          executor: '@nx/react-native:bundle',
+          dependsOn: ['ensure-symlink'],
+          outputs: ['{options.bundleOutput}'],
+          options: {
+            entryFile: 'src/main.tsx',
+            platform: 'android',
+            bundleOutput: 'dist/apps/techy-jokes/android/main.jsbundle',
+          },
+        },
+      },
+    });
+  });
+
+  it(`should remove ensure-symlink target from project.json`, async () => {
+    await update(tree);
+
+    getProjects(tree).forEach((project) => {
+      expect(project.targets['ensure-symlink']).toBeUndefined();
+      expect(project.targets['bundle-android'].dependsOn).toEqual([]);
+    });
+  });
+});

package/src/utils/add-jest.d.ts

@@ -0,0 +1,2 @@
+import { Tree } from '@nx/devkit';
+export declare function addJest(host: Tree, unitTestRunner: 'jest' | 'none', projectName: string, appProjectRoot: string, js: boolean, skipPackageJson: boolean, addPlugin: boolean): Promise<import("@nx/devkit").GeneratorCallback>;

package/src/utils/add-jest.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addJest = void 0;
+const devkit_1 = require("@nx/devkit");
+const jest_1 = require("@nx/jest");
+async function addJest(host, unitTestRunner, projectName, appProjectRoot, js, skipPackageJson, addPlugin) {
+    if (unitTestRunner !== 'jest') {
+        return () => { };
+    }
+    const jestTask = await (0, jest_1.configurationGenerator)(host, {
+        js,
+        project: projectName,
+        supportTsx: true,
+        skipSerializers: true,
+        setupFile: 'none',
+        compiler: 'babel',
+        skipPackageJson,
+        skipFormat: true,
+        addPlugin,
+    });
+    // overwrite the jest.config.ts file because react native needs to have special transform property
+    const configPath = `${appProjectRoot}/jest.config.${js ? 'js' : 'ts'}`;
+    const content = `module.exports = {
+  displayName: '${projectName}',
+  preset: 'react-native',
+  resolver: '@nx/jest/plugins/resolver',
+  moduleFileExtensions: ['ts', 'js', 'html', 'tsx', 'jsx'],
+  setupFilesAfterEnv: ['<rootDir>/test-setup.${js ? 'js' : 'ts'}'],
+  moduleNameMapper: {
+    '\\\\.svg$': '@nx/react-native/plugins/jest/svg-mock'
+  },
+  transform: {
+    '^.+\\.(js|ts|tsx)$': [
+      'babel-jest',
+      {
+        configFile: __dirname + '/.babelrc.js',
+      },
+    ],
+    '^.+\\.(bmp|gif|jpg|jpeg|mp4|png|psd|svg|webp)$': require.resolve(
+      'react-native/jest/assetFileTransformer.js'
+    ),
+  },
+  coverageDirectory: '${(0, devkit_1.offsetFromRoot)(appProjectRoot)}coverage/${appProjectRoot}'
+};`;
+    host.write(configPath, content);
+    return jestTask;
+}
+exports.addJest = addJest;

package/src/utils/add-linting.d.ts

@@ -0,0 +1,13 @@
+import { Linter } from '@nx/eslint';
+import { GeneratorCallback, Tree } from '@nx/devkit';
+interface NormalizedSchema {
+    linter?: Linter;
+    projectName: string;
+    projectRoot: string;
+    setParserOptionsProject?: boolean;
+    tsConfigPaths: string[];
+    skipPackageJson?: boolean;
+    addPlugin?: boolean;
+}
+export declare function addLinting(host: Tree, options: NormalizedSchema): Promise<GeneratorCallback>;
+export {};

package/src/utils/add-linting.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addLinting = void 0;
+const eslint_1 = require("@nx/eslint");
+const devkit_1 = require("@nx/devkit");
+const lint_1 = require("@nx/react/src/utils/lint");
+const eslint_file_1 = require("@nx/eslint/src/generators/utils/eslint-file");
+async function addLinting(host, options) {
+    if (options.linter === eslint_1.Linter.None) {
+        return () => { };
+    }
+    const tasks = [];
+    const lintTask = await (0, eslint_1.lintProjectGenerator)(host, {
+        linter: options.linter,
+        project: options.projectName,
+        tsConfigPaths: options.tsConfigPaths,
+        skipFormat: true,
+        skipPackageJson: options.skipPackageJson,
+        addPlugin: options.addPlugin,
+    });
+    tasks.push(lintTask);
+    if ((0, eslint_file_1.isEslintConfigSupported)(host)) {
+        (0, eslint_file_1.addExtendsToLintConfig)(host, options.projectRoot, 'plugin:@nx/react');
+        (0, eslint_file_1.addIgnoresToLintConfig)(host, options.projectRoot, [
+            'public',
+            '.cache',
+            'node_modules',
+        ]);
+    }
+    if (!options.skipPackageJson) {
+        const installTask = await (0, devkit_1.addDependenciesToPackageJson)(host, lint_1.extraEslintDependencies.dependencies, lint_1.extraEslintDependencies.devDependencies);
+        tasks.push(installTask);
+    }
+    return (0, devkit_1.runTasksInSerial)(...tasks);
+}
+exports.addLinting = addLinting;

package/src/utils/add-linting.spec.ts

@@ -0,0 +1,40 @@
+import { readProjectConfiguration, Tree } from '@nx/devkit';
+import { createTreeWithEmptyWorkspace } from '@nx/devkit/testing';
+import { Linter } from '@nx/eslint';
+import { libraryGenerator } from '@nx/js';
+import { addLinting } from './add-linting';
+
+describe('Add Linting', () => {
+  let tree: Tree;
+
+  beforeEach(async () => {
+    tree = createTreeWithEmptyWorkspace({ layout: 'apps-libs' });
+    await libraryGenerator(tree, {
+      name: 'my-lib',
+      linter: Linter.None,
+    });
+  });
+
+  it('should add a .eslintrc.json when is passed', async () => {
+    await addLinting(tree, {
+      projectName: 'my-lib',
+      linter: Linter.EsLint,
+      tsConfigPaths: ['libs/my-lib/tsconfig.lib.json'],
+      projectRoot: 'libs/my-lib',
+    });
+
+    expect(tree.exists('libs/my-lib/.eslintrc.json')).toBeTruthy();
+  });
+
+  it('should not add lint target when "none" is passed', async () => {
+    await addLinting(tree, {
+      projectName: 'my-lib',
+      linter: Linter.None,
+      tsConfigPaths: ['libs/my-lib/tsconfig.lib.json'],
+      projectRoot: 'libs/my-lib',
+    });
+    const project = readProjectConfiguration(tree, 'my-lib');
+
+    expect(project.targets.lint).toBeUndefined();
+  });
+});

package/src/utils/chmod-android-gradle-files.d.ts

@@ -0,0 +1,3 @@
+import { GeneratorCallback } from '@nx/devkit';
+export declare function chmodAndroidGradlewFiles(androidFolder: string): void;
+export declare function chmodAndroidGradlewFilesTask(androidFolder: string): GeneratorCallback;

package/src/utils/chmod-android-gradle-files.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chmodAndroidGradlewFilesTask = exports.chmodAndroidGradlewFiles = void 0;
+const devkit_1 = require("@nx/devkit");
+const fs_1 = require("fs");
+const path_1 = require("path");
+function chmodAndroidGradlewFiles(androidFolder) {
+    if ((0, fs_1.existsSync)((0, path_1.join)(androidFolder, 'gradlew'))) {
+        (0, fs_1.chmodSync)((0, path_1.join)(androidFolder, 'gradlew'), 0o775);
+    }
+    if ((0, fs_1.existsSync)((0, path_1.join)(androidFolder, 'gradlew.bat'))) {
+        (0, fs_1.chmodSync)((0, path_1.join)(androidFolder, 'gradlew.bat'), 0o775);
+    }
+}
+exports.chmodAndroidGradlewFiles = chmodAndroidGradlewFiles;
+function chmodAndroidGradlewFilesTask(androidFolder) {
+    return () => {
+        devkit_1.logger.info(`chmod android gradlew files under ${androidFolder}`);
+        try {
+            chmodAndroidGradlewFiles(androidFolder);
+        }
+        catch {
+            throw new Error(`chmod failed gradlew file under ${androidFolder}`);
+        }
+    };
+}
+exports.chmodAndroidGradlewFilesTask = chmodAndroidGradlewFilesTask;

package/src/utils/ensure-dependencies.d.ts

@@ -0,0 +1,2 @@
+import { GeneratorCallback, Tree } from '@nx/devkit';
+export declare function ensureDependencies(tree: Tree): GeneratorCallback;

package/src/utils/ensure-dependencies.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureDependencies = void 0;
+const devkit_1 = require("@nx/devkit");
+const versions_1 = require("@nx/react/src/utils/versions");
+const versions_2 = require("./versions");
+function ensureDependencies(tree) {
+    const isPnpm = (0, devkit_1.detectPackageManager)(tree.root) === 'pnpm';
+    return (0, devkit_1.addDependenciesToPackageJson)(tree, {}, {
+        '@types/node': versions_2.typesNodeVersion,
+        '@types/react': versions_2.typesReactVersion,
+        '@react-native/babel-preset': versions_2.reactNativeBabelPresetVersion,
+        '@react-native/metro-config': versions_2.reactNativeMetroConfigVersion,
+        '@testing-library/react-native': versions_2.testingLibraryReactNativeVersion,
+        '@testing-library/jest-native': versions_2.testingLibraryJestNativeVersion,
+        '@react-native-community/cli-platform-android': versions_2.reactNativeCommunityCliPlatformAndroidVersion,
+        'jest-react-native': versions_2.jestReactNativeVersion,
+        'react-test-renderer': versions_2.reactTestRendererVersion,
+        'react-native-svg-transformer': versions_2.reactNativeSvgTransformerVersion,
+        'react-native-svg': versions_2.reactNativeSvgVersion,
+        '@babel/preset-react': versions_1.babelPresetReactVersion,
+        '@babel/core': versions_1.babelCoreVersion,
+        ...(isPnpm
+            ? {
+                '@babel/runtime': versions_2.babelRuntimeVersion, // @babel/runtime is used by react-native-svg
+            }
+            : {}),
+    });
+}
+exports.ensureDependencies = ensureDependencies;

package/src/utils/ensure-node-modules-symlink.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This function symlink workspace node_modules folder with app project's node_mdules folder.
+ * For yarn and npm, it will symlink the entire node_modules folder.
+ * If app project's node_modules already exist, it will remove it first then symlink it.
+ * For pnpm, it will go through the package.json' dependencies and devDependencies, and also the required packages listed above.
+ * @param workspaceRoot path of the workspace root
+ * @param projectRoot path of app project root
+ */
+export declare function ensureNodeModulesSymlink(workspaceRoot: string, projectRoot: string): void;

package/src/utils/ensure-node-modules-symlink.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureNodeModulesSymlink = void 0;
+const path_1 = require("path");
+const os_1 = require("os");
+const fs_extra_1 = require("fs-extra");
+/**
+ * This function symlink workspace node_modules folder with app project's node_mdules folder.
+ * For yarn and npm, it will symlink the entire node_modules folder.
+ * If app project's node_modules already exist, it will remove it first then symlink it.
+ * For pnpm, it will go through the package.json' dependencies and devDependencies, and also the required packages listed above.
+ * @param workspaceRoot path of the workspace root
+ * @param projectRoot path of app project root
+ */
+function ensureNodeModulesSymlink(workspaceRoot, projectRoot) {
+    const worksapceNodeModulesPath = (0, path_1.join)(workspaceRoot, 'node_modules');
+    if (!(0, fs_extra_1.existsSync)(worksapceNodeModulesPath)) {
+        throw new Error(`Cannot find ${worksapceNodeModulesPath}`);
+    }
+    const appNodeModulesPath = (0, path_1.join)(workspaceRoot, projectRoot, 'node_modules');
+    // `mklink /D` requires admin privilege in Windows so we need to use junction
+    const symlinkType = (0, os_1.platform)() === 'win32' ? 'junction' : 'dir';
+    if ((0, fs_extra_1.existsSync)(appNodeModulesPath)) {
+        (0, fs_extra_1.removeSync)(appNodeModulesPath);
+    }
+    (0, fs_extra_1.symlinkSync)(worksapceNodeModulesPath, appNodeModulesPath, symlinkType);
+}
+exports.ensureNodeModulesSymlink = ensureNodeModulesSymlink;