@nx/devkit 16.0.0-beta.1

package/src/utils/module-federation/share.js

@@ -0,0 +1,187 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyAdditionalShared = exports.applySharedFunction = exports.sharePackages = exports.getNpmPackageSharedConfig = exports.shareWorkspaceLibraries = void 0;
+const path_1 = require("path");
+const package_json_1 = require("./package-json");
+const typescript_1 = require("./typescript");
+const secondary_entry_points_1 = require("./secondary-entry-points");
+// eslint-disable-next-line @typescript-eslint/no-restricted-imports
+const typescript_2 = require("nx/src/utils/typescript");
+const nx_1 = require("../../../nx");
+const { workspaceRoot, logger } = (0, nx_1.requireNx)();
+/**
+ * Build an object of functions to be used with the ModuleFederationPlugin to
+ * share Nx Workspace Libraries between Hosts and Remotes.
+ *
+ * @param libraries - The Nx Workspace Libraries to share
+ * @param tsConfigPath - The path to TS Config File that contains the Path Mappings for the Libraries
+ */
+function shareWorkspaceLibraries(libraries, tsConfigPath) {
+    var _a;
+    if (tsConfigPath === void 0) { tsConfigPath = (_a = process.env.NX_TSCONFIG_PATH) !== null && _a !== void 0 ? _a : (0, typescript_2.getRootTsConfigPath)(); }
+    if (!libraries) {
+        return getEmptySharedLibrariesConfig();
+    }
+    const tsconfigPathAliases = (0, typescript_1.readTsPathMappings)(tsConfigPath);
+    if (!Object.keys(tsconfigPathAliases).length) {
+        return getEmptySharedLibrariesConfig();
+    }
+    const pathMappings = [];
+    for (const [key, paths] of Object.entries(tsconfigPathAliases)) {
+        const library = libraries.find((lib) => lib.importKey === key);
+        if (!library) {
+            continue;
+        }
+        // This is for Angular Projects that use ng-package.json
+        // It will do nothing for React Projects
+        (0, secondary_entry_points_1.collectWorkspaceLibrarySecondaryEntryPoints)(library, tsconfigPathAliases).forEach(({ name, path }) => pathMappings.push({
+            name,
+            path,
+        }));
+        pathMappings.push({
+            name: key,
+            path: (0, path_1.normalize)((0, path_1.join)(workspaceRoot, paths[0])),
+        });
+    }
+    const webpack = require('webpack');
+    return {
+        getAliases: () => pathMappings.reduce((aliases, library) => (Object.assign(Object.assign({}, aliases), { [library.name]: library.path })), {}),
+        getLibraries: (eager) => pathMappings.reduce((libraries, library) => (Object.assign(Object.assign({}, libraries), { [library.name]: { requiredVersion: false, eager } })), {}),
+        getReplacementPlugin: () => new webpack.NormalModuleReplacementPlugin(/./, (req) => {
+            if (!req.request.startsWith('.')) {
+                return;
+            }
+            const from = req.context;
+            const to = (0, path_1.normalize)((0, path_1.join)(req.context, req.request));
+            for (const library of pathMappings) {
+                const libFolder = (0, path_1.normalize)((0, path_1.dirname)(library.path));
+                if (!from.startsWith(libFolder) && to.startsWith(libFolder)) {
+                    req.request = library.name;
+                }
+            }
+        }),
+    };
+}
+exports.shareWorkspaceLibraries = shareWorkspaceLibraries;
+/**
+ * Build the Module Federation Share Config for a specific package and the
+ * specified version of that package.
+ * @param pkgName - Name of the package to share
+ * @param version - Version of the package to require by other apps in the Module Federation setup
+ */
+function getNpmPackageSharedConfig(pkgName, version) {
+    if (!version) {
+        logger.warn(`Could not find a version for "${pkgName}" in the root "package.json" ` +
+            'when collecting shared packages for the Module Federation setup. ' +
+            'The package will not be shared.');
+        return undefined;
+    }
+    return { singleton: true, strictVersion: true, requiredVersion: version };
+}
+exports.getNpmPackageSharedConfig = getNpmPackageSharedConfig;
+/**
+ * Create a dictionary of packages and their Module Federation Shared Config
+ * from an array of package names.
+ *
+ * Lookup the versions of the packages from the root package.json file in the
+ * workspace.
+ * @param packages - Array of package names as strings
+ */
+function sharePackages(packages) {
+    const pkgJson = (0, package_json_1.readRootPackageJson)();
+    const allPackages = [];
+    packages.forEach((pkg) => {
+        var _a, _b, _c;
+        const pkgVersion = (_b = (_a = pkgJson.dependencies) === null || _a === void 0 ? void 0 : _a[pkg]) !== null && _b !== void 0 ? _b : (_c = pkgJson.devDependencies) === null || _c === void 0 ? void 0 : _c[pkg];
+        allPackages.push({ name: pkg, version: pkgVersion });
+        (0, secondary_entry_points_1.collectPackageSecondaryEntryPoints)(pkg, pkgVersion, allPackages);
+    });
+    return allPackages.reduce((shared, pkg) => {
+        const config = getNpmPackageSharedConfig(pkg.name, pkg.version);
+        if (config) {
+            shared[pkg.name] = config;
+        }
+        return shared;
+    }, {});
+}
+exports.sharePackages = sharePackages;
+/**
+ * Apply a custom function provided by the user that will modify the Shared Config
+ * of the dependencies for the Module Federation build.
+ *
+ * @param sharedConfig - The original Shared Config to be modified
+ * @param sharedFn - The custom function to run
+ */
+function applySharedFunction(sharedConfig, sharedFn) {
+    if (!sharedFn) {
+        return;
+    }
+    for (const [libraryName, library] of Object.entries(sharedConfig)) {
+        const mappedDependency = sharedFn(libraryName, library);
+        if (mappedDependency === false) {
+            delete sharedConfig[libraryName];
+            continue;
+        }
+        else if (!mappedDependency) {
+            continue;
+        }
+        sharedConfig[libraryName] = mappedDependency;
+    }
+}
+exports.applySharedFunction = applySharedFunction;
+/**
+ * Add additional dependencies to the shared package that may not have been
+ * discovered by the project graph.
+ *
+ * This can be useful for applications that use a Dependency Injection system
+ * that expects certain Singleton values to be present in the shared injection
+ * hierarchy.
+ *
+ * @param sharedConfig - The original Shared Config
+ * @param additionalShared - The additional dependencies to add
+ * @param projectGraph - The Nx project graph
+ */
+function applyAdditionalShared(sharedConfig, additionalShared, projectGraph) {
+    if (!additionalShared) {
+        return;
+    }
+    for (const shared of additionalShared) {
+        if (typeof shared === 'string') {
+            addStringDependencyToSharedConfig(sharedConfig, shared, projectGraph);
+        }
+        else if (Array.isArray(shared)) {
+            sharedConfig[shared[0]] = shared[1];
+        }
+        else if (typeof shared === 'object') {
+            sharedConfig[shared.libraryName] = shared.sharedConfig;
+        }
+    }
+}
+exports.applyAdditionalShared = applyAdditionalShared;
+function addStringDependencyToSharedConfig(sharedConfig, dependency, projectGraph) {
+    var _a, _b, _c, _d;
+    if (projectGraph.nodes[dependency]) {
+        sharedConfig[dependency] = { requiredVersion: false };
+    }
+    else if ((_a = projectGraph.externalNodes) === null || _a === void 0 ? void 0 : _a[`npm:${dependency}`]) {
+        const pkgJson = (0, package_json_1.readRootPackageJson)();
+        const config = getNpmPackageSharedConfig(dependency, (_c = (_b = pkgJson.dependencies) === null || _b === void 0 ? void 0 : _b[dependency]) !== null && _c !== void 0 ? _c : (_d = pkgJson.devDependencies) === null || _d === void 0 ? void 0 : _d[dependency]);
+        if (!config) {
+            return;
+        }
+        sharedConfig[dependency] = config;
+    }
+    else {
+        throw new Error(`The specified dependency "${dependency}" in the additionalShared configuration does not exist in the project graph. ` +
+            `Please check your additionalShared configuration and make sure you are including valid workspace projects or npm packages.`);
+    }
+}
+function getEmptySharedLibrariesConfig() {
+    const webpack = require('webpack');
+    return {
+        getAliases: () => ({}),
+        getLibraries: () => ({}),
+        getReplacementPlugin: () => new webpack.NormalModuleReplacementPlugin(/./, () => { }),
+    };
+}
+//# sourceMappingURL=share.js.map

