@teambit/workspace.modules.node-modules-linker 0.0.1

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { NodeModulesLinksResult, linkToNodeModules, linkToNodeModulesWithCodemod } from './node-modules-linker';

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linkToNodeModulesWithCodemod = exports.linkToNodeModules = void 0;
+var node_modules_linker_1 = require("./node-modules-linker");
+Object.defineProperty(exports, "linkToNodeModules", { enumerable: true, get: function () { return node_modules_linker_1.linkToNodeModules; } });
+Object.defineProperty(exports, "linkToNodeModulesWithCodemod", { enumerable: true, get: function () { return node_modules_linker_1.linkToNodeModulesWithCodemod; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;AAAA,6DAAgH;AAA/E,wHAAA,iBAAiB,OAAA;AAAE,mIAAA,4BAA4B,OAAA"}

package/dist/node-modules-linker.d.ts

@@ -0,0 +1,75 @@
+import { BitId } from '@teambit/legacy-bit-id';
+import BitMap from '@teambit/legacy/dist/consumer/bit-map/bit-map';
+import Component from '@teambit/legacy/dist/consumer/component/consumer-component';
+import PackageJsonFile from '@teambit/legacy/dist/consumer/component/package-json-file';
+import DataToPersist from '@teambit/legacy/dist/consumer/component/sources/data-to-persist';
+import Consumer from '@teambit/legacy/dist/consumer/consumer';
+import { PathOsBasedRelative } from '@teambit/legacy/dist/utils/path';
+import Symlink from '@teambit/legacy/dist/links/symlink';
+import { Workspace } from '@teambit/workspace';
+declare type LinkDetail = {
+    from: string;
+    to: string;
+};
+export declare type NodeModulesLinksResult = {
+    id: BitId;
+    bound: LinkDetail[];
+};
+/**
+ * link given components to node_modules, so it's possible to use absolute link instead of relative
+ * for example, require('@bit/remote-scope.bar.foo)
+ */
+export default class NodeModuleLinker {
+    components: Component[];
+    consumer: Consumer;
+    bitMap: BitMap;
+    dataToPersist: DataToPersist;
+    constructor(components: Component[], consumer: Consumer);
+    link(): Promise<NodeModulesLinksResult[]>;
+    getLinks(): Promise<DataToPersist>;
+    getLinksResults(): NodeModulesLinksResult[];
+    _getDefaultScope(component?: Component): string | undefined | null;
+    /**
+     * even when an authored component has rootDir, we can't just symlink that rootDir to
+     * node_modules/rootDir. it could work only when the main-file is index.js, not for other cases.
+     * node expects the module inside node_modules to have either package.json with valid "main"
+     * property or an index.js file. this main property can't be relative.
+     */
+    _populateComponentsLinks(component: Component): Promise<void>;
+    /**
+     * symlink the entire source directory into "src" in node-modules.
+     */
+    private symlinkComponentDir;
+    /**
+     * Removing existing links root (the package path) - to handle cases it was linked by package manager for example
+     * this makes sure we are not affecting other places (like package manager cache) we shouldn't touch
+     * If you have a case when this deletes something created by the package manager and it's not the desired behavior,
+     * do not delete this code, but make sure the package manger nest the installed version into it's dependent
+     * @param component
+     */
+    _deleteExistingLinksRootIfSymlink(linkPath: string): any;
+    /**
+     * When the dists is outside the components directory, it doesn't have access to the node_modules of the component's
+     * root-dir. The solution is to go through the node_modules packages one by one and symlink them.
+     */
+    _getSymlinkPackages(from: string, to: string, component: Component): Symlink[];
+    _getDependencyLink(parentRootDir: PathOsBasedRelative, bitId: BitId, rootDir: PathOsBasedRelative, bindingPrefix: string, component: Component): Symlink;
+    /**
+     * create package.json on node_modules/@bit/component-name/package.json with a property 'main'
+     * pointing to the component's main file.
+     * It is needed for Authored components only.
+     * Since an authored component doesn't have rootDir, it's impossible to symlink to the component directory.
+     * It makes it easier for Author to use absolute syntax between their own components.
+     */
+    private createPackageJson;
+    /**
+     * these are changes made by aspects
+     */
+    _applyTransformers(component: Component, packageJson: PackageJsonFile): Promise<void>;
+}
+export declare function linkToNodeModulesWithCodemod(workspace: Workspace, bitIds: BitId[], changeRelativeToModulePaths: boolean): Promise<{
+    linksResults: NodeModulesLinksResult[];
+    codemodResults: any;
+}>;
+export declare function linkToNodeModules(workspace: Workspace, bitIds: BitId[], loadFromScope?: boolean): Promise<NodeModulesLinksResult[]>;
+export {};

package/dist/node-modules-linker.js

@@ -0,0 +1,285 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.linkToNodeModules = exports.linkToNodeModulesWithCodemod = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const glob_1 = __importDefault(require("glob"));
+const p_map_series_1 = __importDefault(require("p-map-series"));
+const path = __importStar(require("path"));
+const ramda_1 = __importDefault(require("ramda"));
+const constants_1 = require("@teambit/legacy/dist/constants");
+const components_list_1 = __importDefault(require("@teambit/legacy/dist/consumer/component/components-list"));
+const package_json_file_1 = __importDefault(require("@teambit/legacy/dist/consumer/component/package-json-file"));
+const package_json_transformer_1 = require("@teambit/legacy/dist/consumer/component/package-json-transformer");
+const data_to_persist_1 = __importDefault(require("@teambit/legacy/dist/consumer/component/sources/data-to-persist"));
+const remove_path_1 = __importDefault(require("@teambit/legacy/dist/consumer/component/sources/remove-path"));
+const logger_1 = __importDefault(require("@teambit/legacy/dist/logger/logger"));
+const utils_1 = require("@teambit/legacy/dist/utils");
+const component_node_modules_path_1 = __importDefault(require("@teambit/legacy/dist/utils/bit/component-node-modules-path"));
+const bit_id_1 = require("@teambit/legacy/dist/bit-id");
+const codemod_components_1 = require("@teambit/legacy/dist/consumer/component-ops/codemod-components");
+const symlink_1 = __importDefault(require("@teambit/legacy/dist/links/symlink"));
+/**
+ * link given components to node_modules, so it's possible to use absolute link instead of relative
+ * for example, require('@bit/remote-scope.bar.foo)
+ */
+class NodeModuleLinker {
+    constructor(components, consumer) {
+        this.components = components_list_1.default.getUniqueComponents(components);
+        this.consumer = consumer;
+        this.bitMap = consumer.bitMap;
+        this.dataToPersist = new data_to_persist_1.default();
+    }
+    link() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const links = yield this.getLinks();
+            const linksResults = this.getLinksResults();
+            if (this.consumer)
+                links.addBasePath(this.consumer.getPath());
+            yield links.persistAllToFS();
+            yield ((_a = this.consumer) === null || _a === void 0 ? void 0 : _a.componentFsCache.deleteAllDependenciesDataCache());
+            return linksResults;
+        });
+    }
+    getLinks() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.dataToPersist = new data_to_persist_1.default();
+            // don't use Promise.all because down the road it calls transformPackageJson of pkg aspect, which loads components
+            yield (0, p_map_series_1.default)(this.components, (component) => {
+                const componentId = component.id.toString();
+                logger_1.default.debug(`linking component to node_modules: ${componentId}`);
+                const componentMap = this.bitMap.getComponent(component.id);
+                component.componentMap = componentMap;
+                return this._populateComponentsLinks(component);
+            });
+            return this.dataToPersist;
+        });
+    }
+    getLinksResults() {
+        const linksResults = [];
+        const getExistingLinkResult = (id) => linksResults.find((linkResult) => linkResult.id.isEqual(id));
+        const addLinkResult = (id, from, to) => {
+            if (!id)
+                return;
+            const existingLinkResult = getExistingLinkResult(id);
+            if (existingLinkResult) {
+                existingLinkResult.bound.push({ from, to });
+            }
+            else {
+                linksResults.push({ id, bound: [{ from, to }] });
+            }
+        };
+        this.dataToPersist.symlinks.forEach((symlink) => {
+            addLinkResult(symlink.componentId, symlink.src, symlink.dest);
+        });
+        this.components.forEach((component) => {
+            const existingLinkResult = getExistingLinkResult(component.id);
+            if (!existingLinkResult) {
+                linksResults.push({ id: component.id, bound: [] });
+            }
+        });
+        return linksResults;
+    }
+    _getDefaultScope(component) {
+        if (component) {
+            return component.defaultScope;
+        }
+        return this.consumer ? this.consumer.config.defaultScope : null;
+    }
+    /**
+     * even when an authored component has rootDir, we can't just symlink that rootDir to
+     * node_modules/rootDir. it could work only when the main-file is index.js, not for other cases.
+     * node expects the module inside node_modules to have either package.json with valid "main"
+     * property or an index.js file. this main property can't be relative.
+     */
+    _populateComponentsLinks(component) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const componentId = component.id;
+            const linkPath = (0, component_node_modules_path_1.default)({
+                bindingPrefix: component.bindingPrefix,
+                id: componentId,
+                allowNonScope: true,
+                defaultScope: this._getDefaultScope(component),
+                extensions: component.extensions,
+            });
+            this.symlinkComponentDir(component, linkPath);
+            this._deleteExistingLinksRootIfSymlink(linkPath);
+            yield this.createPackageJson(component);
+        });
+    }
+    /**
+     * symlink the entire source directory into "src" in node-modules.
+     */
+    symlinkComponentDir(component, linkPath) {
+        const componentMap = component.componentMap;
+        const filesToBind = componentMap.getAllFilesPaths();
+        filesToBind.forEach((file) => {
+            const fileWithRootDir = path.join(componentMap.rootDir, file);
+            const dest = path.join(linkPath, file);
+            this.dataToPersist.addSymlink(symlink_1.default.makeInstance(fileWithRootDir, dest, component.id, true));
+        });
+        if (constants_1.IS_WINDOWS) {
+            this.dataToPersist.addSymlink(symlink_1.default.makeInstance(componentMap.rootDir, path.join(linkPath, constants_1.SOURCE_DIR_SYMLINK_TO_NM), component.id));
+        }
+    }
+    /**
+     * Removing existing links root (the package path) - to handle cases it was linked by package manager for example
+     * this makes sure we are not affecting other places (like package manager cache) we shouldn't touch
+     * If you have a case when this deletes something created by the package manager and it's not the desired behavior,
+     * do not delete this code, but make sure the package manger nest the installed version into it's dependent
+     * @param component
+     */
+    _deleteExistingLinksRootIfSymlink(linkPath) {
+        try {
+            const stat = fs_extra_1.default.lstatSync(linkPath);
+            if (stat.isSymbolicLink()) {
+                this.dataToPersist.removePath(new remove_path_1.default(linkPath));
+            }
+            return undefined;
+        }
+        catch (err) {
+            return undefined; // probably file does not exist
+        }
+    }
+    /**
+     * When the dists is outside the components directory, it doesn't have access to the node_modules of the component's
+     * root-dir. The solution is to go through the node_modules packages one by one and symlink them.
+     */
+    _getSymlinkPackages(from, to, component) {
+        if (!this.consumer)
+            throw new Error('getSymlinkPackages expects the Consumer to be defined');
+        const dependenciesSavedAsComponents = component.dependenciesSavedAsComponents;
+        const fromNodeModules = path.join(from, 'node_modules');
+        const toNodeModules = path.join(to, 'node_modules');
+        logger_1.default.debug(`symlinkPackages for dists outside the component directory from ${fromNodeModules} to ${toNodeModules}`);
+        const unfilteredDirs = glob_1.default.sync('*', { cwd: fromNodeModules });
+        // when dependenciesSavedAsComponents the node_modules/@bit has real link files, we don't want to touch them
+        // otherwise, node_modules/@bit has packages as any other directory in node_modules
+        const dirsToFilter = dependenciesSavedAsComponents ? [this.consumer.config._bindingPrefix] : [];
+        const customResolvedData = component.dependencies.getCustomResolvedData();
+        if (!ramda_1.default.isEmpty(customResolvedData)) {
+            // filter out packages that are actually symlinks to dependencies
+            Object.keys(customResolvedData).forEach((importSource) => dirsToFilter.push((0, utils_1.first)(importSource.split('/'))));
+        }
+        const dirs = dirsToFilter.length ? unfilteredDirs.filter((dir) => !dirsToFilter.includes(dir)) : unfilteredDirs;
+        if (!dirs.length)
+            return [];
+        return dirs.map((dir) => {
+            const fromDir = path.join(fromNodeModules, dir);
+            const toDir = path.join(toNodeModules, dir);
+            return symlink_1.default.makeInstance(fromDir, toDir);
+        });
+    }
+    _getDependencyLink(parentRootDir, bitId, rootDir, bindingPrefix, component) {
+        const relativeDestPath = (0, component_node_modules_path_1.default)(Object.assign(Object.assign({}, component), { id: bitId, allowNonScope: true, bindingPrefix, isDependency: true }));
+        const destPathInsideParent = path.join(parentRootDir, relativeDestPath);
+        return symlink_1.default.makeInstance(rootDir, destPathInsideParent, bitId);
+    }
+    /**
+     * create package.json on node_modules/@bit/component-name/package.json with a property 'main'
+     * pointing to the component's main file.
+     * It is needed for Authored components only.
+     * Since an authored component doesn't have rootDir, it's impossible to symlink to the component directory.
+     * It makes it easier for Author to use absolute syntax between their own components.
+     */
+    createPackageJson(component) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // @ts-ignore AUTO-ADDED-AFTER-MIGRATION-PLEASE-FIX!
+            const hasPackageJsonAsComponentFile = component.files.some((file) => file.relative === constants_1.PACKAGE_JSON);
+            if (hasPackageJsonAsComponentFile)
+                return; // don't generate package.json on top of the user package.json
+            const dest = path.join((0, component_node_modules_path_1.default)(Object.assign(Object.assign({}, component), { id: component.id, allowNonScope: true })));
+            const packageJson = package_json_file_1.default.createFromComponent(dest, component, true, true);
+            yield this._applyTransformers(component, packageJson);
+            if (constants_1.IS_WINDOWS) {
+                // in the workspace, override the "types" and add the "src" prefix.
+                // otherwise, the navigation and auto-complete won't work on the IDE.
+                // this is for Windows only. For Linux, we use symlinks for the files.
+                packageJson.addOrUpdateProperty('types', `${constants_1.SOURCE_DIR_SYMLINK_TO_NM}/${component.mainFile}`);
+            }
+            if (packageJson.packageJsonObject.version === 'latest') {
+                packageJson.packageJsonObject.version = '0.0.1-new';
+            }
+            // packageJson.mergePropsFromExtensions(component);
+            // TODO: we need to have an hook here to get the transformer from the pkg extension
+            // delete the version, otherwise, we have to maintains it. such as, when tagging, it should be
+            // changed to the new tagged version.
+            delete packageJson.packageJsonObject.version;
+            this.dataToPersist.addFile(packageJson.toVinylFile());
+        });
+    }
+    /**
+     * these are changes made by aspects
+     */
+    _applyTransformers(component, packageJson) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return package_json_transformer_1.PackageJsonTransformer.applyTransformers(component, packageJson);
+        });
+    }
+}
+exports.default = NodeModuleLinker;
+function linkToNodeModulesWithCodemod(workspace, bitIds, changeRelativeToModulePaths) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let codemodResults;
+        if (changeRelativeToModulePaths) {
+            codemodResults = yield (0, codemod_components_1.changeCodeFromRelativeToModulePaths)(workspace.consumer, bitIds);
+        }
+        const linksResults = yield linkToNodeModules(workspace, bitIds);
+        return { linksResults, codemodResults };
+    });
+}
+exports.linkToNodeModulesWithCodemod = linkToNodeModulesWithCodemod;
+function linkToNodeModules(workspace, bitIds, loadFromScope = false) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const componentsIds = bit_id_1.BitIds.fromArray(bitIds);
+        if (!componentsIds.length)
+            return [];
+        const getComponents = () => __awaiter(this, void 0, void 0, function* () {
+            if (loadFromScope) {
+                return Promise.all(componentsIds.map((id) => workspace.consumer.loadComponentFromModel(id)));
+            }
+            const { components } = yield workspace.consumer.loadComponents(componentsIds);
+            return components;
+        });
+        const components = yield getComponents();
+        const nodeModuleLinker = new NodeModuleLinker(components, workspace.consumer);
+        return nodeModuleLinker.link();
+    });
+}
+exports.linkToNodeModules = linkToNodeModules;
+//# sourceMappingURL=node-modules-linker.js.map

