@warlock.js/core 5.30.0 → 5.32.0

package/esm/upgrade/diff.mjs

@@ -0,0 +1,119 @@
+//#region ../../packages/core/src/upgrade/diff.ts
+/**
+* A minimal unified diff (`diff -u` shape, 3 lines of context) between two
+* versions of one file, enough for `warlock upgrade --dry-run` to show what
+* it would change. Line-based longest common subsequence; files too large for
+* that are shown as one replaced hunk.
+*/
+const CONTEXT = 3;
+const MAX_CELLS = 16e6;
+function unifiedDiff(file, before, after) {
+	if (before === after) return "";
+	const operations = diffLines(splitLines(before), splitLines(after));
+	return `--- a/${file}\n+++ b/${file}\n` + formatHunks(operations);
+}
+function splitLines(text) {
+	if (text === "") return [];
+	const lines = text.split("\n");
+	if (lines[lines.length - 1] === "") lines.pop();
+	return lines;
+}
+function diffLines(oldLines, newLines) {
+	const n = oldLines.length;
+	const m = newLines.length;
+	if (n * m > MAX_CELLS) return [...oldLines.map((text) => ({
+		type: "removed",
+		text
+	})), ...newLines.map((text) => ({
+		type: "added",
+		text
+	}))];
+	const lengths = [];
+	for (let i = 0; i <= n; i++) lengths.push(new Uint32Array(m + 1));
+	for (let i = n - 1; i >= 0; i--) {
+		const row = lengths[i];
+		const below = lengths[i + 1];
+		for (let j = m - 1; j >= 0; j--) row[j] = oldLines[i] === newLines[j] ? (below[j + 1] ?? 0) + 1 : Math.max(below[j] ?? 0, row[j + 1] ?? 0);
+	}
+	const operations = [];
+	let i = 0;
+	let j = 0;
+	while (i < n && j < m) if (oldLines[i] === newLines[j]) {
+		operations.push({
+			type: "same",
+			text: oldLines[i] ?? ""
+		});
+		i++;
+		j++;
+	} else if ((lengths[i + 1]?.[j] ?? 0) >= (lengths[i]?.[j + 1] ?? 0)) {
+		operations.push({
+			type: "removed",
+			text: oldLines[i] ?? ""
+		});
+		i++;
+	} else {
+		operations.push({
+			type: "added",
+			text: newLines[j] ?? ""
+		});
+		j++;
+	}
+	while (i < n) operations.push({
+		type: "removed",
+		text: oldLines[i++] ?? ""
+	});
+	while (j < m) operations.push({
+		type: "added",
+		text: newLines[j++] ?? ""
+	});
+	return operations;
+}
+function formatHunks(operations) {
+	const changed = operations.map((operation, index) => operation.type === "same" ? -1 : index).filter((index) => index >= 0);
+	let output = "";
+	let cursor = 0;
+	while (cursor < changed.length) {
+		const firstChange = changed[cursor] ?? 0;
+		let lastChange = firstChange;
+		while (cursor + 1 < changed.length && (changed[cursor + 1] ?? 0) - lastChange <= 6) {
+			cursor++;
+			lastChange = changed[cursor] ?? lastChange;
+		}
+		cursor++;
+		const start = Math.max(0, firstChange - CONTEXT);
+		const end = Math.min(operations.length, lastChange + CONTEXT + 1);
+		let oldStart = 1;
+		let newStart = 1;
+		for (let index = 0; index < start; index++) {
+			const type = operations[index]?.type;
+			if (type !== "added") oldStart++;
+			if (type !== "removed") newStart++;
+		}
+		let oldCount = 0;
+		let newCount = 0;
+		let body = "";
+		for (let index = start; index < end; index++) {
+			const operation = operations[index];
+			if (!operation) continue;
+			if (operation.type === "same") {
+				oldCount++;
+				newCount++;
+				body += ` ${operation.text}\n`;
+			} else if (operation.type === "removed") {
+				oldCount++;
+				body += `-${operation.text}\n`;
+			} else {
+				newCount++;
+				body += `+${operation.text}\n`;
+			}
+		}
+		const oldRange = oldCount === 0 ? `${oldStart - 1},0` : `${oldStart},${oldCount}`;
+		const newRange = newCount === 0 ? `${newStart - 1},0` : `${newStart},${newCount}`;
+		output += `@@ -${oldRange} +${newRange} @@\n${body}`;
+	}
+	return output;
+}
+
+//#endregion
+export { unifiedDiff };
+//# sourceMappingURL=diff.mjs.map

package/esm/upgrade/diff.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/diff.ts"],"sourcesContent":["/**\n * A minimal unified diff (`diff -u` shape, 3 lines of context) between two\n * versions of one file, enough for `warlock upgrade --dry-run` to show what\n * it would change. Line-based longest common subsequence; files too large for\n * that are shown as one replaced hunk.\n */\nconst CONTEXT = 3;\nconst MAX_CELLS = 16_000_000;\n\ntype Operation = { type: \"same\" | \"removed\" | \"added\"; text: string };\n\nexport function unifiedDiff(file: string, before: string, after: string): string {\n  if (before === after) return \"\";\n\n  const oldLines = splitLines(before);\n  const newLines = splitLines(after);\n  const operations = diffLines(oldLines, newLines);\n\n  const header = `--- a/${file}\\n+++ b/${file}\\n`;\n  return header + formatHunks(operations);\n}\n\nfunction splitLines(text: string): string[] {\n  if (text === \"\") return [];\n  const lines = text.split(\"\\n\");\n  if (lines[lines.length - 1] === \"\") lines.pop();\n  return lines;\n}\n\nfunction diffLines(oldLines: string[], newLines: string[]): Operation[] {\n  const n = oldLines.length;\n  const m = newLines.length;\n\n  if (n * m > MAX_CELLS) {\n    return [\n      ...oldLines.map((text): Operation => ({ type: \"removed\", text })),\n      ...newLines.map((text): Operation => ({ type: \"added\", text })),\n    ];\n  }\n\n  // lengths[i][j] = LCS length of oldLines[i..] and newLines[j..]\n  const lengths: Uint32Array[] = [];\n  for (let i = 0; i <= n; i++) lengths.push(new Uint32Array(m + 1));\n\n  for (let i = n - 1; i >= 0; i--) {\n    const row = lengths[i] as Uint32Array;\n    const below = lengths[i + 1] as Uint32Array;\n    for (let j = m - 1; j >= 0; j--) {\n      row[j] =\n        oldLines[i] === newLines[j]\n          ? (below[j + 1] ?? 0) + 1\n          : Math.max(below[j] ?? 0, row[j + 1] ?? 0);\n    }\n  }\n\n  const operations: Operation[] = [];\n  let i = 0;\n  let j = 0;\n  while (i < n && j < m) {\n    if (oldLines[i] === newLines[j]) {\n      operations.push({ type: \"same\", text: oldLines[i] ?? \"\" });\n      i++;\n      j++;\n    } else if ((lengths[i + 1]?.[j] ?? 0) >= (lengths[i]?.[j + 1] ?? 0)) {\n      operations.push({ type: \"removed\", text: oldLines[i] ?? \"\" });\n      i++;\n    } else {\n      operations.push({ type: \"added\", text: newLines[j] ?? \"\" });\n      j++;\n    }\n  }\n  while (i < n) operations.push({ type: \"removed\", text: oldLines[i++] ?? \"\" });\n  while (j < m) operations.push({ type: \"added\", text: newLines[j++] ?? \"\" });\n\n  return operations;\n}\n\nfunction formatHunks(operations: Operation[]): string {\n  const changed = operations\n    .map((operation, index) => (operation.type === \"same\" ? -1 : index))\n    .filter((index) => index >= 0);\n\n  let output = \"\";\n  let cursor = 0;\n\n  while (cursor < changed.length) {\n    const firstChange = changed[cursor] ?? 0;\n    let lastChange = firstChange;\n    // Merge changes whose context windows touch.\n    while (cursor + 1 < changed.length && (changed[cursor + 1] ?? 0) - lastChange <= CONTEXT * 2) {\n      cursor++;\n      lastChange = changed[cursor] ?? lastChange;\n    }\n    cursor++;\n\n    const start = Math.max(0, firstChange - CONTEXT);\n    const end = Math.min(operations.length, lastChange + CONTEXT + 1);\n\n    let oldStart = 1;\n    let newStart = 1;\n    for (let index = 0; index < start; index++) {\n      const type = operations[index]?.type;\n      if (type !== \"added\") oldStart++;\n      if (type !== \"removed\") newStart++;\n    }\n\n    let oldCount = 0;\n    let newCount = 0;\n    let body = \"\";\n    for (let index = start; index < end; index++) {\n      const operation = operations[index];\n      if (!operation) continue;\n      if (operation.type === \"same\") {\n        oldCount++;\n        newCount++;\n        body += ` ${operation.text}\\n`;\n      } else if (operation.type === \"removed\") {\n        oldCount++;\n        body += `-${operation.text}\\n`;\n      } else {\n        newCount++;\n        body += `+${operation.text}\\n`;\n      }\n    }\n\n    const oldRange = oldCount === 0 ? `${oldStart - 1},0` : `${oldStart},${oldCount}`;\n    const newRange = newCount === 0 ? `${newStart - 1},0` : `${newStart},${newCount}`;\n    output += `@@ -${oldRange} +${newRange} @@\\n${body}`;\n  }\n\n  return output;\n}\n"],"mappings":"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"}

