@warlock.js/core 5.30.0 → 5.31.0

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 };
+//# 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 = 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger-sync-calls.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/logger-sync-calls.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\nconst SYNC_METHODS = new Set([\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"debug\",\n  \"success\",\n  \"fatal\",\n  \"log\",\n  \"assert\",\n]);\n\n/**\n * 5.30: `log.info()` and its siblings return the logger instead of a promise.\n * Removes `await` in front of them; a `.then()` chained on one is listed for\n * review (code that must wait for delivery calls `await log.flush()`).\n */\nexport const loggerSyncCalls: Codemod = {\n  id: \"logger-sync-calls\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/logger\",\n  title: \"Remove `await` from synchronous log calls\",\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      const loggers = importedLocalNames(sourceFile, \"@warlock.js/logger\", \"log\");\n      if (loggers.size === 0) continue;\n\n      const isLogCall = (node: import(\"ts-morph\").Node): boolean => {\n        if (!Node.isCallExpression(node)) return false;\n        const callee = node.getExpression();\n        if (!Node.isPropertyAccessExpression(callee)) return false;\n        const owner = callee.getExpression();\n        return (\n          Node.isIdentifier(owner) &&\n          loggers.has(owner.getText()) &&\n          SYNC_METHODS.has(callee.getName())\n        );\n      };\n\n      for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {\n        const argument = awaitExpression.getExpression();\n        if (!isLogCall(argument)) continue;\n        output.edits.push(\n          replaceNode(\n            context,\n            awaitExpression,\n            argument.getText(),\n            `removed await before ${argument.getText().split(\"(\")[0]}()`,\n          ),\n        );\n      }\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        if (access.getName() !== \"then\" || !isLogCall(access.getExpression())) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            access,\n            \"`.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.\",\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,eAAe,IAAI,IAAI;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAOD,MAAa,kBAA2B;CACtC,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,MAAM,UAAU,mBAAmB,YAAY,sBAAsB,KAAK;GAC1E,IAAI,QAAQ,SAAS,GAAG;GAExB,MAAM,aAAa,SAA2C;IAC5D,IAAI,CAAC,KAAK,iBAAiB,IAAI,GAAG,OAAO;IACzC,MAAM,SAAS,KAAK,cAAc;IAClC,IAAI,CAAC,KAAK,2BAA2B,MAAM,GAAG,OAAO;IACrD,MAAM,QAAQ,OAAO,cAAc;IACnC,OACE,KAAK,aAAa,KAAK,KACvB,QAAQ,IAAI,MAAM,QAAQ,CAAC,KAC3B,aAAa,IAAI,OAAO,QAAQ,CAAC;GAErC;GAEA,KAAK,MAAM,mBAAmB,WAAW,qBAAqB,WAAW,eAAe,GAAG;IACzF,MAAM,WAAW,gBAAgB,cAAc;IAC/C,IAAI,CAAC,UAAU,QAAQ,GAAG;IAC1B,OAAO,MAAM,KACX,YACE,SACA,iBACA,SAAS,QAAQ,GACjB,wBAAwB,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAC3D,CACF;GACF;GAEA,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,IAAI,OAAO,QAAQ,MAAM,UAAU,CAAC,UAAU,OAAO,cAAc,CAAC,GAAG;IACvE,OAAO,OAAO,KACZ,SACE,SACA,QACA,iJACF,CACF;GACF;EACF;EAEA,OAAO;CACT;AACF"}

package/esm/upgrade/codemods/package-json.mjs