package/dist/node-modules-linker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-modules-linker.js","sourceRoot":"","sources":["../node-modules-linker.ts"],"names":[],"mappings":"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"}

package/dist/preview-1675308621306.js

@@ -0,0 +1,7 @@
+;
+;
+
+export const compositions = [];
+export const overview = [];
+
+export const compositions_metadata = {"compositions":[]};

package/dist/tsconfig.json

@@ -0,0 +1,32 @@
+{
+    "compilerOptions": {
+        "lib": [
+            "es2019",
+            "DOM",
+            "ES6",
+            "DOM.Iterable"
+        ],
+        "target": "es2015",
+        "module": "CommonJS",
+        "jsx": "react",
+        "allowJs": true,
+        "composite": true,
+        "declaration": true,
+        "sourceMap": true,
+        "skipLibCheck": true,
+        "experimentalDecorators": true,
+        "outDir": "dist",
+        "moduleResolution": "node",
+        "esModuleInterop": true,
+        "rootDir": ".",
+        "resolveJsonModule": true
+    },
+    "exclude": [
+        "dist",
+        "package.json"
+    ],
+    "include": [
+        "**/*",
+        "**/*.json"
+    ]
+}

package/index.ts

@@ -0,0 +1 @@
+export { NodeModulesLinksResult, linkToNodeModules, linkToNodeModulesWithCodemod } from './node-modules-linker';