package/esm/upgrade/format-upgrade-report.mjs

@@ -0,0 +1,32 @@
+import { colors } from "@mongez/copper";
+
+//#region ../../packages/core/src/upgrade/format-upgrade-report.ts
+/** The human-readable `warlock upgrade` report. */
+function formatUpgradeReport(result) {
+	const lines = [];
+	const verb = result.dryRun ? "would change" : "changed";
+	lines.push(colors.bold(`warlock upgrade ${result.from} → ${result.to}`) + (result.dryRun ? colors.dim(" (dry run: nothing written)") : ""), "");
+	for (const codemod of result.codemods) {
+		const applied = result.applied.filter((item) => item.codemod === codemod.id);
+		const manual = result.manual.filter((item) => item.codemod === codemod.id);
+		const mark = applied.length > 0 ? colors.green("✓") : manual.length > 0 ? colors.yellow("!") : colors.dim("·");
+		const counts = [applied.length > 0 ? `${applied.length} ${verb}` : "", manual.length > 0 ? `${manual.length} to review` : ""].filter(Boolean).join(", ");
+		lines.push(`${mark} ${codemod.id} ${colors.dim(`(${codemod.version})`)} ${codemod.title}${counts ? colors.dim(` — ${counts}`) : colors.dim(" — nothing to do")}`);
+		for (const item of applied) lines.push(`    ${colors.cyan(`${item.file}:${item.line}`)}  ${item.description}`);
+		for (const item of manual) lines.push(`    ${colors.yellow(`${item.file}:${item.line}`)}  ${item.hint}`);
+	}
+	if (result.notes.length > 0) {
+		lines.push("", colors.bold("Plan for (no code change):"));
+		for (const note of result.notes) lines.push(`  - ${note.text} ${colors.dim(`(${note.version})`)}`);
+	}
+	if (result.dryRun && result.diff) lines.push("", colors.bold("Diff:"), result.diff.trimEnd());
+	lines.push("");
+	lines.push(`${result.changedFiles.length} file(s) ${verb}, ${result.manual.length} place(s) to review by hand.`);
+	if (result.installHint) lines.push(`Package versions ${result.dryRun ? "would be" : "were"} updated in package.json: run ${colors.cyan(result.installHint)}.`);
+	lines.push(`Then run your type check and tests. The ${colors.cyan("upgrade-from-5-29")} skill explains each change.`);
+	return lines.join("\n");
+}
+
+//#endregion
+export { formatUpgradeReport };
+//# sourceMappingURL=format-upgrade-report.mjs.map

