pm-dedup-core 2.1.0

package/dist/packageFilterArgs.js

@@ -0,0 +1,65 @@
+// `node:util` parseArgs shape, spread into a bin's own options so the four
+// filter flags read the same whatever the package manager.
+export const packageFilterParseArgsOptions = {
+    packages: { type: "string", multiple: true },
+    scopes: { type: "string", multiple: true },
+    exclude: { type: "string", multiple: true },
+    "exclude-scopes": { type: "string", multiple: true },
+};
+// the `--help` block for the flags above, so every tool documents them alike
+export const packageFilterUsage = `  --packages <names>           only these packages, as names or globs
+  --scopes <scopes>            only these scopes
+  --exclude <names>            never these packages
+  --exclude-scopes <scopes>    never these scopes
+
+Every filter flag takes a comma list, or is repeated.`;
+// A repeated flag is how parseArgs collects several values; a comma list is what
+// people type. Both mean the same thing here.
+const toNames = (values) => {
+    if (!values)
+        return undefined;
+    const names = values
+        .flatMap((value) => value.split(","))
+        .map((name) => name.trim())
+        .filter((name) => name !== "");
+    return names.length > 0 ? names : undefined;
+};
+export const toPackageFilterOptions = (values) => ({
+    include: toNames(values.packages),
+    includeScopes: toNames(values.scopes),
+    exclude: toNames(values.exclude),
+    excludeScopes: toNames(values["exclude-scopes"]),
+});
+// the two flags every `why-duplicate` bin takes on top of the filters
+export const whyDuplicateParseArgsOptions = {
+    all: { type: "boolean", short: "a" },
+    details: { type: "boolean", short: "d" },
+    ...packageFilterParseArgsOptions,
+};
+export const whyDuplicateUsage = `  -a, --all                    keep packages that are not duplicated
+  -d, --details                every dependent of every version, not one line each
+
+${packageFilterUsage}`;
+/**
+ * The positional a `why-duplicate` bin takes is the short form of `--packages`.
+ * Naming something to explain is what separates the two reports: without it
+ * there is nothing to be `--all` about, and the whole lockfile is listed.
+ *
+ * Naming one is also asking why it is duplicated, which the one-line form does
+ * not answer — so an explained selection is detailed unless it is a listing.
+ */
+export const toWhyDuplicateRequest = (values, positionals) => {
+    const filter = toPackageFilterOptions(values);
+    const include = [...(filter.include ?? []), ...positionals];
+    const explains = include.length > 0 || filter.includeScopes !== undefined;
+    return {
+        filter: {
+            ...filter,
+            include: include.length > 0 ? include : undefined,
+        },
+        explains,
+        all: values.all ?? false,
+        details: values.details === true || explains,
+    };
+};
+//# sourceMappingURL=packageFilterArgs.js.map

package/dist/packageFilterArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageFilterArgs.js","sourceRoot":"","sources":["../src/packageFilterArgs.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG;IAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC5C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC1C,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;IAC3C,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;CAC5C,CAAC;AAEX,6EAA6E;AAC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;sDAKoB,CAAC;AASvD,iFAAiF;AACjF,8CAA8C;AAC9C,MAAM,OAAO,GAAG,CAAC,MAA4B,EAAwB,EAAE;IACrE,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IAC9B,MAAM,KAAK,GAAG,MAAM;SACjB,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,MAA8B,EACR,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;IACjC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;IAChC,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH,sEAAsE;AACtE,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACpC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACxC,GAAG,6BAA6B;CACxB,CAAC;AAEX,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;EAG/B,kBAAkB,EAAE,CAAC;AAgBvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAA6B,EAC7B,WAAqB,EACA,EAAE;IACvB,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC;IAE1E,OAAO;QACL,MAAM,EAAE;YACN,GAAG,MAAM;YACT,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SAClD;QACD,QAAQ;QACR,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,KAAK;QACxB,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ;KAC7C,CAAC;AACJ,CAAC,CAAC"}

package/dist/packageFilterArgs.test.js

