pm-dedup-core 2.1.0

package/dist/createPackageFilter.test.js

@@ -0,0 +1,115 @@
+import { describe, it } from "bun:test";
+import { deepStrictEqual, strictEqual } from "node:assert/strict";
+import { createPackageFilter, describeSkippedClusterFix, selectClusterFixes, } from "./createPackageFilter.js";
+const clusterFix = (members) => ({
+    members,
+    duplicatedMembers: members,
+    memberVersions: {},
+    target: null,
+    direction: "none",
+    convergentMembers: [],
+    driverMembers: [],
+    excludedMembers: [],
+    anchor: null,
+    reuseFixes: [],
+    floatingMembers: [],
+    workspaceChanges: [],
+    reResolutionSet: [],
+    externalConstraints: [],
+    needsRoundTrip: false,
+    applicable: true,
+});
+describe("createPackageFilter", () => {
+    it("selects everything when nothing is asked for", () => {
+        const filter = createPackageFilter();
+        strictEqual(filter.selectsEverything, true);
+        strictEqual(filter.selects("lodash"), true);
+        strictEqual(filter.selects("@babel/core"), true);
+        strictEqual(filter.rejectionReason("lodash"), undefined);
+    });
+    it("keeps only the included names", () => {
+        const filter = createPackageFilter({ include: ["lodash", "@babel/core"] });
+        strictEqual(filter.selectsEverything, false);
+        strictEqual(filter.selects("lodash"), true);
+        strictEqual(filter.selects("@babel/core"), true);
+        strictEqual(filter.selects("react"), false);
+        strictEqual(filter.rejectionReason("react"), "not selected");
+    });
+    it("drops the excluded names and keeps the rest", () => {
+        const filter = createPackageFilter({ exclude: ["lodash"] });
+        strictEqual(filter.selects("react"), true);
+        strictEqual(filter.selects("lodash"), false);
+        strictEqual(filter.rejectionReason("lodash"), "excluded");
+    });
+    it("lets an exclusion hold back part of an included scope", () => {
+        const filter = createPackageFilter({
+            includeScopes: ["@babel"],
+            exclude: ["@babel/runtime"],
+        });
+        strictEqual(filter.selects("@babel/core"), true);
+        strictEqual(filter.selects("@babel/runtime"), false);
+        strictEqual(filter.rejectionReason("@babel/runtime"), "excluded");
+    });
+    it("reads a scope with or without its leading @", () => {
+        const withAt = createPackageFilter({ includeScopes: ["@babel"] });
+        const withoutAt = createPackageFilter({ includeScopes: ["babel"] });
+        for (const filter of [withAt, withoutAt]) {
+            strictEqual(filter.selects("@babel/core"), true);
+            strictEqual(filter.selects("@babel/plugin-transform-runtime"), true);
+            strictEqual(filter.selects("babel-jest"), false);
+            strictEqual(filter.selects("@babel-other/core"), false);
+        }
+    });
+    it("excludes a whole scope", () => {
+        const filter = createPackageFilter({ excludeScopes: ["@types"] });
+        strictEqual(filter.selects("@types/node"), false);
+        strictEqual(filter.selects("typescript"), true);
+    });
+    it("matches a name holding glob-adjacent characters literally", () => {
+        const filter = createPackageFilter({
+            include: ["lodash.merge", "@scope/a-b_c"],
+        });
+        strictEqual(filter.selects("lodash.merge"), true);
+        strictEqual(filter.selects("@scope/a-b_c"), true);
+        strictEqual(filter.selects("lodashXmerge"), false);
+    });
+    it("stops a single star at the scope separator", () => {
+        const filter = createPackageFilter({ include: ["@babel/*"] });
+        strictEqual(filter.selects("@babel/core"), true);
+        strictEqual(filter.selects("babel"), false);
+        const everyUnscoped = createPackageFilter({ include: ["*"] });
+        strictEqual(everyUnscoped.selects("lodash"), true);
+        strictEqual(everyUnscoped.selects("@babel/core"), false);
+    });
+});
+describe("selectClusterFixes", () => {
+    it("passes every fix through when the filter selects everything", () => {
+        const fixes = [clusterFix(["@babel/core", "@babel/types"])];
+        deepStrictEqual(selectClusterFixes(fixes, createPackageFilter()), {
+            selected: fixes,
+            skipped: [],
+        });
+    });
+    it("keeps a fix whose whole family is selected", () => {
+        const fix = clusterFix(["@babel/core", "@babel/types"]);
+        const { selected, skipped } = selectClusterFixes([fix], createPackageFilter({ includeScopes: ["@babel"] }));
+        deepStrictEqual(selected, [fix]);
+        deepStrictEqual(skipped, []);
+    });
+    it("skips a partly selected family and names what blocked it", () => {
+        const fix = clusterFix(["@babel/core", "@babel/types"]);
+        const { selected, skipped } = selectClusterFixes([fix], createPackageFilter({ include: ["@babel/types"] }));
+        deepStrictEqual(selected, []);
+        deepStrictEqual(skipped, [{ fix, blockedBy: ["@babel/core"] }]);
+    });
+});
+describe("describeSkippedClusterFix", () => {
+    it("names the family and counts the blockers past the first few", () => {
+        const members = ["a", "b", "c", "d", "e"];
+        strictEqual(describeSkippedClusterFix({
+            fix: clusterFix(members),
+            blockedBy: members,
+        }), "cluster a (+4 more): a, b, c (+2 more) not selected by the filter, and a family only converges as a whole");
+    });
+});
+//# sourceMappingURL=createPackageFilter.test.js.map

