@pnpm/workspace.projects-graph 1000.0.25

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015-2016 Rico Sta. Cruz and other contributors
+Copyright (c) 2016-2026 Zoltan Kochan and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @pnpm/workspace.projects-graph
+
+> Create a graph from an array of packages
+
+[![npm version](https://img.shields.io/npm/v/pkgs-graph.svg)](https://www.npmjs.com/package/pkgs-graph)
+
+## Installation
+
+```
+pnpm add @pnpm/workspace.projects-graph
+```
+
+## Usage
+
+```js
+import createPkgsGraph from 'pkgs-graph'
+
+const {graph} = createPkgsGraph([
+  {
+    dir: '/home/zkochan/src/foo',
+    manifest: {
+      name: 'foo',
+      version: '1.0.0',
+      dependencies: {
+        bar: '^1.0.0',
+      },
+    },
+  },
+  {
+    dir: '/home/zkochan/src/bar',
+    manifest: {
+      name: 'bar',
+      version: '1.1.0',
+    },
+  }
+])
+
+console.log(graph)
+//> {
+//    '/home/zkochan/src/foo': {
+//      dependencies: ['/home/zkochan/src/bar'],
+//      manifest: {
+//        name: 'foo',
+//        version: '1.0.0',
+//        dependencies: {
+//          bar: '^1.0.0',
+//        },
+//      },
+//    },
+//    '/home/zkochan/src/bar': {
+//      dependencies: [],
+//      manifest: {
+//        name: 'bar',
+//        version: '1.1.0',
+//      },
+//    },
+//  }
+```
+
+## License
+
+[MIT](LICENSE) © [Zoltan Kochan](https://www.kochan.io)

package/lib/index.d.ts

@@ -0,0 +1,19 @@
+import type { BaseManifest, ProjectRootDir } from '@pnpm/types';
+export interface BaseProject {
+    manifest: BaseManifest;
+    rootDir: ProjectRootDir;
+}
+export interface ProjectGraphNode<Pkg extends BaseProject> {
+    package: Pkg;
+    dependencies: ProjectRootDir[];
+}
+export declare function createProjectsGraph<Pkg extends BaseProject>(projects: Pkg[], opts?: {
+    ignoreDevDeps?: boolean;
+    linkWorkspacePackages?: boolean;
+}): {
+    graph: Record<ProjectRootDir, ProjectGraphNode<Pkg>>;
+    unmatched: Array<{
+        pkgName: string;
+        range: string;
+    }>;
+};

package/lib/index.js

@@ -0,0 +1,110 @@
+import path from 'node:path';
+import npa from '@pnpm/npm-package-arg';
+import { parseBareSpecifier, workspacePrefToNpm } from '@pnpm/resolving.npm-resolver';
+import { resolveWorkspaceRange } from '@pnpm/workspace.range-resolver';
+import { map as mapValues } from 'ramda';
+export function createProjectsGraph(projects, opts) {
+    const projectMap = createProjectMap(projects);
+    const projectMapValues = Object.values(projectMap);
+    let projectMapByManifestName;
+    let projectMapByDir;
+    const unmatched = [];
+    const graph = mapValues((project) => ({
+        dependencies: createNode(project),
+        package: project,
+    }), projectMap);
+    return { graph, unmatched };
+    function createNode(project) {
+        const dependencies = {
+            ...project.manifest.peerDependencies,
+            ...(!opts?.ignoreDevDeps && project.manifest.devDependencies),
+            ...project.manifest.optionalDependencies,
+            ...project.manifest.dependencies,
+        };
+        return Object.entries(dependencies)
+            .map(([depName, rawSpec]) => {
+            let spec;
+            const isWorkspaceSpec = rawSpec.startsWith('workspace:');
+            try {
+                if (isWorkspaceSpec) {
+                    const { fetchSpec, name } = parseBareSpecifier(workspacePrefToNpm(rawSpec), depName, 'latest', '');
+                    rawSpec = fetchSpec;
+                    depName = name;
+                }
+                spec = npa.resolve(depName, rawSpec, project.rootDir);
+            }
+            catch {
+                return '';
+            }
+            if (spec.type === 'directory') {
+                projectMapByDir ??= getProjectMapByDir(projectMapValues);
+                const resolvedPath = path.resolve(project.rootDir, spec.fetchSpec);
+                const found = projectMapByDir[resolvedPath];
+                if (found) {
+                    return found.rootDir;
+                }
+                // Slow path; only needed when there are case mismatches on case-insensitive filesystems.
+                const matchedProject = projectMapValues.find(p => path.relative(p.rootDir, spec.fetchSpec) === '');
+                if (matchedProject == null) {
+                    return '';
+                }
+                projectMapByDir[resolvedPath] = matchedProject;
+                return matchedProject.rootDir;
+            }
+            if (spec.type !== 'version' && spec.type !== 'range')
+                return '';
+            projectMapByManifestName ??= getProjectMapByManifestName(projectMapValues);
+            const candidates = projectMapByManifestName[depName];
+            if (!candidates || candidates.length === 0)
+                return '';
+            const versions = candidates.filter(({ manifest }) => manifest.version)
+                .map(p => p.manifest.version);
+            // explicitly check if false, backwards-compatibility (can be undefined)
+            const strictWorkspaceMatching = opts?.linkWorkspacePackages === false && !isWorkspaceSpec;
+            if (strictWorkspaceMatching) {
+                unmatched.push({ pkgName: depName, range: rawSpec });
+                return '';
+            }
+            if (isWorkspaceSpec && versions.length === 0) {
+                const matchedProject = candidates.find(p => p.manifest.name === depName);
+                return matchedProject.rootDir;
+            }
+            if (versions.includes(rawSpec)) {
+                const matchedProject = candidates.find(p => p.manifest.name === depName && p.manifest.version === rawSpec);
+                return matchedProject.rootDir;
+            }
+            const matched = resolveWorkspaceRange(rawSpec, versions);
+            if (!matched) {
+                unmatched.push({ pkgName: depName, range: rawSpec });
+                return '';
+            }
+            const matchedProject = candidates.find(p => p.manifest.name === depName && p.manifest.version === matched);
+            return matchedProject.rootDir;
+        })
+            .filter(Boolean);
+    }
+}
+function createProjectMap(projects) {
+    const projectMap = {};
+    for (const project of projects) {
+        projectMap[project.rootDir] = project;
+    }
+    return projectMap;
+}
+function getProjectMapByManifestName(projectMapValues) {
+    const projectMapByManifestName = {};
+    for (const project of projectMapValues) {
+        if (project.manifest.name) {
+            (projectMapByManifestName[project.manifest.name] ??= []).push(project);
+        }
+    }
+    return projectMapByManifestName;
+}
+function getProjectMapByDir(projectMapValues) {
+    const projectMapByDir = {};
+    for (const project of projectMapValues) {
+        projectMapByDir[path.resolve(project.rootDir)] = project;
+    }
+    return projectMapByDir;
+}
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@pnpm/workspace.projects-graph",
+  "version": "1000.0.25",
+  "description": "Create a graph from an array of packages",
+  "keywords": [
+    "pnpm",
+    "pnpm11"
+  ],
+  "license": "MIT",
+  "funding": "https://opencollective.com/pnpm",
+  "repository": "https://github.com/pnpm/pnpm/tree/main/workspace/projects-graph",
+  "homepage": "https://github.com/pnpm/pnpm/tree/main/workspace/projects-graph#readme",
+  "bugs": {
+    "url": "https://github.com/pnpm/pnpm/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "files": [
+    "lib",
+    "!*.map"
+  ],
+  "dependencies": {
+    "@pnpm/npm-package-arg": "^2.0.0",
+    "ramda": "npm:@pnpm/ramda@0.28.1",
+    "@pnpm/resolving.npm-resolver": "1004.4.1",
+    "@pnpm/workspace.range-resolver": "1000.0.0",
+    "@pnpm/types": "1000.9.0"
+  },
+  "devDependencies": {
+    "@types/ramda": "0.29.12",
+    "better-path-resolve": "2.0.0",
+    "@pnpm/workspace.projects-graph": "1000.0.25"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "jest": {
+    "preset": "@pnpm/jest-config"
+  },
+  "scripts": {
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "_test": "cross-env NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules --disable-warning=ExperimentalWarning --disable-warning=DEP0169\" jest",
+    "test": "pnpm run compile && pnpm run _test",
+    "compile": "tsgo --build && pnpm run lint --fix"
+  }
+}