@@ -0,0 +1,122 @@
+import { compareVersions, parseVersion } from "../version.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/package-json.ts
+const NODE_MINIMUM = "22.15.0";
+/** Keep the file's indentation and trailing newline when rewriting JSON. */
+function serialize(original, value) {
+	const indent = /^[ \t]+(?=")/m.exec(original)?.[0];
+	return (indent ? JSON.stringify(value, null, indent) : JSON.stringify(value)) + (original.endsWith("\n") ? "\n" : "");
+}
+function lineOf(source, needle) {
+	const index = source.indexOf(needle);
+	return index < 0 ? 1 : source.slice(0, index).split("\n").length;
+}
+/**
+* 5.31: the CLI needs Node.js 22.15 or newer. Raises `engines.node` in
+* package.json and the version in `.nvmrc` / `.node-version` when they allow
+* an older Node.
+*/
+const node2215 = {
+	id: "node-22-15",
+	version: "5.31.0",
+	package: "@warlock.js/core",
+	title: "Require Node.js 22.15 or newer",
+	skill: "run-app",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const source = context.text.read("package.json");
+		if (source !== void 0) {
+			const pkg = JSON.parse(source);
+			const current = pkg.engines?.node;
+			if (typeof current === "string") {
+				const minimum = parseVersion(current);
+				if (minimum && compareVersions(minimum.join("."), NODE_MINIMUM) < 0) {
+					const line = lineOf(source, "\"node\"");
+					pkg.engines = {
+						...pkg.engines,
+						node: ">=22.15"
+					};
+					context.text.write("package.json", serialize(source, pkg), {
+						line,
+						description: `engines.node "${current}" → ">=22.15"`
+					});
+				}
+			}
+		}
+		for (const file of [".nvmrc", ".node-version"]) {
+			const content = context.text.read(file);
+			if (content === void 0) continue;
+			const value = content.trim();
+			const parsed = /^v?\d/.test(value) ? parseVersion(value) : void 0;
+			if (!parsed) {
+				if (value !== "" && !/^lts\/|^node$|^latest$/i.test(value)) output.manual.push({
+					file,
+					line: 1,
+					hint: `Make sure "${value}" resolves to Node.js 22.15 or newer.`
+				});
+				continue;
+			}
+			if (compareVersions(parsed.join("."), NODE_MINIMUM) >= 0) continue;
+			const next = `${value.startsWith("v") ? "v" : ""}22.15.0`;
+			context.text.write(file, `${next}\n`, {
+				line: 1,
+				description: `Node ${value} → ${next}`
+			});
+		}
+		return output;
+	}
+};
+/** Version specs that are not a plain range and must not be rewritten. */
+const NON_REGISTRY_SPEC = /^(workspace:|file:|link:|portal:|git|github:|https?:|npm:)|^\*$|^latest$/;
+/**
+* Every upgrade: set each `@warlock.js/*` (and `create-warlock`) dependency to
+* the target version, keeping its `^`/`~`/exact style. The family is
+* released in lockstep, so mixed versions are not supported.
+*/
+const warlockVersions = {
+	id: "warlock-versions",
+	version: "target",
+	package: "@warlock.js/core",
+	title: "Move the @warlock.js packages to the target version",
+	skill: "update-packages",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const source = context.text.read("package.json");
+		if (source === void 0) return output;
+		const pkg = JSON.parse(source);
+		const changes = [];
+		for (const field of ["dependencies", "devDependencies"]) {
+			const dependencies = pkg[field];
+			if (!dependencies) continue;
+			for (const [name, spec] of Object.entries(dependencies)) {
+				if (!name.startsWith("@warlock.js/") && name !== "create-warlock") continue;
+				if (typeof spec !== "string" || NON_REGISTRY_SPEC.test(spec)) continue;
+				const next = `${/^[\^~]/.exec(spec)?.[0] ?? (/^\d/.test(spec) ? "" : "^")}${context.targetVersion}`;
+				if (next === spec) continue;
+				dependencies[name] = next;
+				changes.push({
+					name,
+					from: spec,
+					to: next
+				});
+			}
+		}
+		if (changes.length === 0) return output;
+		const first = changes[0];
+		context.text.write("package.json", serialize(source, pkg), {
+			line: first ? lineOf(source, `"${first.name}"`) : 1,
+			description: changes.map((change) => `${change.name} ${change.from} → ${change.to}`).join(", ")
+		});
+		return output;
+	}
+};
+
+//#endregion
+export { node2215, warlockVersions };
+//# sourceMappingURL=package-json.mjs.map