package/dist/createPackageFilter.test.js.map

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

package/dist/definitions/buildIdentifiedFixesMap.d.ts

@@ -0,0 +1,4 @@
+import { type ResolutionDependent, type ResolutionDependentsMap, type ResolutionEntry, type ResolutionFix } from "./identifyResolutionFixes.ts";
+export type ResolutionsMap = Record<string, ResolutionEntry[]>;
+export declare const buildIdentifiedFixesMap: <D extends ResolutionDependent>(duplicatesResolutionsMap: ResolutionsMap, dependents: ResolutionDependentsMap<D>) => Map<string, ResolutionFix[]>;
+//# sourceMappingURL=buildIdentifiedFixesMap.d.ts.map

package/dist/definitions/buildIdentifiedFixesMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildIdentifiedFixesMap.d.ts","sourceRoot":"","sources":["../../src/buildIdentifiedFixesMap.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,aAAa,EAEnB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;AAE/D,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,mBAAmB,4BACzC,cAAc,cAC5B,uBAAuB,CAAC,CAAC,CAAC,KACrC,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAQ3B,CAAC"}

package/dist/definitions/buildLockstepClusters.d.ts

@@ -0,0 +1,8 @@
+export interface LockstepResolution {
+    version: string;
+    isNpm: boolean;
+    dependencies: Record<string, string>;
+}
+export type LockstepGraph = Record<string, LockstepResolution[]>;
+export declare const buildLockstepClusters: (graph: LockstepGraph) => string[][];
+//# sourceMappingURL=buildLockstepClusters.d.ts.map

package/dist/definitions/buildLockstepClusters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildLockstepClusters.d.ts","sourceRoot":"","sources":["../../src/buildLockstepClusters.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAID,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAsFjE,eAAO,MAAM,qBAAqB,UAAW,aAAa,KAAG,MAAM,EAAE,EAsDpE,CAAC"}

package/dist/definitions/buildLockstepClusters.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=buildLockstepClusters.test.d.ts.map

package/dist/definitions/buildLockstepClusters.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildLockstepClusters.test.d.ts","sourceRoot":"","sources":["../../src/buildLockstepClusters.test.ts"],"names":[],"mappings":""}

package/dist/definitions/clusterLabel.d.ts

@@ -0,0 +1,8 @@
+/**
+ * A readable identity for a lockstep cluster, derived from the prefixes its
+ * members share: `@typescript-eslint/* (+1 more)`, `metro* + @react-native/*`.
+ * A second group is only worth naming when it covers more than one member;
+ * anything left over is counted, never guessed at.
+ */
+export declare const clusterLabel: (members: string[]) => string;
+//# sourceMappingURL=clusterLabel.d.ts.map

