@warlock.js/core 5.30.0 → 5.32.0

package/esm/tooling/typecheck/run-typecheck.mjs

@@ -0,0 +1,90 @@
+import { CompilerSession, runCompiler } from "../typescript/compiler.mjs";
+import { createProblem } from "../problem.mjs";
+import path from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+
+//#region ../../packages/core/src/tooling/typecheck/run-typecheck.ts
+const DEFAULT_TYPECHECK_BUILD_INFO = path.join(".warlock", "cache", "typecheck.tsbuildinfo");
+const toPosix = (file) => file.split(path.sep).join("/");
+function isProjectFile(file, root, declarations = true) {
+	return file.startsWith(root + path.sep) && !file.split(path.sep).includes("node_modules") && (declarations || !file.endsWith(".d.ts"));
+}
+function diagnosticToProblem(diagnostic, cwd, code = "WL7101") {
+	return createProblem({
+		code,
+		source: "typescript",
+		severity: diagnostic.severity,
+		message: diagnostic.message,
+		file: diagnostic.fileName ? toPosix(path.relative(cwd, diagnostic.fileName)) : null,
+		line: diagnostic.fileName ? diagnostic.line : null,
+		column: diagnostic.fileName ? diagnostic.column : null,
+		rule: `TS${diagnostic.code}`
+	});
+}
+/** Resolve direct importers with the native checker, including package exports and aliases. */
+function directImporters(session, targets, root) {
+	const importers = /* @__PURE__ */ new Set();
+	for (const file of session.fileNames) {
+		if (!isProjectFile(file, root, false) || targets.has(file)) continue;
+		if (session.importFiles(file).some((imported) => targets.has(path.resolve(imported)))) importers.add(file);
+	}
+	return importers;
+}
+/** TypeScript 7's native incremental compiler owns build state; changed mode filters its diagnostics. */
+function runTypecheck(options = {}) {
+	const startedAt = Date.now();
+	const cwd = path.resolve(options.cwd ?? process.cwd());
+	const configPath = path.resolve(cwd, options.project ?? "tsconfig.json");
+	const result = (problems, rest = {}) => ({
+		ok: !problems.some((problem) => problem.severity === "error"),
+		mode: options.files ? "files" : "program",
+		files: null,
+		checkedFiles: 0,
+		problems,
+		durationMs: Date.now() - startedAt,
+		buildInfoFile: null,
+		...rest
+	});
+	if (!existsSync(configPath)) return result([createProblem({
+		code: "WL7102",
+		source: "typescript",
+		message: `No TypeScript config at ${toPosix(path.relative(cwd, configPath)) || configPath}.`,
+		file: toPosix(path.relative(cwd, configPath))
+	})]);
+	const buildInfoFile = path.resolve(cwd, options.buildInfoFile ?? DEFAULT_TYPECHECK_BUILD_INFO);
+	mkdirSync(path.dirname(buildInfoFile), { recursive: true });
+	const compiled = runCompiler(cwd, [
+		"-p",
+		configPath,
+		"--noEmit",
+		"--incremental",
+		"--tsBuildInfoFile",
+		buildInfoFile,
+		"--composite",
+		"false",
+		"--emitDeclarationOnly",
+		"false",
+		"--listFiles"
+	]);
+	const sources = compiled.output.split(/\r?\n/).map((line) => path.isAbsolute(line) ? line : "").filter((file) => isProjectFile(file, cwd));
+	const wanted = options.files ? new Set(options.files.map((file) => path.resolve(cwd, file))) : null;
+	if (wanted) {
+		const session = new CompilerSession(cwd, configPath);
+		try {
+			for (const file of directImporters(session, wanted, cwd)) wanted.add(file);
+		} finally {
+			session.close();
+		}
+	}
+	const checked = sources.filter((file) => !wanted || wanted.has(file));
+	const configCodes = /* @__PURE__ */ new Set([18002, 18003]);
+	return result([...compiled.diagnostics].sort((a, b) => Number(b.fileName === configPath) - Number(a.fileName === configPath)).filter((diagnostic) => !diagnostic.fileName || diagnostic.fileName === configPath || isProjectFile(diagnostic.fileName, cwd) && (!wanted || wanted.has(diagnostic.fileName))).map((diagnostic) => diagnosticToProblem(diagnostic, cwd, !diagnostic.fileName || diagnostic.fileName === configPath || configCodes.has(diagnostic.code) ? "WL7102" : "WL7101")), {
+		files: wanted ? checked.map((file) => toPosix(path.relative(cwd, file))).sort() : null,
+		checkedFiles: checked.length,
+		buildInfoFile: existsSync(buildInfoFile) ? buildInfoFile : null
+	});
+}
+
+//#endregion
+export { DEFAULT_TYPECHECK_BUILD_INFO, diagnosticToProblem, directImporters, runTypecheck };
+//# sourceMappingURL=run-typecheck.mjs.map

