pm-dedup-core 2.1.0

package/dist/definitions/packageFilterArgs.d.ts

@@ -0,0 +1,74 @@
+import type { PackageFilterOptions } from "./createPackageFilter.ts";
+export declare const packageFilterParseArgsOptions: {
+    readonly packages: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly scopes: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly exclude: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly "exclude-scopes": {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+};
+export declare const packageFilterUsage = "  --packages <names>           only these packages, as names or globs\n  --scopes <scopes>            only these scopes\n  --exclude <names>            never these packages\n  --exclude-scopes <scopes>    never these scopes\n\nEvery filter flag takes a comma list, or is repeated.";
+export interface PackageFilterArgValues {
+    packages?: string[];
+    scopes?: string[];
+    exclude?: string[];
+    "exclude-scopes"?: string[];
+}
+export declare const toPackageFilterOptions: (values: PackageFilterArgValues) => PackageFilterOptions;
+export declare const whyDuplicateParseArgsOptions: {
+    readonly packages: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly scopes: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly exclude: {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly "exclude-scopes": {
+        readonly type: "string";
+        readonly multiple: true;
+    };
+    readonly all: {
+        readonly type: "boolean";
+        readonly short: "a";
+    };
+    readonly details: {
+        readonly type: "boolean";
+        readonly short: "d";
+    };
+};
+export declare const whyDuplicateUsage = "  -a, --all                    keep packages that are not duplicated\n  -d, --details                every dependent of every version, not one line each\n\n  --packages <names>           only these packages, as names or globs\n  --scopes <scopes>            only these scopes\n  --exclude <names>            never these packages\n  --exclude-scopes <scopes>    never these scopes\n\nEvery filter flag takes a comma list, or is repeated.";
+export interface WhyDuplicateArgValues extends PackageFilterArgValues {
+    all?: boolean;
+    details?: boolean;
+}
+export interface WhyDuplicateRequest {
+    filter: PackageFilterOptions;
+    explains: boolean;
+    all: boolean;
+    details: boolean;
+}
+/**
+ * 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 declare const toWhyDuplicateRequest: (values: WhyDuplicateArgValues, positionals: string[]) => WhyDuplicateRequest;
+//# sourceMappingURL=packageFilterArgs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageFilterArgs.d.ts","sourceRoot":"","sources":["../../src/packageFilterArgs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAIrE,eAAO,MAAM,6BAA6B;aACxC,QAAQ;iBAAI,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;aACpC,MAAM;iBAAI,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;aAClC,OAAO;iBAAI,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;aACnC,gBAAgB;iBAAI,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;CACpC,CAAC;AAGX,eAAO,MAAM,kBAAkB,6RAKuB,CAAC;AAEvD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAaD,eAAO,MAAM,sBAAsB,WACzB,sBAAsB,KAC7B,oBAKD,CAAC;AAGH,eAAO,MAAM,4BAA4B;;iBA1C3B,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;;iBAC1B,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;;iBACvB,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;;iBACf,IAAI,EAAE,QAAQ;iBAAE,QAAQ;;;iBAwCrC,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;;;iBACvB,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;;CAE9B,CAAC;AAEX,eAAO,MAAM,iBAAiB,ybAGR,CAAC;AAEvB,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;IACnE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,oBAAoB,CAAC;IAE7B,QAAQ,EAAE,OAAO,CAAC;IAClB,GAAG,EAAE,OAAO,CAAC;IAEb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,WACxB,qBAAqB,eAChB,MAAM,EAAE,KACpB,mBAcF,CAAC"}

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

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

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

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

package/dist/definitions/packageStyles.d.ts

@@ -0,0 +1,14 @@
+import type { Colorize, ReportStyle } from "./reportColors.ts";
+/**
+ * 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 declare const stylePackageName: (color: Colorize, name: string, styles?: ReportStyle[]) => string;
+/**
+ * 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 declare const stylePackageReference: (color: Colorize, reference: string) => string;
+//# sourceMappingURL=packageStyles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageStyles.d.ts","sourceRoot":"","sources":["../../src/packageStyles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE/D;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UACpB,QAAQ,QACT,MAAM,WACJ,WAAW,EAAE,KACpB,MAQF,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UACzB,QAAQ,aACJ,MAAM,KAChB,MAIF,CAAC"}

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

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

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

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

package/dist/definitions/parseBinArgs.d.ts

@@ -0,0 +1,14 @@
+import { parseArgs } from "node:util";
+type ParseArgsConfig = NonNullable<Parameters<typeof parseArgs>[0]>;
+/**
+ * `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 declare const parseBinArgs: <T extends ParseArgsConfig>(usage: string, config: T) => ReturnType<typeof parseArgs<T>> | null;
+export {};
+//# sourceMappingURL=parseBinArgs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseBinArgs.d.ts","sourceRoot":"","sources":["../../src/parseBinArgs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,KAAK,eAAe,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,eAAe,SAC7C,MAAM,UACL,CAAC,KACR,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAgBpC,CAAC"}

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

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

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

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

package/dist/definitions/planClusterApply.d.ts

@@ -0,0 +1,39 @@
+import type { ClusterFix } from "./identifyLockstepClusterFixes.ts";
+import type { WorkspaceRangeEdit } from "./workspaceManifest.ts";
+export interface PlannedManifestEdit extends WorkspaceRangeEdit {
+    importerPath: string;
+}
+export interface PlannedOverride {
+    packageName: string;
+    version: string;
+    reason: "converge" | "reuse";
+}
+export interface ClusterApplyPlan {
+    manifestEdits: PlannedManifestEdit[];
+    overrides: PlannedOverride[];
+    conflicts: {
+        packageName: string;
+        kept: string;
+        dropped: string;
+    }[];
+    unresolvableChanges: string[];
+}
+/**
+ * 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 declare const planClusterApply: (fixes: ClusterFix[]) => ClusterApplyPlan;
+//# sourceMappingURL=planClusterApply.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"planClusterApply.d.ts","sourceRoot":"","sources":["../../src/planClusterApply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAEjE,MAAM,WAAW,mBAAoB,SAAQ,kBAAkB;IAC7D,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,mBAAmB,EAAE,CAAC;IACrC,SAAS,EAAE,eAAe,EAAE,CAAC;IAG7B,SAAS,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAEpE,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,UAAW,UAAU,EAAE,KAAG,gBA+DtD,CAAC"}

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

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

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

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

package/dist/definitions/renderApplyPlan.d.ts

@@ -0,0 +1,22 @@
+export interface ApplyPlanFileChange {
+    path: string;
+    transient?: string;
+    changes: string[];
+}
+export interface ApplyPlanOptions {
+    fileChanges: ApplyPlanFileChange[];
+    skipped?: string[];
+    packageManagerResiduals?: string;
+    dedupeCommand: string;
+    color?: boolean;
+    log?: (message?: string) => void;
+}
+export interface ApplyPlanSummary {
+    changeCount: number;
+}
+/**
+ * The plan a dedupe run would apply, shared by `--check` and `--dry-run`. The
+ * returned `changeCount` is what `--check` gates its exit code on.
+ */
+export declare const renderApplyPlan: ({ fileChanges, skipped, packageManagerResiduals, dedupeCommand, color: colorEnabled, log, }: ApplyPlanOptions) => ApplyPlanSummary;
+//# sourceMappingURL=renderApplyPlan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderApplyPlan.d.ts","sourceRoot":"","sources":["../../src/renderApplyPlan.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAElC,IAAI,EAAE,MAAM,CAAC;IAEb,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,mBAAmB,EAAE,CAAC;IAEnC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,gGAOzB,gBAAgB,KAAG,gBAuDrB,CAAC"}

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

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

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

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

package/dist/definitions/renderDedupeSummary.d.ts

@@ -0,0 +1,22 @@
+import type { DedupedPackage } from "./versionsSnapshot.ts";
+export interface DedupeSummaryOptions {
+    deduped: DedupedPackage[];
+    remainingDuplicates: number;
+    whyCommand: string;
+    color?: boolean;
+    log?: (message?: string) => void;
+}
+/**
+ * What a dedupe run actually collapsed, one line per package. Shared by every
+ * tool so the three of them report a run the same way; the caller still says
+ * what it wrote, which only it knows.
+ *
+ * Both sides are counted and named: `2 versions (1.2.1, 1.3.0) -> 1 version
+ * (1.2.1)` is the copy that went away, where a bare `1.3.0 -> 1.2.1` reads as a
+ * downgrade the tool decided on its own.
+ *
+ * Nothing is printed when nothing was deduped: the caller has its own wording
+ * for that, and an empty table reads as a failure it may not be.
+ */
+export declare const renderDedupeSummary: ({ deduped, remainingDuplicates, whyCommand, color: colorEnabled, log, }: DedupeSummaryOptions) => void;
+//# sourceMappingURL=renderDedupeSummary.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderDedupeSummary.d.ts","sourceRoot":"","sources":["../../src/renderDedupeSummary.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAG1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAeD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,4EAM7B,oBAAoB,KAAG,IA8BzB,CAAC"}

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

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

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

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

package/dist/definitions/renderDuplicatesReport.d.ts

@@ -0,0 +1,39 @@
+import type { ClusterFix } from "./identifyLockstepClusterFixes.ts";
+export interface DuplicateResolutionView {
+    resolution: string;
+    version?: string;
+    installations: string[];
+}
+export interface DuplicateDependentView {
+    requester: string;
+    range: string;
+    resolvedVersion?: string;
+    resolvedResolution?: string;
+    peer?: boolean;
+}
+export interface DuplicateDedupeView {
+    from: string[];
+    to: string;
+    direction?: ClusterFix["direction"];
+}
+export interface DuplicatePackageView {
+    packageName: string;
+    resolutions: DuplicateResolutionView[];
+    dependents: DuplicateDependentView[];
+    dedupe: DuplicateDedupeView[];
+}
+export type DuplicatesReportTitle = "duplicates" | "matches";
+export interface DuplicatesReportOptions {
+    title: DuplicatesReportTitle;
+    packages: DuplicatePackageView[];
+    notice?: string;
+    totalDependencies: number;
+    clusterFixes?: ClusterFix[];
+    dedupeCommand: string;
+    whyCommand?: string;
+    details?: boolean;
+    color?: boolean;
+    log?: (message?: string) => void;
+}
+export declare const renderDuplicatesReport: ({ title, packages, notice, totalDependencies, clusterFixes, dedupeCommand, whyCommand, details, color: colorEnabled, log, }: DuplicatesReportOptions) => void;
+//# sourceMappingURL=renderDuplicatesReport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderDuplicatesReport.d.ts","sourceRoot":"","sources":["../../src/renderDuplicatesReport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,UAAU,EACX,MAAM,mCAAmC,CAAC;AAM3C,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IAInB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IAKd,eAAe,CAAC,EAAE,MAAM,CAAC;IAIzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAK5B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IAGX,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,UAAU,EAAE,sBAAsB,EAAE,CAAC;IACrC,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAID,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IAGjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AA8dD,eAAO,MAAM,sBAAsB,gIAWhC,uBAAuB,KAAG,IA+E5B,CAAC"}

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

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

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

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

package/dist/definitions/reportColors.d.ts

@@ -0,0 +1,25 @@
+declare const palette: {
+    readonly scope: {
+        readonly hex: "#d75f00";
+        readonly ansi256: 166;
+    };
+    readonly packageName: {
+        readonly hex: "#d7875f";
+        readonly ansi256: 173;
+    };
+};
+export type PaletteStyle = keyof typeof palette;
+export type ReportStyle = PaletteStyle | "bold" | "cyan" | "dim" | "green" | "red" | "yellow";
+export type Colorize = (styles: ReportStyle | ReportStyle[], text: string) => string;
+/**
+ * `styleText`'s own stream detection always looks at `process.stdout`, and bun
+ * has emitted escape codes regardless of it in the past. The bins run under
+ * both runtimes and also report on stderr, so the decision is taken here and
+ * `styleText` is called with `validateStream: false`.
+ */
+export declare const shouldColorize: (stream?: {
+    isTTY?: boolean;
+}) => boolean;
+export declare const createColorize: (enabled: boolean) => Colorize;
+export {};
+//# sourceMappingURL=reportColors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reportColors.d.ts","sourceRoot":"","sources":["../../src/reportColors.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,OAAO;aACX,KAAK;iBAAI,GAAG,EAAE,SAAS;iBAAE,OAAO,EAAE,GAAG;;aACrC,WAAW;iBAAI,GAAG,EAAE,SAAS;iBAAE,OAAO,EAAE,GAAG;;CACnC,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,OAAO,CAAC;AAEhD,MAAM,MAAM,WAAW,GACnB,YAAY,GACZ,MAAM,GACN,MAAM,GACN,KAAK,GACL,OAAO,GACP,KAAK,GACL,QAAQ,CAAC;AAEb,MAAM,MAAM,QAAQ,GAAG,CACrB,MAAM,EAAE,WAAW,GAAG,WAAW,EAAE,EACnC,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,cAAc,YACjB;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KAC1B,OAQF,CAAC;AAkCF,eAAO,MAAM,cAAc,YAAa,OAAO,KAAG,QACxB,CAAC"}

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

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

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

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

package/dist/definitions/reportText.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The wording every report shares. Kept in one place so `why-duplicate` and the
+ * summary of a dedupe run cannot drift on how they count versions: both mean
+ * "this many remain", never "this many were merged".
+ */
+export declare const plural: (count: number, singular: string, pluralForm: string) => string;
+/**
+ * How wide a left column may get before it starts pushing what follows off the
+ * right of the screen. A value longer than the budget keeps its own line width
+ * — the column is sized on the longest one that fits, so the outlier overflows
+ * alone instead of clamping the column below what every other row needs.
+ */
+export declare const maxColumnWidth = 44;
+export declare const maxItemsListed = 5;
+export declare const columnWidth: (values: string[], budget?: number) => number;
+export declare const padTo: (width: number, value: string) => string;
+interface ListTextOptions {
+    items: string[];
+    render?: (item: string) => string;
+    limit?: number;
+    more: (rest: number) => string;
+}
+/**
+ * `a, b, c, +2 more` — the tail counted rather than dropped, so a truncated
+ * list never reads as a complete one.
+ */
+export declare const listText: ({ items, render, limit, more, }: ListTextOptions) => string;
+export {};
+//# sourceMappingURL=reportText.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reportText.d.ts","sourceRoot":"","sources":["../../src/reportText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,MAAM,UACV,MAAM,YACH,MAAM,cACJ,MAAM,KACjB,MAA2D,CAAC;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAGjC,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,eAAO,MAAM,WAAW,WACd,MAAM,EAAE,WACR,MAAM,KACb,MAIA,CAAC;AAGJ,eAAO,MAAM,KAAK,UAAW,MAAM,SAAS,MAAM,KAAG,MACN,CAAC;AAEhD,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,oCAKlB,eAAe,KAAG,MAKpB,CAAC"}

package/dist/definitions/selectExplainedPackages.d.ts

@@ -0,0 +1,22 @@
+import type { PackageFilter } from "./createPackageFilter.ts";
+import type { DuplicatesReportTitle } from "./renderDuplicatesReport.ts";
+export interface SelectExplainedPackagesOptions<Resolutions extends readonly unknown[]> {
+    packagesMap: Record<string, Resolutions>;
+    filter: PackageFilter;
+    all: boolean;
+}
+export interface ExplainedPackagesSelection<Resolutions extends readonly unknown[]> {
+    packages: Record<string, Resolutions>;
+    title: DuplicatesReportTitle;
+    notice: string | undefined;
+}
+/**
+ * The packages a `why-duplicate` run reports on. Naming a package is asking why
+ * it is duplicated, and the honest answer to "it is not" is its dependents, not
+ * an empty report: a selection holding no duplicate is kept whole, and the
+ * notice says why it is being shown.
+ *
+ * `--all` asks for that unconditionally, so it never needs the fallback.
+ */
+export declare const selectExplainedPackages: <Resolutions extends readonly unknown[]>({ packagesMap, filter, all, }: SelectExplainedPackagesOptions<Resolutions>) => ExplainedPackagesSelection<Resolutions>;
+//# sourceMappingURL=selectExplainedPackages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectExplainedPackages.d.ts","sourceRoot":"","sources":["../../src/selectExplainedPackages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGzE,MAAM,WAAW,8BAA8B,CAC7C,WAAW,SAAS,SAAS,OAAO,EAAE;IAGtC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACzC,MAAM,EAAE,aAAa,CAAC;IAEtB,GAAG,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B,CACzC,WAAW,SAAS,SAAS,OAAO,EAAE;IAEtC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACtC,KAAK,EAAE,qBAAqB,CAAC;IAG7B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAYD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,GAClC,WAAW,SAAS,SAAS,OAAO,EAAE,iCAKrC,8BAA8B,CAAC,WAAW,CAAC,KAAG,0BAA0B,CAAC,WAAW,CA8BtF,CAAC"}

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

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

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

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

package/dist/definitions/unconditionalOverrides.d.ts

@@ -0,0 +1,24 @@
+import type { ClusterExternalConstraint, ClusterFix } from "./identifyLockstepClusterFixes.ts";
+import type { PlannedOverride } from "./planClusterApply.ts";
+export interface RejectedOverride {
+    override: PlannedOverride;
+    rejectedBy: ClusterExternalConstraint[];
+}
+export interface PartitionedOverrides {
+    safe: PlannedOverride[];
+    rejected: RejectedOverride[];
+}
+/**
+ * Split the planned overrides for a package manager whose overrides apply to
+ * every requester of the package, whatever range it declares (bun's
+ * `overrides`, pnpm's plain ones). Such an override cannot spare the dependents
+ * a conditional one would — pnpm's convergence overrides only repoint the edges
+ * that accept the version — so one a third-party range rejects would force that
+ * dependent onto a version it never allowed.
+ *
+ * The `converge` overrides are safe by construction: the detector only converges
+ * a member no third-party range holds elsewhere. A `reuse` override is derived
+ * from a single requester's range, and another requester can still reject it.
+ */
+export declare const partitionUnconditionalOverrides: (fixes: ClusterFix[], overrides: PlannedOverride[]) => PartitionedOverrides;
+//# sourceMappingURL=unconditionalOverrides.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unconditionalOverrides.d.ts","sourceRoot":"","sources":["../../src/unconditionalOverrides.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,UAAU,EACX,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,yBAAyB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AASD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,+BAA+B,UACnC,UAAU,EAAE,aACR,eAAe,EAAE,KAC3B,oBAoBF,CAAC"}

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

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

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

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

package/dist/definitions/versionsSnapshot.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Every version a package resolves to in a lockfile, by package name.
+ *
+ * The duplicate snapshot only carries the resolutions of packages that have
+ * several, so it cannot name the version a merge landed on: once a package is
+ * deduplicated it leaves the snapshot altogether. Saying what a run deduped
+ * needs the whole picture, before and after.
+ */
+export type VersionsSnapshot = Map<string, string[]>;
+/**
+ * The shape every package manager's parsed package already has. `version` is
+ * only there for npm resolutions — a `git:` or `file:` copy is identified by its
+ * resolution instead, which is unique per install just the same.
+ */
+export interface SnapshotPackage {
+    type: string;
+    name: string;
+    resolution: string;
+    version?: string;
+}
+export declare const buildVersionsSnapshot: (packages: Iterable<SnapshotPackage>) => VersionsSnapshot;
+export interface DedupedPackage {
+    packageName: string;
+    before: string[];
+    after: string[];
+}
+/**
+ * What the two snapshots say a run collapsed, one entry per package: both sides
+ * whole, so a family converging on an older release reads as the two copies
+ * becoming one rather than as a downgrade.
+ *
+ * Only a package resolved fewer times than before is reported. A version that
+ * moved without a copy going away is a re-resolution, not a dedupe — the pass
+ * that made the edit already said so — and a package that left the lockfile
+ * entirely is neither: the in-memory rewrite drops the private subtrees of the
+ * versions it replaced, entries the next install resolves again.
+ */
+export declare const diffVersionsSnapshots: (before: VersionsSnapshot, after: VersionsSnapshot) => DedupedPackage[];
+export declare const countDuplicatedPackages: (snapshot: VersionsSnapshot) => number;
+//# sourceMappingURL=versionsSnapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"versionsSnapshot.d.ts","sourceRoot":"","sources":["../../src/versionsSnapshot.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAYD,eAAO,MAAM,qBAAqB,aACtB,QAAQ,CAAC,eAAe,CAAC,KAClC,gBAgBF,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,WACxB,gBAAgB,SACjB,gBAAgB,KACtB,cAAc,EAYhB,CAAC;AAGF,eAAO,MAAM,uBAAuB,aAAc,gBAAgB,KAAG,MACI,CAAC"}

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

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

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

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

package/dist/definitions/workspaceManifest.d.ts

@@ -0,0 +1,21 @@
+export interface WorkspaceRangeEdit {
+    packageName: string;
+    depType: string;
+    range: string;
+    to: string;
+}
+/**
+ * Keep the user's range style when it still expresses the same intent: a caret
+ * or tilde range moved to the target line stays a caret or tilde range. Any
+ * other shape (`*`, `0.83 - 0.86`, `>=1`) has no target-line equivalent, so the
+ * exact version is the only faithful rewrite.
+ */
+export declare const nextSelector: (range: string, to: string) => string;
+/**
+ * Rewrite one declared range in a workspace `package.json`, as a targeted edit
+ * on the raw text: reserializing would reformat a file the tool does not own.
+ * Returns `undefined` when the declaration is not there any more, which is the
+ * caller's signal that the lockfile it read from is stale.
+ */
+export declare const applyWorkspaceRangeEdit: (content: string, edit: WorkspaceRangeEdit) => string | undefined;
+//# sourceMappingURL=workspaceManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspaceManifest.d.ts","sourceRoot":"","sources":["../../src/workspaceManifest.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IAEjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAEhB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,UAAW,MAAM,MAAM,MAAM,KAAG,MAKxD,CAAC;AAqCF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,YACzB,MAAM,QACT,kBAAkB,KACvB,MAAM,GAAG,SA8BX,CAAC"}

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

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

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

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

package/dist/duplicateSnapshot.js

@@ -0,0 +1,10 @@
+export const diffDuplicates = (before, after) => {
+    const removed = [...before].filter((resolution) => !after.has(resolution));
+    const added = [...after].filter((resolution) => !before.has(resolution));
+    return {
+        removed: removed.toSorted((a, b) => a.localeCompare(b)),
+        added: added.toSorted((a, b) => a.localeCompare(b)),
+        improved: added.length === 0 && removed.length > 0,
+    };
+};
+//# sourceMappingURL=duplicateSnapshot.js.map

package/dist/duplicateSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicateSnapshot.js","sourceRoot":"","sources":["../src/duplicateSnapshot.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAAyB,EACzB,KAAwB,EACT,EAAE;IACjB,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAEzE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACvD,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACnD,QAAQ,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;KACnD,CAAC;AACJ,CAAC,CAAC"}

package/dist/fileSnapshot.js

@@ -0,0 +1,21 @@
+import { readFileSync, rmSync, writeFileSync } from "node:fs";
+const readIfExists = (path) => {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+};
+export const captureFiles = (paths) => paths.map((path) => ({ path, content: readIfExists(path) }));
+export const restoreFiles = (snapshots) => {
+    for (const { path, content } of snapshots) {
+        if (content === undefined) {
+            rmSync(path, { force: true });
+        }
+        else {
+            writeFileSync(path, content);
+        }
+    }
+};
+//# sourceMappingURL=fileSnapshot.js.map

package/dist/fileSnapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileSnapshot.js","sourceRoot":"","sources":["../src/fileSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAQ9D,MAAM,YAAY,GAAG,CAAC,IAAY,EAAsB,EAAE;IACxD,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAe,EAAkB,EAAE,CAC9D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAyB,EAAQ,EAAE;IAC9D,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;QAC1C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;AACH,CAAC,CAAC"}