package/dist/definitions/clusterLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterLabel.d.ts","sourceRoot":"","sources":["../../src/clusterLabel.ts"],"names":[],"mappings":"AAoDA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,YAAa,MAAM,EAAE,KAAG,MAgBhD,CAAC"}

package/dist/definitions/clusterLabel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clusterLabel.test.d.ts.map

package/dist/definitions/clusterLabel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clusterLabel.test.d.ts","sourceRoot":"","sources":["../../src/clusterLabel.test.ts"],"names":[],"mappings":""}

package/dist/definitions/compareCandidateVersions.d.ts

@@ -0,0 +1,10 @@
+export interface CandidateVersionComparatorOptions {
+    satisfiedCountOf?: (version: string) => number;
+}
+/**
+ * A version satisfying every dependent holds the maximal count, so it always
+ * sorts first: "the highest version that satisfies everyone" falls out of this
+ * ordering instead of needing a pass of its own.
+ */
+export declare const createCandidateVersionComparator: ({ satisfiedCountOf }?: CandidateVersionComparatorOptions) => (versionA: string, versionB: string) => number;
+//# sourceMappingURL=compareCandidateVersions.d.ts.map

package/dist/definitions/compareCandidateVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareCandidateVersions.d.ts","sourceRoot":"","sources":["../../src/compareCandidateVersions.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iCAAiC;IAEhD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,0BACpB,iCAAiC,gBAC7C,MAAM,YAAY,MAAM,KAAG,MAQrC,CAAC"}

package/dist/definitions/compareCandidateVersions.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=compareCandidateVersions.test.d.ts.map

package/dist/definitions/compareCandidateVersions.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareCandidateVersions.test.d.ts","sourceRoot":"","sources":["../../src/compareCandidateVersions.test.ts"],"names":[],"mappings":""}

package/dist/definitions/createPackageFilter.d.ts

@@ -0,0 +1,45 @@
+import type { ClusterFix } from "./identifyLockstepClusterFixes.ts";
+export interface PackageFilterOptions {
+    include?: string[];
+    exclude?: string[];
+    includeScopes?: string[];
+    excludeScopes?: string[];
+}
+export interface PackageFilter {
+    selectsEverything: boolean;
+    selects: (packageName: string) => boolean;
+    rejectionReason: (packageName: string) => string | undefined;
+}
+/**
+ * Selects the packages a dedupe run is allowed to touch. Deduplicating a large
+ * lockfile in one pass produces a diff no one reviews, so every tool exposes
+ * this as the way to work through it a family at a time.
+ *
+ * A package is selected when the include list is empty or one of its patterns
+ * matches, and no exclude pattern matches — exclusion always wins, so a scope
+ * can be selected with a few of its packages held back.
+ *
+ * Patterns are globs with path semantics (`*` stops at `/`), the same as the
+ * `why-duplicate` filters: `@babel/*` matches `@babel/core`, a bare `*` does
+ * not. npm names carry no glob metacharacter, so a plain name is still an
+ * exact match.
+ */
+export declare const createPackageFilter: ({ include, exclude, includeScopes, excludeScopes, }?: PackageFilterOptions) => PackageFilter;
+export declare const selectPackages: <T>(packages: Record<string, T>, filter: PackageFilter) => Record<string, T>;
+export interface SkippedClusterFix {
+    fix: ClusterFix;
+    blockedBy: string[];
+}
+export interface SelectedClusterFixes {
+    selected: ClusterFix[];
+    skipped: SkippedClusterFix[];
+}
+/**
+ * A cluster fix moves its whole family in lockstep, so it is kept only when
+ * every member is selected: applying it for part of a family would move the
+ * rest anyway, past the filter the user set. Select a family with a scope, or
+ * by naming all of its members.
+ */
+export declare const selectClusterFixes: (fixes: ClusterFix[], filter: PackageFilter) => SelectedClusterFixes;
+export declare const describeSkippedClusterFix: ({ fix, blockedBy, }: SkippedClusterFix) => string;
+//# sourceMappingURL=createPackageFilter.d.ts.map