package/esm/upgrade/codemods/package-json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/package-json.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { compareVersions, parseVersion } from \"../version\";\n\nconst NODE_MINIMUM = \"22.15.0\";\n\ntype PackageJson = {\n  engines?: Record<string, unknown>;\n  dependencies?: Record<string, unknown>;\n  devDependencies?: Record<string, unknown>;\n};\n\n/** Keep the file's indentation and trailing newline when rewriting JSON. */\nfunction serialize(original: string, value: unknown): string {\n  const indent = /^[ \\t]+(?=\")/m.exec(original)?.[0];\n  // A one-line (minified) manifest stays on one line.\n  const json = indent ? JSON.stringify(value, null, indent) : JSON.stringify(value);\n  return json + (original.endsWith(\"\\n\") ? \"\\n\" : \"\");\n}\n\nfunction lineOf(source: string, needle: string): number {\n  const index = source.indexOf(needle);\n  return index < 0 ? 1 : source.slice(0, index).split(\"\\n\").length;\n}\n\n/**\n * 5.31: the CLI needs Node.js 22.15 or newer. Raises `engines.node` in\n * package.json and the version in `.nvmrc` / `.node-version` when they allow\n * an older Node.\n */\nexport const node2215: Codemod = {\n  id: \"node-22-15\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/core\",\n  title: \"Require Node.js 22.15 or newer\",\n  skill: \"run-app\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    const source = context.text.read(\"package.json\");\n    if (source !== undefined) {\n      const pkg = JSON.parse(source) as PackageJson;\n      const current = pkg.engines?.node;\n      if (typeof current === \"string\") {\n        const minimum = parseVersion(current);\n        if (minimum && compareVersions(minimum.join(\".\"), NODE_MINIMUM) < 0) {\n          const line = lineOf(source, '\"node\"');\n          pkg.engines = { ...pkg.engines, node: \">=22.15\" };\n          context.text.write(\"package.json\", serialize(source, pkg), {\n            line,\n            description: `engines.node \"${current}\" → \">=22.15\"`,\n          });\n        }\n      }\n    }\n\n    for (const file of [\".nvmrc\", \".node-version\"]) {\n      const content = context.text.read(file);\n      if (content === undefined) continue;\n      const value = content.trim();\n      const parsed = /^v?\\d/.test(value) ? parseVersion(value) : undefined;\n      if (!parsed) {\n        if (value !== \"\" && !/^lts\\/|^node$|^latest$/i.test(value)) {\n          output.manual.push({\n            file,\n            line: 1,\n            hint: `Make sure \"${value}\" resolves to Node.js 22.15 or newer.`,\n          });\n        }\n        continue;\n      }\n      if (compareVersions(parsed.join(\".\"), NODE_MINIMUM) >= 0) continue;\n      const next = `${value.startsWith(\"v\") ? \"v\" : \"\"}22.15.0`;\n      context.text.write(file, `${next}\\n`, { line: 1, description: `Node ${value} → ${next}` });\n    }\n\n    return output;\n  },\n};\n\n/** Version specs that are not a plain range and must not be rewritten. */\nconst NON_REGISTRY_SPEC =\n  /^(workspace:|file:|link:|portal:|git|github:|https?:|npm:)|^\\*$|^latest$/;\n\n/**\n * Every upgrade: set each `@warlock.js/*` (and `create-warlock`) dependency to\n * the target version, keeping its `^`/`~`/exact style. The family is\n * released in lockstep, so mixed versions are not supported.\n */\nexport const warlockVersions: Codemod = {\n  id: \"warlock-versions\",\n  version: \"target\",\n  package: \"@warlock.js/core\",\n  title: \"Move the @warlock.js packages to the target version\",\n  skill: \"update-packages\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    const source = context.text.read(\"package.json\");\n    if (source === undefined) return output;\n\n    const pkg = JSON.parse(source) as PackageJson;\n    const changes: { name: string; from: string; to: string }[] = [];\n\n    for (const field of [\"dependencies\", \"devDependencies\"] as const) {\n      const dependencies = pkg[field];\n      if (!dependencies) continue;\n      for (const [name, spec] of Object.entries(dependencies)) {\n        if (!name.startsWith(\"@warlock.js/\") && name !== \"create-warlock\") continue;\n        if (typeof spec !== \"string\" || NON_REGISTRY_SPEC.test(spec)) continue;\n        const prefix = /^[\\^~]/.exec(spec)?.[0] ?? (/^\\d/.test(spec) ? \"\" : \"^\");\n        const next = `${prefix}${context.targetVersion}`;\n        if (next === spec) continue;\n        dependencies[name] = next;\n        changes.push({ name, from: spec, to: next });\n      }\n    }\n\n    if (changes.length === 0) return output;\n\n    const first = changes[0];\n    context.text.write(\"package.json\", serialize(source, pkg), {\n      line: first ? lineOf(source, `\"${first.name}\"`) : 1,\n      description: changes\n        .map((change) => `${change.name} ${change.from} → ${change.to}`)\n        .join(\", \"),\n    });\n\n    return output;\n  },\n};\n"],"mappings":"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"}