package/src/utils/module-federation/share.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"share.js","sourceRoot":"","sources":["../../../../../../packages/devkit/src/utils/module-federation/share.ts"],"names":[],"mappings":"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"}

package/src/utils/module-federation/typescript.d.ts

@@ -0,0 +1,3 @@
+import { ParsedCommandLine } from 'typescript';
+export declare function readTsPathMappings(tsConfigPath?: string): ParsedCommandLine['options']['paths'];
+export declare function readTsConfig(tsConfigPath: string): ParsedCommandLine;

package/src/utils/module-federation/typescript.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readTsConfig = exports.readTsPathMappings = void 0;
+const fs_1 = require("fs");
+// eslint-disable-next-line @typescript-eslint/no-restricted-imports
+const typescript_1 = require("nx/src/utils/typescript");
+const path_1 = require("path");
+let tsConfig;
+let tsPathMappings;
+function readTsPathMappings(tsConfigPath) {
+    var _a, _b, _c;
+    if (tsConfigPath === void 0) { tsConfigPath = (_a = process.env.NX_TSCONFIG_PATH) !== null && _a !== void 0 ? _a : (0, typescript_1.getRootTsConfigPath)(); }
+    if (tsPathMappings) {
+        return tsPathMappings;
+    }
+    tsConfig !== null && tsConfig !== void 0 ? tsConfig : (tsConfig = readTsConfiguration(tsConfigPath));
+    tsPathMappings = {};
+    Object.entries((_c = (_b = tsConfig.options) === null || _b === void 0 ? void 0 : _b.paths) !== null && _c !== void 0 ? _c : {}).forEach(([alias, paths]) => {
+        tsPathMappings[alias] = paths.map((path) => path.replace(/^\.\//, ''));
+    });
+    return tsPathMappings;
+}
+exports.readTsPathMappings = readTsPathMappings;
+function readTsConfiguration(tsConfigPath) {
+    if (!(0, fs_1.existsSync)(tsConfigPath)) {
+        throw new Error(`NX MF: TsConfig Path for workspace libraries does not exist! (${tsConfigPath}).`);
+    }
+    return readTsConfig(tsConfigPath);
+}
+let tsModule;
+function readTsConfig(tsConfigPath) {
+    if (!tsModule) {
+        tsModule = require('typescript');
+    }
+    const readResult = tsModule.readConfigFile(tsConfigPath, tsModule.sys.readFile);
+    return tsModule.parseJsonConfigFileContent(readResult.config, tsModule.sys, (0, path_1.dirname)(tsConfigPath));
+}
+exports.readTsConfig = readTsConfig;
+//# sourceMappingURL=typescript.js.map

package/src/utils/module-federation/typescript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript.js","sourceRoot":"","sources":["../../../../../../packages/devkit/src/utils/module-federation/typescript.ts"],"names":[],"mappings":";;;AAAA,2BAAgC;AAEhC,oEAAoE;AACpE,wDAA8D;AAC9D,+BAA+B;AAE/B,IAAI,QAA2B,CAAC;AAChC,IAAI,cAAqD,CAAC;AAE1D,SAAgB,kBAAkB,CAChC,YAA4E;;iCAA5E,EAAA,qBAAuB,OAAO,CAAC,GAAG,CAAC,gBAAgB,mCAAI,IAAA,gCAAmB,GAAE;IAE5E,IAAI,cAAc,EAAE;QAClB,OAAO,cAAc,CAAC;KACvB;IAED,QAAQ,aAAR,QAAQ,cAAR,QAAQ,IAAR,QAAQ,GAAK,mBAAmB,CAAC,YAAY,CAAC,EAAC;IAC/C,cAAc,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,OAAO,CAAC,MAAA,MAAA,QAAQ,CAAC,OAAO,0CAAE,KAAK,mCAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;QACvE,cAAc,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC;AACxB,CAAC;AAdD,gDAcC;AAED,SAAS,mBAAmB,CAAC,YAAoB;IAC/C,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE;QAC7B,MAAM,IAAI,KAAK,CACb,iEAAiE,YAAY,IAAI,CAClF,CAAC;KACH;IAED,OAAO,YAAY,CAAC,YAAY,CAAC,CAAC;AACpC,CAAC;AAED,IAAI,QAAqC,CAAC;AAC1C,SAAgB,YAAY,CAAC,YAAoB;IAC/C,IAAI,CAAC,QAAQ,EAAE;QACb,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;KAClC;IACD,MAAM,UAAU,GAAG,QAAQ,CAAC,cAAc,CACxC,YAAY,EACZ,QAAQ,CAAC,GAAG,CAAC,QAAQ,CACtB,CAAC;IACF,OAAO,QAAQ,CAAC,0BAA0B,CACxC,UAAU,CAAC,MAAM,EACjB,QAAQ,CAAC,GAAG,EACZ,IAAA,cAAO,EAAC,YAAY,CAAC,CACtB,CAAC;AACJ,CAAC;AAbD,oCAaC"}

package/src/utils/move-dir.d.ts

@@ -0,0 +1,5 @@
+import type { Tree } from 'nx/src/generators/tree';
+/**
+ * Analogous to cp -r oldDir newDir
+ */
+export declare function moveFilesToNewDirectory(tree: Tree, oldDir: string, newDir: string): void;

package/src/utils/move-dir.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moveFilesToNewDirectory = void 0;
+const path_1 = require("path");
+const visit_not_ignored_files_1 = require("../generators/visit-not-ignored-files");
+const nx_1 = require("../../nx");
+const { normalizePath } = (0, nx_1.requireNx)();
+/**
+ * Analogous to cp -r oldDir newDir
+ */
+function moveFilesToNewDirectory(tree, oldDir, newDir) {
+    oldDir = normalizePath(oldDir);
+    newDir = normalizePath(newDir);
+    (0, visit_not_ignored_files_1.visitNotIgnoredFiles)(tree, oldDir, (file) => {
+        try {
+            tree.rename(file, `${newDir}/${(0, path_1.relative)(oldDir, file)}`);
+        }
+        catch (e) {
+            if (!tree.exists(oldDir)) {
+                console.warn(`Path ${oldDir} does not exist`);
+            }
+            else if (!tree.exists(newDir)) {
+                console.warn(`Path ${newDir} does not exist`);
+            }
+        }
+    });
+}
+exports.moveFilesToNewDirectory = moveFilesToNewDirectory;
+//# sourceMappingURL=move-dir.js.map

package/src/utils/move-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-dir.js","sourceRoot":"","sources":["../../../../../packages/devkit/src/utils/move-dir.ts"],"names":[],"mappings":";;;AACA,+BAAgC;AAChC,mFAA6E;AAC7E,iCAAqC;AAErC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAA,cAAS,GAAE,CAAC;AACtC;;GAEG;AACH,SAAgB,uBAAuB,CACrC,IAAU,EACV,MAAc,EACd,MAAc;IAEd,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAA,8CAAoB,EAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAC1C,IAAI;YACF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,IAAI,IAAA,eAAQ,EAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;SAC1D;QAAC,OAAO,CAAC,EAAE;YACV,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;gBACxB,OAAO,CAAC,IAAI,CAAC,QAAQ,MAAM,iBAAiB,CAAC,CAAC;aAC/C;iBAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;gBAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,MAAM,iBAAiB,CAAC,CAAC;aAC/C;SACF;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAlBD,0DAkBC"}

package/src/utils/names.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Util function to generate different strings based off the provided name.
+ *
+ * Examples:
+ *
+ * ```typescript
+ * names("my-name") // {name: 'my-name', className: 'MyName', propertyName: 'myName', constantName: 'MY_NAME', fileName: 'my-name'}
+ * names("myName") // {name: 'myName', className: 'MyName', propertyName: 'myName', constantName: 'MY_NAME', fileName: 'my-name'}
+ * ```
+ * @param name
+ */
+export declare function names(name: string): {
+    name: string;
+    className: string;
+    propertyName: string;
+    constantName: string;
+    fileName: string;
+};

package/src/utils/names.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.names = void 0;
+/**
+ * Util function to generate different strings based off the provided name.
+ *
+ * Examples:
+ *
+ * ```typescript
+ * names("my-name") // {name: 'my-name', className: 'MyName', propertyName: 'myName', constantName: 'MY_NAME', fileName: 'my-name'}
+ * names("myName") // {name: 'myName', className: 'MyName', propertyName: 'myName', constantName: 'MY_NAME', fileName: 'my-name'}
+ * ```
+ * @param name
+ */
+function names(name) {
+    return {
+        name,
+        className: toClassName(name),
+        propertyName: toPropertyName(name),
+        constantName: toConstantName(name),
+        fileName: toFileName(name),
+    };
+}
+exports.names = names;
+/**
+ * Hyphenated to UpperCamelCase
+ */
+function toClassName(str) {
+    return toCapitalCase(toPropertyName(str));
+}
+/**
+ * Hyphenated to lowerCamelCase
+ */
+function toPropertyName(s) {
+    return s
+        .replace(/([^a-zA-Z0-9])+(.)?/g, (_, __, chr) => chr ? chr.toUpperCase() : '')
+        .replace(/[^a-zA-Z\d]/g, '')
+        .replace(/^([A-Z])/, (m) => m.toLowerCase());
+}
+/**
+ * Hyphenated to CONSTANT_CASE
+ */
+function toConstantName(s) {
+    return toFileName(toPropertyName(s))
+        .replace(/([^a-zA-Z0-9])/g, '_')
+        .toUpperCase();
+}
+/**
+ * Upper camelCase to lowercase, hyphenated
+ */
+function toFileName(s) {
+    return s
+        .replace(/([a-z\d])([A-Z])/g, '$1_$2')
+        .toLowerCase()
+        .replace(/(?!^[_])[ _]/g, '-');
+}
+/**
+ * Capitalizes the first letter of a string
+ */
+function toCapitalCase(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=names.js.map

package/src/utils/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../../../packages/devkit/src/utils/names.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,KAAK,CAAC,IAAY;IAOhC,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC;QAC5B,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC;QAClC,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC;QAClC,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC;AAdD,sBAcC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC;SACL,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,CAC9C,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAC7B;SACA,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;SACjC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;SAC/B,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC;SACL,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC;SACrC,WAAW,EAAE;SACb,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,CAAS;IAC9B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/src/utils/offset-from-root.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Calculates an offset from the root of the workspace, which is useful for
+ * constructing relative URLs.
+ *
+ * Examples:
+ *
+ * ```typescript
+ * offsetFromRoot("apps/mydir/myapp/") // returns "../../../"
+ * ```
+ *
+ * @param fullPathToDir - directory path
+ */
+export declare function offsetFromRoot(fullPathToDir: string): string;

package/src/utils/offset-from-root.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.offsetFromRoot = void 0;
+const path_1 = require("path");
+/**
+ * Calculates an offset from the root of the workspace, which is useful for
+ * constructing relative URLs.
+ *
+ * Examples:
+ *
+ * ```typescript
+ * offsetFromRoot("apps/mydir/myapp/") // returns "../../../"
+ * ```
+ *
+ * @param fullPathToDir - directory path
+ */
+function offsetFromRoot(fullPathToDir) {
+    if (fullPathToDir === '.')
+        return './';
+    const parts = (0, path_1.normalize)(fullPathToDir).split(path_1.sep);
+    let offset = '';
+    for (let i = 0; i < parts.length; ++i) {
+        if (parts[i].length > 0) {
+            offset += '../';
+        }
+    }
+    return offset;
+}
+exports.offsetFromRoot = offsetFromRoot;
+//# sourceMappingURL=offset-from-root.js.map

package/src/utils/offset-from-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset-from-root.js","sourceRoot":"","sources":["../../../../../packages/devkit/src/utils/offset-from-root.ts"],"names":[],"mappings":";;;AAAA,+BAAsC;AAEtC;;;;;;;;;;;GAWG;AACH,SAAgB,cAAc,CAAC,aAAqB;IAClD,IAAI,aAAa,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEvC,MAAM,KAAK,GAAG,IAAA,gBAAS,EAAC,aAAa,CAAC,CAAC,KAAK,CAAC,UAAG,CAAC,CAAC;IAClD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;QACrC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;YACvB,MAAM,IAAI,KAAK,CAAC;SACjB;KACF;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAXD,wCAWC"}

package/src/utils/package-json.d.ts

@@ -0,0 +1,74 @@
+import type { Tree } from 'nx/src/generators/tree';
+import type { GeneratorCallback } from 'nx/src/config/misc-interfaces';
+/**
+ * Add Dependencies and Dev Dependencies to package.json
+ *
+ * For example:
+ * ```typescript
+ * addDependenciesToPackageJson(tree, { react: 'latest' }, { jest: 'latest' })
+ * ```
+ * This will **add** `react` and `jest` to the dependencies and devDependencies sections of package.json respectively.
+ *
+ * @param tree Tree representing file system to modify
+ * @param dependencies Dependencies to be added to the dependencies section of package.json
+ * @param devDependencies Dependencies to be added to the devDependencies section of package.json
+ * @param packageJsonPath Path to package.json
+ * @returns Callback to install dependencies only if necessary, no-op otherwise
+ */
+export declare function addDependenciesToPackageJson(tree: Tree, dependencies: Record<string, string>, devDependencies: Record<string, string>, packageJsonPath?: string): GeneratorCallback;
+/**
+ * Remove Dependencies and Dev Dependencies from package.json
+ *
+ * For example:
+ * ```typescript
+ * removeDependenciesFromPackageJson(tree, ['react'], ['jest'])
+ * ```
+ * This will **remove** `react` and `jest` from the dependencies and devDependencies sections of package.json respectively.
+ *
+ * @param dependencies Dependencies to be removed from the dependencies section of package.json
+ * @param devDependencies Dependencies to be removed from the devDependencies section of package.json
+ * @returns Callback to uninstall dependencies only if necessary. undefined is returned if changes are not necessary.
+ */
+export declare function removeDependenciesFromPackageJson(tree: Tree, dependencies: string[], devDependencies: string[], packageJsonPath?: string): GeneratorCallback;
+/**
+ * @typedef EnsurePackageOptions
+ * @type {object}
+ * @property {boolean} dev indicate if the package is a dev dependency
+ * @property {throwOnMissing} boolean throws an error when the package is missing
+ */
+/**
+ * @deprecated Use the other function signature without a Tree
+ *
+ * Use a package that has not been installed as a dependency.
+ *
+ * For example:
+ * ```typescript
+ * ensurePackage(tree, '@nrwl/jest', nxVersion)
+ * ```
+ * This install the @nrwl/jest@<nxVersion> and return the module
+ * When running with --dryRun, the function will throw when dependencies are missing.
+ *
+ * @param tree the file system tree
+ * @param pkg the package to check (e.g. @nrwl/jest)
+ * @param requiredVersion the version or semver range to check (e.g. ~1.0.0, >=1.0.0 <2.0.0)
+ * @param {EnsurePackageOptions} options?
+ */
+export declare function ensurePackage(tree: Tree, pkg: string, requiredVersion: string, options?: {
+    dev?: boolean;
+    throwOnMissing?: boolean;
+}): void;
+/**
+ * Ensure that dependencies and devDependencies from package.json are installed at the required versions.
+ *
+ * For example:
+ * ```typescript
+ * ensurePackage(tree, '@nrwl/jest', nxVersion)
+ * ```
+ * @param pkg the package to install and require
+ * @param version the version to install if the package doesn't exist already
+ */
+export declare function ensurePackage<T extends any = any>(pkg: string, version: string): T;
+/**
+ * @description The version of Nx used by the workspace. Returns null if no version is found.
+ */
+export declare const NX_VERSION: string;