package/dist/definitions/createPackageFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPackageFilter.d.ts","sourceRoot":"","sources":["../../src/createPackageFilter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,WAAW,oBAAoB;IAEnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAG5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAE1C,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9D;AAeD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,yDAK7B,oBAAoB,KAAQ,aAoB9B,CAAC;AAIF,eAAO,MAAM,cAAc,GAAI,CAAC,YACpB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UACnB,aAAa,KACpB,MAAM,CAAC,MAAM,EAAE,CAAC,CAOZ,CAAC;AAER,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,UAAU,CAAC;IAEhB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,UACtB,UAAU,EAAE,UACX,aAAa,KACpB,oBAgBF,CAAC;AAOF,eAAO,MAAM,yBAAyB,wBAGnC,iBAAiB,KAAG,MAKtB,CAAC"}

package/dist/definitions/createPackageFilter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createPackageFilter.test.d.ts.map

package/dist/definitions/createPackageFilter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPackageFilter.test.d.ts","sourceRoot":"","sources":["../../src/createPackageFilter.test.ts"],"names":[],"mappings":""}

package/dist/definitions/duplicateSnapshot.d.ts

@@ -0,0 +1,8 @@
+export type DuplicateSnapshot = Set<string>;
+export interface DuplicateDiff {
+    removed: string[];
+    added: string[];
+    improved: boolean;
+}
+export declare const diffDuplicates: (before: DuplicateSnapshot, after: DuplicateSnapshot) => DuplicateDiff;
+//# sourceMappingURL=duplicateSnapshot.d.ts.map

package/dist/definitions/duplicateSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateSnapshot.d.ts","sourceRoot":"","sources":["../../src/duplicateSnapshot.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,cAAc,WACjB,iBAAiB,SAClB,iBAAiB,KACvB,aASF,CAAC"}

package/dist/definitions/fileSnapshot.d.ts

@@ -0,0 +1,7 @@
+export interface FileSnapshot {
+    path: string;
+    content: string | undefined;
+}
+export declare const captureFiles: (paths: string[]) => FileSnapshot[];
+export declare const restoreFiles: (snapshots: FileSnapshot[]) => void;
+//# sourceMappingURL=fileSnapshot.d.ts.map

package/dist/definitions/fileSnapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSnapshot.d.ts","sourceRoot":"","sources":["../../src/fileSnapshot.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAUD,eAAO,MAAM,YAAY,UAAW,MAAM,EAAE,KAAG,YAAY,EACG,CAAC;AAE/D,eAAO,MAAM,YAAY,cAAe,YAAY,EAAE,KAAG,IAQxD,CAAC"}

package/dist/definitions/findProjectRoot.d.ts

@@ -0,0 +1,27 @@
+export interface ProjectRootOptions {
+    lockfileName: string;
+    cwd?: string;
+}
+/**
+ * The nearest directory holding the lockfile, starting at `cwd` and walking up
+ * to the filesystem root; null when there is none.
+ *
+ * Nearest wins, which is the rule every package manager applies: a nested
+ * project carrying its own lockfile keeps resolving to itself rather than to the
+ * workspace above it.
+ */
+export declare const findProjectRoot: ({ lockfileName, cwd, }: ProjectRootOptions) => string | null;
+/**
+ * `findProjectRoot` for a bin: the project root the run operates on, whatever
+ * subdirectory it was invoked from.
+ *
+ * Returns null when there is no project to work on — as `parseBinArgs` does, the
+ * reason is printed and the exit code already says so, leaving the caller
+ * nothing to do but return.
+ *
+ * The notice goes to stderr, and only when the root is not `cwd` — a run from
+ * the root prints exactly what it always did, and a redirected report stays
+ * parseable.
+ */
+export declare const resolveProjectDir: ({ lockfileName, cwd, }: ProjectRootOptions) => string | null;
+//# sourceMappingURL=findProjectRoot.d.ts.map

package/dist/definitions/findProjectRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findProjectRoot.d.ts","sourceRoot":"","sources":["../../src/findProjectRoot.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,2BAGzB,kBAAkB,KAAG,MAAM,GAAG,IAQhC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,2BAG3B,kBAAkB,KAAG,MAAM,GAAG,IAehC,CAAC"}

package/dist/definitions/findProjectRoot.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=findProjectRoot.test.d.ts.map