package/esm/tooling/typecheck/run-typecheck.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-typecheck.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/typecheck/run-typecheck.ts"],"sourcesContent":["import { existsSync, mkdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { createProblem, type ToolingProblem } from \"../problem\";\nimport { CompilerSession, runCompiler, type CompilerDiagnostic } from \"../typescript/compiler\";\n\nexport type TypecheckOptions = {\n  cwd?: string;\n  project?: string;\n  files?: readonly string[];\n  buildInfoFile?: string;\n};\nexport type TypecheckResult = {\n  ok: boolean;\n  mode: \"program\" | \"files\";\n  files: string[] | null;\n  checkedFiles: number;\n  problems: ToolingProblem[];\n  durationMs: number;\n  buildInfoFile: string | null;\n};\nexport const DEFAULT_TYPECHECK_BUILD_INFO = path.join(\".warlock\", \"cache\", \"typecheck.tsbuildinfo\");\nconst toPosix = (file: string) => file.split(path.sep).join(\"/\");\nfunction isProjectFile(file: string, root: string, declarations = true): boolean {\n  return (\n    file.startsWith(root + path.sep) &&\n    !file.split(path.sep).includes(\"node_modules\") &&\n    (declarations || !file.endsWith(\".d.ts\"))\n  );\n}\nexport function diagnosticToProblem(\n  diagnostic: CompilerDiagnostic,\n  cwd: string,\n  code: \"WL7101\" | \"WL7102\" = \"WL7101\",\n): ToolingProblem {\n  return createProblem({\n    code,\n    source: \"typescript\",\n    severity: diagnostic.severity,\n    message: diagnostic.message,\n    file: diagnostic.fileName ? toPosix(path.relative(cwd, diagnostic.fileName)) : null,\n    line: diagnostic.fileName ? diagnostic.line : null,\n    column: diagnostic.fileName ? diagnostic.column : null,\n    rule: `TS${diagnostic.code}`,\n  });\n}\n\n/** Resolve direct importers with the native checker, including package exports and aliases. */\nexport function directImporters(\n  session: CompilerSession,\n  targets: ReadonlySet<string>,\n  root: string,\n): Set<string> {\n  const importers = new Set<string>();\n  for (const file of session.fileNames) {\n    if (!isProjectFile(file, root, false) || targets.has(file)) continue;\n    if (session.importFiles(file).some((imported) => targets.has(path.resolve(imported))))\n      importers.add(file);\n  }\n  return importers;\n}\n\n/** TypeScript 7's native incremental compiler owns build state; changed mode filters its diagnostics. */\nexport function runTypecheck(options: TypecheckOptions = {}): TypecheckResult {\n  const startedAt = Date.now();\n  const cwd = path.resolve(options.cwd ?? process.cwd());\n  const configPath = path.resolve(cwd, options.project ?? \"tsconfig.json\");\n  const result = (\n    problems: ToolingProblem[],\n    rest: Partial<TypecheckResult> = {},\n  ): TypecheckResult => ({\n    ok: !problems.some((problem) => problem.severity === \"error\"),\n    mode: options.files ? \"files\" : \"program\",\n    files: null,\n    checkedFiles: 0,\n    problems,\n    durationMs: Date.now() - startedAt,\n    buildInfoFile: null,\n    ...rest,\n  });\n  if (!existsSync(configPath))\n    return result([\n      createProblem({\n        code: \"WL7102\",\n        source: \"typescript\",\n        message: `No TypeScript config at ${toPosix(path.relative(cwd, configPath)) || configPath}.`,\n        file: toPosix(path.relative(cwd, configPath)),\n      }),\n    ]);\n  const buildInfoFile = path.resolve(cwd, options.buildInfoFile ?? DEFAULT_TYPECHECK_BUILD_INFO);\n  mkdirSync(path.dirname(buildInfoFile), { recursive: true });\n  const compiled = runCompiler(cwd, [\n    \"-p\",\n    configPath,\n    \"--noEmit\",\n    \"--incremental\",\n    \"--tsBuildInfoFile\",\n    buildInfoFile,\n    \"--composite\",\n    \"false\",\n    \"--emitDeclarationOnly\",\n    \"false\",\n    \"--listFiles\",\n  ]);\n  const sources = compiled.output\n    .split(/\\r?\\n/)\n    .map((line) => (path.isAbsolute(line) ? line : \"\"))\n    .filter((file) => isProjectFile(file, cwd));\n  const wanted = options.files\n    ? new Set(options.files.map((file) => path.resolve(cwd, file)))\n    : null;\n  if (wanted) {\n    const session = new CompilerSession(cwd, configPath);\n    try {\n      for (const file of directImporters(session, wanted, cwd)) wanted.add(file);\n    } finally {\n      session.close();\n    }\n  }\n  const checked = sources.filter((file) => !wanted || wanted.has(file));\n  const configCodes = new Set([18002, 18003]);\n  const problems = [...compiled.diagnostics]\n    .sort((a, b) => Number(b.fileName === configPath) - Number(a.fileName === configPath))\n    .filter(\n      (diagnostic) =>\n        !diagnostic.fileName ||\n        diagnostic.fileName === configPath ||\n        (isProjectFile(diagnostic.fileName, cwd) && (!wanted || wanted.has(diagnostic.fileName))),\n    )\n    .map((diagnostic) =>\n      diagnosticToProblem(\n        diagnostic,\n        cwd,\n        !diagnostic.fileName ||\n          diagnostic.fileName === configPath ||\n          configCodes.has(diagnostic.code)\n          ? \"WL7102\"\n          : \"WL7101\",\n      ),\n    );\n  return result(problems, {\n    files: wanted ? checked.map((file) => toPosix(path.relative(cwd, file))).sort() : null,\n    checkedFiles: checked.length,\n    buildInfoFile: existsSync(buildInfoFile) ? buildInfoFile : null,\n  });\n}\n"],"mappings":";;;;;;AAoBA,MAAa,+BAA+B,KAAK,KAAK,YAAY,SAAS,uBAAuB;AAClG,MAAM,WAAW,SAAiB,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;AAC/D,SAAS,cAAc,MAAc,MAAc,eAAe,MAAe;CAC/E,OACE,KAAK,WAAW,OAAO,KAAK,GAAG,KAC/B,CAAC,KAAK,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,cAAc,MAC5C,gBAAgB,CAAC,KAAK,SAAS,OAAO;AAE3C;AACA,SAAgB,oBACd,YACA,KACA,OAA4B,UACZ;CAChB,OAAO,cAAc;EACnB;EACA,QAAQ;EACR,UAAU,WAAW;EACrB,SAAS,WAAW;EACpB,MAAM,WAAW,WAAW,QAAQ,KAAK,SAAS,KAAK,WAAW,QAAQ,CAAC,IAAI;EAC/E,MAAM,WAAW,WAAW,WAAW,OAAO;EAC9C,QAAQ,WAAW,WAAW,WAAW,SAAS;EAClD,MAAM,KAAK,WAAW;CACxB,CAAC;AACH;;AAGA,SAAgB,gBACd,SACA,SACA,MACa;CACb,MAAM,4BAAY,IAAI,IAAY;CAClC,KAAK,MAAM,QAAQ,QAAQ,WAAW;EACpC,IAAI,CAAC,cAAc,MAAM,MAAM,KAAK,KAAK,QAAQ,IAAI,IAAI,GAAG;EAC5D,IAAI,QAAQ,YAAY,IAAI,CAAC,CAAC,MAAM,aAAa,QAAQ,IAAI,KAAK,QAAQ,QAAQ,CAAC,CAAC,GAClF,UAAU,IAAI,IAAI;CACtB;CACA,OAAO;AACT;;AAGA,SAAgB,aAAa,UAA4B,CAAC,GAAoB;CAC5E,MAAM,YAAY,KAAK,IAAI;CAC3B,MAAM,MAAM,KAAK,QAAQ,QAAQ,OAAO,QAAQ,IAAI,CAAC;CACrD,MAAM,aAAa,KAAK,QAAQ,KAAK,QAAQ,WAAW,eAAe;CACvE,MAAM,UACJ,UACA,OAAiC,CAAC,OACb;EACrB,IAAI,CAAC,SAAS,MAAM,YAAY,QAAQ,aAAa,OAAO;EAC5D,MAAM,QAAQ,QAAQ,UAAU;EAChC,OAAO;EACP,cAAc;EACd;EACA,YAAY,KAAK,IAAI,IAAI;EACzB,eAAe;EACf,GAAG;CACL;CACA,IAAI,CAAC,WAAW,UAAU,GACxB,OAAO,OAAO,CACZ,cAAc;EACZ,MAAM;EACN,QAAQ;EACR,SAAS,2BAA2B,QAAQ,KAAK,SAAS,KAAK,UAAU,CAAC,KAAK,WAAW;EAC1F,MAAM,QAAQ,KAAK,SAAS,KAAK,UAAU,CAAC;CAC9C,CAAC,CACH,CAAC;CACH,MAAM,gBAAgB,KAAK,QAAQ,KAAK,QAAQ,iBAAiB,4BAA4B;CAC7F,UAAU,KAAK,QAAQ,aAAa,GAAG,EAAE,WAAW,KAAK,CAAC;CAC1D,MAAM,WAAW,YAAY,KAAK;EAChC;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF,CAAC;CACD,MAAM,UAAU,SAAS,OACtB,MAAM,OAAO,CAAC,CACd,KAAK,SAAU,KAAK,WAAW,IAAI,IAAI,OAAO,EAAG,CAAC,CAClD,QAAQ,SAAS,cAAc,MAAM,GAAG,CAAC;CAC5C,MAAM,SAAS,QAAQ,QACnB,IAAI,IAAI,QAAQ,MAAM,KAAK,SAAS,KAAK,QAAQ,KAAK,IAAI,CAAC,CAAC,IAC5D;CACJ,IAAI,QAAQ;EACV,MAAM,UAAU,IAAI,gBAAgB,KAAK,UAAU;EACnD,IAAI;GACF,KAAK,MAAM,QAAQ,gBAAgB,SAAS,QAAQ,GAAG,GAAG,OAAO,IAAI,IAAI;EAC3E,UAAU;GACR,QAAQ,MAAM;EAChB;CACF;CACA,MAAM,UAAU,QAAQ,QAAQ,SAAS,CAAC,UAAU,OAAO,IAAI,IAAI,CAAC;CACpE,MAAM,8BAAc,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC;CAoB1C,OAAO,OAnBU,CAAC,GAAG,SAAS,WAAW,CAAC,CACvC,MAAM,GAAG,MAAM,OAAO,EAAE,aAAa,UAAU,IAAI,OAAO,EAAE,aAAa,UAAU,CAAC,CAAC,CACrF,QACE,eACC,CAAC,WAAW,YACZ,WAAW,aAAa,cACvB,cAAc,WAAW,UAAU,GAAG,MAAM,CAAC,UAAU,OAAO,IAAI,WAAW,QAAQ,EAC1F,CAAC,CACA,KAAK,eACJ,oBACE,YACA,KACA,CAAC,WAAW,YACV,WAAW,aAAa,cACxB,YAAY,IAAI,WAAW,IAAI,IAC7B,WACA,QACN,CAEiB,GAAG;EACtB,OAAO,SAAS,QAAQ,KAAK,SAAS,QAAQ,KAAK,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;EAClF,cAAc,QAAQ;EACtB,eAAe,WAAW,aAAa,IAAI,gBAAgB;CAC7D,CAAC;AACH"}

package/esm/tooling/typescript/compiler.d.mts

@@ -0,0 +1,31 @@
+//#region ../../packages/core/src/tooling/typescript/compiler.d.ts
+/** Keep the pinned compiler's unstable protocol inside this module. */
+export type CompilerDiagnostic = {
+  fileName?: string;
+  code: number;
+  message: string;
+  severity: "error" | "warning";
+  line: number;
+  column: number;
+  length: number;
+};
+export type SourceUpdate = {
+  path: string;
+  content: string;
+};
+/** One native server per dev session; snapshots retain the configured declaration roots. */
+export declare class CompilerSession {
+  private api;
+  private snapshot;
+  private contents;
+  private configPath;
+  constructor(cwd: string, configPath?: string, virtualFiles?: Record<string, string>);
+  update(files: readonly SourceUpdate[], deleted?: readonly string[]): void;
+  get fileNames(): readonly string[];
+  /** Ask the checker to resolve module references using the project's actual options. */
+  importFiles(file: string): string[];
+  diagnostics(file: string): CompilerDiagnostic[];
+  close(): void;
+}
+//#endregion
+//# sourceMappingURL=compiler.d.mts.map

package/esm/tooling/typescript/compiler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/typescript/compiler.ts"],"mappings":";;YASY;EACV;EACA;EACA;EACA;EACA;EACA;EACA;;YA+CU;EAAiB;EAAc;;;qBAG9B;UACH;UACA;UACA;UACA;EAER,YACE,aACA,qBACA,eAAc;EA6BhB,OAAO,gBAAgB,gBAAgB;MAQnC;;EAKJ,YAAY;EAUZ,YAAY,eAAe;EAqB3B"}

package/esm/tooling/typescript/compiler.mjs