package/esm/upgrade/format-upgrade-report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-upgrade-report.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/format-upgrade-report.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { UpgradeResult } from \"./types\";\n\n/** The human-readable `warlock upgrade` report. */\nexport function formatUpgradeReport(result: UpgradeResult): string {\n  const lines: string[] = [];\n  const verb = result.dryRun ? \"would change\" : \"changed\";\n\n  lines.push(\n    colors.bold(`warlock upgrade ${result.from} → ${result.to}`) +\n      (result.dryRun ? colors.dim(\" (dry run: nothing written)\") : \"\"),\n    \"\",\n  );\n\n  for (const codemod of result.codemods) {\n    const applied = result.applied.filter((item) => item.codemod === codemod.id);\n    const manual = result.manual.filter((item) => item.codemod === codemod.id);\n    const mark =\n      applied.length > 0\n        ? colors.green(\"✓\")\n        : manual.length > 0\n          ? colors.yellow(\"!\")\n          : colors.dim(\"·\");\n    const counts = [\n      applied.length > 0 ? `${applied.length} ${verb}` : \"\",\n      manual.length > 0 ? `${manual.length} to review` : \"\",\n    ]\n      .filter(Boolean)\n      .join(\", \");\n\n    lines.push(\n      `${mark} ${codemod.id} ${colors.dim(`(${codemod.version})`)} ${codemod.title}${counts ? colors.dim(` — ${counts}`) : colors.dim(\" — nothing to do\")}`,\n    );\n    for (const item of applied) {\n      lines.push(`    ${colors.cyan(`${item.file}:${item.line}`)}  ${item.description}`);\n    }\n    for (const item of manual) {\n      lines.push(`    ${colors.yellow(`${item.file}:${item.line}`)}  ${item.hint}`);\n    }\n  }\n\n  if (result.notes.length > 0) {\n    lines.push(\"\", colors.bold(\"Plan for (no code change):\"));\n    for (const note of result.notes)\n      lines.push(`  - ${note.text} ${colors.dim(`(${note.version})`)}`);\n  }\n\n  if (result.dryRun && result.diff) {\n    lines.push(\"\", colors.bold(\"Diff:\"), result.diff.trimEnd());\n  }\n\n  lines.push(\"\");\n  lines.push(\n    `${result.changedFiles.length} file(s) ${verb}, ${result.manual.length} place(s) to review by hand.`,\n  );\n  if (result.installHint) {\n    lines.push(\n      `Package versions ${result.dryRun ? \"would be\" : \"were\"} updated in package.json: run ${colors.cyan(result.installHint)}.`,\n    );\n  }\n  lines.push(\n    `Then run your type check and tests. The ${colors.cyan(\"upgrade-from-5-29\")} skill explains each change.`,\n  );\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;AAIA,SAAgB,oBAAoB,QAA+B;CACjE,MAAM,QAAkB,CAAC;CACzB,MAAM,OAAO,OAAO,SAAS,iBAAiB;CAE9C,MAAM,KACJ,OAAO,KAAK,mBAAmB,OAAO,KAAK,KAAK,OAAO,IAAI,KACxD,OAAO,SAAS,OAAO,IAAI,6BAA6B,IAAI,KAC/D,EACF;CAEA,KAAK,MAAM,WAAW,OAAO,UAAU;EACrC,MAAM,UAAU,OAAO,QAAQ,QAAQ,SAAS,KAAK,YAAY,QAAQ,EAAE;EAC3E,MAAM,SAAS,OAAO,OAAO,QAAQ,SAAS,KAAK,YAAY,QAAQ,EAAE;EACzE,MAAM,OACJ,QAAQ,SAAS,IACb,OAAO,MAAM,GAAG,IAChB,OAAO,SAAS,IACd,OAAO,OAAO,GAAG,IACjB,OAAO,IAAI,GAAG;EACtB,MAAM,SAAS,CACb,QAAQ,SAAS,IAAI,GAAG,QAAQ,OAAO,GAAG,SAAS,IACnD,OAAO,SAAS,IAAI,GAAG,OAAO,OAAO,cAAc,EACrD,CAAC,CACE,OAAO,OAAO,CAAC,CACf,KAAK,IAAI;EAEZ,MAAM,KACJ,GAAG,KAAK,GAAG,QAAQ,GAAG,GAAG,OAAO,IAAI,IAAI,QAAQ,QAAQ,EAAE,EAAE,GAAG,QAAQ,QAAQ,SAAS,OAAO,IAAI,MAAM,QAAQ,IAAI,OAAO,IAAI,kBAAkB,GACpJ;EACA,KAAK,MAAM,QAAQ,SACjB,MAAM,KAAK,OAAO,OAAO,KAAK,GAAG,KAAK,KAAK,GAAG,KAAK,MAAM,EAAE,IAAI,KAAK,aAAa;EAEnF,KAAK,MAAM,QAAQ,QACjB,MAAM,KAAK,OAAO,OAAO,OAAO,GAAG,KAAK,KAAK,GAAG,KAAK,MAAM,EAAE,IAAI,KAAK,MAAM;CAEhF;CAEA,IAAI,OAAO,MAAM,SAAS,GAAG;EAC3B,MAAM,KAAK,IAAI,OAAO,KAAK,4BAA4B,CAAC;EACxD,KAAK,MAAM,QAAQ,OAAO,OACxB,MAAM,KAAK,OAAO,KAAK,KAAK,GAAG,OAAO,IAAI,IAAI,KAAK,QAAQ,EAAE,GAAG;CACpE;CAEA,IAAI,OAAO,UAAU,OAAO,MAC1B,MAAM,KAAK,IAAI,OAAO,KAAK,OAAO,GAAG,OAAO,KAAK,QAAQ,CAAC;CAG5D,MAAM,KAAK,EAAE;CACb,MAAM,KACJ,GAAG,OAAO,aAAa,OAAO,WAAW,KAAK,IAAI,OAAO,OAAO,OAAO,6BACzE;CACA,IAAI,OAAO,aACT,MAAM,KACJ,oBAAoB,OAAO,SAAS,aAAa,OAAO,gCAAgC,OAAO,KAAK,OAAO,WAAW,EAAE,EAC1H;CAEF,MAAM,KACJ,2CAA2C,OAAO,KAAK,mBAAmB,EAAE,6BAC9E;CAEA,OAAO,MAAM,KAAK,IAAI;AACxB"}

package/esm/upgrade/load-ts-morph.mjs

@@ -0,0 +1,49 @@
+import { detectPackageManager } from "../updater/package-manager.mjs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+
+//#region ../../packages/core/src/upgrade/load-ts-morph.ts
+/** Thrown when `ts-morph` is not installed; the message says how to add it. */
+var TsMorphMissingError = class extends Error {
+	constructor(installCommand) {
+		super(`warlock upgrade edits source files with ts-morph, which is not installed. Add it as a development dependency, then run the command again:\n\n  ${installCommand}\n`);
+		this.installCommand = installCommand;
+		this.name = "TsMorphMissingError";
+	}
+};
+/** The dev-dependency install command for `ts-morph` with this package manager. */
+function tsMorphInstallCommand(packageManager) {
+	switch (packageManager) {
+		case "pnpm": return "pnpm add --save-dev ts-morph";
+		case "yarn": return "yarn add --dev ts-morph";
+		case "bun": return "bun add --dev ts-morph";
+		default: return "npm install --save-dev ts-morph";
+	}
+}
+/**
+* Load `ts-morph` lazily: it is an optional peer of `@warlock.js/core`, needed
+* only by `warlock upgrade`. Resolved from the app first (where the user
+* installs it), then from core's own location.
+*/
+async function loadTsMorph(root) {
+	try {
+		const resolved = createRequire(path.join(root, "package.json")).resolve("ts-morph");
+		return fromNamespace(await import(pathToFileURL(resolved).href));
+	} catch {}
+	try {
+		return fromNamespace(await import("ts-morph"));
+	} catch {
+		throw new TsMorphMissingError(tsMorphInstallCommand(await detectPackageManager(root)));
+	}
+}
+/** A CommonJS package imported from ESM may expose its API on `default` only. */
+function fromNamespace(namespace) {
+	const candidate = namespace;
+	if (typeof candidate.Project === "function") return namespace;
+	return candidate.default;
+}
+
+//#endregion
+export { TsMorphMissingError, loadTsMorph, tsMorphInstallCommand };
+//# sourceMappingURL=load-ts-morph.mjs.map

package/esm/upgrade/load-ts-morph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-ts-morph.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/load-ts-morph.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { detectPackageManager, type PackageManager } from \"../updater/package-manager\";\nimport type { TsMorphModule } from \"./types\";\n\n/** Thrown when `ts-morph` is not installed; the message says how to add it. */\nexport class TsMorphMissingError extends Error {\n  public override readonly name = \"TsMorphMissingError\";\n\n  public constructor(public readonly installCommand: string) {\n    super(\n      `warlock upgrade edits source files with ts-morph, which is not installed. ` +\n        `Add it as a development dependency, then run the command again:\\n\\n  ${installCommand}\\n`,\n    );\n  }\n}\n\n/** The dev-dependency install command for `ts-morph` with this package manager. */\nexport function tsMorphInstallCommand(packageManager: PackageManager): string {\n  switch (packageManager) {\n    case \"pnpm\":\n      return \"pnpm add --save-dev ts-morph\";\n    case \"yarn\":\n      return \"yarn add --dev ts-morph\";\n    case \"bun\":\n      return \"bun add --dev ts-morph\";\n    default:\n      return \"npm install --save-dev ts-morph\";\n  }\n}\n\n/**\n * Load `ts-morph` lazily: it is an optional peer of `@warlock.js/core`, needed\n * only by `warlock upgrade`. Resolved from the app first (where the user\n * installs it), then from core's own location.\n */\nexport async function loadTsMorph(root: string): Promise<TsMorphModule> {\n  try {\n    const resolved = createRequire(path.join(root, \"package.json\")).resolve(\"ts-morph\");\n    return fromNamespace(await import(pathToFileURL(resolved).href));\n  } catch {\n    // Not in the app; try core's own resolution below.\n  }\n\n  try {\n    return fromNamespace(await import(\"ts-morph\"));\n  } catch {\n    throw new TsMorphMissingError(tsMorphInstallCommand(await detectPackageManager(root)));\n  }\n}\n\n/** A CommonJS package imported from ESM may expose its API on `default` only. */\nfunction fromNamespace(namespace: unknown): TsMorphModule {\n  const candidate = namespace as { Project?: unknown; default?: unknown };\n  if (typeof candidate.Project === \"function\") return namespace as TsMorphModule;\n  return candidate.default as TsMorphModule;\n}\n"],"mappings":";;;;;;;AAOA,IAAa,sBAAb,cAAyC,MAAM;CAG7C,AAAO,YAAY,AAAgB,gBAAwB;EACzD,MACE,kJAC0E,eAAe,GAC3F;EAJiC;cAFH;CAOhC;AACF;;AAGA,SAAgB,sBAAsB,gBAAwC;CAC5E,QAAQ,gBAAR;EACE,KAAK,QACH,OAAO;EACT,KAAK,QACH,OAAO;EACT,KAAK,OACH,OAAO;EACT,SACE,OAAO;CACX;AACF;;;;;;AAOA,eAAsB,YAAY,MAAsC;CACtE,IAAI;EACF,MAAM,WAAW,cAAc,KAAK,KAAK,MAAM,cAAc,CAAC,CAAC,CAAC,QAAQ,UAAU;EAClF,OAAO,cAAc,MAAM,OAAO,cAAc,QAAQ,CAAC,CAAC,KAAK;CACjE,QAAQ,CAER;CAEA,IAAI;EACF,OAAO,cAAc,MAAM,OAAO,WAAW;CAC/C,QAAQ;EACN,MAAM,IAAI,oBAAoB,sBAAsB,MAAM,qBAAqB,IAAI,CAAC,CAAC;CACvF;AACF;;AAGA,SAAS,cAAc,WAAmC;CACxD,MAAM,YAAY;CAClB,IAAI,OAAO,UAAU,YAAY,YAAY,OAAO;CACpD,OAAO,UAAU;AACnB"}