@@ -0,0 +1,93 @@
+import { describe, it } from "bun:test";
+import { deepStrictEqual } from "node:assert/strict";
+import { parseArgs } from "node:util";
+import { toPackageFilterOptions, toWhyDuplicateRequest, whyDuplicateParseArgsOptions, } from "./packageFilterArgs.js";
+const parseFlags = (args) => parseArgs({
+    args,
+    options: { ...whyDuplicateParseArgsOptions },
+    allowPositionals: true,
+});
+const parse = (args) => toPackageFilterOptions(parseFlags(args).values);
+const request = (args) => {
+    const { values, positionals } = parseFlags(args);
+    return toWhyDuplicateRequest(values, positionals);
+};
+describe("toPackageFilterOptions", () => {
+    it("leaves every list undefined when no flag is passed", () => {
+        deepStrictEqual(parse([]), {
+            include: undefined,
+            includeScopes: undefined,
+            exclude: undefined,
+            excludeScopes: undefined,
+        });
+    });
+    it("reads the four flags", () => {
+        deepStrictEqual(parse([
+            "--packages",
+            "lodash",
+            "--scopes",
+            "@babel",
+            "--exclude",
+            "react",
+            "--exclude-scopes",
+            "@types",
+        ]), {
+            include: ["lodash"],
+            includeScopes: ["@babel"],
+            exclude: ["react"],
+            excludeScopes: ["@types"],
+        });
+    });
+    it("reads a repeated flag and a comma list the same way", () => {
+        const repeated = parse(["--packages", "lodash", "--packages", "react"]);
+        const commaSeparated = parse(["--packages", "lodash,react"]);
+        deepStrictEqual(repeated.include, ["lodash", "react"]);
+        deepStrictEqual(commaSeparated.include, ["lodash", "react"]);
+    });
+    it("drops the blanks a trailing comma or a stray space leaves behind", () => {
+        deepStrictEqual(parse(["--packages", " lodash , ,"]).include, ["lodash"]);
+        deepStrictEqual(parse(["--packages", ","]).include, undefined);
+    });
+});
+describe("toWhyDuplicateRequest", () => {
+    it("takes a positional as an included name", () => {
+        deepStrictEqual(request(["lodash"]), {
+            filter: {
+                include: ["lodash"],
+                includeScopes: undefined,
+                exclude: undefined,
+                excludeScopes: undefined,
+            },
+            explains: true,
+            all: false,
+            // naming a package is asking why, which the one-line form does not answer
+            details: true,
+        });
+    });
+    it("merges the positionals with the names the flag carries", () => {
+        deepStrictEqual(request(["--packages", "lodash", "react"]).filter.include, [
+            "lodash",
+            "react",
+        ]);
+    });
+    it("explains a scope with nothing named", () => {
+        const { filter, explains } = request(["--scopes", "@babel"]);
+        deepStrictEqual(filter.include, undefined);
+        deepStrictEqual(filter.includeScopes, ["@babel"]);
+        deepStrictEqual(explains, true);
+    });
+    it("lists the whole lockfile when only exclusions are given", () => {
+        deepStrictEqual(request(["--exclude", "lodash"]).explains, false);
+        deepStrictEqual(request([]).explains, false);
+    });
+    it("leaves a listing on one line per package until --details is asked for", () => {
+        deepStrictEqual(request([]).details, false);
+        deepStrictEqual(request(["--details"]).details, true);
+        deepStrictEqual(request(["-d"]).details, true);
+    });
+    it("reads --all", () => {
+        deepStrictEqual(request(["lodash"]).all, false);
+        deepStrictEqual(request(["lodash", "--all"]).all, true);
+    });
+});
+//# sourceMappingURL=packageFilterArgs.test.js.map

package/dist/packageFilterArgs.test.js.map

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

package/dist/packageStyles.js

