@rushstack/lockfile-explorer 1.7.41 → 1.8.0

package/CHANGELOG.json

@@ -1,6 +1,61 @@
 {
   "name": "@rushstack/lockfile-explorer",
   "entries": [
+    {
+      "version": "1.8.0",
+      "tag": "@rushstack/lockfile-explorer_v1.8.0",
+      "date": "Tue, 30 Sep 2025 20:33:51 GMT",
+      "comments": {
+        "patch": [
+          {
+            "comment": "Bump \"express\" to 4.21.1 to address reported vulnerabilities in 4.20.0."
+          },
+          {
+            "comment": "Upgraded `js-yaml` dependency"
+          },
+          {
+            "comment": "Improve support for PNPM lockfile format V6.0"
+          },
+          {
+            "comment": "Refactoring to support future work"
+          }
+        ],
+        "minor": [
+          {
+            "comment": "Add syntax highlighter"
+          },
+          {
+            "comment": "Isolate .pnpmcfile.cjs evaluation"
+          }
+        ],
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/node-core-library\" to `5.15.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/terminal\" to `0.17.0`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/ts-command-line\" to `5.0.4`"
+          },
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `0.75.0`"
+          }
+        ]
+      }
+    },
+    {
+      "version": "1.7.42",
+      "tag": "@rushstack/lockfile-explorer_v1.7.42",
+      "date": "Fri, 12 Sep 2025 15:13:07 GMT",
+      "comments": {
+        "dependency": [
+          {
+            "comment": "Updating dependency \"@rushstack/heft\" to `0.74.5`"
+          }
+        ]
+      }
+    },
     {
       "version": "1.7.41",
       "tag": "@rushstack/lockfile-explorer_v1.7.41",

package/CHANGELOG.md

@@ -1,6 +1,26 @@
 # Change Log - @rushstack/lockfile-explorer
 
-This log was last generated on Thu, 11 Sep 2025 00:22:31 GMT and should not be manually modified.
+This log was last generated on Tue, 30 Sep 2025 20:33:51 GMT and should not be manually modified.
+
+## 1.8.0
+Tue, 30 Sep 2025 20:33:51 GMT
+
+### Minor changes
+
+- Add syntax highlighter
+- Isolate .pnpmcfile.cjs evaluation
+
+### Patches
+
+- Bump "express" to 4.21.1 to address reported vulnerabilities in 4.20.0.
+- Upgraded `js-yaml` dependency
+- Improve support for PNPM lockfile format V6.0
+- Refactoring to support future work
+
+## 1.7.42
+Fri, 12 Sep 2025 15:13:07 GMT
+
+_Version update only_
 
 ## 1.7.41
 Thu, 11 Sep 2025 00:22:31 GMT

package/build/lfx-shared/IAppContext.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Describes the `window.appContext` object that the Node.js service uses
+ * to communicate runtime configuration to the web app.
+ *
+ * @remarks
+ * The `dist/index.html` page loads a script `initappcontext.js` to initialize
+ * this object before the web app starts.
+ *
+ * When the app is hosted by Webpack dev server, this is implemented by
+ * `lockfile-explorer-web/src/stub/initappcontext.ts`.
+ *
+ * When the app is hosted by the CLI front end, the `initappcontext.js` content
+ * is generated by an Express route.
+ */
+export interface IAppContext {
+    /**
+     * The service URL, without the trailing slash.
+     *
+     * @example
+     * Example: `http://localhost:8091`
+     */
+    serviceUrl: string;
+    /**
+     * The `package.json` version for the app.
+     */
+    appVersion: string;
+    /**
+     * Whether the CLI was invoked with the `--debug` parameter.
+     */
+    debugMode: boolean;
+}
+//# sourceMappingURL=IAppContext.d.ts.map

package/build/lfx-shared/IAppContext.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IAppContext.js.map

package/build/lfx-shared/IAppContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAppContext.js","sourceRoot":"","sources":["../../../src/packlets/lfx-shared/IAppContext.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * Describes the `window.appContext` object that the Node.js service uses\n * to communicate runtime configuration to the web app.\n *\n * @remarks\n * The `dist/index.html` page loads a script `initappcontext.js` to initialize\n * this object before the web app starts.\n *\n * When the app is hosted by Webpack dev server, this is implemented by\n * `lockfile-explorer-web/src/stub/initappcontext.ts`.\n *\n * When the app is hosted by the CLI front end, the `initappcontext.js` content\n * is generated by an Express route.\n */\nexport interface IAppContext {\n  /**\n   * The service URL, without the trailing slash.\n   *\n   * @example\n   * Example: `http://localhost:8091`\n   */\n  serviceUrl: string;\n\n  /**\n   * The `package.json` version for the app.\n   */\n  appVersion: string;\n\n  /**\n   * Whether the CLI was invoked with the `--debug` parameter.\n   */\n  debugMode: boolean;\n}\n"]}

package/build/lfx-shared/IJsonLfxGraph.d.ts

@@ -0,0 +1,51 @@
+import type { IJsonLfxWorkspace } from './IJsonLfxWorkspace';
+export declare enum LfxGraphEntryKind {
+    Project = 1,
+    Package = 2,
+    SideBySide = 3,
+    Doppelganger = 4
+}
+export interface IJsonPeerDependencyMeta {
+    name?: string;
+    version?: string;
+    optional?: boolean;
+}
+export interface IJsonLfxDependency {
+    name: string;
+    version: string;
+    entryId: string;
+    dependencyType: LfxDependencyKind;
+    resolvedEntryJsonId?: number;
+    peerDependencyMeta: IJsonPeerDependencyMeta;
+}
+export declare enum LfxDependencyKind {
+    Regular = "regular",
+    Dev = "dev",
+    Peer = "peer"
+}
+export interface IJsonLfxEntry {
+    /**
+     * A unique ID used when serializing graph links.
+     *
+     * @remarks
+     * This is just the `IJsonLfxGraph.entries` array index, but debugging is easier if we include
+     * it in the serialized representation.
+     */
+    jsonId: number;
+    kind: LfxGraphEntryKind;
+    entryId: string;
+    rawEntryId: string;
+    packageJsonFolderPath: string;
+    entryPackageName: string;
+    displayText: string;
+    entryPackageVersion: string;
+    entrySuffix: string;
+    dependencies: IJsonLfxDependency[];
+    transitivePeerDependencies: string[];
+    referrerJsonIds: number[];
+}
+export interface IJsonLfxGraph {
+    workspace: IJsonLfxWorkspace;
+    entries: IJsonLfxEntry[];
+}
+//# sourceMappingURL=IJsonLfxGraph.d.ts.map

package/build/lfx-shared/IJsonLfxGraph.js

@@ -0,0 +1,19 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LfxDependencyKind = exports.LfxGraphEntryKind = void 0;
+var LfxGraphEntryKind;
+(function (LfxGraphEntryKind) {
+    LfxGraphEntryKind[LfxGraphEntryKind["Project"] = 1] = "Project";
+    LfxGraphEntryKind[LfxGraphEntryKind["Package"] = 2] = "Package";
+    LfxGraphEntryKind[LfxGraphEntryKind["SideBySide"] = 3] = "SideBySide";
+    LfxGraphEntryKind[LfxGraphEntryKind["Doppelganger"] = 4] = "Doppelganger";
+})(LfxGraphEntryKind || (exports.LfxGraphEntryKind = LfxGraphEntryKind = {}));
+var LfxDependencyKind;
+(function (LfxDependencyKind) {
+    LfxDependencyKind["Regular"] = "regular";
+    LfxDependencyKind["Dev"] = "dev";
+    LfxDependencyKind["Peer"] = "peer";
+})(LfxDependencyKind || (exports.LfxDependencyKind = LfxDependencyKind = {}));
+//# sourceMappingURL=IJsonLfxGraph.js.map

package/build/lfx-shared/IJsonLfxGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJsonLfxGraph.js","sourceRoot":"","sources":["../../../src/packlets/lfx-shared/IJsonLfxGraph.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAI3D,IAAY,iBAKX;AALD,WAAY,iBAAiB;IAC3B,+DAAW,CAAA;IACX,+DAAW,CAAA;IACX,qEAAc,CAAA;IACd,yEAAgB,CAAA;AAClB,CAAC,EALW,iBAAiB,iCAAjB,iBAAiB,QAK5B;AAmBD,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,gCAAW,CAAA;IACX,kCAAa,CAAA;AACf,CAAC,EAJW,iBAAiB,iCAAjB,iBAAiB,QAI5B","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { IJsonLfxWorkspace } from './IJsonLfxWorkspace';\n\nexport enum LfxGraphEntryKind {\n  Project = 1,\n  Package = 2,\n  SideBySide = 3,\n  Doppelganger = 4\n}\n\nexport interface IJsonPeerDependencyMeta {\n  name?: string;\n  version?: string;\n  optional?: boolean;\n}\n\nexport interface IJsonLfxDependency {\n  name: string;\n  version: string;\n  entryId: string;\n  dependencyType: LfxDependencyKind;\n\n  resolvedEntryJsonId?: number;\n\n  peerDependencyMeta: IJsonPeerDependencyMeta;\n}\n\nexport enum LfxDependencyKind {\n  Regular = 'regular',\n  Dev = 'dev',\n  Peer = 'peer'\n}\n\nexport interface IJsonLfxEntry {\n  /**\n   * A unique ID used when serializing graph links.\n   *\n   * @remarks\n   * This is just the `IJsonLfxGraph.entries` array index, but debugging is easier if we include\n   * it in the serialized representation.\n   */\n  jsonId: number;\n\n  kind: LfxGraphEntryKind;\n  entryId: string;\n  rawEntryId: string;\n  packageJsonFolderPath: string;\n  entryPackageName: string;\n  displayText: string;\n  entryPackageVersion: string;\n  entrySuffix: string;\n\n  // Lists\n  dependencies: IJsonLfxDependency[];\n  transitivePeerDependencies: string[];\n  referrerJsonIds: number[];\n}\n\nexport interface IJsonLfxGraph {\n  workspace: IJsonLfxWorkspace;\n  entries: IJsonLfxEntry[];\n}\n"]}

package/build/lfx-shared/IJsonLfxWorkspace.d.ts

@@ -0,0 +1,59 @@
+export interface IJsonLfxWorkspaceRushConfig {
+    /**
+     * The `rushVersion` field from rush.json.
+     */
+    readonly rushVersion: string;
+    /**
+     * If the subspaces feature is enabled and a subspace was loaded, the name of the subspace.
+     * Otherwise this will be an empty string.
+     */
+    readonly subspaceName: string;
+    /**
+     * The path to Rush's input file `.pnpmfile.cjs`, relative to `workspaceRootFullPath`
+     * and normalized to use forward slashes without a leading slash.  In a Rush workspace,
+     * {@link IJsonLfxWorkspace.pnpmfilePath} is a temporary file that is generated from `rushPnpmfilePath`.
+     *
+     * @example `"common/config/my-subspace/pnpm-lock.yaml"`
+     */
+    readonly rushPnpmfilePath: string;
+}
+export interface IJsonLfxWorkspace {
+    /**
+     * Absolute path to the workspace folder that is opened by the app,  normalized to use forward slashes
+     * without a trailing slash.
+     *
+     * @example `"C:/path/to/MyRepo"`
+     */
+    readonly workspaceRootFullPath: string;
+    /**
+     * The path to the "pnpm-lock.yaml" file, relative to `workspaceRootFullPath`
+     * and normalized to use forward slashes without a leading slash.
+     *
+     * @example `"common/temp/my-subspace/pnpm-lock.yaml"`
+     * @example `"pnpm-lock.yaml"`
+     */
+    readonly pnpmLockfilePath: string;
+    /**
+     * The path to the folder of "pnpm-lock.yaml" file, relative to `workspaceRootFullPath`
+     * and normalized to use forward slashes without a leading slash.
+     *
+     * If `pnpm-lack.yaml` is in the `workspaceRootFullPath` folder, then pnpmLockfileFolder
+     * is the empty string.
+     *
+     * @example `"common/temp/my-subspace"`
+     * @example `""`
+     */
+    readonly pnpmLockfileFolder: string;
+    /**
+     * The path to the `.pnpmfile.cjs` file that is loaded by PNPM.  In a Rush workspace,
+     * this is a temporary file that is generated from `rushPnpmfilePath`.
+     *
+     * @example `"common/temp/my-subspace/.pnpmfile.cjs"`
+     */
+    readonly pnpmfilePath: string;
+    /**
+     * This section will be defined only if this is a Rush workspace (versus a plain PNPM workspace).
+     */
+    readonly rushConfig: IJsonLfxWorkspaceRushConfig | undefined;
+}
+//# sourceMappingURL=IJsonLfxWorkspace.d.ts.map

package/build/lfx-shared/IJsonLfxWorkspace.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IJsonLfxWorkspace.js.map

package/build/lfx-shared/IJsonLfxWorkspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IJsonLfxWorkspace.js","sourceRoot":"","sources":["../../../src/packlets/lfx-shared/IJsonLfxWorkspace.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport interface IJsonLfxWorkspaceRushConfig {\n  /**\n   * The `rushVersion` field from rush.json.\n   */\n  readonly rushVersion: string;\n\n  /**\n   * If the subspaces feature is enabled and a subspace was loaded, the name of the subspace.\n   * Otherwise this will be an empty string.\n   */\n  readonly subspaceName: string;\n\n  /**\n   * The path to Rush's input file `.pnpmfile.cjs`, relative to `workspaceRootFullPath`\n   * and normalized to use forward slashes without a leading slash.  In a Rush workspace,\n   * {@link IJsonLfxWorkspace.pnpmfilePath} is a temporary file that is generated from `rushPnpmfilePath`.\n   *\n   * @example `\"common/config/my-subspace/pnpm-lock.yaml\"`\n   */\n  readonly rushPnpmfilePath: string;\n}\n\nexport interface IJsonLfxWorkspace {\n  /**\n   * Absolute path to the workspace folder that is opened by the app,  normalized to use forward slashes\n   * without a trailing slash.\n   *\n   * @example `\"C:/path/to/MyRepo\"`\n   */\n  readonly workspaceRootFullPath: string;\n\n  /**\n   * The path to the \"pnpm-lock.yaml\" file, relative to `workspaceRootFullPath`\n   * and normalized to use forward slashes without a leading slash.\n   *\n   * @example `\"common/temp/my-subspace/pnpm-lock.yaml\"`\n   * @example `\"pnpm-lock.yaml\"`\n   */\n  readonly pnpmLockfilePath: string;\n\n  /**\n   * The path to the folder of \"pnpm-lock.yaml\" file, relative to `workspaceRootFullPath`\n   * and normalized to use forward slashes without a leading slash.\n   *\n   * If `pnpm-lack.yaml` is in the `workspaceRootFullPath` folder, then pnpmLockfileFolder\n   * is the empty string.\n   *\n   * @example `\"common/temp/my-subspace\"`\n   * @example `\"\"`\n   */\n  readonly pnpmLockfileFolder: string;\n\n  /**\n   * The path to the `.pnpmfile.cjs` file that is loaded by PNPM.  In a Rush workspace,\n   * this is a temporary file that is generated from `rushPnpmfilePath`.\n   *\n   * @example `\"common/temp/my-subspace/.pnpmfile.cjs\"`\n   */\n  readonly pnpmfilePath: string;\n\n  /**\n   * This section will be defined only if this is a Rush workspace (versus a plain PNPM workspace).\n   */\n  readonly rushConfig: IJsonLfxWorkspaceRushConfig | undefined;\n}\n"]}

package/build/lfx-shared/LfxGraph.d.ts

@@ -0,0 +1,96 @@
+import type { LfxDependencyKind, IJsonPeerDependencyMeta, LfxGraphEntryKind } from './IJsonLfxGraph';
+import type { IJsonLfxWorkspace } from './IJsonLfxWorkspace';
+export interface ILfxGraphDependencyOptions {
+    name: string;
+    version: string;
+    dependencyType: LfxDependencyKind;
+    containingEntry: LfxGraphEntry;
+    peerDependencyMeta: IJsonPeerDependencyMeta;
+    entryId: string;
+}
+/**
+ * Represents a dependency listed under a LockfileEntry
+ *
+ * @remarks
+ * Each dependency listed under a package in the lockfile should have a separate entry. These Dependencies
+ * will link to the "containingEntry", which is the LockfileEntry that specified this dependency.
+ * The "resolvedEntry" field is the corresponding LockfileEntry for this dependency, as all dependencies also have
+ * their own entries in the pnpm lockfile.
+ */
+export declare class LfxGraphDependency {
+    readonly name: string;
+    readonly version: string;
+    readonly dependencyType: LfxDependencyKind;
+    readonly containingEntry: LfxGraphEntry;
+    readonly entryId: string;
+    readonly peerDependencyMeta: IJsonPeerDependencyMeta;
+    resolvedEntry: LfxGraphEntry | undefined;
+    constructor(options: ILfxGraphDependencyOptions);
+}
+export interface ILfxGraphEntryOptions {
+    kind: LfxGraphEntryKind;
+    entryId: string;
+    rawEntryId: string;
+    packageJsonFolderPath: string;
+    entryPackageName: string;
+    displayText: string;
+    entryPackageVersion: string;
+    entrySuffix: string;
+}
+/**
+ * Represents a project or package listed in the pnpm lockfile.
+ *
+ * @remarks
+ * Each project or package will have its own LockfileEntry, which is created when the lockfile is first parsed.
+ * The fields for the LockfileEntry are outlined below:
+ */
+export declare class LfxGraphEntry {
+    /**
+     * Whether this entry is a project or a package (specified by importers or packages in the lockfile).
+     */
+    readonly kind: LfxGraphEntryKind;
+    /**
+     * A unique (human-readable) identifier for this lockfile entry. For projects, this is just
+     * `Project:` + the package json path for this project.
+     */
+    readonly entryId: string;
+    /**
+     * The unique identifier assigned to this project/package in the lockfile.
+     * e.g. `/@emotion/core/10.3.1_qjwx5m6wssz3lnb35xwkc3pz6q:`
+     */
+    readonly rawEntryId: string;
+    /**
+     * Where the package.json is for this project or package.
+     */
+    readonly packageJsonFolderPath: string;
+    /**
+     * Just the name of the package with no specifiers.
+     */
+    readonly entryPackageName: string;
+    /**
+     * A human friendly name for the project or package.
+     */
+    readonly displayText: string;
+    readonly entryPackageVersion: string;
+    readonly entrySuffix: string;
+    /**
+     * A list of all the dependencies for this entry.
+     * Note that dependencies, dev dependencies, as well as peer dependencies are all included.
+     */
+    readonly dependencies: LfxGraphDependency[];
+    /**
+     * A list of dependencies that are listed under the "transitivePeerDependencies" in the pnpm lockfile.
+     */
+    readonly transitivePeerDependencies: Set<string>;
+    /**
+     * A list of entries that specify this entry as a dependency.
+     */
+    readonly referrers: LfxGraphEntry[];
+    constructor(options: ILfxGraphEntryOptions);
+}
+export declare class LfxGraph {
+    readonly workspace: IJsonLfxWorkspace;
+    readonly entries: LfxGraphEntry[];
+    constructor(workspace: IJsonLfxWorkspace);
+}
+//# sourceMappingURL=LfxGraph.d.ts.map

package/build/lfx-shared/LfxGraph.js

@@ -0,0 +1,67 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LfxGraph = exports.LfxGraphEntry = exports.LfxGraphDependency = void 0;
+/**
+ * Represents a dependency listed under a LockfileEntry
+ *
+ * @remarks
+ * Each dependency listed under a package in the lockfile should have a separate entry. These Dependencies
+ * will link to the "containingEntry", which is the LockfileEntry that specified this dependency.
+ * The "resolvedEntry" field is the corresponding LockfileEntry for this dependency, as all dependencies also have
+ * their own entries in the pnpm lockfile.
+ */
+class LfxGraphDependency {
+    constructor(options) {
+        this.resolvedEntry = undefined;
+        this.name = options.name;
+        this.version = options.version;
+        this.dependencyType = options.dependencyType;
+        this.containingEntry = options.containingEntry;
+        this.entryId = options.entryId;
+        this.peerDependencyMeta = options.peerDependencyMeta;
+    }
+}
+exports.LfxGraphDependency = LfxGraphDependency;
+/**
+ * Represents a project or package listed in the pnpm lockfile.
+ *
+ * @remarks
+ * Each project or package will have its own LockfileEntry, which is created when the lockfile is first parsed.
+ * The fields for the LockfileEntry are outlined below:
+ */
+class LfxGraphEntry {
+    constructor(options) {
+        /**
+         * A list of all the dependencies for this entry.
+         * Note that dependencies, dev dependencies, as well as peer dependencies are all included.
+         */
+        this.dependencies = [];
+        /**
+         * A list of dependencies that are listed under the "transitivePeerDependencies" in the pnpm lockfile.
+         */
+        this.transitivePeerDependencies = new Set();
+        /**
+         * A list of entries that specify this entry as a dependency.
+         */
+        this.referrers = [];
+        this.kind = options.kind;
+        this.entryId = options.entryId;
+        this.rawEntryId = options.rawEntryId;
+        this.packageJsonFolderPath = options.packageJsonFolderPath;
+        this.entryPackageName = options.entryPackageName;
+        this.displayText = options.displayText;
+        this.entryPackageVersion = options.entryPackageVersion;
+        this.entrySuffix = options.entrySuffix;
+    }
+}
+exports.LfxGraphEntry = LfxGraphEntry;
+class LfxGraph {
+    constructor(workspace) {
+        this.entries = [];
+        this.workspace = Object.assign({}, workspace);
+    }
+}
+exports.LfxGraph = LfxGraph;
+//# sourceMappingURL=LfxGraph.js.map

package/build/lfx-shared/LfxGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LfxGraph.js","sourceRoot":"","sources":["../../../src/packlets/lfx-shared/LfxGraph.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;AAc3D;;;;;;;;GAQG;AACH,MAAa,kBAAkB;IAU7B,YAAmB,OAAmC;QAF/C,kBAAa,GAA8B,SAAS,CAAC;QAG1D,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;QAC7C,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IACvD,CAAC;CACF;AAlBD,gDAkBC;AAaD;;;;;;GAMG;AACH,MAAa,aAAa;IAoDxB,YAAmB,OAA8B;QAhBjD;;;WAGG;QACa,iBAAY,GAAyB,EAAE,CAAC;QAExD;;WAEG;QACa,+BAA0B,GAAgB,IAAI,GAAG,EAAE,CAAC;QAEpE;;WAEG;QACa,cAAS,GAAoB,EAAE,CAAC;QAG9C,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;QAC3D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;QACjD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;QACvD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACzC,CAAC;CACF;AA9DD,sCA8DC;AAED,MAAa,QAAQ;IAInB,YAAmB,SAA4B;QAF/B,YAAO,GAAoB,EAAE,CAAC;QAG5C,IAAI,CAAC,SAAS,qBAAQ,SAAS,CAAE,CAAC;IACpC,CAAC;CACF;AAPD,4BAOC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { LfxDependencyKind, IJsonPeerDependencyMeta, LfxGraphEntryKind } from './IJsonLfxGraph';\nimport type { IJsonLfxWorkspace } from './IJsonLfxWorkspace';\n\nexport interface ILfxGraphDependencyOptions {\n  name: string;\n  version: string;\n  dependencyType: LfxDependencyKind;\n  containingEntry: LfxGraphEntry;\n  peerDependencyMeta: IJsonPeerDependencyMeta;\n  entryId: string;\n}\n\n/**\n * Represents a dependency listed under a LockfileEntry\n *\n * @remarks\n * Each dependency listed under a package in the lockfile should have a separate entry. These Dependencies\n * will link to the \"containingEntry\", which is the LockfileEntry that specified this dependency.\n * The \"resolvedEntry\" field is the corresponding LockfileEntry for this dependency, as all dependencies also have\n * their own entries in the pnpm lockfile.\n */\nexport class LfxGraphDependency {\n  public readonly name: string;\n  public readonly version: string;\n  public readonly dependencyType: LfxDependencyKind;\n  public readonly containingEntry: LfxGraphEntry;\n  public readonly entryId: string;\n  public readonly peerDependencyMeta: IJsonPeerDependencyMeta;\n\n  public resolvedEntry: LfxGraphEntry | undefined = undefined;\n\n  public constructor(options: ILfxGraphDependencyOptions) {\n    this.name = options.name;\n    this.version = options.version;\n    this.dependencyType = options.dependencyType;\n    this.containingEntry = options.containingEntry;\n    this.entryId = options.entryId;\n    this.peerDependencyMeta = options.peerDependencyMeta;\n  }\n}\n\nexport interface ILfxGraphEntryOptions {\n  kind: LfxGraphEntryKind;\n  entryId: string;\n  rawEntryId: string;\n  packageJsonFolderPath: string;\n  entryPackageName: string;\n  displayText: string;\n  entryPackageVersion: string;\n  entrySuffix: string;\n}\n\n/**\n * Represents a project or package listed in the pnpm lockfile.\n *\n * @remarks\n * Each project or package will have its own LockfileEntry, which is created when the lockfile is first parsed.\n * The fields for the LockfileEntry are outlined below:\n */\nexport class LfxGraphEntry {\n  /**\n   * Whether this entry is a project or a package (specified by importers or packages in the lockfile).\n   */\n  public readonly kind: LfxGraphEntryKind;\n\n  /**\n   * A unique (human-readable) identifier for this lockfile entry. For projects, this is just\n   * `Project:` + the package json path for this project.\n   */\n  public readonly entryId: string;\n\n  /**\n   * The unique identifier assigned to this project/package in the lockfile.\n   * e.g. `/@emotion/core/10.3.1_qjwx5m6wssz3lnb35xwkc3pz6q:`\n   */\n  public readonly rawEntryId: string;\n\n  /**\n   * Where the package.json is for this project or package.\n   */\n  public readonly packageJsonFolderPath: string;\n\n  /**\n   * Just the name of the package with no specifiers.\n   */\n  public readonly entryPackageName: string;\n\n  /**\n   * A human friendly name for the project or package.\n   */\n  public readonly displayText: string;\n\n  public readonly entryPackageVersion: string;\n  public readonly entrySuffix: string;\n\n  /**\n   * A list of all the dependencies for this entry.\n   * Note that dependencies, dev dependencies, as well as peer dependencies are all included.\n   */\n  public readonly dependencies: LfxGraphDependency[] = [];\n\n  /**\n   * A list of dependencies that are listed under the \"transitivePeerDependencies\" in the pnpm lockfile.\n   */\n  public readonly transitivePeerDependencies: Set<string> = new Set();\n\n  /**\n   * A list of entries that specify this entry as a dependency.\n   */\n  public readonly referrers: LfxGraphEntry[] = [];\n\n  public constructor(options: ILfxGraphEntryOptions) {\n    this.kind = options.kind;\n    this.entryId = options.entryId;\n    this.rawEntryId = options.rawEntryId;\n    this.packageJsonFolderPath = options.packageJsonFolderPath;\n    this.entryPackageName = options.entryPackageName;\n    this.displayText = options.displayText;\n    this.entryPackageVersion = options.entryPackageVersion;\n    this.entrySuffix = options.entrySuffix;\n  }\n}\n\nexport class LfxGraph {\n  public readonly workspace: IJsonLfxWorkspace;\n  public readonly entries: LfxGraphEntry[] = [];\n\n  public constructor(workspace: IJsonLfxWorkspace) {\n    this.workspace = { ...workspace };\n  }\n}\n"]}

package/build/lfx-shared/index.d.ts

@@ -0,0 +1,6 @@
+export * from './IAppContext';
+export * from './IJsonLfxGraph';
+export * from './IJsonLfxWorkspace';
+export * from './LfxGraph';
+export * as lfxGraphSerializer from './lfxGraphSerializer';
+//# sourceMappingURL=index.d.ts.map

package/build/lfx-shared/index.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lfxGraphSerializer = void 0;
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./IAppContext"), exports);
+tslib_1.__exportStar(require("./IJsonLfxGraph"), exports);
+tslib_1.__exportStar(require("./IJsonLfxWorkspace"), exports);
+tslib_1.__exportStar(require("./LfxGraph"), exports);
+exports.lfxGraphSerializer = tslib_1.__importStar(require("./lfxGraphSerializer"));
+//# sourceMappingURL=index.js.map

package/build/lfx-shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/packlets/lfx-shared/index.ts"],"names":[],"mappings":";AAAA,4FAA4F;AAC5F,2DAA2D;;;;AAE3D,wDAA8B;AAC9B,0DAAgC;AAChC,8DAAoC;AACpC,qDAA2B;AAC3B,mFAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nexport * from './IAppContext';\nexport * from './IJsonLfxGraph';\nexport * from './IJsonLfxWorkspace';\nexport * from './LfxGraph';\nexport * as lfxGraphSerializer from './lfxGraphSerializer';\n"]}

package/build/lfx-shared/lfxGraphSerializer.d.ts

@@ -0,0 +1,5 @@
+import type { IJsonLfxGraph } from './IJsonLfxGraph';
+import { LfxGraph } from './LfxGraph';
+export declare function serializeToJson(graph: LfxGraph): IJsonLfxGraph;
+export declare function deserializeFromJson(jsonLfxGraph: IJsonLfxGraph): LfxGraph;
+//# sourceMappingURL=lfxGraphSerializer.d.ts.map

package/build/lfx-shared/lfxGraphSerializer.js

@@ -0,0 +1,121 @@
+"use strict";
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeToJson = serializeToJson;
+exports.deserializeFromJson = deserializeFromJson;
+const LfxGraph_1 = require("./LfxGraph");
+function serializeToJson(graph) {
+    const jsonLfxEntries = [];
+    const jsonIdByEntry = new Map();
+    function toJsonId(entry) {
+        const result = jsonIdByEntry.get(entry);
+        if (result === undefined) {
+            throw new Error('Attempt to serialize disconnected object');
+        }
+        return result;
+    }
+    // First create the jsonId mapping
+    for (const entry of graph.entries) {
+        const nextIndex = jsonLfxEntries.length;
+        const jsonLfxEntry = {
+            jsonId: nextIndex,
+            kind: entry.kind,
+            entryId: entry.entryId,
+            rawEntryId: entry.rawEntryId,
+            packageJsonFolderPath: entry.packageJsonFolderPath,
+            entryPackageName: entry.entryPackageName,
+            displayText: entry.displayText,
+            entryPackageVersion: entry.entryPackageVersion,
+            entrySuffix: entry.entrySuffix,
+            // Lists will be added in the second loop
+            dependencies: [],
+            transitivePeerDependencies: [],
+            referrerJsonIds: []
+        };
+        jsonLfxEntries.push(jsonLfxEntry);
+        jsonIdByEntry.set(entry, jsonLfxEntry.jsonId);
+    }
+    // Use the jsonId mapping to serialize the lists
+    for (let i = 0; i < jsonLfxEntries.length; ++i) {
+        const jsonLfxEntry = jsonLfxEntries[i];
+        const entry = graph.entries[i];
+        for (const dependency of entry.dependencies) {
+            const jsonLfxDependency = {
+                name: dependency.name,
+                version: dependency.version,
+                entryId: dependency.entryId,
+                dependencyType: dependency.dependencyType,
+                peerDependencyMeta: {
+                    name: dependency.peerDependencyMeta.name,
+                    version: dependency.peerDependencyMeta.version,
+                    optional: dependency.peerDependencyMeta.optional
+                }
+            };
+            if (dependency.resolvedEntry) {
+                jsonLfxDependency.resolvedEntryJsonId = toJsonId(dependency.resolvedEntry);
+            }
+            jsonLfxEntry.dependencies.push(jsonLfxDependency);
+        }
+        jsonLfxEntry.transitivePeerDependencies = Array.from(entry.transitivePeerDependencies);
+        jsonLfxEntry.referrerJsonIds = entry.referrers.map((x) => toJsonId(x));
+    }
+    return { workspace: graph.workspace, entries: jsonLfxEntries };
+}
+function deserializeFromJson(jsonLfxGraph) {
+    const graph = new LfxGraph_1.LfxGraph(jsonLfxGraph.workspace);
+    const entries = graph.entries;
+    function fromJsonId(jsonId) {
+        const result = entries[jsonId];
+        if (result === undefined) {
+            throw new Error('Invalid jsonId');
+        }
+        return result;
+    }
+    const jsonLfxEntries = jsonLfxGraph.entries;
+    // First create the jsonId mapping
+    for (const jsonLfxEntry of jsonLfxEntries) {
+        const options = {
+            kind: jsonLfxEntry.kind,
+            entryId: jsonLfxEntry.entryId,
+            rawEntryId: jsonLfxEntry.rawEntryId,
+            packageJsonFolderPath: jsonLfxEntry.packageJsonFolderPath,
+            entryPackageName: jsonLfxEntry.entryPackageName,
+            displayText: jsonLfxEntry.displayText,
+            entryPackageVersion: jsonLfxEntry.entryPackageVersion,
+            entrySuffix: jsonLfxEntry.entrySuffix
+        };
+        entries.push(new LfxGraph_1.LfxGraphEntry(options));
+    }
+    // Use the jsonId mapping to deserialize the lists
+    for (let i = 0; i < jsonLfxEntries.length; ++i) {
+        const jsonLfxEntry = jsonLfxEntries[i];
+        const entry = graph.entries[i];
+        for (const jsonLfxDependency of jsonLfxEntry.dependencies) {
+            const dependency = new LfxGraph_1.LfxGraphDependency({
+                name: jsonLfxDependency.name,
+                version: jsonLfxDependency.version,
+                dependencyType: jsonLfxDependency.dependencyType,
+                containingEntry: entry,
+                entryId: jsonLfxDependency.entryId,
+                peerDependencyMeta: {
+                    name: jsonLfxDependency.peerDependencyMeta.name,
+                    version: jsonLfxDependency.peerDependencyMeta.version,
+                    optional: jsonLfxDependency.peerDependencyMeta.optional
+                }
+            });
+            if (jsonLfxDependency.resolvedEntryJsonId) {
+                dependency.resolvedEntry = fromJsonId(jsonLfxDependency.resolvedEntryJsonId);
+            }
+            entry.dependencies.push(dependency);
+        }
+        for (const item of jsonLfxEntry.transitivePeerDependencies) {
+            entry.transitivePeerDependencies.add(item);
+        }
+        for (const referrerJsonId of jsonLfxEntry.referrerJsonIds) {
+            entry.referrers.push(fromJsonId(referrerJsonId));
+        }
+    }
+    return graph;
+}
+//# sourceMappingURL=lfxGraphSerializer.js.map

package/build/lfx-shared/lfxGraphSerializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lfxGraphSerializer.js","sourceRoot":"","sources":["../../../src/packlets/lfx-shared/lfxGraphSerializer.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { IJsonLfxDependency, IJsonLfxEntry, IJsonLfxGraph } from './IJsonLfxGraph';\nimport { type ILfxGraphEntryOptions, LfxGraph, LfxGraphDependency, LfxGraphEntry } from './LfxGraph';\n\nexport function serializeToJson(graph: LfxGraph): IJsonLfxGraph {\n  const jsonLfxEntries: IJsonLfxEntry[] = [];\n\n  const jsonIdByEntry: Map<LfxGraphEntry, number> = new Map();\n\n  function toJsonId(entry: LfxGraphEntry): number {\n    const result: number | undefined = jsonIdByEntry.get(entry);\n    if (result === undefined) {\n      throw new Error('Attempt to serialize disconnected object');\n    }\n    return result;\n  }\n\n  // First create the jsonId mapping\n  for (const entry of graph.entries) {\n    const nextIndex: number = jsonLfxEntries.length;\n\n    const jsonLfxEntry: IJsonLfxEntry = {\n      jsonId: nextIndex,\n\n      kind: entry.kind,\n      entryId: entry.entryId,\n      rawEntryId: entry.rawEntryId,\n      packageJsonFolderPath: entry.packageJsonFolderPath,\n      entryPackageName: entry.entryPackageName,\n      displayText: entry.displayText,\n      entryPackageVersion: entry.entryPackageVersion,\n      entrySuffix: entry.entrySuffix,\n\n      // Lists will be added in the second loop\n      dependencies: [],\n      transitivePeerDependencies: [],\n      referrerJsonIds: []\n    };\n\n    jsonLfxEntries.push(jsonLfxEntry);\n    jsonIdByEntry.set(entry, jsonLfxEntry.jsonId);\n  }\n\n  // Use the jsonId mapping to serialize the lists\n  for (let i: number = 0; i < jsonLfxEntries.length; ++i) {\n    const jsonLfxEntry: IJsonLfxEntry = jsonLfxEntries[i];\n    const entry: LfxGraphEntry = graph.entries[i];\n\n    for (const dependency of entry.dependencies) {\n      const jsonLfxDependency: IJsonLfxDependency = {\n        name: dependency.name,\n        version: dependency.version,\n        entryId: dependency.entryId,\n        dependencyType: dependency.dependencyType,\n        peerDependencyMeta: {\n          name: dependency.peerDependencyMeta.name,\n          version: dependency.peerDependencyMeta.version,\n          optional: dependency.peerDependencyMeta.optional\n        }\n      };\n      if (dependency.resolvedEntry) {\n        jsonLfxDependency.resolvedEntryJsonId = toJsonId(dependency.resolvedEntry);\n      }\n\n      jsonLfxEntry.dependencies.push(jsonLfxDependency);\n    }\n    jsonLfxEntry.transitivePeerDependencies = Array.from(entry.transitivePeerDependencies);\n    jsonLfxEntry.referrerJsonIds = entry.referrers.map((x) => toJsonId(x));\n  }\n\n  return { workspace: graph.workspace, entries: jsonLfxEntries };\n}\n\nexport function deserializeFromJson(jsonLfxGraph: IJsonLfxGraph): LfxGraph {\n  const graph: LfxGraph = new LfxGraph(jsonLfxGraph.workspace);\n\n  const entries: LfxGraphEntry[] = graph.entries;\n\n  function fromJsonId(jsonId: number): LfxGraphEntry {\n    const result: LfxGraphEntry | undefined = entries[jsonId];\n    if (result === undefined) {\n      throw new Error('Invalid jsonId');\n    }\n    return result;\n  }\n\n  const jsonLfxEntries: IJsonLfxEntry[] = jsonLfxGraph.entries;\n\n  // First create the jsonId mapping\n  for (const jsonLfxEntry of jsonLfxEntries) {\n    const options: ILfxGraphEntryOptions = {\n      kind: jsonLfxEntry.kind,\n      entryId: jsonLfxEntry.entryId,\n      rawEntryId: jsonLfxEntry.rawEntryId,\n      packageJsonFolderPath: jsonLfxEntry.packageJsonFolderPath,\n      entryPackageName: jsonLfxEntry.entryPackageName,\n      displayText: jsonLfxEntry.displayText,\n      entryPackageVersion: jsonLfxEntry.entryPackageVersion,\n      entrySuffix: jsonLfxEntry.entrySuffix\n    };\n    entries.push(new LfxGraphEntry(options));\n  }\n\n  // Use the jsonId mapping to deserialize the lists\n  for (let i: number = 0; i < jsonLfxEntries.length; ++i) {\n    const jsonLfxEntry: IJsonLfxEntry = jsonLfxEntries[i];\n    const entry: LfxGraphEntry = graph.entries[i];\n\n    for (const jsonLfxDependency of jsonLfxEntry.dependencies) {\n      const dependency: LfxGraphDependency = new LfxGraphDependency({\n        name: jsonLfxDependency.name,\n        version: jsonLfxDependency.version,\n        dependencyType: jsonLfxDependency.dependencyType,\n        containingEntry: entry,\n        entryId: jsonLfxDependency.entryId,\n        peerDependencyMeta: {\n          name: jsonLfxDependency.peerDependencyMeta.name,\n          version: jsonLfxDependency.peerDependencyMeta.version,\n          optional: jsonLfxDependency.peerDependencyMeta.optional\n        }\n      });\n\n      if (jsonLfxDependency.resolvedEntryJsonId) {\n        dependency.resolvedEntry = fromJsonId(jsonLfxDependency.resolvedEntryJsonId);\n      }\n\n      entry.dependencies.push(dependency);\n    }\n\n    for (const item of jsonLfxEntry.transitivePeerDependencies) {\n      entry.transitivePeerDependencies.add(item);\n    }\n\n    for (const referrerJsonId of jsonLfxEntry.referrerJsonIds) {\n      entry.referrers.push(fromJsonId(referrerJsonId));\n    }\n  }\n\n  return graph;\n}\n"]}