package/esm/upgrade/notes.mjs

@@ -0,0 +1,16 @@
+//#region ../../packages/core/src/upgrade/notes.ts
+/**
+* Breaking changes with nothing to edit in source: they change data or
+* operations. Printed so the rollout plans for them.
+*/
+const UPGRADE_NOTES = [{
+	version: "5.30.0",
+	text: "Auth login throttle keys are hashed: counters and lockouts written by 5.29 are forgotten on upgrade (locked accounts and IPs unlock)."
+}, {
+	version: "5.30.0",
+	text: "Image derivatives use a new cache layout: the first request re-renders each one. Delete the old two-level cache folders once the rollout is done."
+}];
+
+//#endregion
+export { UPGRADE_NOTES };
+//# sourceMappingURL=notes.mjs.map

package/esm/upgrade/notes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notes.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/notes.ts"],"sourcesContent":["import type { UpgradeNote } from \"./types\";\n\n/**\n * Breaking changes with nothing to edit in source: they change data or\n * operations. Printed so the rollout plans for them.\n */\nexport const UPGRADE_NOTES: readonly UpgradeNote[] = [\n  {\n    version: \"5.30.0\",\n    text: \"Auth login throttle keys are hashed: counters and lockouts written by 5.29 are forgotten on upgrade (locked accounts and IPs unlock).\",\n  },\n  {\n    version: \"5.30.0\",\n    text: \"Image derivatives use a new cache layout: the first request re-renders each one. Delete the old two-level cache folders once the rollout is done.\",\n  },\n];\n"],"mappings":";;;;;AAMA,MAAa,gBAAwC,CACnD;CACE,SAAS;CACT,MAAM;AACR,GACA;CACE,SAAS;CACT,MAAM;AACR,CACF"}

package/esm/upgrade/run-upgrade.mjs