@@ -0,0 +1,120 @@
+import { importSpecifiers } from "../syntax/imports.mjs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { readFileSync } from "node:fs";
+import { readTsconfig } from "get-tsconfig";
+import { spawnSync } from "node:child_process";
+import { API } from "typescript/unstable/sync";
+
+//#region ../../packages/core/src/tooling/typescript/compiler.ts
+const manifestPath = createRequire(import.meta.url).resolve("typescript/package.json");
+const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+const compilerBin = path.resolve(path.dirname(manifestPath), manifest.bin.tsc);
+function parseCompilerOutput(output, cwd) {
+	const diagnostics = [];
+	for (const line of output.split(/\r?\n/)) {
+		const match = /^(?:(.*?)\((\d+),(\d+)\): )?(error|warning) TS(\d+): (.*)$/.exec(line);
+		if (match) diagnostics.push({
+			...match[1] ? { fileName: path.resolve(cwd, match[1]) } : {},
+			line: Number(match[2] ?? 1),
+			column: Number(match[3] ?? 1),
+			severity: match[4] === "warning" ? "warning" : "error",
+			code: Number(match[5]),
+			message: match[6] ?? "",
+			length: 1
+		});
+		else if (/^\s+\S/.test(line)) {
+			const previous = diagnostics.at(-1);
+			if (previous) previous.message += `\n${line}`;
+		}
+	}
+	return diagnostics;
+}
+function runCompiler(cwd, args) {
+	const result = spawnSync(process.execPath, [
+		compilerBin,
+		...args,
+		"--pretty",
+		"false"
+	], {
+		cwd,
+		encoding: "utf8",
+		maxBuffer: 67108864
+	});
+	if (result.error) throw result.error;
+	if (result.signal) throw new Error(`TypeScript compiler terminated by ${result.signal}.`);
+	const output = `${result.stdout ?? ""}${result.stderr ?? ""}`;
+	const diagnostics = parseCompilerOutput(output, cwd);
+	if (result.status !== 0 && diagnostics.length === 0) throw new Error(`TypeScript compiler exited ${result.status}: ${output}`);
+	return {
+		diagnostics,
+		output,
+		status: result.status,
+		pid: result.pid
+	};
+}
+/** One native server per dev session; snapshots retain the configured declaration roots. */
+var CompilerSession = class {
+	constructor(cwd, configPath = path.join(cwd, "tsconfig.json"), virtualFiles = {}) {
+		this.contents = /* @__PURE__ */ new Map();
+		for (const [file, content] of Object.entries(virtualFiles)) this.contents.set(path.resolve(file), content);
+		this.configPath = path.resolve(cwd, configPath);
+		this.api = new API({
+			cwd,
+			fs: {
+				readFile: (file) => this.contents.get(path.resolve(file)),
+				directoryExists: (directory) => [...this.contents.keys()].some((file) => file.startsWith(path.resolve(directory) + path.sep)) ? true : void 0,
+				fileExists: (file) => this.contents.has(path.resolve(file)) ? this.contents.get(path.resolve(file)) !== null : void 0
+			}
+		});
+		try {
+			this.snapshot = this.api.updateSnapshot({ openProjects: [this.configPath] });
+		} catch (error) {
+			this.api.close();
+			throw error;
+		}
+	}
+	update(files, deleted = []) {
+		for (const file of files) this.contents.set(path.resolve(file.path), file.content);
+		for (const file of deleted) this.contents.set(path.resolve(file), null);
+		const old = this.snapshot;
+		this.snapshot = this.api.updateSnapshot({ fileChanges: { invalidateAll: true } });
+		old.dispose();
+	}
+	get fileNames() {
+		return this.snapshot.getProject(this.configPath)?.program.getSourceFileNames() ?? [];
+	}
+	/** Ask the checker to resolve module references using the project's actual options. */
+	importFiles(file) {
+		const project = this.snapshot.getProject(this.configPath);
+		if (!project?.program.getSourceFile(file)) return [];
+		const source = this.contents.get(path.resolve(file)) ?? readFileSync(file, "utf8");
+		return importSpecifiers(file, source).flatMap((imported) => {
+			return project.checker.getSymbolAtPosition(file, imported.node.start + 1)?.declarations.map((declaration) => declaration.path) ?? [];
+		});
+	}
+	diagnostics(file) {
+		const program = this.snapshot.getProject(this.configPath)?.program;
+		if (!program?.getSourceFile(file)) return [];
+		return [...program.getSyntacticDiagnostics(file), ...program.getSemanticDiagnostics(file)].filter((diagnostic) => diagnostic.category === 1 || diagnostic.category === 0).map((diagnostic) => {
+			const lines = (this.contents.get(path.resolve(file)) ?? readFileSync(file, "utf8")).slice(0, Math.max(0, diagnostic.pos)).split("\n");
+			return {
+				fileName: diagnostic.fileName,
+				code: diagnostic.code,
+				message: diagnostic.text,
+				severity: diagnostic.category === 1 ? "error" : "warning",
+				line: lines.length,
+				column: (lines.at(-1)?.length ?? 0) + 1,
+				length: Math.max(1, diagnostic.end - diagnostic.pos)
+			};
+		});
+	}
+	close() {
+		this.snapshot.dispose();
+		this.api.close();
+	}
+};
+
+//#endregion
+export { CompilerSession, compilerBin, parseCompilerOutput, runCompiler };
+//# sourceMappingURL=compiler.mjs.map

package/esm/tooling/typescript/compiler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/typescript/compiler.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\nimport { readTsconfig } from \"get-tsconfig\";\nimport { importSpecifiers } from \"../syntax/imports\";\nimport { API, type Snapshot } from \"typescript/unstable/sync\";\n\n/** Keep the pinned compiler's unstable protocol inside this module. */\nexport type CompilerDiagnostic = {\n  fileName?: string;\n  code: number;\n  message: string;\n  severity: \"error\" | \"warning\";\n  line: number;\n  column: number;\n  length: number;\n};\n\nconst require = createRequire(import.meta.url);\nconst manifestPath = require.resolve(\"typescript/package.json\");\nconst manifest: { bin: { tsc: string } } = JSON.parse(readFileSync(manifestPath, \"utf8\"));\nexport const compilerBin = path.resolve(path.dirname(manifestPath), manifest.bin.tsc);\n\nexport function parseCompilerOutput(output: string, cwd: string): CompilerDiagnostic[] {\n  const diagnostics: CompilerDiagnostic[] = [];\n  for (const line of output.split(/\\r?\\n/)) {\n    const match = /^(?:(.*?)\\((\\d+),(\\d+)\\): )?(error|warning) TS(\\d+): (.*)$/.exec(line);\n    if (match) {\n      diagnostics.push({\n        ...(match[1] ? { fileName: path.resolve(cwd, match[1]) } : {}),\n        line: Number(match[2] ?? 1),\n        column: Number(match[3] ?? 1),\n        severity: match[4] === \"warning\" ? \"warning\" : \"error\",\n        code: Number(match[5]),\n        message: match[6] ?? \"\",\n        length: 1,\n      });\n    } else if (/^\\s+\\S/.test(line)) {\n      const previous = diagnostics.at(-1);\n      if (previous) previous.message += `\\n${line}`;\n    }\n  }\n  return diagnostics;\n}\n\nexport function runCompiler(cwd: string, args: string[]) {\n  // spawnSync owns and waits for this exact child PID; it never stops unrelated processes.\n  const result = spawnSync(process.execPath, [compilerBin, ...args, \"--pretty\", \"false\"], {\n    cwd,\n    encoding: \"utf8\",\n    maxBuffer: 64 * 1024 * 1024,\n  });\n  if (result.error) throw result.error;\n  if (result.signal) throw new Error(`TypeScript compiler terminated by ${result.signal}.`);\n  const output = `${result.stdout ?? \"\"}${result.stderr ?? \"\"}`;\n  const diagnostics = parseCompilerOutput(output, cwd);\n  if (result.status !== 0 && diagnostics.length === 0) {\n    throw new Error(`TypeScript compiler exited ${result.status}: ${output}`);\n  }\n  return { diagnostics, output, status: result.status, pid: result.pid };\n}\n\nexport type SourceUpdate = { path: string; content: string };\n\n/** One native server per dev session; snapshots retain the configured declaration roots. */\nexport class CompilerSession {\n  private api: API;\n  private snapshot: Snapshot;\n  private contents = new Map<string, string | null>();\n  private configPath: string;\n\n  constructor(\n    cwd: string,\n    configPath = path.join(cwd, \"tsconfig.json\"),\n    virtualFiles: Record<string, string> = {},\n  ) {\n    for (const [file, content] of Object.entries(virtualFiles))\n      this.contents.set(path.resolve(file), content);\n    this.configPath = path.resolve(cwd, configPath);\n    this.api = new API({\n      cwd,\n      fs: {\n        readFile: (file) => this.contents.get(path.resolve(file)),\n        directoryExists: (directory) =>\n          [...this.contents.keys()].some((file) =>\n            file.startsWith(path.resolve(directory) + path.sep),\n          )\n            ? true\n            : undefined,\n        fileExists: (file) =>\n          this.contents.has(path.resolve(file))\n            ? this.contents.get(path.resolve(file)) !== null\n            : undefined,\n      },\n    });\n    try {\n      this.snapshot = this.api.updateSnapshot({ openProjects: [this.configPath] });\n    } catch (error) {\n      this.api.close();\n      throw error;\n    }\n  }\n\n  update(files: readonly SourceUpdate[], deleted: readonly string[] = []): void {\n    for (const file of files) this.contents.set(path.resolve(file.path), file.content);\n    for (const file of deleted) this.contents.set(path.resolve(file), null);\n    const old = this.snapshot;\n    this.snapshot = this.api.updateSnapshot({ fileChanges: { invalidateAll: true } });\n    old.dispose();\n  }\n\n  get fileNames(): readonly string[] {\n    return this.snapshot.getProject(this.configPath)?.program.getSourceFileNames() ?? [];\n  }\n\n  /** Ask the checker to resolve module references using the project's actual options. */\n  importFiles(file: string): string[] {\n    const project = this.snapshot.getProject(this.configPath);\n    if (!project?.program.getSourceFile(file)) return [];\n    const source = this.contents.get(path.resolve(file)) ?? readFileSync(file, \"utf8\");\n    return importSpecifiers(file, source).flatMap((imported) => {\n      const symbol = project.checker.getSymbolAtPosition(file, imported.node.start + 1);\n      return symbol?.declarations.map((declaration) => declaration.path) ?? [];\n    });\n  }\n\n  diagnostics(file: string): CompilerDiagnostic[] {\n    const program = this.snapshot.getProject(this.configPath)?.program;\n    if (!program?.getSourceFile(file)) return [];\n    return [...program.getSyntacticDiagnostics(file), ...program.getSemanticDiagnostics(file)]\n      .filter((diagnostic) => diagnostic.category === 1 || diagnostic.category === 0)\n      .map((diagnostic) => {\n        const content = this.contents.get(path.resolve(file)) ?? readFileSync(file, \"utf8\");\n        const before = content.slice(0, Math.max(0, diagnostic.pos));\n        const lines = before.split(\"\\n\");\n        return {\n          fileName: diagnostic.fileName,\n          code: diagnostic.code,\n          message: diagnostic.text,\n          severity: diagnostic.category === 1 ? \"error\" : \"warning\",\n          line: lines.length,\n          column: (lines.at(-1)?.length ?? 0) + 1,\n          length: Math.max(1, diagnostic.end - diagnostic.pos),\n        };\n      });\n  }\n\n  close(): void {\n    this.snapshot.dispose();\n    // API.close() stops only the child it spawned (typescript/dist/api/syncChannel.js).\n    this.api.close();\n  }\n}\n\n/** Compile generated source against the real project, with an isolated virtual config. */\nexport function compileSources(\n  configPath: string,\n  files: Record<string, string>,\n  paths: Record<string, string[]> = {},\n): Record<string, string[]> {\n  const cwd = path.dirname(configPath);\n  const config = readTsconfig(configPath);\n  const virtualConfig = path.join(cwd, \"__generated-types__\", \"tsconfig.json\");\n  const session = new CompilerSession(cwd, virtualConfig, {\n    ...files,\n    [virtualConfig]: JSON.stringify({\n      extends: configPath,\n      compilerOptions: {\n        noEmit: true,\n        paths: { ...config.config.compilerOptions?.paths, ...paths },\n      },\n      files: Object.keys(files),\n      include: [],\n    }),\n  });\n  try {\n    return Object.fromEntries(\n      Object.keys(files).map((file) => [\n        file,\n        session.diagnostics(file).map((diagnostic) => diagnostic.message),\n      ]),\n    );\n  } finally {\n    session.close();\n  }\n}\n"],"mappings":"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"}