@@ -0,0 +1,33 @@
+/**
+ * A package name in two tones: the scope one shade deeper than the name it
+ * prefixes, so the half that identifies stays the readable one without the
+ * other fading out.
+ */
+export const stylePackageName = (color, name, styles = ["packageName"]) => {
+    // 0 when unscoped, since indexOf returns -1
+    const scopeEnd = name.startsWith("@") ? name.indexOf("/") + 1 : 0;
+    if (scopeEnd === 0)
+        return color(styles, name);
+    const scopeStyles = styles.map((style) => style === "packageName" ? "scope" : style);
+    return `${color(scopeStyles, name.slice(0, scopeEnd))}${color(styles, name.slice(scopeEnd))}`;
+};
+// The version part of `name@version`, past the scope's own `@`. Yarn's
+// `lodash@npm:4.17.21` and pnpm's `metro@0.84.5(react@19)` both split here.
+const versionStart = (reference) => {
+    const nameStart = reference.startsWith("@") ? reference.indexOf("/") + 1 : 0;
+    if (nameStart === 0 && reference.startsWith("@"))
+        return -1;
+    return reference.indexOf("@", nameStart);
+};
+/**
+ * A `name@version` reference. Anything without a version is returned untouched:
+ * the reports also list requesters that are not packages at all, such as
+ * `package.json in devDependencies`.
+ */
+export const stylePackageReference = (color, reference) => {
+    const at = versionStart(reference);
+    if (at <= 0)
+        return reference;
+    return `${stylePackageName(color, reference.slice(0, at))}${color("yellow", reference.slice(at))}`;
+};
+//# sourceMappingURL=packageStyles.js.map

package/dist/packageStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageStyles.js","sourceRoot":"","sources":["../src/packageStyles.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAe,EACf,IAAY,EACZ,MAAM,GAAkB,CAAC,aAAa,CAAC,EAC/B,EAAE;IACV,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACvC,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC1C,CAAC;IACF,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;AAChG,CAAC,CAAC;AAEF,uEAAuE;AACvE,4EAA4E;AAC5E,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAU,EAAE;IACjD,MAAM,SAAS,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,OAAO,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAe,EACf,SAAiB,EACT,EAAE;IACV,MAAM,EAAE,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9B,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACrG,CAAC,CAAC"}

package/dist/packageStyles.test.js

@@ -0,0 +1,58 @@
+import { afterEach, describe, it } from "bun:test";
+import { ok, strictEqual } from "node:assert/strict";
+import { stylePackageName, stylePackageReference } from "./packageStyles.js";
+import { createColorize } from "./reportColors.js";
+const environment = { ...process.env };
+afterEach(() => {
+    process.env = { ...environment };
+});
+const colorize = createColorize(true);
+// eslint-disable-next-line no-control-regex
+const escapePattern = /\u001B\[[\d;]+m/gu;
+const plainText = (text) => text.replaceAll(escapePattern, "");
+describe("stylePackageName", () => {
+    it("returns the name untouched when colour is off", () => {
+        strictEqual(stylePackageName(createColorize(false), "@babel/core"), "@babel/core");
+    });
+    it("styles the scope apart from the rest of the name", () => {
+        const styled = stylePackageName(colorize, "@babel/core");
+        strictEqual(plainText(styled), "@babel/core");
+        // the two are not in the same run of escape codes
+        ok(!styled.includes("@babel/core"));
+    });
+    it("renders the scope and the name in two shades of one hue", () => {
+        delete process.env.COLORTERM;
+        const styled = stylePackageName(colorize, "@babel/core");
+        ok(styled.startsWith("\u001B[38;5;166m@babel/"));
+        ok(styled.includes("\u001B[38;5;173mcore"));
+    });
+    it("switches to 24-bit colour when the terminal advertises it", () => {
+        process.env.COLORTERM = "truecolor";
+        ok(stylePackageName(colorize, "metro").startsWith("\u001B[38;2;215;135;95m"));
+    });
+    it("styles an unscoped name in one run", () => {
+        strictEqual(plainText(stylePackageName(colorize, "metro")), "metro");
+    });
+});
+describe("stylePackageReference", () => {
+    it("splits the name from the version", () => {
+        const styled = stylePackageReference(colorize, "metro@0.84.5");
+        strictEqual(plainText(styled), "metro@0.84.5");
+        ok(!styled.includes("metro@"));
+    });
+    it("splits past the scope", () => {
+        const styled = stylePackageReference(colorize, "@babel/core@7.28.0");
+        strictEqual(plainText(styled), "@babel/core@7.28.0");
+        ok(!styled.includes("core@"));
+    });
+    it("keeps a peer suffix with the version", () => {
+        const styled = stylePackageReference(colorize, "metro@0.84.5(react@19)");
+        strictEqual(plainText(styled), "metro@0.84.5(react@19)");
+        ok(!styled.includes("metro@"));
+    });
+    it("leaves a reference carrying no version untouched", () => {
+        strictEqual(stylePackageReference(colorize, "package.json in devDependencies"), "package.json in devDependencies");
+        strictEqual(stylePackageReference(colorize, "@babel/core"), "@babel/core");
+    });
+});
+//# sourceMappingURL=packageStyles.test.js.map

package/dist/packageStyles.test.js.map

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

package/dist/parseBinArgs.js

@@ -0,0 +1,28 @@
+import { parseArgs } from "node:util";
+/**
+ * `parseArgs` with the two things a bin still has to do itself: answer
+ * `--help`, and turn an unknown flag into a readable line instead of a stack
+ * trace. Rejecting the unknown flag matters more than it reads: a mistyped
+ * `--dry-run` silently ignored is a run that applies its changes.
+ *
+ * Returns null when the bin has nothing left to do — the usage was asked for,
+ * or the arguments were rejected and the exit code already says so.
+ */
+export const parseBinArgs = (usage, config) => {
+    const args = config.args ?? process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        console.log(usage);
+        return null;
+    }
+    try {
+        return parseArgs(config);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        console.error();
+        console.error(usage);
+        process.exitCode = 1;
+        return null;
+    }
+};
+//# sourceMappingURL=parseBinArgs.js.map