package/dist/definitions/findProjectRoot.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findProjectRoot.test.d.ts","sourceRoot":"","sources":["../../src/findProjectRoot.test.ts"],"names":[],"mappings":""}

package/dist/definitions/identifyLockstepClusterFixes.d.ts

@@ -0,0 +1,89 @@
+export interface ClusterWorkspaceRef {
+    path: string;
+    depType: string;
+}
+export interface ClusterExternalConstraint {
+    requester: string;
+    requesterName: string | undefined;
+    packageName: string;
+    range: string;
+    isAlias?: boolean;
+    resolvedVersion?: string;
+    workspace?: ClusterWorkspaceRef;
+}
+export interface ClusterWorkspaceChange extends ClusterExternalConstraint {
+    to: string;
+}
+export interface ClusterExcludedMember {
+    packageName: string;
+    blockedBy: ClusterExternalConstraint[];
+}
+export interface ClusterMember {
+    npmVersions: string[];
+    resolutionCount: number;
+}
+export type ClusterMembersMap = Record<string, ClusterMember>;
+export interface ClusterDependent {
+    requester: string;
+    requesterName: string | undefined;
+    range: string;
+    isAlias?: boolean;
+    workspace?: ClusterWorkspaceRef;
+    resolvedVersion?: string;
+    nonSemver?: boolean;
+}
+export type ClusterDependentsMap = Map<string, ClusterDependent[]>;
+export interface ClusterReuseFix {
+    requester: string;
+    requesterName: string;
+    packageName: string;
+    range: string;
+    from: string;
+    to: string;
+}
+export interface ClusterMemberVersions {
+    versions: string[];
+    nonNpmCount: number;
+}
+export interface ClusterFix {
+    members: string[];
+    duplicatedMembers: string[];
+    memberVersions: Record<string, ClusterMemberVersions>;
+    target: string | null;
+    direction: "down" | "none" | "same" | "up";
+    convergentMembers: string[];
+    driverMembers: string[];
+    excludedMembers: ClusterExcludedMember[];
+    anchor: string | null;
+    reuseFixes: ClusterReuseFix[];
+    floatingMembers: string[];
+    workspaceChanges: ClusterWorkspaceChange[];
+    reResolutionSet: string[];
+    externalConstraints: ClusterExternalConstraint[];
+    needsRoundTrip: boolean;
+    applicable: boolean;
+}
+/**
+ * Compute dedupe opportunities for lockstep clusters (see
+ * `buildLockstepClusters`) that a per-package pass cannot: a family of
+ * co-versioned packages whose duplicate is kept alive only because a few
+ * externally-requested members resolve high. The fix converges the family onto
+ * a single version; fetching absent manifests and cascading the internal pins
+ * is left to the package manager, surfaced here as `reResolutionSet` /
+ * `needsRoundTrip`.
+ *
+ * Two kinds of external constraint are treated differently:
+ * - a third-party requester's range is immutable, so a member it rejects the
+ *   target for is excluded from the convergence instead of sinking the whole
+ *   cluster (clusters routinely span several publishers, and one unfixable
+ *   member should not hide the rest);
+ * - a workspace pin belongs to the user, so it is reported as a
+ *   `workspaceChanges` edit rather than a blocker.
+ *
+ * Ranges in `dependents` must be the ranges the requesters declare. A package
+ * manager that only stores resolved versions in its lockfile has to recover
+ * them (pnpm reads the installed manifests) or the constraints read as exact
+ * pins and no target is found.
+ */
+export declare const identifyLockstepClusterFixes: (clusters: string[][], members: ClusterMembersMap, dependents: ClusterDependentsMap) => ClusterFix[];
+//# sourceMappingURL=identifyLockstepClusterFixes.d.ts.map