package/esm/updater/update-warlock-packages.mjs

@@ -184,7 +184,8 @@ function printUpdates(updates, { pending = false } = {}) {
 }
 /** Reconcile node_modules to the rewritten package.json via the project PM. */
 async function installDependencies() {
-	const installCommand = getInstallCommand(await detectPackageManager());
+	const packageManager = await detectPackageManager();
+	const installCommand = getInstallCommand(packageManager);
 	console.log(`${colors.cyan("›")} Running ${colors.bold(installCommand)}…`);
 	execSync(installCommand, {
 		cwd: process.cwd(),
@@ -193,5 +194,5 @@ async function installDependencies() {
 }
 
 //#endregion
-export { updateWarlockPackages };
+export { isRegistryUnreachable, resolvePackageUpdates, updateWarlockPackages };
 //# sourceMappingURL=update-warlock-packages.mjs.map

package/esm/updater/update-warlock-packages.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"update-warlock-packages.mjs","names":[],"sources":["../../../../../../../../packages/core/src/updater/update-warlock-packages.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getJsonFileAsync, putJsonFileAsync } from \"@warlock.js/fs\";\nimport { execSync } from \"node:child_process\";\nimport { rootPath } from \"../utils\";\nimport { fetchLatestVersion } from \"../utils/npm-registry\";\nimport { isNewerVersion } from \"../utils/version-compare\";\nimport { detectPackageManager, getInstallCommand } from \"./package-manager\";\n\n/** Scope prefix that identifies a Warlock framework package. */\nconst WARLOCK_SCOPE = \"@warlock.js/\";\n\n/** The dependency maps in package.json we update, in display order. */\nconst DEPENDENCY_SECTIONS = [\"dependencies\", \"devDependencies\"] as const;\n\ntype DependencySection = (typeof DEPENDENCY_SECTIONS)[number];\n\ntype DependencyMap = Record<string, string>;\n\ntype PackageJson = Record<string, unknown> & {\n  dependencies?: DependencyMap;\n  devDependencies?: DependencyMap;\n};\n\n/** A `@warlock.js/*` dependency found in package.json. */\ntype WarlockDependency = {\n  name: string;\n  section: DependencySection;\n  /** The current spec exactly as written, e.g. `^4.2.0`. */\n  current: string;\n};\n\n/** A dependency whose latest version has been resolved from the registry. */\nexport type ResolvedDependency = WarlockDependency & {\n  /** Latest version from npm, or `undefined` when the lookup failed. */\n  latest: string | undefined;\n};\n\n/** A concrete version bump to write back into package.json. */\nexport type PackageUpdate = {\n  name: string;\n  section: DependencySection;\n  /** Existing spec, e.g. `^4.2.0`. */\n  from: string;\n  /** New spec with the original range operator preserved, e.g. `^4.3.0`. */\n  to: string;\n};\n\n/** Options accepted by {@link updateWarlockPackages}. */\nexport type UpdateWarlockPackagesOptions = {\n  /** Run the package manager install after rewriting versions (default true). */\n  install?: boolean;\n  /**\n   * Report what would change without touching package.json or node_modules.\n   * Resolves with the `outdated` outcome instead of `updated`.\n   */\n  dryRun?: boolean;\n};\n\n/**\n * How an update run ended. Callers branch on this instead of re-deriving the\n * situation from the printed output — the dev-server `u` shortcut needs to\n * know whether restarting is warranted, and whether it may offer a retry.\n */\nexport type UpdateOutcome =\n  /** No package.json at the project root — nothing to do. */\n  | \"no-package-json\"\n  /** package.json carries no `@warlock.js/*` dependency. */\n  | \"no-packages\"\n  /** Every registry lookup failed — offline, DNS down, or npm unreachable. */\n  | \"registry-unreachable\"\n  /** Every package is already at (or ahead of) its latest published version. */\n  | \"up-to-date\"\n  /** Newer versions exist, and a dry run left everything untouched. */\n  | \"outdated\"\n  /** Versions were rewritten (and installed, unless `install: false`). */\n  | \"updated\"\n  /** Versions were rewritten but the package manager install failed. */\n  | \"install-failed\";\n\n/** The result of an update run. */\nexport type UpdateWarlockPackagesResult = {\n  outcome: UpdateOutcome;\n  /** The bumps written to package.json — empty unless `outcome` wrote any. */\n  updates: PackageUpdate[];\n  /** The install failure, present only for `install-failed`. */\n  error?: Error;\n};\n\n/**\n * Update every `@warlock.js/*` package listed in the project's root\n * package.json to its latest published version, then reconcile `node_modules`\n * via the detected package manager.\n *\n * The original range operator on each dependency (`^`, `~`, or an exact pin)\n * is preserved; specs that aren't a plain semver — `workspace:*`, `*`,\n * `latest`, git/file URLs — are left untouched. Only genuine upgrades are\n * written, so re-running on an already-current project is a no-op.\n *\n * Resolves rather than throws on the two failures a caller is expected to\n * survive — an unreachable registry and a failed install — so the dev-server\n * shortcut can report them and keep serving.\n */\nexport async function updateWarlockPackages(\n  options: UpdateWarlockPackagesOptions = {},\n): Promise<UpdateWarlockPackagesResult> {\n  const runInstall = options.install ?? true;\n  const packageJsonPath = rootPath(\"package.json\");\n\n  if (!(await fileExistsAsync(packageJsonPath))) {\n    console.log(`${colors.red(\"✖\")} No package.json found at the project root.`);\n    return { outcome: \"no-package-json\", updates: [] };\n  }\n\n  const packageJson = (await getJsonFileAsync(packageJsonPath)) as PackageJson;\n  const dependencies = collectWarlockDependencies(packageJson);\n\n  if (dependencies.length === 0) {\n    console.log(`${colors.yellow(\"⚠\")} No @warlock.js packages found in package.json.`);\n    return { outcome: \"no-packages\", updates: [] };\n  }\n\n  console.log(\n    `${colors.cyan(\"›\")} Checking ${colors.bold(String(dependencies.length))} ` +\n      `@warlock.js package(s) for updates…`,\n  );\n\n  const resolved = await resolveLatestVersions(dependencies);\n\n  // Distinguish \"nothing newer\" from \"we never got an answer\". Without this,\n  // an offline run reports every package as up to date, which is a lie.\n  if (isRegistryUnreachable(resolved)) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not reach the npm registry — ` +\n        `no versions were changed. Check your connection and try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  // A partial failure would bump some family members and leave others behind,\n  // a lockstep drift reported as success. Refuse the whole run instead.\n  const failedLookups = resolved.filter((dependency) => !dependency.latest);\n\n  if (failedLookups.length > 0) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not look up ${failedLookups.map((dependency) => dependency.name).join(\", \")} — ` +\n        `no versions were changed, to keep @warlock.js packages in lockstep. Try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  const updates = resolvePackageUpdates(resolved);\n\n  if (updates.length === 0) {\n    console.log(`${colors.green(\"✓\")} All @warlock.js packages are already up to date.`);\n    return { outcome: \"up-to-date\", updates: [] };\n  }\n\n  if (options.dryRun) {\n    printUpdates(updates, { pending: true });\n    return { outcome: \"outdated\", updates };\n  }\n\n  applyUpdates(packageJson, updates);\n  await putJsonFileAsync(packageJsonPath, packageJson);\n\n  printUpdates(updates);\n\n  if (!runInstall) {\n    console.log(\n      colors.dim(\"Skipped install (--no-install). Run your package manager to apply the changes.\"),\n    );\n    return { outcome: \"updated\", updates };\n  }\n\n  try {\n    await installDependencies();\n  } catch (error) {\n    console.log(\n      `${colors.red(\"✖\")} The install failed. package.json is already updated — ` +\n        `re-run your package manager install to finish.`,\n    );\n    return { outcome: \"install-failed\", updates, error: error as Error };\n  }\n\n  return { outcome: \"updated\", updates };\n}\n\n/**\n * Whether *every* lookup came back empty, which in practice means the\n * registry was never reached. A single failed package (unpublished, renamed,\n * private) leaves the rest resolvable and is not treated as an outage.\n */\nexport function isRegistryUnreachable(resolved: ResolvedDependency[]): boolean {\n  return resolved.length > 0 && resolved.every((dependency) => !dependency.latest);\n}\n\n/** Collect every `@warlock.js/*` dependency across the relevant sections. */\nfunction collectWarlockDependencies(packageJson: PackageJson): WarlockDependency[] {\n  const dependencies: WarlockDependency[] = [];\n\n  for (const section of DEPENDENCY_SECTIONS) {\n    const map = packageJson[section];\n\n    if (!map) {\n      continue;\n    }\n\n    for (const [name, current] of Object.entries(map)) {\n      if (name.startsWith(WARLOCK_SCOPE)) {\n        dependencies.push({ name, section, current });\n      }\n    }\n  }\n\n  return dependencies;\n}\n\n/** Resolve each dependency's latest version from the registry in parallel. */\nasync function resolveLatestVersions(\n  dependencies: WarlockDependency[],\n): Promise<ResolvedDependency[]> {\n  return Promise.all(\n    dependencies.map(async (dependency) => ({\n      ...dependency,\n      latest: await fetchLatestVersion(dependency.name),\n    })),\n  );\n}\n\n/**\n * Turn resolved dependencies into the concrete set of version bumps to write.\n * Pure (no I/O) so it can be unit-tested directly: skips lookups that failed,\n * non-semver specs, and anything already at (or ahead of) the latest version,\n * and preserves the original range operator on everything it does rewrite.\n */\nexport function resolvePackageUpdates(resolved: ResolvedDependency[]): PackageUpdate[] {\n  const updates: PackageUpdate[] = [];\n\n  for (const dependency of resolved) {\n    if (!dependency.latest) {\n      continue;\n    }\n\n    const parsed = parseSpec(dependency.current);\n\n    if (!parsed) {\n      continue;\n    }\n\n    if (!isNewerVersion(dependency.latest, parsed.version)) {\n      continue;\n    }\n\n    updates.push({\n      name: dependency.name,\n      section: dependency.section,\n      from: dependency.current,\n      to: `${parsed.operator}${dependency.latest}`,\n    });\n  }\n\n  return updates;\n}\n\n/**\n * Split a dependency spec into its range operator and concrete version.\n * Returns `undefined` for specs we won't touch — `workspace:*`, `*`,\n * `latest`, multi-part ranges, or git/file URLs — leaving them exactly as\n * the author wrote them.\n */\nfunction parseSpec(spec: string): { operator: string; version: string } | undefined {\n  const match = spec.trim().match(/^(\\^|~)?(\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?)$/);\n\n  if (!match) {\n    return undefined;\n  }\n\n  const version = match[2];\n\n  if (version === undefined) {\n    return undefined;\n  }\n\n  return { operator: match[1] ?? \"\", version };\n}\n\n/** Write the resolved bumps back into the package.json object in place. */\nfunction applyUpdates(packageJson: PackageJson, updates: PackageUpdate[]): void {\n  for (const update of updates) {\n    const map = packageJson[update.section];\n\n    if (map) {\n      map[update.name] = update.to;\n    }\n  }\n}\n\n/** Print the version bumps — applied, or pending on a dry run. */\nfunction printUpdates(updates: PackageUpdate[], { pending = false } = {}): void {\n  const headline = pending\n    ? `${colors.yellow(\"↑\")} ${colors.bold(String(updates.length))} package(s) can be updated:`\n    : `${colors.green(\"✓\")} Updated ${colors.bold(String(updates.length))} package(s):`;\n\n  console.log(headline);\n\n  for (const update of updates) {\n    console.log(\n      `   ${colors.cyan(update.name)}  ` +\n        `${colors.dim(update.from)} ${colors.dim(\"→\")} ${colors.greenBright(update.to)}`,\n    );\n  }\n}\n\n/** Reconcile node_modules to the rewritten package.json via the project PM. */\nasync function installDependencies(): Promise<void> {\n  const packageManager = await detectPackageManager();\n  const installCommand = getInstallCommand(packageManager);\n\n  console.log(`${colors.cyan(\"›\")} Running ${colors.bold(installCommand)}…`);\n\n  execSync(installCommand, { cwd: process.cwd(), stdio: \"inherit\" });\n}\n"],"mappings":"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"}
+{"version":3,"file":"update-warlock-packages.mjs","names":[],"sources":["../../../../../../../../packages/core/src/updater/update-warlock-packages.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { fileExistsAsync, getJsonFileAsync, putJsonFileAsync } from \"@warlock.js/fs\";\nimport { execSync } from \"node:child_process\";\nimport { rootPath } from \"../utils\";\nimport { fetchLatestVersion } from \"../utils/npm-registry\";\nimport { isNewerVersion } from \"../utils/version-compare\";\nimport { detectPackageManager, getInstallCommand } from \"./package-manager\";\n\n/** Scope prefix that identifies a Warlock framework package. */\nconst WARLOCK_SCOPE = \"@warlock.js/\";\n\n/** The dependency maps in package.json we update, in display order. */\nconst DEPENDENCY_SECTIONS = [\"dependencies\", \"devDependencies\"] as const;\n\ntype DependencySection = (typeof DEPENDENCY_SECTIONS)[number];\n\ntype DependencyMap = Record<string, string>;\n\ntype PackageJson = Record<string, unknown> & {\n  dependencies?: DependencyMap;\n  devDependencies?: DependencyMap;\n};\n\n/** A `@warlock.js/*` dependency found in package.json. */\ntype WarlockDependency = {\n  name: string;\n  section: DependencySection;\n  /** The current spec exactly as written, e.g. `^4.2.0`. */\n  current: string;\n};\n\n/** A dependency whose latest version has been resolved from the registry. */\nexport type ResolvedDependency = WarlockDependency & {\n  /** Latest version from npm, or `undefined` when the lookup failed. */\n  latest: string | undefined;\n};\n\n/** A concrete version bump to write back into package.json. */\nexport type PackageUpdate = {\n  name: string;\n  section: DependencySection;\n  /** Existing spec, e.g. `^4.2.0`. */\n  from: string;\n  /** New spec with the original range operator preserved, e.g. `^4.3.0`. */\n  to: string;\n};\n\n/** Options accepted by {@link updateWarlockPackages}. */\nexport type UpdateWarlockPackagesOptions = {\n  /** Run the package manager install after rewriting versions (default true). */\n  install?: boolean;\n  /**\n   * Report what would change without touching package.json or node_modules.\n   * Resolves with the `outdated` outcome instead of `updated`.\n   */\n  dryRun?: boolean;\n};\n\n/**\n * How an update run ended. Callers branch on this instead of re-deriving the\n * situation from the printed output — the dev-server `u` shortcut needs to\n * know whether restarting is warranted, and whether it may offer a retry.\n */\nexport type UpdateOutcome =\n  /** No package.json at the project root — nothing to do. */\n  | \"no-package-json\"\n  /** package.json carries no `@warlock.js/*` dependency. */\n  | \"no-packages\"\n  /** Every registry lookup failed — offline, DNS down, or npm unreachable. */\n  | \"registry-unreachable\"\n  /** Every package is already at (or ahead of) its latest published version. */\n  | \"up-to-date\"\n  /** Newer versions exist, and a dry run left everything untouched. */\n  | \"outdated\"\n  /** Versions were rewritten (and installed, unless `install: false`). */\n  | \"updated\"\n  /** Versions were rewritten but the package manager install failed. */\n  | \"install-failed\";\n\n/** The result of an update run. */\nexport type UpdateWarlockPackagesResult = {\n  outcome: UpdateOutcome;\n  /** The bumps written to package.json — empty unless `outcome` wrote any. */\n  updates: PackageUpdate[];\n  /** The install failure, present only for `install-failed`. */\n  error?: Error;\n};\n\n/**\n * Update every `@warlock.js/*` package listed in the project's root\n * package.json to its latest published version, then reconcile `node_modules`\n * via the detected package manager.\n *\n * The original range operator on each dependency (`^`, `~`, or an exact pin)\n * is preserved; specs that aren't a plain semver — `workspace:*`, `*`,\n * `latest`, git/file URLs — are left untouched. Only genuine upgrades are\n * written, so re-running on an already-current project is a no-op.\n *\n * Resolves rather than throws on the two failures a caller is expected to\n * survive — an unreachable registry and a failed install — so the dev-server\n * shortcut can report them and keep serving.\n */\nexport async function updateWarlockPackages(\n  options: UpdateWarlockPackagesOptions = {},\n): Promise<UpdateWarlockPackagesResult> {\n  const runInstall = options.install ?? true;\n  const packageJsonPath = rootPath(\"package.json\");\n\n  if (!(await fileExistsAsync(packageJsonPath))) {\n    console.log(`${colors.red(\"✖\")} No package.json found at the project root.`);\n    return { outcome: \"no-package-json\", updates: [] };\n  }\n\n  const packageJson = (await getJsonFileAsync(packageJsonPath)) as PackageJson;\n  const dependencies = collectWarlockDependencies(packageJson);\n\n  if (dependencies.length === 0) {\n    console.log(`${colors.yellow(\"⚠\")} No @warlock.js packages found in package.json.`);\n    return { outcome: \"no-packages\", updates: [] };\n  }\n\n  console.log(\n    `${colors.cyan(\"›\")} Checking ${colors.bold(String(dependencies.length))} ` +\n      `@warlock.js package(s) for updates…`,\n  );\n\n  const resolved = await resolveLatestVersions(dependencies);\n\n  // Distinguish \"nothing newer\" from \"we never got an answer\". Without this,\n  // an offline run reports every package as up to date, which is a lie.\n  if (isRegistryUnreachable(resolved)) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not reach the npm registry — ` +\n        `no versions were changed. Check your connection and try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  // A partial failure would bump some family members and leave others behind,\n  // a lockstep drift reported as success. Refuse the whole run instead.\n  const failedLookups = resolved.filter((dependency) => !dependency.latest);\n\n  if (failedLookups.length > 0) {\n    console.log(\n      `${colors.yellow(\"⚠\")} Could not look up ${failedLookups.map((dependency) => dependency.name).join(\", \")} — ` +\n        `no versions were changed, to keep @warlock.js packages in lockstep. Try again.`,\n    );\n    return { outcome: \"registry-unreachable\", updates: [] };\n  }\n\n  const updates = resolvePackageUpdates(resolved);\n\n  if (updates.length === 0) {\n    console.log(`${colors.green(\"✓\")} All @warlock.js packages are already up to date.`);\n    return { outcome: \"up-to-date\", updates: [] };\n  }\n\n  if (options.dryRun) {\n    printUpdates(updates, { pending: true });\n    return { outcome: \"outdated\", updates };\n  }\n\n  applyUpdates(packageJson, updates);\n  await putJsonFileAsync(packageJsonPath, packageJson);\n\n  printUpdates(updates);\n\n  if (!runInstall) {\n    console.log(\n      colors.dim(\"Skipped install (--no-install). Run your package manager to apply the changes.\"),\n    );\n    return { outcome: \"updated\", updates };\n  }\n\n  try {\n    await installDependencies();\n  } catch (error) {\n    console.log(\n      `${colors.red(\"✖\")} The install failed. package.json is already updated — ` +\n        `re-run your package manager install to finish.`,\n    );\n    return { outcome: \"install-failed\", updates, error: error as Error };\n  }\n\n  return { outcome: \"updated\", updates };\n}\n\n/**\n * Whether *every* lookup came back empty, which in practice means the\n * registry was never reached. A single failed package (unpublished, renamed,\n * private) leaves the rest resolvable and is not treated as an outage.\n */\nexport function isRegistryUnreachable(resolved: ResolvedDependency[]): boolean {\n  return resolved.length > 0 && resolved.every((dependency) => !dependency.latest);\n}\n\n/** Collect every `@warlock.js/*` dependency across the relevant sections. */\nfunction collectWarlockDependencies(packageJson: PackageJson): WarlockDependency[] {\n  const dependencies: WarlockDependency[] = [];\n\n  for (const section of DEPENDENCY_SECTIONS) {\n    const map = packageJson[section];\n\n    if (!map) {\n      continue;\n    }\n\n    for (const [name, current] of Object.entries(map)) {\n      if (name.startsWith(WARLOCK_SCOPE)) {\n        dependencies.push({ name, section, current });\n      }\n    }\n  }\n\n  return dependencies;\n}\n\n/** Resolve each dependency's latest version from the registry in parallel. */\nasync function resolveLatestVersions(\n  dependencies: WarlockDependency[],\n): Promise<ResolvedDependency[]> {\n  return Promise.all(\n    dependencies.map(async (dependency) => ({\n      ...dependency,\n      latest: await fetchLatestVersion(dependency.name),\n    })),\n  );\n}\n\n/**\n * Turn resolved dependencies into the concrete set of version bumps to write.\n * Pure (no I/O) so it can be unit-tested directly: skips lookups that failed,\n * non-semver specs, and anything already at (or ahead of) the latest version,\n * and preserves the original range operator on everything it does rewrite.\n */\nexport function resolvePackageUpdates(resolved: ResolvedDependency[]): PackageUpdate[] {\n  const updates: PackageUpdate[] = [];\n\n  for (const dependency of resolved) {\n    if (!dependency.latest) {\n      continue;\n    }\n\n    const parsed = parseSpec(dependency.current);\n\n    if (!parsed) {\n      continue;\n    }\n\n    if (!isNewerVersion(dependency.latest, parsed.version)) {\n      continue;\n    }\n\n    updates.push({\n      name: dependency.name,\n      section: dependency.section,\n      from: dependency.current,\n      to: `${parsed.operator}${dependency.latest}`,\n    });\n  }\n\n  return updates;\n}\n\n/**\n * Split a dependency spec into its range operator and concrete version.\n * Returns `undefined` for specs we won't touch — `workspace:*`, `*`,\n * `latest`, multi-part ranges, or git/file URLs — leaving them exactly as\n * the author wrote them.\n */\nfunction parseSpec(spec: string): { operator: string; version: string } | undefined {\n  const match = spec.trim().match(/^(\\^|~)?(\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?)$/);\n\n  if (!match) {\n    return undefined;\n  }\n\n  const version = match[2];\n\n  if (version === undefined) {\n    return undefined;\n  }\n\n  return { operator: match[1] ?? \"\", version };\n}\n\n/** Write the resolved bumps back into the package.json object in place. */\nfunction applyUpdates(packageJson: PackageJson, updates: PackageUpdate[]): void {\n  for (const update of updates) {\n    const map = packageJson[update.section];\n\n    if (map) {\n      map[update.name] = update.to;\n    }\n  }\n}\n\n/** Print the version bumps — applied, or pending on a dry run. */\nfunction printUpdates(updates: PackageUpdate[], { pending = false } = {}): void {\n  const headline = pending\n    ? `${colors.yellow(\"↑\")} ${colors.bold(String(updates.length))} package(s) can be updated:`\n    : `${colors.green(\"✓\")} Updated ${colors.bold(String(updates.length))} package(s):`;\n\n  console.log(headline);\n\n  for (const update of updates) {\n    console.log(\n      `   ${colors.cyan(update.name)}  ` +\n        `${colors.dim(update.from)} ${colors.dim(\"→\")} ${colors.greenBright(update.to)}`,\n    );\n  }\n}\n\n/** Reconcile node_modules to the rewritten package.json via the project PM. */\nasync function installDependencies(): Promise<void> {\n  const packageManager = await detectPackageManager();\n  const installCommand = getInstallCommand(packageManager);\n\n  console.log(`${colors.cyan(\"›\")} Running ${colors.bold(installCommand)}…`);\n\n  execSync(installCommand, { cwd: process.cwd(), stdio: \"inherit\" });\n}\n"],"mappings":"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"}

package/esm/upgrade/codemods/head-viewport.mjs

@@ -0,0 +1,46 @@
+import { manualAt, removeNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/head-viewport.ts
+const DEFAULT_VIEWPORT = "width=device-width,initial-scale=1";
+/**
+* 5.30: `<Head />` emits `width=device-width, initial-scale=1` itself. Removes
+* a hand-written duplicate of exactly that tag next to `<Head`; a different
+* viewport is listed so it can move to `metadata.viewport`.
+*/
+const headViewport = {
+	id: "head-viewport",
+	version: "5.30.0",
+	package: "@warlock.js/web",
+	title: "Remove the duplicate viewport meta tag",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			if (!sourceFile.getFilePath().endsWith(".tsx")) continue;
+			if (!/<Head[\s/>]/.test(sourceFile.getFullText())) continue;
+			for (const element of sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)) {
+				if (element.getTagNameNode().getText() !== "meta") continue;
+				const attributes = /* @__PURE__ */ new Map();
+				for (const attribute of element.getAttributes()) {
+					if (!Node.isJsxAttribute(attribute)) continue;
+					const initializer = attribute.getInitializer();
+					const value = initializer && Node.isStringLiteral(initializer) ? initializer.getLiteralValue() : void 0;
+					attributes.set(attribute.getNameNode().getText(), value);
+				}
+				if (attributes.get("name") !== "viewport") continue;
+				const content = attributes.get("content");
+				if (attributes.size === 2 && content?.replace(/\s/g, "") === DEFAULT_VIEWPORT) output.edits.push(removeNode(context, element, "removed a viewport tag <Head /> already emits"));
+				else output.manual.push(manualAt(context, element, "`<Head />` now emits its own viewport tag. Move this one to `metadata.viewport` (or set it to `false`) so the page does not get two."));
+			}
+		}
+		return output;
+	}
+};
+
+//#endregion
+export { headViewport };
+//# sourceMappingURL=head-viewport.mjs.map