@@ -0,0 +1,246 @@
+import { detectPackageManager, getInstallCommand } from "../updater/package-manager.mjs";
+import { loadTsMorph } from "./load-ts-morph.mjs";
+import { compareVersions, normalizeVersion, parseVersion } from "./version.mjs";
+import { CODEMODS } from "./codemods/index.mjs";
+import { unifiedDiff } from "./diff.mjs";
+import { UPGRADE_NOTES } from "./notes.mjs";
+import path from "node:path";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import glob from "fast-glob";
+
+//#region ../../packages/core/src/upgrade/run-upgrade.ts
+/** Thrown for a request the command cannot act on (bad versions, nothing to detect). */
+var UpgradeUsageError = class extends Error {
+	constructor(..._args) {
+		super(..._args);
+		this.name = "UpgradeUsageError";
+	}
+};
+/**
+* Apply the mechanical edits for every breaking change between two releases
+* and list what needs a decision. Writes nothing with `dryRun`.
+*/
+async function runUpgrade(options) {
+	const root = path.resolve(options.root ?? process.cwd());
+	const to = toVersion(options.to);
+	const from = options.from ? toVersion(options.from) : detectInstalledVersion(root);
+	if (compareVersions(from, to) >= 0) throw new UpgradeUsageError(notNewerMessage(from, to, options.from !== void 0));
+	const selected = (options.codemods ?? CODEMODS).filter((codemod) => codemod.version === "target" || compareVersions(codemod.version, from) > 0 && compareVersions(codemod.version, to) <= 0);
+	const tsMorph = await (options.loadTsMorph ?? loadTsMorph)(root);
+	const project = new tsMorph.Project({
+		skipAddingFilesFromTsConfig: true,
+		skipFileDependencyResolution: true,
+		compilerOptions: {
+			jsx: tsMorph.ts.JsxEmit.Preserve,
+			allowJs: false
+		}
+	});
+	const relativePaths = await glob("src/**/*.{ts,tsx}", {
+		cwd: root,
+		ignore: [
+			"**/node_modules/**",
+			"**/dist/**",
+			"**/.warlock/**",
+			"**/*.d.ts"
+		],
+		dot: false
+	});
+	relativePaths.sort();
+	const originals = /* @__PURE__ */ new Map();
+	const sourceFiles = [];
+	for (const relative of relativePaths) {
+		const content = readFileSync(path.join(root, relative), "utf8");
+		originals.set(relative, content);
+		sourceFiles.push(project.createSourceFile(path.join(root, relative), content, { overwrite: true }));
+	}
+	const relativeOf = new Map(sourceFiles.map((sourceFile, index) => [sourceFile, relativePaths[index] ?? ""]));
+	const applied = [];
+	const manual = [];
+	const textFiles = createTextFiles(root);
+	let activeCodemod;
+	const context = {
+		tsMorph,
+		sourceFiles,
+		relativePath: (sourceFile) => relativeOf.get(sourceFile) ?? path.relative(root, sourceFile.getFilePath()).split(path.sep).join("/"),
+		text: {
+			read: (file) => textFiles.read(file),
+			write: (file, content, change) => {
+				textFiles.write(file, content);
+				if (activeCodemod) applied.push({
+					codemod: activeCodemod.id,
+					file,
+					...change
+				});
+			}
+		},
+		targetVersion: to
+	};
+	const summary = [];
+	for (const codemod of selected) {
+		activeCodemod = codemod;
+		const appliedBefore = applied.length;
+		const output = codemod.run(context);
+		for (const finding of output.manual) manual.push({
+			...finding,
+			codemod: codemod.id,
+			skill: codemod.skill
+		});
+		const byFile = /* @__PURE__ */ new Map();
+		for (const edit of output.edits) {
+			const list = byFile.get(edit.file) ?? [];
+			list.push(edit);
+			byFile.set(edit.file, list);
+		}
+		for (const [file, edits] of byFile) {
+			const sourceFile = sourceFiles[relativePaths.indexOf(file)];
+			if (!sourceFile) continue;
+			let content = sourceFile.getFullText();
+			let lowestStart = Number.POSITIVE_INFINITY;
+			for (const edit of [...edits].sort((left, right) => right.start - left.start)) {
+				if (edit.end > lowestStart) {
+					manual.push({
+						codemod: codemod.id,
+						skill: codemod.skill,
+						file,
+						line: edit.line,
+						hint: `Not edited automatically (overlaps another change): ${edit.description}. Run the upgrade again after reviewing.`
+					});
+					continue;
+				}
+				content = content.slice(0, edit.start) + edit.text + content.slice(edit.end);
+				lowestStart = edit.start;
+				applied.push({
+					codemod: codemod.id,
+					file,
+					line: edit.line,
+					description: edit.description
+				});
+			}
+			sourceFile.replaceWithText(content);
+		}
+		summary.push({
+			id: codemod.id,
+			version: codemod.version === "target" ? to : codemod.version,
+			title: codemod.title,
+			applied: applied.length - appliedBefore,
+			manual: manual.filter((item) => item.codemod === codemod.id).length
+		});
+	}
+	activeCodemod = void 0;
+	applied.sort(byFileAndLine);
+	manual.sort(byFileAndLine);
+	const changes = [];
+	sourceFiles.forEach((sourceFile, index) => {
+		const file = relativePaths[index];
+		if (file === void 0) return;
+		const before = originals.get(file) ?? "";
+		const after = sourceFile.getFullText();
+		if (before !== after) changes.push({
+			file,
+			before,
+			after
+		});
+	});
+	for (const change of textFiles.changes()) changes.push(change);
+	changes.sort((left, right) => left.file.localeCompare(right.file));
+	if (!options.dryRun) for (const change of changes) writeFileSync(path.join(root, change.file), change.after);
+	const packageJsonChanged = changes.some((change) => change.file === "package.json" && applied.some((item) => item.codemod === "warlock-versions" && item.file === "package.json"));
+	return {
+		from,
+		to,
+		dryRun: options.dryRun === true,
+		codemods: summary,
+		applied,
+		manual,
+		notes: UPGRADE_NOTES.filter((note) => compareVersions(note.version, from) > 0 && compareVersions(note.version, to) <= 0),
+		changedFiles: changes.map((change) => change.file),
+		diff: changes.map((change) => unifiedDiff(change.file, change.before, change.after)).join(""),
+		...packageJsonChanged && { installHint: getInstallCommand(await detectPackageManager(root)) }
+	};
+}
+/**
+* Explain why `--to` is not newer than the starting version. The usual cause
+* is running the command after installing the new release: the starting
+* version is read from the installed `@warlock.js/core`, which is then already
+* the target, so the command needs `--from`.
+*/
+function notNewerMessage(from, to, fromWasPassed) {
+	if (fromWasPassed) return `--from ${from} is not older than --to ${to}. Pass the version this app is upgrading from.`;
+	const example = `warlock upgrade --from ${previousMinor(to)} --to ${to}`;
+	if (compareVersions(from, to) === 0) return `The installed @warlock.js/core is already ${from}, the --to version, so the version this app is upgrading from cannot be detected. Pass it with --from <previous version>, e.g. ${example}.`;
+	return `This app is already on ${from}; --to ${to} is not newer. If the detected version is wrong, pass --from <previous version>, e.g. ${example}.`;
+}
+/** `5.31.0` → `5.30`. A major's first release has no minor to step back to, so it gets a placeholder. */
+function previousMinor(version) {
+	const [major, minor] = parseVersion(version) ?? [
+		0,
+		0,
+		0
+	];
+	return minor > 0 ? `${major}.${minor - 1}` : "<previous version>";
+}
+function toVersion(value) {
+	try {
+		return normalizeVersion(value);
+	} catch (error) {
+		throw new UpgradeUsageError(error instanceof Error ? error.message : String(error));
+	}
+}
+/** The installed `@warlock.js/core`, or the version its package.json range names. */
+function detectInstalledVersion(root) {
+	const installed = path.join(root, "node_modules", "@warlock.js", "core", "package.json");
+	if (existsSync(installed)) {
+		const version = JSON.parse(readFileSync(installed, "utf8")).version;
+		if (typeof version === "string" && parseVersion(version)) return normalizeVersion(stripRange(version));
+	}
+	const manifest = path.join(root, "package.json");
+	if (existsSync(manifest)) {
+		const pkg = JSON.parse(readFileSync(manifest, "utf8"));
+		const spec = pkg.dependencies?.["@warlock.js/core"] ?? pkg.devDependencies?.["@warlock.js/core"];
+		const parsed = typeof spec === "string" ? parseVersion(spec) : void 0;
+		if (parsed) return parsed.join(".");
+	}
+	throw new UpgradeUsageError("Could not tell which Warlock version this app is on (no installed @warlock.js/core). Pass it with --from, e.g. --from 5.29.");
+}
+function stripRange(version) {
+	return (parseVersion(version) ?? [
+		0,
+		0,
+		0
+	]).join(".");
+}
+function byFileAndLine(left, right) {
+	return left.file.localeCompare(right.file) || left.line - right.line;
+}
+/** Non-TypeScript files a codemod reads and rewrites, buffered until the end. */
+function createTextFiles(root) {
+	const files = /* @__PURE__ */ new Map();
+	const entry = (file) => {
+		let existing = files.get(file);
+		if (!existing) {
+			const absolute = path.join(root, file);
+			const content = existsSync(absolute) ? readFileSync(absolute, "utf8") : void 0;
+			existing = {
+				before: content,
+				current: content
+			};
+			files.set(file, existing);
+		}
+		return existing;
+	};
+	return {
+		read: (file) => entry(file).current,
+		write: (file, content) => {
+			entry(file).current = content;
+		},
+		changes: () => [...files.entries()].filter(([, value]) => value.current !== void 0 && value.current !== value.before).map(([file, value]) => ({
+			file,
+			before: value.before ?? "",
+			after: value.current ?? ""
+		}))
+	};
+}
+
+//#endregion
+export { UpgradeUsageError, detectInstalledVersion, runUpgrade };
+//# sourceMappingURL=run-upgrade.mjs.map