package/dist/parseBinArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseBinArgs.js","sourceRoot":"","sources":["../src/parseBinArgs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAItC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,KAAa,EACb,MAAS,EAC+B,EAAE;IAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC"}

package/dist/parseBinArgs.test.js

@@ -0,0 +1,62 @@
+import { afterEach, describe, it } from "bun:test";
+import { deepStrictEqual, strictEqual } from "node:assert/strict";
+import { parseBinArgs } from "./parseBinArgs.js";
+const usage = "Usage: tool [options]";
+const originalLog = console.log;
+const originalError = console.error;
+afterEach(() => {
+    console.log = originalLog;
+    console.error = originalError;
+});
+// `process.exitCode` is the test runner's own, so the error path has to hand it
+// back untouched.
+const withCapturedOutput = (run) => {
+    const lines = [];
+    const record = (message = "") => {
+        lines.push(message);
+    };
+    console.log = record;
+    console.error = record;
+    const exitCodeBefore = process.exitCode;
+    try {
+        return { result: run(), output: lines.join("\n") };
+    }
+    finally {
+        if (process.exitCode !== exitCodeBefore) {
+            // bun ignores `process.exitCode = undefined` (node resets it), so the
+            // whole run would end on 1 with every test passing.
+            process.exitCode = exitCodeBefore ?? 0;
+        }
+    }
+};
+describe("parseBinArgs", () => {
+    const parse = (args) => parseBinArgs(usage, {
+        args,
+        options: { check: { type: "boolean" } },
+        allowPositionals: true,
+    });
+    it("parses the arguments it knows", () => {
+        const parsed = parse(["--check", "lodash"]);
+        // `parseArgs` returns a null-prototype `values`, and `deepStrictEqual`
+        // compares prototypes.
+        deepStrictEqual(parsed?.values, { __proto__: null, check: true });
+        deepStrictEqual(parsed?.positionals, ["lodash"]);
+    });
+    it("prints the usage and stops on --help", () => {
+        const { result, output } = withCapturedOutput(() => parse(["--help"]));
+        strictEqual(result, null);
+        strictEqual(output, usage);
+        strictEqual(process.exitCode, undefined);
+    });
+    it("names an unknown flag and fails instead of ignoring it", () => {
+        const { result, output } = withCapturedOutput(() => {
+            const parsed = parse(["--chekc"]);
+            strictEqual(process.exitCode, 1);
+            return parsed;
+        });
+        strictEqual(result, null);
+        strictEqual(output.includes("--chekc"), true);
+        strictEqual(output.includes(usage), true);
+    });
+});
+//# sourceMappingURL=parseBinArgs.test.js.map

package/dist/parseBinArgs.test.js.map

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

package/dist/planClusterApply.js