package/dist/definitions/identifyLockstepClusterFixes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifyLockstepClusterFixes.d.ts","sourceRoot":"","sources":["../../src/identifyLockstepClusterFixes.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IAExC,SAAS,EAAE,MAAM,CAAC;IAElB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,mBAAmB,CAAC;CACjC;AAGD,MAAM,WAAW,sBAAuB,SAAQ,yBAAyB;IACvE,EAAE,EAAE,MAAM,CAAC;CACZ;AAID,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,yBAAyB,EAAE,CAAC;CACxC;AAGD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAMnE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAKD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAE5B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAEtD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE3C,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAI5B,aAAa,EAAE,MAAM,EAAE,CAAC;IAGxB,eAAe,EAAE,qBAAqB,EAAE,CAAC;IAGzC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB,UAAU,EAAE,eAAe,EAAE,CAAC;IAG9B,eAAe,EAAE,MAAM,EAAE,CAAC;IAI1B,gBAAgB,EAAE,sBAAsB,EAAE,CAAC;IAG3C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB,EAAE,yBAAyB,EAAE,CAAC;IAEjD,cAAc,EAAE,OAAO,CAAC;IAGxB,UAAU,EAAE,OAAO,CAAC;CACrB;AAmDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,4BAA4B,aAC7B,MAAM,EAAE,EAAE,WACX,iBAAiB,cACd,oBAAoB,KAC/B,UAAU,EAmZZ,CAAC"}

package/dist/definitions/identifyLockstepClusterFixes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identifyLockstepClusterFixes.test.d.ts.map

package/dist/definitions/identifyLockstepClusterFixes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifyLockstepClusterFixes.test.d.ts","sourceRoot":"","sources":["../../src/identifyLockstepClusterFixes.test.ts"],"names":[],"mappings":""}

package/dist/definitions/identifyResolutionFixes.d.ts

@@ -0,0 +1,28 @@
+export interface ResolutionPackage {
+    type: string;
+    name: string;
+}
+export interface NpmResolutionPackage extends ResolutionPackage {
+    type: "npm";
+    version: string;
+}
+export interface ResolutionEntry<P extends ResolutionPackage = ResolutionPackage> {
+    resolution: string;
+    package: P;
+}
+export interface ResolutionDependent {
+    version: string;
+    nonSemver?: boolean;
+}
+export type ResolutionDependentsMap<D extends ResolutionDependent = ResolutionDependent> = Map<string, D[]>;
+export interface ResolutionFix {
+    mergeableResolutions: string[];
+    to: string;
+}
+/**
+ * Dedupe opportunities reachable one package at a time. A family of co-versioned
+ * packages whose duplicate survives only because a few members resolve high is
+ * invisible here and is handled by `identifyLockstepClusterFixes`.
+ */
+export declare const identifyResolutionFixes: <D extends ResolutionDependent>(resolutions: ResolutionEntry[], dependents: ResolutionDependentsMap<D>) => ResolutionFix[];
+//# sourceMappingURL=identifyResolutionFixes.d.ts.map

package/dist/definitions/identifyResolutionFixes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifyResolutionFixes.d.ts","sourceRoot":"","sources":["../../src/identifyResolutionFixes.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe,CAC9B,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAE/C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAElC,OAAO,EAAE,MAAM,CAAC;IAKhB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,uBAAuB,CACjC,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,IACjD,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAC;CACZ;AAOD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAAI,CAAC,SAAS,mBAAmB,eACtD,eAAe,EAAE,cAClB,uBAAuB,CAAC,CAAC,CAAC,KACrC,aAAa,EAkIf,CAAC"}

package/dist/definitions/identifyResolutionFixes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identifyResolutionFixes.test.d.ts.map

package/dist/definitions/identifyResolutionFixes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifyResolutionFixes.test.d.ts","sourceRoot":"","sources":["../../src/identifyResolutionFixes.test.ts"],"names":[],"mappings":""}

package/dist/definitions/index.d.ts