package/esm/upgrade/run-upgrade.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-upgrade.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/run-upgrade.ts"],"sourcesContent":["import glob from \"fast-glob\";\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { detectPackageManager, getInstallCommand } from \"../updater/package-manager\";\nimport { CODEMODS } from \"./codemods\";\nimport { unifiedDiff } from \"./diff\";\nimport { loadTsMorph } from \"./load-ts-morph\";\nimport { UPGRADE_NOTES } from \"./notes\";\nimport type {\n  AppliedChange,\n  Codemod,\n  CodemodContext,\n  ManualItem,\n  SourceEdit,\n  SourceFile,\n  TextFiles,\n  TsMorphModule,\n  UpgradeResult,\n} from \"./types\";\nimport { compareVersions, normalizeVersion, parseVersion } from \"./version\";\n\nexport type RunUpgradeOptions = {\n  /** App root. Defaults to the current directory. */\n  root?: string;\n  /** Target version, e.g. `5.31` or `5.31.0`. */\n  to: string;\n  /** Version upgrading from; detected from the installed `@warlock.js/core` when omitted. */\n  from?: string;\n  /** Compute and report everything, write nothing. */\n  dryRun?: boolean;\n  /** Override the codemod list (tests). */\n  codemods?: readonly Codemod[];\n  /** Override how ts-morph is loaded (tests). */\n  loadTsMorph?: (root: string) => Promise<TsMorphModule>;\n};\n\n/** Thrown for a request the command cannot act on (bad versions, nothing to detect). */\nexport class UpgradeUsageError extends Error {\n  public override readonly name = \"UpgradeUsageError\";\n}\n\n/**\n * Apply the mechanical edits for every breaking change between two releases\n * and list what needs a decision. Writes nothing with `dryRun`.\n */\nexport async function runUpgrade(options: RunUpgradeOptions): Promise<UpgradeResult> {\n  const root = path.resolve(options.root ?? process.cwd());\n  const to = toVersion(options.to);\n  const from = options.from ? toVersion(options.from) : detectInstalledVersion(root);\n\n  if (compareVersions(from, to) >= 0) {\n    throw new UpgradeUsageError(notNewerMessage(from, to, options.from !== undefined));\n  }\n\n  const selected = (options.codemods ?? CODEMODS).filter(\n    (codemod) =>\n      codemod.version === \"target\" ||\n      (compareVersions(codemod.version, from) > 0 && compareVersions(codemod.version, to) <= 0),\n  );\n\n  const tsMorph = await (options.loadTsMorph ?? loadTsMorph)(root);\n  const project = new tsMorph.Project({\n    skipAddingFilesFromTsConfig: true,\n    skipFileDependencyResolution: true,\n    compilerOptions: { jsx: tsMorph.ts.JsxEmit.Preserve, allowJs: false },\n  });\n\n  const relativePaths = await glob(\"src/**/*.{ts,tsx}\", {\n    cwd: root,\n    ignore: [\"**/node_modules/**\", \"**/dist/**\", \"**/.warlock/**\", \"**/*.d.ts\"],\n    dot: false,\n  });\n  relativePaths.sort();\n\n  const originals = new Map<string, string>();\n  const sourceFiles: SourceFile[] = [];\n  for (const relative of relativePaths) {\n    const content = readFileSync(path.join(root, relative), \"utf8\");\n    originals.set(relative, content);\n    sourceFiles.push(\n      project.createSourceFile(path.join(root, relative), content, { overwrite: true }),\n    );\n  }\n\n  const relativeOf = new Map<SourceFile, string>(\n    sourceFiles.map((sourceFile, index) => [sourceFile, relativePaths[index] ?? \"\"]),\n  );\n\n  const applied: AppliedChange[] = [];\n  const manual: ManualItem[] = [];\n  const textFiles = createTextFiles(root);\n  let activeCodemod: Codemod | undefined;\n\n  const text: TextFiles = {\n    read: (file) => textFiles.read(file),\n    write: (file, content, change) => {\n      textFiles.write(file, content);\n      if (activeCodemod) {\n        applied.push({ codemod: activeCodemod.id, file, ...change });\n      }\n    },\n  };\n\n  const context: CodemodContext = {\n    tsMorph,\n    sourceFiles,\n    relativePath: (sourceFile) =>\n      relativeOf.get(sourceFile) ??\n      path.relative(root, sourceFile.getFilePath()).split(path.sep).join(\"/\"),\n    text,\n    targetVersion: to,\n  };\n\n  const summary: UpgradeResult[\"codemods\"] = [];\n\n  for (const codemod of selected) {\n    activeCodemod = codemod;\n    const appliedBefore = applied.length;\n    const output = codemod.run(context);\n\n    for (const finding of output.manual) {\n      manual.push({ ...finding, codemod: codemod.id, skill: codemod.skill });\n    }\n\n    const byFile = new Map<string, SourceEdit[]>();\n    for (const edit of output.edits) {\n      const list = byFile.get(edit.file) ?? [];\n      list.push(edit);\n      byFile.set(edit.file, list);\n    }\n\n    for (const [file, edits] of byFile) {\n      const sourceFile = sourceFiles[relativePaths.indexOf(file)];\n      if (!sourceFile) continue;\n\n      let content = sourceFile.getFullText();\n      let lowestStart = Number.POSITIVE_INFINITY;\n      for (const edit of [...edits].sort((left, right) => right.start - left.start)) {\n        // Overlapping edits (one inside another) would corrupt the file: keep the outer one.\n        if (edit.end > lowestStart) {\n          manual.push({\n            codemod: codemod.id,\n            skill: codemod.skill,\n            file,\n            line: edit.line,\n            hint: `Not edited automatically (overlaps another change): ${edit.description}. Run the upgrade again after reviewing.`,\n          });\n          continue;\n        }\n        content = content.slice(0, edit.start) + edit.text + content.slice(edit.end);\n        lowestStart = edit.start;\n        applied.push({ codemod: codemod.id, file, line: edit.line, description: edit.description });\n      }\n\n      sourceFile.replaceWithText(content);\n    }\n\n    summary.push({\n      id: codemod.id,\n      version: codemod.version === \"target\" ? to : codemod.version,\n      title: codemod.title,\n      applied: applied.length - appliedBefore,\n      manual: manual.filter((item) => item.codemod === codemod.id).length,\n    });\n  }\n  activeCodemod = undefined;\n\n  applied.sort(byFileAndLine);\n  manual.sort(byFileAndLine);\n\n  const changes: { file: string; before: string; after: string }[] = [];\n  sourceFiles.forEach((sourceFile, index) => {\n    const file = relativePaths[index];\n    if (file === undefined) return;\n    const before = originals.get(file) ?? \"\";\n    const after = sourceFile.getFullText();\n    if (before !== after) changes.push({ file, before, after });\n  });\n  for (const change of textFiles.changes()) changes.push(change);\n  changes.sort((left, right) => left.file.localeCompare(right.file));\n\n  if (!options.dryRun) {\n    for (const change of changes) writeFileSync(path.join(root, change.file), change.after);\n  }\n\n  const packageJsonChanged = changes.some(\n    (change) =>\n      change.file === \"package.json\" &&\n      applied.some((item) => item.codemod === \"warlock-versions\" && item.file === \"package.json\"),\n  );\n\n  return {\n    from,\n    to,\n    dryRun: options.dryRun === true,\n    codemods: summary,\n    applied,\n    manual,\n    notes: UPGRADE_NOTES.filter(\n      (note) => compareVersions(note.version, from) > 0 && compareVersions(note.version, to) <= 0,\n    ),\n    changedFiles: changes.map((change) => change.file),\n    diff: changes.map((change) => unifiedDiff(change.file, change.before, change.after)).join(\"\"),\n    ...(packageJsonChanged && {\n      installHint: getInstallCommand(await detectPackageManager(root)),\n    }),\n  };\n}\n\n/**\n * Explain why `--to` is not newer than the starting version. The usual cause\n * is running the command after installing the new release: the starting\n * version is read from the installed `@warlock.js/core`, which is then already\n * the target, so the command needs `--from`.\n */\nfunction notNewerMessage(from: string, to: string, fromWasPassed: boolean): string {\n  if (fromWasPassed) {\n    return `--from ${from} is not older than --to ${to}. Pass the version this app is upgrading from.`;\n  }\n\n  const example = `warlock upgrade --from ${previousMinor(to)} --to ${to}`;\n\n  if (compareVersions(from, to) === 0) {\n    return `The installed @warlock.js/core is already ${from}, the --to version, so the version this app is upgrading from cannot be detected. Pass it with --from <previous version>, e.g. ${example}.`;\n  }\n\n  return `This app is already on ${from}; --to ${to} is not newer. If the detected version is wrong, pass --from <previous version>, e.g. ${example}.`;\n}\n\n/** `5.31.0` → `5.30`. A major's first release has no minor to step back to, so it gets a placeholder. */\nfunction previousMinor(version: string): string {\n  const [major, minor] = parseVersion(version) ?? [0, 0, 0];\n\n  return minor > 0 ? `${major}.${minor - 1}` : \"<previous version>\";\n}\n\nfunction toVersion(value: string): string {\n  try {\n    return normalizeVersion(value);\n  } catch (error) {\n    throw new UpgradeUsageError(error instanceof Error ? error.message : String(error));\n  }\n}\n\n/** The installed `@warlock.js/core`, or the version its package.json range names. */\nexport function detectInstalledVersion(root: string): string {\n  const installed = path.join(root, \"node_modules\", \"@warlock.js\", \"core\", \"package.json\");\n  if (existsSync(installed)) {\n    const version = (JSON.parse(readFileSync(installed, \"utf8\")) as { version?: unknown }).version;\n    if (typeof version === \"string\" && parseVersion(version))\n      return normalizeVersion(stripRange(version));\n  }\n\n  const manifest = path.join(root, \"package.json\");\n  if (existsSync(manifest)) {\n    const pkg = JSON.parse(readFileSync(manifest, \"utf8\")) as {\n      dependencies?: Record<string, unknown>;\n      devDependencies?: Record<string, unknown>;\n    };\n    const spec =\n      pkg.dependencies?.[\"@warlock.js/core\"] ?? pkg.devDependencies?.[\"@warlock.js/core\"];\n    const parsed = typeof spec === \"string\" ? parseVersion(spec) : undefined;\n    if (parsed) return parsed.join(\".\");\n  }\n\n  throw new UpgradeUsageError(\n    \"Could not tell which Warlock version this app is on (no installed @warlock.js/core). Pass it with --from, e.g. --from 5.29.\",\n  );\n}\n\nfunction stripRange(version: string): string {\n  return (parseVersion(version) ?? [0, 0, 0]).join(\".\");\n}\n\nfunction byFileAndLine(\n  left: { file: string; line: number },\n  right: { file: string; line: number },\n) {\n  return left.file.localeCompare(right.file) || left.line - right.line;\n}\n\n/** Non-TypeScript files a codemod reads and rewrites, buffered until the end. */\nfunction createTextFiles(root: string) {\n  const files = new Map<string, { before: string | undefined; current: string | undefined }>();\n\n  const entry = (file: string) => {\n    let existing = files.get(file);\n    if (!existing) {\n      const absolute = path.join(root, file);\n      const content = existsSync(absolute) ? readFileSync(absolute, \"utf8\") : undefined;\n      existing = { before: content, current: content };\n      files.set(file, existing);\n    }\n    return existing;\n  };\n\n  return {\n    read: (file: string) => entry(file).current,\n    write: (file: string, content: string) => {\n      entry(file).current = content;\n    },\n    changes: () =>\n      [...files.entries()]\n        .filter(([, value]) => value.current !== undefined && value.current !== value.before)\n        .map(([file, value]) => ({ file, before: value.before ?? \"\", after: value.current ?? \"\" })),\n  };\n}\n"],"mappings":"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"}