@@ -0,0 +1,69 @@
+/**
+ * Turn the detector's records into the two edits every package manager
+ * understands:
+ *
+ * - a `workspaceChanges` entry is a range the user declares, so it is edited in
+ *   place in the importer's `package.json`;
+ * - everything else is a transitive edge, which only an override can repoint.
+ *
+ * The overrides are per package name and carry no scoping: a package manager
+ * whose overrides apply unconditionally (bun) has to drop the ones a third-party
+ * range would reject, where one with conditional overrides (pnpm's convergence
+ * overrides) can write them all and let the resolver spare the members
+ * `excludedMembers` lists.
+ *
+ * `reuseFixes` come first: they converge on `anchor`, the version the user
+ * pinned, and a pin outranks a version the detector merely computed.
+ */
+export const planClusterApply = (fixes) => {
+    const manifestEdits = [];
+    const unresolvableChanges = [];
+    const conflicts = [];
+    const overrides = new Map();
+    const addOverride = (packageName, version, reason) => {
+        const existing = overrides.get(packageName);
+        if (existing) {
+            if (existing.version !== version) {
+                conflicts.push({
+                    packageName,
+                    kept: existing.version,
+                    dropped: version,
+                });
+            }
+            return;
+        }
+        overrides.set(packageName, { packageName, version, reason });
+    };
+    for (const fix of fixes) {
+        for (const reuse of fix.reuseFixes) {
+            addOverride(reuse.packageName, reuse.to, "reuse");
+        }
+    }
+    for (const fix of fixes) {
+        if (!fix.applicable || fix.target === null)
+            continue;
+        for (const change of fix.workspaceChanges) {
+            if (!change.workspace) {
+                unresolvableChanges.push(`${change.packageName} in ${change.requester}`);
+                continue;
+            }
+            manifestEdits.push({
+                importerPath: change.workspace.path,
+                depType: change.workspace.depType,
+                packageName: change.packageName,
+                range: change.range,
+                to: change.to,
+            });
+        }
+        for (const member of [...fix.convergentMembers, ...fix.reResolutionSet]) {
+            addOverride(member, fix.target, "converge");
+        }
+    }
+    return {
+        manifestEdits,
+        overrides: [...overrides.values()].toSorted((a, b) => a.packageName.localeCompare(b.packageName)),
+        conflicts,
+        unresolvableChanges,
+    };
+};
+//# sourceMappingURL=planClusterApply.js.map

package/dist/planClusterApply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planClusterApply.js","sourceRoot":"","sources":["../src/planClusterApply.ts"],"names":[],"mappings":"AAwBA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAmB,EAAoB,EAAE;IACxE,MAAM,aAAa,GAA0B,EAAE,CAAC;IAChD,MAAM,mBAAmB,GAAa,EAAE,CAAC;IACzC,MAAM,SAAS,GAAkC,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAErD,MAAM,WAAW,GAAG,CAClB,WAAmB,EACnB,OAAe,EACf,MAAiC,EAC3B,EAAE;QACR,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACjC,SAAS,CAAC,IAAI,CAAC;oBACb,WAAW;oBACX,IAAI,EAAE,QAAQ,CAAC,OAAO;oBACtB,OAAO,EAAE,OAAO;iBACjB,CAAC,CAAC;YACL,CAAC;YACD,OAAO;QACT,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC,CAAC;IAEF,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;YACnC,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;YAAE,SAAS;QAErD,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,gBAAgB,EAAE,CAAC;YAC1C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACtB,mBAAmB,CAAC,IAAI,CACtB,GAAG,MAAM,CAAC,WAAW,OAAO,MAAM,CAAC,SAAS,EAAE,CAC/C,CAAC;gBACF,SAAS;YACX,CAAC;YACD,aAAa,CAAC,IAAI,CAAC;gBACjB,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI;gBACnC,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO;gBACjC,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,EAAE,EAAE,MAAM,CAAC,EAAE;aACd,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,GAAG,CAAC,iBAAiB,EAAE,GAAG,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YACxE,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa;QACb,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACnD,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAC3C;QACD,SAAS;QACT,mBAAmB;KACpB,CAAC;AACJ,CAAC,CAAC"}

package/dist/planClusterApply.test.js