package/esm/upgrade/codemods/head-viewport.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"head-viewport.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/head-viewport.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { manualAt, removeNode } from \"./helpers\";\n\nconst DEFAULT_VIEWPORT = \"width=device-width,initial-scale=1\";\n\n/**\n * 5.30: `<Head />` emits `width=device-width, initial-scale=1` itself. Removes\n * a hand-written duplicate of exactly that tag next to `<Head`; a different\n * viewport is listed so it can move to `metadata.viewport`.\n */\nexport const headViewport: Codemod = {\n  id: \"head-viewport\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/web\",\n  title: \"Remove the duplicate viewport meta tag\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (!sourceFile.getFilePath().endsWith(\".tsx\")) continue;\n      if (!/<Head[\\s/>]/.test(sourceFile.getFullText())) continue;\n\n      for (const element of sourceFile.getDescendantsOfKind(SyntaxKind.JsxSelfClosingElement)) {\n        if (element.getTagNameNode().getText() !== \"meta\") continue;\n\n        const attributes = new Map<string, string | undefined>();\n        for (const attribute of element.getAttributes()) {\n          if (!Node.isJsxAttribute(attribute)) continue;\n          const initializer = attribute.getInitializer();\n          const value =\n            initializer && Node.isStringLiteral(initializer)\n              ? initializer.getLiteralValue()\n              : undefined;\n          attributes.set(attribute.getNameNode().getText(), value);\n        }\n        if (attributes.get(\"name\") !== \"viewport\") continue;\n\n        const content = attributes.get(\"content\");\n        if (attributes.size === 2 && content?.replace(/\\s/g, \"\") === DEFAULT_VIEWPORT) {\n          output.edits.push(\n            removeNode(context, element, \"removed a viewport tag <Head /> already emits\"),\n          );\n        } else {\n          output.manual.push(\n            manualAt(\n              context,\n              element,\n              \"`<Head />` now emits its own viewport tag. Move this one to `metadata.viewport` (or set it to `false`) so the page does not get two.\",\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,mBAAmB;;;;;;AAOzB,MAAa,eAAwB;CACnC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,IAAI,CAAC,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG;GAChD,IAAI,CAAC,cAAc,KAAK,WAAW,YAAY,CAAC,GAAG;GAEnD,KAAK,MAAM,WAAW,WAAW,qBAAqB,WAAW,qBAAqB,GAAG;IACvF,IAAI,QAAQ,eAAe,CAAC,CAAC,QAAQ,MAAM,QAAQ;IAEnD,MAAM,6BAAa,IAAI,IAAgC;IACvD,KAAK,MAAM,aAAa,QAAQ,cAAc,GAAG;KAC/C,IAAI,CAAC,KAAK,eAAe,SAAS,GAAG;KACrC,MAAM,cAAc,UAAU,eAAe;KAC7C,MAAM,QACJ,eAAe,KAAK,gBAAgB,WAAW,IAC3C,YAAY,gBAAgB,IAC5B;KACN,WAAW,IAAI,UAAU,YAAY,CAAC,CAAC,QAAQ,GAAG,KAAK;IACzD;IACA,IAAI,WAAW,IAAI,MAAM,MAAM,YAAY;IAE3C,MAAM,UAAU,WAAW,IAAI,SAAS;IACxC,IAAI,WAAW,SAAS,KAAK,SAAS,QAAQ,OAAO,EAAE,MAAM,kBAC3D,OAAO,MAAM,KACX,WAAW,SAAS,SAAS,+CAA+C,CAC9E;SAEA,OAAO,OAAO,KACZ,SACE,SACA,SACA,sIACF,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF"}