package/esm/upgrade/codemods/request-log-snapshot.mjs

@@ -0,0 +1,82 @@
+import { importedLocalNames, manualAt, replaceNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/request-log-snapshot.ts
+/** Fields of the `RequestLogSnapshot` a log channel now receives. */
+const SNAPSHOT_FIELDS = new Set([
+	"id",
+	"method",
+	"url",
+	"route",
+	"name",
+	"ip",
+	"userAgent",
+	"query",
+	"body",
+	"statusCode"
+]);
+/** `request.<a>.<b>` reads with a snapshot equivalent. */
+const REWRITES = {
+	"baseRequest.url": "url",
+	"baseRequest.method": "method",
+	"baseRequest.ip": "ip",
+	"route.path": "route",
+	"route.name": "name"
+};
+/**
+* 5.30: request log entries carry a plain `RequestLogSnapshot` in
+* `context.request`, not the `Request` instance. Inside custom log channels,
+* rewrites the reads that have a direct snapshot field and lists the rest.
+*/
+const requestLogSnapshot = {
+	id: "request-log-snapshot",
+	version: "5.30.0",
+	package: "@warlock.js/core",
+	title: "Read request log snapshots in custom log channels",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			if (importedLocalNames(sourceFile, "@warlock.js/logger", "LogChannel").size === 0) continue;
+			for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {
+				const owner = access.getExpression();
+				if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== "context") continue;
+				const target = access.getName();
+				if (target !== "request" && target !== "response") continue;
+				const chain = memberChain(Node, access);
+				if (chain.length === 0) continue;
+				const first = chain[0];
+				const second = chain[1];
+				const pair = second ? `${first.getName()}.${second.getName()}` : void 0;
+				const replacement = pair ? REWRITES[pair] : void 0;
+				if (target === "request" && replacement && second) {
+					output.edits.push(replaceNode(context, second, `${access.getText()}.${replacement}`, `context.request.${pair} → context.request.${replacement}`));
+					continue;
+				}
+				const field = first.getName();
+				const isCall = Node.isCallExpression(first.getParent());
+				const readsRouteObject = target === "request" && field === "route" && second !== void 0;
+				if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) output.manual.push(manualAt(context, first, `\`context.${target}.${field}\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \`request.toLogSnapshot()\` where the entry is logged.`));
+			}
+		}
+		return output;
+	}
+};
+/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */
+function memberChain(Node, start) {
+	const chain = [];
+	let current = start;
+	for (;;) {
+		const parent = current.getParent();
+		if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) return chain;
+		chain.push(parent);
+		current = parent;
+	}
+}
+
+//#endregion
+export { requestLogSnapshot };
+//# sourceMappingURL=request-log-snapshot.mjs.map