@@ -0,0 +1,44 @@
+export { PackageDescriptorNameUtils, PackageDependencyDescriptorUtils, isNpmProtocol, isSemverComparable, } from "./packageDependenciesUtils.ts";
+export type { PackageDescriptorName, PackageDependencyDescriptor, } from "./packageDependenciesUtils.ts";
+export { buildLockstepClusters } from "./buildLockstepClusters.ts";
+export type { LockstepGraph, LockstepResolution, } from "./buildLockstepClusters.ts";
+export { identifyLockstepClusterFixes } from "./identifyLockstepClusterFixes.ts";
+export type { ClusterDependent, ClusterDependentsMap, ClusterExcludedMember, ClusterExternalConstraint, ClusterFix, ClusterMember, ClusterMemberVersions, ClusterMembersMap, ClusterReuseFix, ClusterWorkspaceChange, ClusterWorkspaceRef, } from "./identifyLockstepClusterFixes.ts";
+export { identifyResolutionFixes } from "./identifyResolutionFixes.ts";
+export type { NpmResolutionPackage, ResolutionDependent, ResolutionDependentsMap, ResolutionEntry, ResolutionFix, ResolutionPackage, } from "./identifyResolutionFixes.ts";
+export { buildIdentifiedFixesMap } from "./buildIdentifiedFixesMap.ts";
+export type { ResolutionsMap } from "./buildIdentifiedFixesMap.ts";
+export { createPackageFilter, describeSkippedClusterFix, selectClusterFixes, selectPackages, } from "./createPackageFilter.ts";
+export type { PackageFilter, PackageFilterOptions, SelectedClusterFixes, SkippedClusterFix, } from "./createPackageFilter.ts";
+export { packageFilterParseArgsOptions, packageFilterUsage, toPackageFilterOptions, toWhyDuplicateRequest, whyDuplicateParseArgsOptions, whyDuplicateUsage, } from "./packageFilterArgs.ts";
+export type { PackageFilterArgValues, WhyDuplicateArgValues, WhyDuplicateRequest, } from "./packageFilterArgs.ts";
+export { parseBinArgs } from "./parseBinArgs.ts";
+export { findProjectRoot, resolveProjectDir } from "./findProjectRoot.ts";
+export type { ProjectRootOptions } from "./findProjectRoot.ts";
+export { createCandidateVersionComparator } from "./compareCandidateVersions.ts";
+export type { CandidateVersionComparatorOptions } from "./compareCandidateVersions.ts";
+export { clusterLabel } from "./clusterLabel.ts";
+export { createColorize, shouldColorize } from "./reportColors.ts";
+export type { Colorize, PaletteStyle, ReportStyle } from "./reportColors.ts";
+export { stylePackageName, stylePackageReference } from "./packageStyles.ts";
+export { renderDuplicatesReport } from "./renderDuplicatesReport.ts";
+export type { DuplicateDedupeView, DuplicateDependentView, DuplicatePackageView, DuplicateResolutionView, DuplicatesReportOptions, DuplicatesReportTitle, } from "./renderDuplicatesReport.ts";
+export { selectExplainedPackages } from "./selectExplainedPackages.ts";
+export type { ExplainedPackagesSelection, SelectExplainedPackagesOptions, } from "./selectExplainedPackages.ts";
+export { renderApplyPlan } from "./renderApplyPlan.ts";
+export type { ApplyPlanFileChange, ApplyPlanOptions, ApplyPlanSummary, } from "./renderApplyPlan.ts";
+export { renderDedupeSummary } from "./renderDedupeSummary.ts";
+export type { DedupeSummaryOptions } from "./renderDedupeSummary.ts";
+export { buildVersionsSnapshot, countDuplicatedPackages, diffVersionsSnapshots, } from "./versionsSnapshot.ts";
+export type { DedupedPackage, SnapshotPackage, VersionsSnapshot, } from "./versionsSnapshot.ts";
+export { captureFiles, restoreFiles } from "./fileSnapshot.ts";
+export type { FileSnapshot } from "./fileSnapshot.ts";
+export { applyWorkspaceRangeEdit, nextSelector } from "./workspaceManifest.ts";
+export type { WorkspaceRangeEdit } from "./workspaceManifest.ts";
+export { planClusterApply } from "./planClusterApply.ts";
+export type { ClusterApplyPlan, PlannedManifestEdit, PlannedOverride, } from "./planClusterApply.ts";
+export { diffDuplicates } from "./duplicateSnapshot.ts";
+export type { DuplicateDiff, DuplicateSnapshot } from "./duplicateSnapshot.ts";
+export { partitionUnconditionalOverrides } from "./unconditionalOverrides.ts";
+export type { PartitionedOverrides, RejectedOverride, } from "./unconditionalOverrides.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/definitions/index.d.ts.map

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