package/esm/upgrade/upgrade-command.action.mjs

@@ -0,0 +1,37 @@
+import { formatUpgradeReport } from "./format-upgrade-report.mjs";
+import { TsMorphMissingError } from "./load-ts-morph.mjs";
+import { UpgradeUsageError, runUpgrade } from "./run-upgrade.mjs";
+
+//#region ../../packages/core/src/upgrade/upgrade-command.action.ts
+/**
+* The `warlock upgrade` action. Returns the exit code it set: 0 when it ran
+* (even with places to review), 1 for unusable arguments or a missing ts-morph.
+*/
+async function runUpgradeCommand(options, overrides = {}, output = console) {
+	const json = Boolean(options.json);
+	const fail = (message) => {
+		if (json) output.log(JSON.stringify({ error: message }, null, 2));
+		else output.error(message);
+		process.exitCode = 1;
+		return 1;
+	};
+	const to = typeof options.to === "string" || typeof options.to === "number" ? String(options.to) : "";
+	if (!to) return fail("Pass the version to upgrade to, and the version upgrading from once the new release is installed: warlock upgrade --from 5.30 --to 5.31.0");
+	try {
+		const result = await runUpgrade({
+			...overrides,
+			to,
+			...options.from !== void 0 && options.from !== true && { from: String(options.from) },
+			dryRun: Boolean(options.dryRun)
+		});
+		output.log(json ? JSON.stringify(result, null, 2) : formatUpgradeReport(result));
+		return 0;
+	} catch (error) {
+		if (error instanceof UpgradeUsageError || error instanceof TsMorphMissingError) return fail(error.message);
+		throw error;
+	}
+}
+
+//#endregion
+export { runUpgradeCommand };
+//# sourceMappingURL=upgrade-command.action.mjs.map

package/esm/upgrade/upgrade-command.action.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-command.action.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/upgrade-command.action.ts"],"sourcesContent":["import { formatUpgradeReport } from \"./format-upgrade-report\";\nimport { TsMorphMissingError } from \"./load-ts-morph\";\nimport { type RunUpgradeOptions, runUpgrade, UpgradeUsageError } from \"./run-upgrade\";\n\ntype Output = { log(message: string): void; error(message: string): void };\n\n/**\n * The `warlock upgrade` action. Returns the exit code it set: 0 when it ran\n * (even with places to review), 1 for unusable arguments or a missing ts-morph.\n */\nexport async function runUpgradeCommand(\n  options: Record<string, string | boolean | number>,\n  overrides: Pick<RunUpgradeOptions, \"root\" | \"codemods\" | \"loadTsMorph\"> = {},\n  output: Output = console,\n): Promise<number> {\n  const json = Boolean(options.json);\n  const fail = (message: string): number => {\n    if (json) output.log(JSON.stringify({ error: message }, null, 2));\n    else output.error(message);\n    process.exitCode = 1;\n    return 1;\n  };\n\n  const to =\n    typeof options.to === \"string\" || typeof options.to === \"number\" ? String(options.to) : \"\";\n  if (!to) {\n    return fail(\n      \"Pass the version to upgrade to, and the version upgrading from once the new release is installed: warlock upgrade --from 5.30 --to 5.31.0\",\n    );\n  }\n\n  try {\n    const result = await runUpgrade({\n      ...overrides,\n      to,\n      ...(options.from !== undefined && options.from !== true && { from: String(options.from) }),\n      dryRun: Boolean(options.dryRun),\n    });\n\n    output.log(json ? JSON.stringify(result, null, 2) : formatUpgradeReport(result));\n    return 0;\n  } catch (error) {\n    if (error instanceof UpgradeUsageError || error instanceof TsMorphMissingError) {\n      return fail(error.message);\n    }\n    throw error;\n  }\n}\n"],"mappings":";;;;;;;;;AAUA,eAAsB,kBACpB,SACA,YAA0E,CAAC,GAC3E,SAAiB,SACA;CACjB,MAAM,OAAO,QAAQ,QAAQ,IAAI;CACjC,MAAM,QAAQ,YAA4B;EACxC,IAAI,MAAM,OAAO,IAAI,KAAK,UAAU,EAAE,OAAO,QAAQ,GAAG,MAAM,CAAC,CAAC;OAC3D,OAAO,MAAM,OAAO;EACzB,QAAQ,WAAW;EACnB,OAAO;CACT;CAEA,MAAM,KACJ,OAAO,QAAQ,OAAO,YAAY,OAAO,QAAQ,OAAO,WAAW,OAAO,QAAQ,EAAE,IAAI;CAC1F,IAAI,CAAC,IACH,OAAO,KACL,2IACF;CAGF,IAAI;EACF,MAAM,SAAS,MAAM,WAAW;GAC9B,GAAG;GACH;GACA,GAAI,QAAQ,SAAS,UAAa,QAAQ,SAAS,QAAQ,EAAE,MAAM,OAAO,QAAQ,IAAI,EAAE;GACxF,QAAQ,QAAQ,QAAQ,MAAM;EAChC,CAAC;EAED,OAAO,IAAI,OAAO,KAAK,UAAU,QAAQ,MAAM,CAAC,IAAI,oBAAoB,MAAM,CAAC;EAC/E,OAAO;CACT,SAAS,OAAO;EACd,IAAI,iBAAiB,qBAAqB,iBAAiB,qBACzD,OAAO,KAAK,MAAM,OAAO;EAE3B,MAAM;CACR;AACF"}