package/esm/upgrade/codemods/helpers.mjs

@@ -0,0 +1,81 @@
+//#region ../../packages/core/src/upgrade/codemods/helpers.ts
+/** Local names bound to `exported` imported from `moduleName` (`import { log as l }` → `l`). */
+function importedLocalNames(sourceFile, moduleName, exported) {
+	const names = /* @__PURE__ */ new Set();
+	for (const declaration of sourceFile.getImportDeclarations()) {
+		if (declaration.getModuleSpecifierValue() !== moduleName) continue;
+		for (const specifier of declaration.getNamedImports()) {
+			if (specifier.getName() !== exported) continue;
+			names.add(specifier.getAliasNode()?.getText() ?? exported);
+		}
+	}
+	return names;
+}
+/** Whether the file imports anything from `moduleName`. */
+function importsFrom(sourceFile, moduleName) {
+	return sourceFile.getImportDeclarations().some((declaration) => declaration.getModuleSpecifierValue() === moduleName);
+}
+/** A replacement of a node's text (leading trivia kept). */
+function replaceNode(context, node, text, description) {
+	return {
+		file: context.relativePath(node.getSourceFile()),
+		start: node.getStart(),
+		end: node.getEnd(),
+		text,
+		line: node.getStartLineNumber(),
+		description
+	};
+}
+/**
+* Remove a node; when it sits alone on its line(s), remove those lines too so
+* no blank line is left behind.
+*/
+function removeNode(context, node, description) {
+	const full = node.getSourceFile().getFullText();
+	let start = node.getStart();
+	let end = node.getEnd();
+	let lineStart = start;
+	while (lineStart > 0 && (full[lineStart - 1] === " " || full[lineStart - 1] === "	")) lineStart--;
+	let lineEnd = end;
+	while (lineEnd < full.length && (full[lineEnd] === " " || full[lineEnd] === "	")) lineEnd++;
+	const startsLine = lineStart === 0 || full[lineStart - 1] === "\n";
+	const endsLine = lineEnd === full.length || full[lineEnd] === "\n" || full[lineEnd] === "\r";
+	if (startsLine && endsLine) {
+		start = lineStart;
+		end = full[lineEnd] === "\r" ? lineEnd + 2 : lineEnd + 1;
+		end = Math.min(end, full.length);
+	}
+	return {
+		file: context.relativePath(node.getSourceFile()),
+		start,
+		end,
+		text: "",
+		line: node.getStartLineNumber(),
+		description
+	};
+}
+function manualAt(context, node, hint) {
+	return {
+		file: context.relativePath(node.getSourceFile()),
+		line: node.getStartLineNumber(),
+		hint
+	};
+}
+/** The property names of an object literal (static names only). */
+function objectPropertyNames(tsMorph, literal) {
+	const names = /* @__PURE__ */ new Set();
+	for (const property of literal.getProperties()) if (tsMorph.Node.isPropertyAssignment(property) || tsMorph.Node.isShorthandPropertyAssignment(property) || tsMorph.Node.isMethodDeclaration(property)) names.add(property.getName().replace(/^["']|["']$/g, ""));
+	return names;
+}
+/** The object literal assigned to `name` in `literal`, if any. */
+function objectProperty(tsMorph, literal, name) {
+	for (const property of literal.getProperties()) {
+		if (!tsMorph.Node.isPropertyAssignment(property)) continue;
+		if (property.getName().replace(/^["']|["']$/g, "") !== name) continue;
+		return property.getInitializer();
+	}
+}
+
+//#endregion
+export { importedLocalNames, importsFrom, manualAt, objectProperty, objectPropertyNames, removeNode, replaceNode };
+//# sourceMappingURL=helpers.mjs.map

package/esm/upgrade/codemods/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/helpers.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { CodemodContext, ManualFinding, SourceEdit, SourceFile } from \"../types\";\n\n/** Local names bound to `exported` imported from `moduleName` (`import { log as l }` → `l`). */\nexport function importedLocalNames(\n  sourceFile: SourceFile,\n  moduleName: string,\n  exported: string,\n): Set<string> {\n  const names = new Set<string>();\n\n  for (const declaration of sourceFile.getImportDeclarations()) {\n    if (declaration.getModuleSpecifierValue() !== moduleName) continue;\n    for (const specifier of declaration.getNamedImports()) {\n      if (specifier.getName() !== exported) continue;\n      names.add(specifier.getAliasNode()?.getText() ?? exported);\n    }\n  }\n\n  return names;\n}\n\n/** Whether the file imports anything from `moduleName`. */\nexport function importsFrom(sourceFile: SourceFile, moduleName: string): boolean {\n  return sourceFile\n    .getImportDeclarations()\n    .some((declaration) => declaration.getModuleSpecifierValue() === moduleName);\n}\n\n/** A replacement of a node's text (leading trivia kept). */\nexport function replaceNode(\n  context: CodemodContext,\n  node: TsMorph.Node,\n  text: string,\n  description: string,\n): SourceEdit {\n  return {\n    file: context.relativePath(node.getSourceFile()),\n    start: node.getStart(),\n    end: node.getEnd(),\n    text,\n    line: node.getStartLineNumber(),\n    description,\n  };\n}\n\n/**\n * Remove a node; when it sits alone on its line(s), remove those lines too so\n * no blank line is left behind.\n */\nexport function removeNode(\n  context: CodemodContext,\n  node: TsMorph.Node,\n  description: string,\n): SourceEdit {\n  const full = node.getSourceFile().getFullText();\n  let start = node.getStart();\n  let end = node.getEnd();\n\n  let lineStart = start;\n  while (lineStart > 0 && (full[lineStart - 1] === \" \" || full[lineStart - 1] === \"\\t\")) {\n    lineStart--;\n  }\n  let lineEnd = end;\n  while (lineEnd < full.length && (full[lineEnd] === \" \" || full[lineEnd] === \"\\t\")) lineEnd++;\n\n  const startsLine = lineStart === 0 || full[lineStart - 1] === \"\\n\";\n  const endsLine = lineEnd === full.length || full[lineEnd] === \"\\n\" || full[lineEnd] === \"\\r\";\n  if (startsLine && endsLine) {\n    start = lineStart;\n    end = full[lineEnd] === \"\\r\" ? lineEnd + 2 : lineEnd + 1;\n    end = Math.min(end, full.length);\n  }\n\n  return {\n    file: context.relativePath(node.getSourceFile()),\n    start,\n    end,\n    text: \"\",\n    line: node.getStartLineNumber(),\n    description,\n  };\n}\n\nexport function manualAt(context: CodemodContext, node: TsMorph.Node, hint: string): ManualFinding {\n  return {\n    file: context.relativePath(node.getSourceFile()),\n    line: node.getStartLineNumber(),\n    hint,\n  };\n}\n\n/** The property names of an object literal (static names only). */\nexport function objectPropertyNames(\n  tsMorph: CodemodContext[\"tsMorph\"],\n  literal: TsMorph.ObjectLiteralExpression,\n): Set<string> {\n  const names = new Set<string>();\n  for (const property of literal.getProperties()) {\n    if (\n      tsMorph.Node.isPropertyAssignment(property) ||\n      tsMorph.Node.isShorthandPropertyAssignment(property) ||\n      tsMorph.Node.isMethodDeclaration(property)\n    ) {\n      names.add(property.getName().replace(/^[\"']|[\"']$/g, \"\"));\n    }\n  }\n  return names;\n}\n\n/** The object literal assigned to `name` in `literal`, if any. */\nexport function objectProperty(\n  tsMorph: CodemodContext[\"tsMorph\"],\n  literal: TsMorph.ObjectLiteralExpression,\n  name: string,\n): TsMorph.Node | undefined {\n  for (const property of literal.getProperties()) {\n    if (!tsMorph.Node.isPropertyAssignment(property)) continue;\n    if (property.getName().replace(/^[\"']|[\"']$/g, \"\") !== name) continue;\n    return property.getInitializer();\n  }\n  return undefined;\n}\n"],"mappings":";;AAIA,SAAgB,mBACd,YACA,YACA,UACa;CACb,MAAM,wBAAQ,IAAI,IAAY;CAE9B,KAAK,MAAM,eAAe,WAAW,sBAAsB,GAAG;EAC5D,IAAI,YAAY,wBAAwB,MAAM,YAAY;EAC1D,KAAK,MAAM,aAAa,YAAY,gBAAgB,GAAG;GACrD,IAAI,UAAU,QAAQ,MAAM,UAAU;GACtC,MAAM,IAAI,UAAU,aAAa,CAAC,EAAE,QAAQ,KAAK,QAAQ;EAC3D;CACF;CAEA,OAAO;AACT;;AAGA,SAAgB,YAAY,YAAwB,YAA6B;CAC/E,OAAO,WACJ,sBAAsB,CAAC,CACvB,MAAM,gBAAgB,YAAY,wBAAwB,MAAM,UAAU;AAC/E;;AAGA,SAAgB,YACd,SACA,MACA,MACA,aACY;CACZ,OAAO;EACL,MAAM,QAAQ,aAAa,KAAK,cAAc,CAAC;EAC/C,OAAO,KAAK,SAAS;EACrB,KAAK,KAAK,OAAO;EACjB;EACA,MAAM,KAAK,mBAAmB;EAC9B;CACF;AACF;;;;;AAMA,SAAgB,WACd,SACA,MACA,aACY;CACZ,MAAM,OAAO,KAAK,cAAc,CAAC,CAAC,YAAY;CAC9C,IAAI,QAAQ,KAAK,SAAS;CAC1B,IAAI,MAAM,KAAK,OAAO;CAEtB,IAAI,YAAY;CAChB,OAAO,YAAY,MAAM,KAAK,YAAY,OAAO,OAAO,KAAK,YAAY,OAAO,MAC9E;CAEF,IAAI,UAAU;CACd,OAAO,UAAU,KAAK,WAAW,KAAK,aAAa,OAAO,KAAK,aAAa,MAAO;CAEnF,MAAM,aAAa,cAAc,KAAK,KAAK,YAAY,OAAO;CAC9D,MAAM,WAAW,YAAY,KAAK,UAAU,KAAK,aAAa,QAAQ,KAAK,aAAa;CACxF,IAAI,cAAc,UAAU;EAC1B,QAAQ;EACR,MAAM,KAAK,aAAa,OAAO,UAAU,IAAI,UAAU;EACvD,MAAM,KAAK,IAAI,KAAK,KAAK,MAAM;CACjC;CAEA,OAAO;EACL,MAAM,QAAQ,aAAa,KAAK,cAAc,CAAC;EAC/C;EACA;EACA,MAAM;EACN,MAAM,KAAK,mBAAmB;EAC9B;CACF;AACF;AAEA,SAAgB,SAAS,SAAyB,MAAoB,MAA6B;CACjG,OAAO;EACL,MAAM,QAAQ,aAAa,KAAK,cAAc,CAAC;EAC/C,MAAM,KAAK,mBAAmB;EAC9B;CACF;AACF;;AAGA,SAAgB,oBACd,SACA,SACa;CACb,MAAM,wBAAQ,IAAI,IAAY;CAC9B,KAAK,MAAM,YAAY,QAAQ,cAAc,GAC3C,IACE,QAAQ,KAAK,qBAAqB,QAAQ,KAC1C,QAAQ,KAAK,8BAA8B,QAAQ,KACnD,QAAQ,KAAK,oBAAoB,QAAQ,GAEzC,MAAM,IAAI,SAAS,QAAQ,CAAC,CAAC,QAAQ,gBAAgB,EAAE,CAAC;CAG5D,OAAO;AACT;;AAGA,SAAgB,eACd,SACA,SACA,MAC0B;CAC1B,KAAK,MAAM,YAAY,QAAQ,cAAc,GAAG;EAC9C,IAAI,CAAC,QAAQ,KAAK,qBAAqB,QAAQ,GAAG;EAClD,IAAI,SAAS,QAAQ,CAAC,CAAC,QAAQ,gBAAgB,EAAE,MAAM,MAAM;EAC7D,OAAO,SAAS,eAAe;CACjC;AAEF"}

package/esm/upgrade/codemods/index.mjs

@@ -0,0 +1,34 @@
+import { importedLocalNames, importsFrom, manualAt, objectProperty, objectPropertyNames, removeNode, replaceNode } from "./helpers.mjs";
+import { headViewport } from "./head-viewport.mjs";
+import { loggerSyncCalls } from "./logger-sync-calls.mjs";
+import { node2215, warlockVersions } from "./package-json.mjs";
+import { requestLogSnapshot } from "./request-log-snapshot.mjs";
+import { aiAnthropicBody, aiCompactionOptIn, aiFinishReason, aiToolDispatch, rateLimitDefaults, sealContainerCatch, sealRefineOutput, sealUnionOutput, sealValidateResult } from "./review-sites.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/index.ts
+/**
+* Every codemod, oldest release first. A codemod runs when the app upgrades
+* across its `version` (`from < version <= to`); `"target"` ones run on every
+* upgrade. Add one here for each breaking change, and name its id next to the
+* `**BREAKING**` entry in the package changelog.
+*/
+const CODEMODS = [
+	loggerSyncCalls,
+	requestLogSnapshot,
+	headViewport,
+	sealValidateResult,
+	aiToolDispatch,
+	aiAnthropicBody,
+	aiFinishReason,
+	node2215,
+	rateLimitDefaults,
+	sealRefineOutput,
+	sealContainerCatch,
+	sealUnionOutput,
+	aiCompactionOptIn,
+	warlockVersions
+];
+
+//#endregion
+export { CODEMODS, importedLocalNames, importsFrom, manualAt, objectProperty, objectPropertyNames, removeNode, replaceNode };
+//# sourceMappingURL=index.mjs.map

package/esm/upgrade/codemods/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/index.ts"],"sourcesContent":["import type { Codemod } from \"../types\";\nimport { headViewport } from \"./head-viewport\";\nimport { loggerSyncCalls } from \"./logger-sync-calls\";\nimport { node2215, warlockVersions } from \"./package-json\";\nimport { requestLogSnapshot } from \"./request-log-snapshot\";\nimport {\n  aiAnthropicBody,\n  aiCompactionOptIn,\n  aiFinishReason,\n  aiToolDispatch,\n  rateLimitDefaults,\n  sealContainerCatch,\n  sealRefineOutput,\n  sealUnionOutput,\n  sealValidateResult,\n} from \"./review-sites\";\n\n/**\n * Every codemod, oldest release first. A codemod runs when the app upgrades\n * across its `version` (`from < version <= to`); `\"target\"` ones run on every\n * upgrade. Add one here for each breaking change, and name its id next to the\n * `**BREAKING**` entry in the package changelog.\n */\nexport const CODEMODS: readonly Codemod[] = [\n  loggerSyncCalls,\n  requestLogSnapshot,\n  headViewport,\n  sealValidateResult,\n  aiToolDispatch,\n  aiAnthropicBody,\n  aiFinishReason,\n  node2215,\n  rateLimitDefaults,\n  sealRefineOutput,\n  sealContainerCatch,\n  sealUnionOutput,\n  aiCompactionOptIn,\n  warlockVersions,\n];\n\nexport * from \"./helpers\";\n"],"mappings":";;;;;;;;;;;;;;AAuBA,MAAa,WAA+B;CAC1C;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/esm/upgrade/codemods/logger-sync-calls.mjs

@@ -0,0 +1,57 @@
+import { importedLocalNames, manualAt, replaceNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/logger-sync-calls.ts
+const SYNC_METHODS = /* @__PURE__ */ new Set([
+	"info",
+	"warn",
+	"error",
+	"debug",
+	"success",
+	"fatal",
+	"log",
+	"assert"
+]);
+/**
+* 5.30: `log.info()` and its siblings return the logger instead of a promise.
+* Removes `await` in front of them; a `.then()` chained on one is listed for
+* review (code that must wait for delivery calls `await log.flush()`).
+*/
+const loggerSyncCalls = {
+	id: "logger-sync-calls",
+	version: "5.30.0",
+	package: "@warlock.js/logger",
+	title: "Remove `await` from synchronous log calls",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			const loggers = importedLocalNames(sourceFile, "@warlock.js/logger", "log");
+			if (loggers.size === 0) continue;
+			const isLogCall = (node) => {
+				if (!Node.isCallExpression(node)) return false;
+				const callee = node.getExpression();
+				if (!Node.isPropertyAccessExpression(callee)) return false;
+				const owner = callee.getExpression();
+				return Node.isIdentifier(owner) && loggers.has(owner.getText()) && SYNC_METHODS.has(callee.getName());
+			};
+			for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {
+				const argument = awaitExpression.getExpression();
+				if (!isLogCall(argument)) continue;
+				output.edits.push(replaceNode(context, awaitExpression, argument.getText(), `removed await before ${argument.getText().split("(")[0]}()`));
+			}
+			for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {
+				if (access.getName() !== "then" || !isLogCall(access.getExpression())) continue;
+				output.manual.push(manualAt(context, access, "`.then()` on a log call: log calls return the logger now. Run the callback directly, or `await log.flush()` first if it must wait for delivery."));
+			}
+		}
+		return output;
+	}
+};
+
+//#endregion
+export { loggerSyncCalls };
+//# sourceMappingURL=logger-sync-calls.mjs.map