styled-components-to-stylex-codemod 0.0.7 → 0.0.10

package/dist/logger-BLeJjMzG.mjs

@@ -0,0 +1,306 @@
+import { readFileSync } from "node:fs";
+
+//#region src/internal/public-api-validation.ts
+function describeValue(value) {
+	if (value === null) return "null";
+	if (value === void 0) return "undefined";
+	if (Array.isArray(value)) return `Array(${value.length})`;
+	if (typeof value === "string") return `"${value}"`;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	if (typeof value === "bigint") return value.toString();
+	if (typeof value === "symbol") return value.description ? `Symbol(${value.description})` : "Symbol()";
+	if (typeof value === "function") return "[Function]";
+	if (typeof value === "object") {
+		const ctor = value?.constructor?.name ?? "Object";
+		let keys = [];
+		try {
+			keys = Object.keys(value);
+		} catch {}
+		const preview = keys.slice(0, 5).join(", ");
+		const suffix = keys.length > 5 ? ", ..." : "";
+		return keys.length ? `${ctor} { ${preview}${suffix} }` : ctor;
+	}
+	return "[Unknown]";
+}
+function assertValidAdapter(candidate, where) {
+	const obj = candidate;
+	const resolveValue = obj?.resolveValue;
+	const resolveCall = obj?.resolveCall;
+	const resolveSelector = obj?.resolveSelector;
+	const externalInterface = obj?.externalInterface;
+	if (!candidate || typeof candidate !== "object") throw new Error([
+		`${where}: expected an adapter object.`,
+		`Received: ${describeValue(candidate)}`,
+		"",
+		"Adapter requirements:",
+		"  - adapter.resolveValue(context) is required",
+		"  - adapter.resolveCall(context) is required",
+		"  - adapter.resolveSelector(context) is required",
+		"  - adapter.externalInterface(context) is required",
+		"",
+		"resolveValue(context) is called with one of these shapes:",
+		"  - { kind: \"theme\", path }",
+		"  - { kind: \"cssVariable\", name, fallback?, definedValue? }",
+		"  - { kind: \"importedValue\", importedName, source, path? }",
+		"",
+		"resolveCall(context) is called with:",
+		"  - { callSiteFilePath, calleeImportedName, calleeSource, args }",
+		"",
+		"resolveSelector(context) is called with:",
+		"  - { kind: \"selectorInterpolation\", importedName, source, path? }",
+		"",
+		`Docs/examples: ${ADAPTER_DOCS_URL}`
+	].join("\n"));
+	if (typeof resolveValue !== "function") throw new Error([
+		`${where}: adapter.resolveValue must be a function.`,
+		`Received: resolveValue=${describeValue(resolveValue)}`,
+		"",
+		"Adapter shape:",
+		"  {",
+		"    resolveValue(context) {",
+		"      // theme/cssVariable -> { expr, imports, dropDefinition? } | null",
+		"    }",
+		"    resolveCall(context) { return { expr, imports } | null }",
+		"  }",
+		"",
+		`Docs/examples: ${ADAPTER_DOCS_URL}`
+	].join("\n"));
+	if (typeof resolveCall !== "function") throw new Error([
+		`${where}: adapter.resolveCall must be a function.`,
+		`Received: resolveCall=${describeValue(resolveCall)}`,
+		"",
+		"Adapter shape:",
+		"  {",
+		"    resolveCall(context) { return { expr: string, imports: ImportSpec[] } | null }",
+		"  }",
+		"",
+		`Docs/examples: ${ADAPTER_DOCS_URL}`
+	].join("\n"));
+	if (typeof resolveSelector !== "function") throw new Error([
+		`${where}: adapter.resolveSelector must be a function.`,
+		`Received: resolveSelector=${describeValue(resolveSelector)}`,
+		"",
+		"Adapter shape:",
+		"  {",
+		"    resolveSelector(context) { return { kind: \"media\", expr: string, imports: ImportSpec[] } | undefined }",
+		"  }",
+		"",
+		`Docs/examples: ${ADAPTER_DOCS_URL}`
+	].join("\n"));
+	if (typeof externalInterface !== "function") throw new Error([`${where}: adapter.externalInterface must be a function.`, `Received: externalInterface=${describeValue(externalInterface)}`].join("\n"));
+	const styleMerger = obj?.styleMerger;
+	if (styleMerger !== null && styleMerger !== void 0) {
+		if (typeof styleMerger !== "object") throw new Error([
+			`${where}: adapter.styleMerger must be null or an object.`,
+			`Received: styleMerger=${describeValue(styleMerger)}`,
+			"",
+			"Expected shape:",
+			"  {",
+			"    functionName: \"stylexProps\",",
+			"    importSource: { kind: \"specifier\", value: \"@company/ui-utils\" }",
+			"  }"
+		].join("\n"));
+		const { functionName, importSource } = styleMerger;
+		if (typeof functionName !== "string" || !functionName.trim()) throw new Error([`${where}: adapter.styleMerger.functionName must be a non-empty string.`, `Received: functionName=${describeValue(functionName)}`].join("\n"));
+		if (!importSource || typeof importSource !== "object") throw new Error([
+			`${where}: adapter.styleMerger.importSource must be an object.`,
+			`Received: importSource=${describeValue(importSource)}`,
+			"",
+			"Expected shape:",
+			"  { kind: \"specifier\", value: \"@company/ui-utils\" }",
+			"  or",
+			"  { kind: \"absolutePath\", value: \"/path/to/module.ts\" }"
+		].join("\n"));
+		const { kind, value } = importSource;
+		if (kind !== "specifier" && kind !== "absolutePath") throw new Error([`${where}: adapter.styleMerger.importSource.kind must be "specifier" or "absolutePath".`, `Received: kind=${describeValue(kind)}`].join("\n"));
+		if (typeof value !== "string" || !value.trim()) throw new Error([`${where}: adapter.styleMerger.importSource.value must be a non-empty string.`, `Received: value=${describeValue(value)}`].join("\n"));
+	}
+}
+const ADAPTER_DOCS_URL = `https://github.com/skovhus/styled-components-to-stylex-codemod#adapter`;
+
+//#endregion
+//#region src/internal/logger.ts
+/**
+* Logger and warning types for transform diagnostics.
+* Core concepts: severity classification and source context reporting.
+*/
+var Logger = class Logger {
+	/**
+	* Log a warning message to stdout.
+	* All codemod warnings go through this so tests can mock it.
+	*/
+	static warn(message, context) {
+		Logger.writeWithSpacing(message, context);
+	}
+	/**
+	* Log an error message to stdout with file path and optional location.
+	* Formats like warnings: "Error filepath:line:column\nmessage"
+	*/
+	static logError(message, filePath, loc, context) {
+		const location = loc ? `${filePath}:${loc.line}:${loc.column}` : filePath;
+		const label = Logger.colorizeErrorLabel("Error");
+		Logger.writeWithSpacing(`${label} ${location}\n${message}`, context);
+	}
+	/**
+	* Log transform warnings to stdout and collect them.
+	*/
+	static logWarnings(warnings, filePath) {
+		for (const warning of warnings) {
+			Logger.collected.push({
+				...warning,
+				filePath
+			});
+			const location = warning.loc ? `${filePath}:${warning.loc.line}:${warning.loc.column}` : `${filePath}`;
+			const label = Logger.colorizeSeverityLabel(warning.severity);
+			Logger.writeWithSpacing(`${label} ${location}\n${warning.type}`, warning.context);
+		}
+	}
+	/**
+	* Create a report from all collected warnings.
+	*/
+	static createReport() {
+		return new LoggerReport([...Logger.collected]);
+	}
+	/** @internal - for testing only */
+	static _clearCollected() {
+		Logger.collected = [];
+	}
+	static collected = [];
+	static writeWithSpacing(message, context) {
+		const trimmed = message.replace(/\s+$/u, "");
+		const serialized = Logger.formatContext(context);
+		process.stdout.write(`${trimmed}${serialized ? `\n${serialized}` : ""}\n\n`);
+	}
+	static colorizeSeverityLabel(severity) {
+		if (severity === "error") return Logger.colorizeErrorLabel("Error");
+		if (severity === "info") return Logger.colorizeInfoLabel("Info");
+		return Logger.colorizeWarnLabel("Warning");
+	}
+	static colorizeWarnLabel(label) {
+		if (!process.stdout.isTTY) return label;
+		return `${WARN_BG_COLOR}${WARN_TEXT_COLOR}${label}${RESET_COLOR}`;
+	}
+	static colorizeErrorLabel(label) {
+		if (!process.stdout.isTTY) return label;
+		return `${ERROR_BG_COLOR}${ERROR_TEXT_COLOR}${label}${RESET_COLOR}`;
+	}
+	static colorizeInfoLabel(label) {
+		if (!process.stdout.isTTY) return label;
+		return `${INFO_BG_COLOR}${INFO_TEXT_COLOR}${label}${RESET_COLOR}`;
+	}
+	static formatContext(context) {
+		if (typeof context === "undefined") return null;
+		return JSON.stringify(context, null, 2);
+	}
+};
+var LoggerReport = class {
+	warnings;
+	fileCache = /* @__PURE__ */ new Map();
+	constructor(warnings) {
+		this.warnings = warnings;
+	}
+	getWarnings() {
+		return this.warnings;
+	}
+	/**
+	* Get the formatted report as a string.
+	*/
+	toString() {
+		if (this.warnings.length === 0) return "";
+		const lines = [];
+		const groups = this.groupWarnings();
+		lines.push("");
+		lines.push("─".repeat(60));
+		lines.push(`Warning Summary: ${this.warnings.length} warning(s) in ${groups.length} category(s)`);
+		lines.push("─".repeat(60));
+		const MAX_EXAMPLES = 15;
+		for (const group of groups) {
+			lines.push("");
+			lines.push(`▸ ${group.message} (${group.warnings.length})`);
+			lines.push("");
+			const seenFiles = /* @__PURE__ */ new Set();
+			const uniqueLocations = [];
+			for (const loc of group.warnings) if (!seenFiles.has(loc.filePath)) {
+				seenFiles.add(loc.filePath);
+				uniqueLocations.push(loc);
+			}
+			const displayed = uniqueLocations.slice(0, MAX_EXAMPLES);
+			for (const loc of displayed) {
+				const location = loc.loc ? `${loc.filePath}:${loc.loc.line}:${loc.loc.column}` : loc.filePath;
+				lines.push(`  ${location}`);
+				if (loc.snippet) lines.push(loc.snippet);
+				lines.push("");
+			}
+			const remaining = uniqueLocations.length - MAX_EXAMPLES;
+			if (remaining > 0) {
+				lines.push(`  ... and ${remaining} more file(s)`);
+				lines.push("");
+			}
+		}
+		return lines.join("\n");
+	}
+	/**
+	* Print the formatted warning report to stdout.
+	*/
+	print() {
+		const output = this.toString();
+		if (output) {
+			const colored = output.replace(/▸ (.+?) \((\d+)\)/g, `${SECTION_COLOR}▸ $1 ($2)${RESET_COLOR}`);
+			process.stdout.write(colored + "\n");
+		}
+	}
+	groupWarnings() {
+		const groupMap = /* @__PURE__ */ new Map();
+		for (const warning of this.warnings) {
+			const enrichedWarning = {
+				...warning,
+				snippet: warning.loc ? this.getSnippet(warning.filePath, warning.loc) : void 0
+			};
+			const existing = groupMap.get(warning.type);
+			if (existing) existing.warnings.push(enrichedWarning);
+			else groupMap.set(warning.type, {
+				message: warning.type,
+				warnings: [enrichedWarning]
+			});
+		}
+		return Array.from(groupMap.values()).sort((a, b) => b.warnings.length - a.warnings.length);
+	}
+	getSnippet(filePath, loc) {
+		if (!loc) return;
+		const lines = this.getFileLines(filePath);
+		if (!lines) return;
+		const lineIndex = loc.line - 1;
+		if (lineIndex < 0 || lineIndex >= lines.length) return;
+		const snippetLines = [];
+		const startLine = Math.max(0, lineIndex - 2);
+		const endLine = Math.min(lines.length - 1, lineIndex + 4);
+		for (let i = startLine; i <= endLine; i++) {
+			const lineNum = String(i + 1).padStart(4, " ");
+			const marker = i === lineIndex ? ">" : " ";
+			snippetLines.push(`  ${marker} ${lineNum} | ${lines[i]}`);
+		}
+		return snippetLines.join("\n");
+	}
+	getFileLines(filePath) {
+		if (this.fileCache.has(filePath)) return this.fileCache.get(filePath) ?? null;
+		try {
+			const lines = readFileSync(filePath, "utf-8").split("\n");
+			this.fileCache.set(filePath, lines);
+			return lines;
+		} catch {
+			this.fileCache.set(filePath, null);
+			return null;
+		}
+	}
+};
+const WARN_BG_COLOR = "\x1B[43m";
+const WARN_TEXT_COLOR = "\x1B[30m";
+const ERROR_BG_COLOR = "\x1B[41m";
+const ERROR_TEXT_COLOR = "\x1B[37m";
+const INFO_BG_COLOR = "\x1B[44m";
+const INFO_TEXT_COLOR = "\x1B[37m";
+const SECTION_COLOR = "\x1B[36m";
+const RESET_COLOR = "\x1B[0m";
+
+//#endregion
+export { assertValidAdapter as n, describeValue as r, Logger as t };