package/node-modules-linker.ts

@@ -0,0 +1,288 @@
+import fs from 'fs-extra';
+import glob from 'glob';
+import pMapSeries from 'p-map-series';
+import * as path from 'path';
+import R from 'ramda';
+import { BitId } from '@teambit/legacy-bit-id';
+import { IS_WINDOWS, PACKAGE_JSON, SOURCE_DIR_SYMLINK_TO_NM } from '@teambit/legacy/dist/constants';
+import BitMap from '@teambit/legacy/dist/consumer/bit-map/bit-map';
+import ComponentMap from '@teambit/legacy/dist/consumer/bit-map/component-map';
+import ComponentsList from '@teambit/legacy/dist/consumer/component/components-list';
+import Component from '@teambit/legacy/dist/consumer/component/consumer-component';
+import PackageJsonFile from '@teambit/legacy/dist/consumer/component/package-json-file';
+import { PackageJsonTransformer } from '@teambit/legacy/dist/consumer/component/package-json-transformer';
+import DataToPersist from '@teambit/legacy/dist/consumer/component/sources/data-to-persist';
+import RemovePath from '@teambit/legacy/dist/consumer/component/sources/remove-path';
+import Consumer from '@teambit/legacy/dist/consumer/consumer';
+import logger from '@teambit/legacy/dist/logger/logger';
+import { first } from '@teambit/legacy/dist/utils';
+import getNodeModulesPathOfComponent from '@teambit/legacy/dist/utils/bit/component-node-modules-path';
+import { PathOsBasedRelative } from '@teambit/legacy/dist/utils/path';
+import { BitIds } from '@teambit/legacy/dist/bit-id';
+import { changeCodeFromRelativeToModulePaths } from '@teambit/legacy/dist/consumer/component-ops/codemod-components';
+import Symlink from '@teambit/legacy/dist/links/symlink';
+import { Workspace } from '@teambit/workspace';
+
+type LinkDetail = { from: string; to: string };
+export type NodeModulesLinksResult = {
+  id: BitId;
+  bound: LinkDetail[];
+};
+
+/**
+ * link given components to node_modules, so it's possible to use absolute link instead of relative
+ * for example, require('@bit/remote-scope.bar.foo)
+ */
+export default class NodeModuleLinker {
+  components: Component[];
+  consumer: Consumer;
+  bitMap: BitMap; // preparation for the capsule, which is going to have only BitMap with no Consumer
+  dataToPersist: DataToPersist;
+  constructor(components: Component[], consumer: Consumer) {
+    this.components = ComponentsList.getUniqueComponents(components);
+    this.consumer = consumer;
+    this.bitMap = consumer.bitMap;
+    this.dataToPersist = new DataToPersist();
+  }
+  async link(): Promise<NodeModulesLinksResult[]> {
+    const links = await this.getLinks();
+    const linksResults = this.getLinksResults();
+    if (this.consumer) links.addBasePath(this.consumer.getPath());
+    await links.persistAllToFS();
+    await this.consumer?.componentFsCache.deleteAllDependenciesDataCache();
+    return linksResults;
+  }
+  async getLinks(): Promise<DataToPersist> {
+    this.dataToPersist = new DataToPersist();
+    // don't use Promise.all because down the road it calls transformPackageJson of pkg aspect, which loads components
+    await pMapSeries(this.components, (component) => {
+      const componentId = component.id.toString();
+      logger.debug(`linking component to node_modules: ${componentId}`);
+      const componentMap: ComponentMap = this.bitMap.getComponent(component.id);
+      component.componentMap = componentMap;
+      return this._populateComponentsLinks(component);
+    });
+
+    return this.dataToPersist;
+  }
+  getLinksResults(): NodeModulesLinksResult[] {
+    const linksResults: NodeModulesLinksResult[] = [];
+    const getExistingLinkResult = (id) => linksResults.find((linkResult) => linkResult.id.isEqual(id));
+    const addLinkResult = (id: BitId | null | undefined, from: string, to: string) => {
+      if (!id) return;
+      const existingLinkResult = getExistingLinkResult(id);
+      if (existingLinkResult) {
+        existingLinkResult.bound.push({ from, to });
+      } else {
+        linksResults.push({ id, bound: [{ from, to }] });
+      }
+    };
+    this.dataToPersist.symlinks.forEach((symlink: Symlink) => {
+      addLinkResult(symlink.componentId, symlink.src, symlink.dest);
+    });
+    this.components.forEach((component) => {
+      const existingLinkResult = getExistingLinkResult(component.id);
+      if (!existingLinkResult) {
+        linksResults.push({ id: component.id, bound: [] });
+      }
+    });
+    return linksResults;
+  }
+
+  _getDefaultScope(component?: Component): string | undefined | null {
+    if (component) {
+      return component.defaultScope;
+    }
+    return this.consumer ? this.consumer.config.defaultScope : null;
+  }
+
+  /**
+   * even when an authored component has rootDir, we can't just symlink that rootDir to
+   * node_modules/rootDir. it could work only when the main-file is index.js, not for other cases.
+   * node expects the module inside node_modules to have either package.json with valid "main"
+   * property or an index.js file. this main property can't be relative.
+   */
+  async _populateComponentsLinks(component: Component): Promise<void> {
+    const componentId = component.id;
+    const linkPath: PathOsBasedRelative = getNodeModulesPathOfComponent({
+      bindingPrefix: component.bindingPrefix,
+      id: componentId,
+      allowNonScope: true,
+      defaultScope: this._getDefaultScope(component),
+      extensions: component.extensions,
+    });
+
+    this.symlinkComponentDir(component, linkPath);
+    this._deleteExistingLinksRootIfSymlink(linkPath);
+    await this.createPackageJson(component);
+  }
+
+  /**
+   * symlink the entire source directory into "src" in node-modules.
+   */
+  private symlinkComponentDir(component: Component, linkPath: PathOsBasedRelative) {
+    const componentMap = component.componentMap as ComponentMap;
+
+    const filesToBind = componentMap.getAllFilesPaths();
+    filesToBind.forEach((file) => {
+      const fileWithRootDir = path.join(componentMap.rootDir as string, file);
+      const dest = path.join(linkPath, file);
+      this.dataToPersist.addSymlink(Symlink.makeInstance(fileWithRootDir, dest, component.id, true));
+    });
+
+    if (IS_WINDOWS) {
+      this.dataToPersist.addSymlink(
+        Symlink.makeInstance(
+          componentMap.rootDir as string,
+          path.join(linkPath, SOURCE_DIR_SYMLINK_TO_NM),
+          component.id
+        )
+      );
+    }
+  }
+
+  /**
+   * Removing existing links root (the package path) - to handle cases it was linked by package manager for example
+   * this makes sure we are not affecting other places (like package manager cache) we shouldn't touch
+   * If you have a case when this deletes something created by the package manager and it's not the desired behavior,
+   * do not delete this code, but make sure the package manger nest the installed version into it's dependent
+   * @param component
+   */
+  _deleteExistingLinksRootIfSymlink(linkPath: string) {
+    try {
+      const stat = fs.lstatSync(linkPath);
+      if (stat.isSymbolicLink()) {
+        this.dataToPersist.removePath(new RemovePath(linkPath));
+      }
+      return undefined;
+    } catch (err: any) {
+      return undefined; // probably file does not exist
+    }
+  }
+
+  /**
+   * When the dists is outside the components directory, it doesn't have access to the node_modules of the component's
+   * root-dir. The solution is to go through the node_modules packages one by one and symlink them.
+   */
+  _getSymlinkPackages(from: string, to: string, component: Component): Symlink[] {
+    if (!this.consumer) throw new Error('getSymlinkPackages expects the Consumer to be defined');
+    const dependenciesSavedAsComponents = component.dependenciesSavedAsComponents;
+    const fromNodeModules = path.join(from, 'node_modules');
+    const toNodeModules = path.join(to, 'node_modules');
+    logger.debug(
+      `symlinkPackages for dists outside the component directory from ${fromNodeModules} to ${toNodeModules}`
+    );
+    const unfilteredDirs = glob.sync('*', { cwd: fromNodeModules });
+    // when dependenciesSavedAsComponents the node_modules/@bit has real link files, we don't want to touch them
+    // otherwise, node_modules/@bit has packages as any other directory in node_modules
+    const dirsToFilter = dependenciesSavedAsComponents ? [this.consumer.config._bindingPrefix] : [];
+    const customResolvedData = component.dependencies.getCustomResolvedData();
+    if (!R.isEmpty(customResolvedData)) {
+      // filter out packages that are actually symlinks to dependencies
+      Object.keys(customResolvedData).forEach((importSource) => dirsToFilter.push(first(importSource.split('/'))));
+    }
+    const dirs = dirsToFilter.length ? unfilteredDirs.filter((dir) => !dirsToFilter.includes(dir)) : unfilteredDirs;
+    if (!dirs.length) return [];
+    return dirs.map((dir) => {
+      const fromDir = path.join(fromNodeModules, dir);
+      const toDir = path.join(toNodeModules, dir);
+      return Symlink.makeInstance(fromDir, toDir);
+    });
+  }
+
+  _getDependencyLink(
+    parentRootDir: PathOsBasedRelative,
+    bitId: BitId,
+    rootDir: PathOsBasedRelative,
+    bindingPrefix: string,
+    component: Component
+  ): Symlink {
+    const relativeDestPath = getNodeModulesPathOfComponent({
+      ...component,
+      id: bitId,
+      allowNonScope: true,
+      bindingPrefix,
+      isDependency: true,
+    });
+    const destPathInsideParent = path.join(parentRootDir, relativeDestPath);
+    return Symlink.makeInstance(rootDir, destPathInsideParent, bitId);
+  }
+
+  /**
+   * create package.json on node_modules/@bit/component-name/package.json with a property 'main'
+   * pointing to the component's main file.
+   * It is needed for Authored components only.
+   * Since an authored component doesn't have rootDir, it's impossible to symlink to the component directory.
+   * It makes it easier for Author to use absolute syntax between their own components.
+   */
+  private async createPackageJson(component: Component) {
+    // @ts-ignore AUTO-ADDED-AFTER-MIGRATION-PLEASE-FIX!
+    const hasPackageJsonAsComponentFile = component.files.some((file) => file.relative === PACKAGE_JSON);
+    if (hasPackageJsonAsComponentFile) return; // don't generate package.json on top of the user package.json
+    const dest = path.join(
+      getNodeModulesPathOfComponent({
+        ...component,
+        id: component.id,
+        allowNonScope: true,
+      })
+    );
+    const packageJson = PackageJsonFile.createFromComponent(dest, component, true, true);
+    await this._applyTransformers(component, packageJson);
+    if (IS_WINDOWS) {
+      // in the workspace, override the "types" and add the "src" prefix.
+      // otherwise, the navigation and auto-complete won't work on the IDE.
+      // this is for Windows only. For Linux, we use symlinks for the files.
+      packageJson.addOrUpdateProperty('types', `${SOURCE_DIR_SYMLINK_TO_NM}/${component.mainFile}`);
+    }
+    if (packageJson.packageJsonObject.version === 'latest') {
+      packageJson.packageJsonObject.version = '0.0.1-new';
+    }
+
+    // packageJson.mergePropsFromExtensions(component);
+    // TODO: we need to have an hook here to get the transformer from the pkg extension
+
+    // delete the version, otherwise, we have to maintains it. such as, when tagging, it should be
+    // changed to the new tagged version.
+    delete packageJson.packageJsonObject.version;
+    this.dataToPersist.addFile(packageJson.toVinylFile());
+  }
+
+  /**
+   * these are changes made by aspects
+   */
+  async _applyTransformers(component: Component, packageJson: PackageJsonFile) {
+    return PackageJsonTransformer.applyTransformers(component, packageJson);
+  }
+}
+
+export async function linkToNodeModulesWithCodemod(
+  workspace: Workspace,
+  bitIds: BitId[],
+  changeRelativeToModulePaths: boolean
+) {
+  let codemodResults;
+  if (changeRelativeToModulePaths) {
+    codemodResults = await changeCodeFromRelativeToModulePaths(workspace.consumer, bitIds);
+  }
+  const linksResults = await linkToNodeModules(workspace, bitIds);
+  return { linksResults, codemodResults };
+}
+
+export async function linkToNodeModules(
+  workspace: Workspace,
+  bitIds: BitId[],
+  loadFromScope = false
+): Promise<NodeModulesLinksResult[]> {
+  const componentsIds = BitIds.fromArray(bitIds);
+  if (!componentsIds.length) return [];
+  const getComponents = async () => {
+    if (loadFromScope) {
+      return Promise.all(componentsIds.map((id) => workspace.consumer.loadComponentFromModel(id)));
+    }
+    const { components } = await workspace.consumer.loadComponents(componentsIds);
+    return components;
+  };
+  const components = await getComponents();
+  const nodeModuleLinker = new NodeModuleLinker(components, workspace.consumer);
+  return nodeModuleLinker.link();
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@teambit/workspace.modules.node-modules-linker",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "componentId": {
+    "scope": "teambit.workspace",
+    "name": "modules/node-modules-linker",
+    "version": "0.0.1"
+  },
+  "dependencies": {
+    "fs-extra": "10.0.0",
+    "glob": "7.1.6",
+    "p-map-series": "2.1.0",
+    "ramda": "0.27.1",
+    "@teambit/legacy-bit-id": "0.0.421"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "9.0.7",
+    "@types/mocha": "9.1.0",
+    "@types/jest": "26.0.20",
+    "@types/node": "12.20.4",
+    "@babel/runtime": "7.20.0"
+  },
+  "peerDependencies": {},
+  "license": "Apache-2.0",
+  "private": false,
+  "engines": {
+    "node": ">=12.22.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/teambit/bit"
+  },
+  "keywords": [
+    "bit",
+    "components",
+    "collaboration",
+    "web",
+    "react",
+    "react-components",
+    "angular",
+    "angular-components"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,32 @@
+{
+  "compilerOptions": {
+    "lib": [
+      "es2019",
+      "DOM",
+      "ES6",
+      "DOM.Iterable"
+    ],
+    "target": "es2015",
+    "module": "CommonJS",
+    "jsx": "react",
+    "allowJs": true,
+    "composite": true,
+    "declaration": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "experimentalDecorators": true,
+    "outDir": "dist",
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "rootDir": ".",
+    "resolveJsonModule": true
+  },
+  "exclude": [
+    "dist",
+    "package.json"
+  ],
+  "include": [
+    "**/*",
+    "**/*.json"
+  ]
+}

package/types/asset.d.ts

@@ -0,0 +1,29 @@
+declare module '*.png' {
+  const value: any;
+  export = value;
+}
+declare module '*.svg' {
+  import type { FunctionComponent, SVGProps } from 'react';
+
+  export const ReactComponent: FunctionComponent<SVGProps<SVGSVGElement> & { title?: string }>;
+  const src: string;
+  export default src;
+}
+
+// @TODO Gilad
+declare module '*.jpg' {
+  const value: any;
+  export = value;
+}
+declare module '*.jpeg' {
+  const value: any;
+  export = value;
+}
+declare module '*.gif' {
+  const value: any;
+  export = value;
+}
+declare module '*.bmp' {
+  const value: any;
+  export = value;
+}

package/types/style.d.ts

@@ -0,0 +1,42 @@
+declare module '*.module.css' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+declare module '*.module.scss' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+declare module '*.module.sass' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.module.less' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.less' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.css' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.sass' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.scss' {
+  const classes: { readonly [key: string]: string };
+  export default classes;
+}
+
+declare module '*.mdx' {
+  const component: any;
+  export default component;
+}