package/dist/definitions/packageDependenciesUtils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Combination of an optional scope and name.
+ *
+ * eg `@npm/types`
+ */
+export interface PackageDescriptorName {
+    scope?: string;
+    name: string;
+}
+interface DescriptorUtils<Descriptor> {
+    parse: (value: string) => Descriptor;
+    stringify: (descriptor: Descriptor) => string;
+}
+export declare const PackageDescriptorNameUtils: DescriptorUtils<PackageDescriptorName>;
+export interface PackageDependencyDescriptor<Protocol extends string = string> {
+    key: string;
+    npmName: string;
+    nameDescriptor: PackageDescriptorName;
+    /** `undefined` when the value is declared bare (`^1.0.0`), which means npm */
+    protocol: Protocol | undefined;
+    /** the npm name comes from the value (`npm:other@^1`), not from the key */
+    isAlias: boolean;
+    /** protocol removed: `^1.0.0` for `npm:^1.0.0`, `*` for `workspace:*` */
+    selector: string;
+}
+export declare const PackageDependencyDescriptorUtils: {
+    make: <Protocol extends string>(descriptor: PackageDependencyDescriptor<Protocol>, selector: string) => PackageDependencyDescriptor<Protocol>;
+    /**
+     * The `Protocol` union declares what a given lockfile can contain; `parse`
+     * does not enforce it. An unknown protocol has to parse, because
+     * `manifestKeyOf` reads every sibling declaration in a dependency block to
+     * find the one it edits — throwing on a neighbour would abort an unrelated
+     * rewrite. It still lands in `protocol` rather than being folded into the
+     * selector, so `isNpmProtocol` keeps it out of the npm comparisons.
+     */
+    parse: <Protocol extends string = string>(dependencyKey: string, dependencyValue: string) => PackageDependencyDescriptor<Protocol>;
+    stringify: ({ key, npmName, protocol, isAlias, selector, }: PackageDependencyDescriptor) => [key: string, value: string];
+};
+export declare const isNpmProtocol: (protocol: string | undefined) => boolean;
+/**
+ * The guard to use before handing a selector to semver. A protocol check alone
+ * is not enough: shorthand declarations carry no prefix at all (`user/repo`,
+ * `./local`, `git@host:o/r.git`) and would otherwise read as npm ranges.
+ */
+export declare const isSemverComparable: (descriptor: PackageDependencyDescriptor) => boolean;
+export {};
+//# sourceMappingURL=packageDependenciesUtils.d.ts.map

package/dist/definitions/packageDependenciesUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageDependenciesUtils.d.ts","sourceRoot":"","sources":["../../src/packageDependenciesUtils.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,eAAe,CAAC,UAAU;IAClC,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,UAAU,CAAC;IACrC,SAAS,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,MAAM,CAAC;CAC/C;AAED,eAAO,MAAM,0BAA0B,EAAE,eAAe,CAAC,qBAAqB,CAmB3E,CAAC;AAEJ,MAAM,WAAW,2BAA2B,CAAC,QAAQ,SAAS,MAAM,GAAG,MAAM;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,qBAAqB,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC/B,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+CD,eAAO,MAAM,gCAAgC;IAC3C,IAAI,GAAG,QAAQ,SAAS,MAAM,cAChB,2BAA2B,CAAC,QAAQ,CAAC,YACvC,MAAM,KACf,2BAA2B,CAAC,QAAQ,CAAC;IAExC;;;;;;;OAOG;IACH,KAAK,GAAG,QAAQ,SAAS,MAAM,GAAG,MAAM,iBACvB,MAAM,mBACJ,MAAM,KACtB,2BAA2B,CAAC,QAAQ,CAAC;IAexC,SAAS,mDAMN,2BAA2B,KAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;CAQ9D,CAAC;AAEF,eAAO,MAAM,aAAa,aAAc,MAAM,GAAG,SAAS,KAAG,OACf,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,eACjB,2BAA2B,KACtC,OAE8C,CAAC"}

package/dist/definitions/packageDependenciesUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=packageDependenciesUtils.test.d.ts.map

package/dist/definitions/packageDependenciesUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageDependenciesUtils.test.d.ts","sourceRoot":"","sources":["../../src/packageDependenciesUtils.test.ts"],"names":[],"mappings":""}