package/esm/upgrade/version.mjs

@@ -0,0 +1,39 @@
+//#region ../../packages/core/src/upgrade/version.ts
+/** Parse `5.31`, `5.31.0`, `v5.31.2`, `^5.30.0` into `[major, minor, patch]`. */
+function parseVersion(value) {
+	const match = /(\d{1,6})(?:\.(\d{1,6}))?(?:\.(\d{1,6}))?/.exec(value.trim());
+	if (!match) return void 0;
+	return [
+		Number(match[1]),
+		Number(match[2] ?? 0),
+		Number(match[3] ?? 0)
+	];
+}
+/** `5.31` → `5.31.0`; throws on something that is not a version. */
+function normalizeVersion(value) {
+	const parsed = parseVersion(value);
+	if (!parsed || !/^v?\d{1,6}(\.\d{1,6}){0,2}$/.test(value.trim())) throw new Error(`"${value}" is not a version. Pass one like --to 5.31 or --to 5.31.0.`);
+	return parsed.join(".");
+}
+/** Negative when `left` is older than `right`, 0 when equal, positive when newer. */
+function compareVersions(left, right) {
+	const a = parseVersion(left) ?? [
+		0,
+		0,
+		0
+	];
+	const b = parseVersion(right) ?? [
+		0,
+		0,
+		0
+	];
+	for (let index = 0; index < 3; index++) {
+		const difference = (a[index] ?? 0) - (b[index] ?? 0);
+		if (difference !== 0) return difference;
+	}
+	return 0;
+}
+
+//#endregion
+export { compareVersions, normalizeVersion, parseVersion };
+//# sourceMappingURL=version.mjs.map

package/esm/upgrade/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","names":[],"sources":["../../../../../../../../packages/core/src/upgrade/version.ts"],"sourcesContent":["/** Parse `5.31`, `5.31.0`, `v5.31.2`, `^5.30.0` into `[major, minor, patch]`. */\nexport function parseVersion(value: string): [number, number, number] | undefined {\n  const match = /(\\d{1,6})(?:\\.(\\d{1,6}))?(?:\\.(\\d{1,6}))?/.exec(value.trim());\n  if (!match) return undefined;\n\n  return [Number(match[1]), Number(match[2] ?? 0), Number(match[3] ?? 0)];\n}\n\n/** `5.31` → `5.31.0`; throws on something that is not a version. */\nexport function normalizeVersion(value: string): string {\n  const parsed = parseVersion(value);\n  if (!parsed || !/^v?\\d{1,6}(\\.\\d{1,6}){0,2}$/.test(value.trim())) {\n    throw new Error(`\"${value}\" is not a version. Pass one like --to 5.31 or --to 5.31.0.`);\n  }\n\n  return parsed.join(\".\");\n}\n\n/** Negative when `left` is older than `right`, 0 when equal, positive when newer. */\nexport function compareVersions(left: string, right: string): number {\n  const a = parseVersion(left) ?? [0, 0, 0];\n  const b = parseVersion(right) ?? [0, 0, 0];\n\n  for (let index = 0; index < 3; index++) {\n    const difference = (a[index] ?? 0) - (b[index] ?? 0);\n    if (difference !== 0) return difference;\n  }\n\n  return 0;\n}\n"],"mappings":";;AACA,SAAgB,aAAa,OAAqD;CAChF,MAAM,QAAQ,4CAA4C,KAAK,MAAM,KAAK,CAAC;CAC3E,IAAI,CAAC,OAAO,OAAO;CAEnB,OAAO;EAAC,OAAO,MAAM,EAAE;EAAG,OAAO,MAAM,MAAM,CAAC;EAAG,OAAO,MAAM,MAAM,CAAC;CAAC;AACxE;;AAGA,SAAgB,iBAAiB,OAAuB;CACtD,MAAM,SAAS,aAAa,KAAK;CACjC,IAAI,CAAC,UAAU,CAAC,8BAA8B,KAAK,MAAM,KAAK,CAAC,GAC7D,MAAM,IAAI,MAAM,IAAI,MAAM,4DAA4D;CAGxF,OAAO,OAAO,KAAK,GAAG;AACxB;;AAGA,SAAgB,gBAAgB,MAAc,OAAuB;CACnE,MAAM,IAAI,aAAa,IAAI,KAAK;EAAC;EAAG;EAAG;CAAC;CACxC,MAAM,IAAI,aAAa,KAAK,KAAK;EAAC;EAAG;EAAG;CAAC;CAEzC,KAAK,IAAI,QAAQ,GAAG,QAAQ,GAAG,SAAS;EACtC,MAAM,cAAc,EAAE,UAAU,MAAM,EAAE,UAAU;EAClD,IAAI,eAAe,GAAG,OAAO;CAC/B;CAEA,OAAO;AACT"}

package/esm/use-cases/index.d.mts

@@ -4,4 +4,5 @@ import { broadcastUseCaseResult } from "./use-case-broadcast.mjs";
 import { fireLifecycleEvent, globalEventsCallbacksMap, globalUseCasesEvents } from "./use-case-events.mjs";
 import { PipelineOptions, runPipeline } from "./use-case-pipeline.mjs";
 import { BadSchemaUseCaseError } from "./use-case.errors.mjs";
-import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases-registry.mjs";
+import { $registerUseCase, $unregisterUseCase, addUseCaseHistory, getUseCase, getUseCaseHistory, getUseCases, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls } from "./use-cases-registry.mjs";
+export { $registerUseCase, $unregisterUseCase, BadSchemaUseCaseError, PipelineOptions, RegisteredUseCase, UseCase, UseCaseAfterMiddleware, UseCaseBeforeMiddleware, UseCaseBroadcastChannel, UseCaseBroadcastEvent, UseCaseBroadcastOption, UseCaseConfigurations, UseCaseContext, UseCaseErrorResult, UseCaseEventsCallbacksMap, UseCaseGuard, UseCaseHandler, UseCaseOnExecutingContext, UseCaseResult, UseCaseRuntimeOptions, UseCaseWithSchema, addUseCaseHistory, broadcastUseCaseResult, fireLifecycleEvent, getUseCase, getUseCaseHistory, getUseCases, globalEventsCallbacksMap, globalUseCasesEvents, increaseUseCaseFailedCalls, increaseUseCaseSuccessCalls, runPipeline, useCase };