package/esm/upgrade/codemods/request-log-snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-log-snapshot.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/request-log-snapshot.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\n/** Fields of the `RequestLogSnapshot` a log channel now receives. */\nconst SNAPSHOT_FIELDS = new Set([\n  \"id\",\n  \"method\",\n  \"url\",\n  \"route\",\n  \"name\",\n  \"ip\",\n  \"userAgent\",\n  \"query\",\n  \"body\",\n  \"statusCode\",\n]);\n\n/** `request.<a>.<b>` reads with a snapshot equivalent. */\nconst REWRITES: Record<string, string> = {\n  \"baseRequest.url\": \"url\",\n  \"baseRequest.method\": \"method\",\n  \"baseRequest.ip\": \"ip\",\n  \"route.path\": \"route\",\n  \"route.name\": \"name\",\n};\n\n/**\n * 5.30: request log entries carry a plain `RequestLogSnapshot` in\n * `context.request`, not the `Request` instance. Inside custom log channels,\n * rewrites the reads that have a direct snapshot field and lists the rest.\n */\nexport const requestLogSnapshot: Codemod = {\n  id: \"request-log-snapshot\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/core\",\n  title: \"Read request log snapshots in custom log channels\",\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 (importedLocalNames(sourceFile, \"@warlock.js/logger\", \"LogChannel\").size === 0) continue;\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        const owner = access.getExpression();\n        // `<anything>.context.request` / `.context.response`\n        if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== \"context\") continue;\n        const target = access.getName();\n        if (target !== \"request\" && target !== \"response\") continue;\n\n        const chain = memberChain(Node, access);\n        if (chain.length === 0) continue;\n\n        const first = chain[0] as TsMorph.PropertyAccessExpression;\n        const second = chain[1];\n        const pair = second ? `${first.getName()}.${second.getName()}` : undefined;\n        const replacement = pair ? REWRITES[pair] : undefined;\n\n        if (target === \"request\" && replacement && second) {\n          output.edits.push(\n            replaceNode(\n              context,\n              second,\n              `${access.getText()}.${replacement}`,\n              `context.request.${pair} → context.request.${replacement}`,\n            ),\n          );\n          continue;\n        }\n\n        const field = first.getName();\n        const isCall = Node.isCallExpression(first.getParent());\n        // `route` is the matched pattern string now, not the route object.\n        const readsRouteObject = target === \"request\" && field === \"route\" && second !== undefined;\n        if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) {\n          output.manual.push(\n            manualAt(\n              context,\n              first,\n              `\\`context.${target}.${field}\\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \\`request.toLogSnapshot()\\` where the entry is logged.`,\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n\n/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */\nfunction memberChain(\n  Node: typeof TsMorph.Node,\n  start: TsMorph.PropertyAccessExpression,\n): TsMorph.PropertyAccessExpression[] {\n  const chain: TsMorph.PropertyAccessExpression[] = [];\n  let current: TsMorph.Node = start;\n\n  for (;;) {\n    const parent = current.getParent();\n    if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) {\n      return chain;\n    }\n    chain.push(parent);\n    current = parent;\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,kBAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,WAAmC;CACvC,mBAAmB;CACnB,sBAAsB;CACtB,kBAAkB;CAClB,cAAc;CACd,cAAc;AAChB;;;;;;AAOA,MAAa,qBAA8B;CACzC,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,mBAAmB,YAAY,sBAAsB,YAAY,CAAC,CAAC,SAAS,GAAG;GAEnF,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,MAAM,QAAQ,OAAO,cAAc;IAEnC,IAAI,CAAC,KAAK,2BAA2B,KAAK,KAAK,MAAM,QAAQ,MAAM,WAAW;IAC9E,MAAM,SAAS,OAAO,QAAQ;IAC9B,IAAI,WAAW,aAAa,WAAW,YAAY;IAEnD,MAAM,QAAQ,YAAY,MAAM,MAAM;IACtC,IAAI,MAAM,WAAW,GAAG;IAExB,MAAM,QAAQ,MAAM;IACpB,MAAM,SAAS,MAAM;IACrB,MAAM,OAAO,SAAS,GAAG,MAAM,QAAQ,EAAE,GAAG,OAAO,QAAQ,MAAM;IACjE,MAAM,cAAc,OAAO,SAAS,QAAQ;IAE5C,IAAI,WAAW,aAAa,eAAe,QAAQ;KACjD,OAAO,MAAM,KACX,YACE,SACA,QACA,GAAG,OAAO,QAAQ,EAAE,GAAG,eACvB,mBAAmB,KAAK,qBAAqB,aAC/C,CACF;KACA;IACF;IAEA,MAAM,QAAQ,MAAM,QAAQ;IAC5B,MAAM,SAAS,KAAK,iBAAiB,MAAM,UAAU,CAAC;IAEtD,MAAM,mBAAmB,WAAW,aAAa,UAAU,WAAW,WAAW;IACjF,IAAI,CAAC,gBAAgB,IAAI,KAAK,KAAK,UAAU,kBAC3C,OAAO,OAAO,KACZ,SACE,SACA,OACA,aAAa,OAAO,GAAG,MAAM,sLAC/B,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF;;AAGA,SAAS,YACP,MACA,OACoC;CACpC,MAAM,QAA4C,CAAC;CACnD,IAAI,UAAwB;CAE5B,SAAS;EACP,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,CAAC,UAAU,CAAC,KAAK,2BAA2B,MAAM,KAAK,OAAO,cAAc,MAAM,SACpF,OAAO;EAET,MAAM,KAAK,MAAM;EACjB,UAAU;CACZ;AACF"}