@@ -0,0 +1,152 @@
+import { describe, it } from "bun:test";
+import { deepStrictEqual } from "node:assert/strict";
+import { planClusterApply } from "./planClusterApply.js";
+const fix = (overrides) => ({
+    members: [],
+    duplicatedMembers: [],
+    memberVersions: {},
+    target: null,
+    direction: "none",
+    convergentMembers: [],
+    driverMembers: [],
+    excludedMembers: [],
+    anchor: null,
+    reuseFixes: [],
+    floatingMembers: [],
+    workspaceChanges: [],
+    reResolutionSet: [],
+    externalConstraints: [],
+    needsRoundTrip: false,
+    applicable: false,
+    ...overrides,
+});
+describe("planClusterApply", () => {
+    it("edits the importer the workspace change points at", () => {
+        const plan = planClusterApply([
+            fix({
+                applicable: true,
+                target: "0.87.0",
+                workspaceChanges: [
+                    {
+                        requester: "package.json in devDependencies",
+                        requesterName: undefined,
+                        packageName: "metro",
+                        range: "0.84.5",
+                        to: "0.87.0",
+                        workspace: { path: ".", depType: "devDependencies" },
+                    },
+                ],
+            }),
+        ]);
+        deepStrictEqual(plan.manifestEdits, [
+            {
+                importerPath: ".",
+                depType: "devDependencies",
+                packageName: "metro",
+                range: "0.84.5",
+                to: "0.87.0",
+            },
+        ]);
+        deepStrictEqual(plan.unresolvableChanges, []);
+    });
+    it("reports a workspace change it cannot locate on disk", () => {
+        const plan = planClusterApply([
+            fix({
+                applicable: true,
+                target: "0.87.0",
+                workspaceChanges: [
+                    {
+                        requester: "package.json in devDependencies",
+                        requesterName: undefined,
+                        packageName: "metro",
+                        range: "0.84.5",
+                        to: "0.87.0",
+                    },
+                ],
+            }),
+        ]);
+        deepStrictEqual(plan.manifestEdits, []);
+        deepStrictEqual(plan.unresolvableChanges, [
+            "metro in package.json in devDependencies",
+        ]);
+    });
+    it("overrides the convergent members and the ones to re-resolve", () => {
+        const plan = planClusterApply([
+            fix({
+                applicable: true,
+                target: "8.59.1",
+                convergentMembers: ["@typescript-eslint/types"],
+                reResolutionSet: ["@typescript-eslint/parser"],
+                // spared by construction: a convergence override skips the edges whose
+                // declared range rejects the target
+                excludedMembers: [
+                    { packageName: "@typescript-eslint/utils", blockedBy: [] },
+                ],
+            }),
+        ]);
+        deepStrictEqual(plan.overrides, [
+            {
+                packageName: "@typescript-eslint/parser",
+                version: "8.59.1",
+                reason: "converge",
+            },
+            {
+                packageName: "@typescript-eslint/types",
+                version: "8.59.1",
+                reason: "converge",
+            },
+        ]);
+    });
+    it("lets the anchored reuse win over a computed target", () => {
+        const plan = planClusterApply([
+            fix({
+                applicable: true,
+                target: "0.87.0",
+                convergentMembers: ["mini-metro-config"],
+                anchor: "0.84.5",
+                reuseFixes: [
+                    {
+                        requester: "mini-plugin@1.0.0",
+                        requesterName: "mini-plugin",
+                        packageName: "mini-metro-config",
+                        range: "*",
+                        from: "0.87.0",
+                        to: "0.84.5",
+                    },
+                ],
+            }),
+        ]);
+        deepStrictEqual(plan.overrides, [
+            {
+                packageName: "mini-metro-config",
+                version: "0.84.5",
+                reason: "reuse",
+            },
+        ]);
+        deepStrictEqual(plan.conflicts, [
+            { packageName: "mini-metro-config", kept: "0.84.5", dropped: "0.87.0" },
+        ]);
+    });
+    it("ignores a cluster with no applicable fix but keeps its reuse fixes", () => {
+        const plan = planClusterApply([
+            fix({
+                applicable: false,
+                convergentMembers: ["ignored"],
+                reuseFixes: [
+                    {
+                        requester: "plugin@1",
+                        requesterName: "plugin",
+                        packageName: "leaf",
+                        range: "*",
+                        from: "2.0.0",
+                        to: "1.0.0",
+                    },
+                ],
+            }),
+        ]);
+        deepStrictEqual(plan.overrides, [
+            { packageName: "leaf", version: "1.0.0", reason: "reuse" },
+        ]);
+    });
+});
+//# sourceMappingURL=planClusterApply.test.js.map

package/dist/planClusterApply.test.js.map

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