styled-components-to-stylex-codemod 0.0.28 → 0.0.30

package/dist/{logger-Bt4qdjjb.mjs → adapter-BP7bn_pZ.mjs}

@@ -1,5 +1,3 @@
-import { readFileSync } from "node:fs";
-
 //#region src/internal/public-api-validation.ts
 function describeValue(value) {
 	if (value === null) return "null";
@@ -175,7 +173,6 @@ function assertFunctionNameAndImportSource(args) {
 	if (typeof value !== "string" || !value.trim()) throw new Error([`${where}: ${configPath}.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/adapter.ts
 /**
@@ -268,237 +265,5 @@ function defineAdapter(adapter) {
 	assertValidAdapterInput(adapter, "defineAdapter(adapter)");
 	return adapter;
 }
-
 //#endregion
-//#region src/internal/logger.ts
-/**
-* Logger and warning types for transform diagnostics.
-* Core concepts: severity classification and source context reporting.
-*/
-/**
-* When fileCount <= this threshold, warnings are printed per-file inline and
-* the summary is skipped. Above the threshold only the summary is printed.
-*/
-const FILE_COUNT_INLINE_THRESHOLD = 10;
-var Logger = class Logger {
-	/**
-	* Set the total number of files being transformed.
-	* Controls whether warnings are printed per-file or only in the summary.
-	*/
-	static setFileCount(count) {
-		Logger.fileCount = count;
-	}
-	/**
-	* Set the maximum number of examples shown per warning category in the summary.
-	*/
-	static setMaxExamples(count) {
-		Logger.maxExamples = count;
-	}
-	/**
-	* 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);
-	}
-	/**
-	* Mark an Error instance as already logged so downstream catch blocks can skip it.
-	*/
-	static markErrorAsLogged(e) {
-		if (e instanceof Error) Logger.loggedErrors.add(e);
-	}
-	/**
-	* Check whether an error was already logged via `markErrorAsLogged`.
-	*/
-	static isErrorLogged(e) {
-		return e instanceof Error && Logger.loggedErrors.has(e);
-	}
-	/**
-	* Log an error message to stdout with file path and optional location.
-	* Formats like warnings: "Error filepath:line:column\nmessage"
-	* Always prints regardless of file count.
-	*/
-	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);
-	}
-	/**
-	* Collect transform warnings and optionally print them per-file.
-	* Per-file output is shown when fileCount is unknown or <= threshold.
-	* When fileCount > threshold, warnings are only collected for the summary.
-	*/
-	static logWarnings(warnings, filePath) {
-		const printInline = Logger.fileCount === null || Logger.fileCount <= FILE_COUNT_INLINE_THRESHOLD;
-		for (const warning of warnings) {
-			Logger.collected.push({
-				...warning,
-				filePath
-			});
-			if (printInline) {
-				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], Logger.fileCount, Logger.maxExamples);
-	}
-	/** @internal - for testing only */
-	static _clearCollected() {
-		Logger.collected = [];
-		Logger.fileCount = null;
-		Logger.loggedErrors = /* @__PURE__ */ new WeakSet();
-	}
-	static collected = [];
-	static fileCount = null;
-	static maxExamples = 3;
-	static loggedErrors = /* @__PURE__ */ new WeakSet();
-	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;
-	fileCount;
-	maxExamples;
-	fileCache = /* @__PURE__ */ new Map();
-	constructor(warnings, fileCount, maxExamples = 3) {
-		this.warnings = warnings;
-		this.fileCount = fileCount;
-		this.maxExamples = maxExamples;
-	}
-	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 = this.maxExamples;
-		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.
-	* Skips the summary when fileCount <= threshold (warnings already shown inline).
-	*/
-	print() {
-		if (this.fileCount !== null && this.fileCount <= FILE_COUNT_INLINE_THRESHOLD) return;
-		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 a, isDirectionalResult as i, DEFAULT_THEME_HOOK as n, assertValidAdapterInput as o, defineAdapter as r, describeValue as s, Logger as t };
+export { assertValidAdapterInput as a, assertValidAdapter as i, defineAdapter as n, describeValue as o, isDirectionalResult as r, DEFAULT_THEME_HOOK as t };

package/dist/{bridge-consumer-patcher-yD2M8NhV.mjs → bridge-consumer-patcher-BbjyGr2R.mjs}

@@ -1,8 +1,7 @@
-import { n as escapeRegex } from "./string-utils-J3iaDsXd.mjs";
-import { t as toRealPath } from "./path-utils-CTsuWb5f.mjs";
-import { t as isSelectorContext } from "./selector-context-heuristic-CQgP_0dH.mjs";
+import { n as escapeRegex } from "./string-utils-5EMAWj3q.mjs";
+import { t as toRealPath } from "./path-utils-BlOXGcCF.mjs";
+import { t as isSelectorContext } from "./selector-context-heuristic-Dualf7ac.mjs";
 import { readFileSync } from "node:fs";
-
 //#region src/internal/bridge-consumer-patcher.ts
 /**
 * Post-transform consumer patching for global selector bridges.
@@ -120,6 +119,5 @@ function isInStyledTemplateSelectorContext(source, offset, length) {
 function hasExactImportName(importSpecifiers, name) {
 	return new RegExp(`(?:^|[^A-Za-z0-9_$])${escapeRegex(name)}(?:$|[^A-Za-z0-9_$])`).test(importSpecifiers);
 }
-
 //#endregion
-export { buildConsumerReplacements, patchConsumerFile };
+export { buildConsumerReplacements, patchConsumerFile };

package/dist/{forwarded-as-consumer-patcher-DobBjqdG.mjs → forwarded-as-consumer-patcher-Rd7QcRNR.mjs}

@@ -1,7 +1,6 @@
-import { n as escapeRegex } from "./string-utils-J3iaDsXd.mjs";
-import { t as toRealPath } from "./path-utils-CTsuWb5f.mjs";
+import { n as escapeRegex } from "./string-utils-5EMAWj3q.mjs";
+import { t as toRealPath } from "./path-utils-BlOXGcCF.mjs";
 import { readFileSync } from "node:fs";
-
 //#region src/internal/forwarded-as-consumer-patcher.ts
 /**
 * Post-transform consumer patching for `as` → `forwardedAs`.
@@ -77,6 +76,5 @@ function patchAttrsAsProp(source, componentName) {
 		return `${before}forwardedAs${after}`;
 	});
 }
-
 //#endregion
-export { buildForwardedAsReplacements, patchConsumerForwardedAs };
+export { buildForwardedAsReplacements, patchConsumerForwardedAs };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as defineAdapter, i as AdapterInput, t as CollectedWarning } from "./logger-DKOqU7as.mjs";
+import { a as defineAdapter, i as AdapterInput, t as CollectedWarning } from "./logger-BQnWs1On.mjs";
 
 //#region src/run.d.ts
 interface RunTransformOptions {
@@ -59,6 +59,11 @@ interface RunTransformOptions {
    * @default 3
    */
   maxExamples?: number;
+  /**
+   * Suppress jscodeshift runner output.
+   * @default false
+   */
+  silent?: boolean;
 }
 interface RunTransformResult {
   /** Number of files that had errors */

package/dist/index.mjs

@@ -1,11 +1,11 @@
-import { o as assertValidAdapterInput, r as defineAdapter, s as describeValue, t as Logger } from "./logger-Bt4qdjjb.mjs";
+import { a as assertValidAdapterInput, n as defineAdapter, o as describeValue } from "./adapter-BP7bn_pZ.mjs";
+import { t as Logger } from "./logger-C2O81VeU.mjs";
 import { run } from "jscodeshift/src/Runner.js";
 import { fileURLToPath } from "node:url";
 import { dirname, join, resolve } from "node:path";
 import { existsSync, readFileSync, realpathSync } from "node:fs";
 import { glob, writeFile } from "node:fs/promises";
 import { spawn } from "node:child_process";
-
 //#region src/run.ts
 /**
 * Runs the codemod over input files with an adapter.
@@ -141,9 +141,9 @@ async function runTransform(options) {
 		`Pattern(s): ${consumerPatterns.join(", ")}`,
 		"Check that the glob pattern is correct and files exist."
 	].join("\n"));
-	const { createModuleResolver } = await import("./resolve-imports-CN7ulI4X.mjs");
+	const { createModuleResolver } = await import("./resolve-imports-DKohVjNI.mjs");
 	const sharedResolver = createModuleResolver();
-	const { runPrepass } = await import("./run-prepass-BInfVTeK.mjs");
+	const { runPrepass } = await import("./run-prepass-4gxoyZ8y.mjs");
 	const absoluteFiles = filePaths.map((f) => resolve(f));
 	const absoluteConsumers = consumerFilePaths.map((f) => resolve(f));
 	let prepassResult;
@@ -230,11 +230,12 @@ async function runTransform(options) {
 		bridgeResults,
 		transformedFiles,
 		transientPropRenames,
-		runInBand: true
+		runInBand: true,
+		silent: options.silent ?? false
 	});
 	if (sidecarFiles.size > 0 && !dryRun) for (const [sidecarPath, content] of sidecarFiles) await writeFile(sidecarPath, mergeSidecarContent(sidecarPath, content), "utf-8");
 	if (bridgeResults.size > 0 && !dryRun) {
-		const { buildConsumerReplacements, patchConsumerFile } = await import("./bridge-consumer-patcher-yD2M8NhV.mjs");
+		const { buildConsumerReplacements, patchConsumerFile } = await import("./bridge-consumer-patcher-BbjyGr2R.mjs");
 		const consumerReplacements = buildConsumerReplacements(crossFilePrepassResult.selectorUsages, bridgeResults, transformedFiles);
 		const patchedFiles = [];
 		for (const [consumerPath, replacements] of consumerReplacements) {
@@ -247,7 +248,7 @@ async function runTransform(options) {
 		if (formatterCommands && patchedFiles.length > 0) await runFormatters(formatterCommands, patchedFiles);
 	}
 	if (prepassResult.forwardedAsConsumers.size > 0 && !dryRun) {
-		const { buildForwardedAsReplacements, patchConsumerForwardedAs } = await import("./forwarded-as-consumer-patcher-DobBjqdG.mjs");
+		const { buildForwardedAsReplacements, patchConsumerForwardedAs } = await import("./forwarded-as-consumer-patcher-Rd7QcRNR.mjs");
 		const forwardedAsReplacements = buildForwardedAsReplacements(prepassResult.forwardedAsConsumers, transformedFiles);
 		const patchedFiles = [];
 		for (const [consumerPath, entries] of forwardedAsReplacements) {
@@ -260,7 +261,7 @@ async function runTransform(options) {
 		if (formatterCommands && patchedFiles.length > 0) await runFormatters(formatterCommands, patchedFiles);
 	}
 	if (transientPropRenames.size > 0 && !dryRun) {
-		const { collectTransientPropPatches } = await import("./transient-prop-consumer-patcher-DAX9HWDH.mjs");
+		const { collectTransientPropPatches } = await import("./transient-prop-consumer-patcher-CeMJEJG9.mjs");
 		const patches = collectTransientPropPatches({
 			transientPropRenames,
 			consumerFilePaths: consumerFilePaths.map((p) => resolve(p)),
@@ -349,6 +350,5 @@ async function runFormatters(commands, files) {
 		}
 	}
 }
-
 //#endregion
-export { defineAdapter, runTransform };
+export { defineAdapter, runTransform };

package/dist/{logger-DKOqU7as.d.mts → logger-BQnWs1On.d.mts}

@@ -260,6 +260,19 @@ type CallResolveResultWithExpr = {
    * - Theme access in the original call is rewritten to use the wrapper `useTheme()` value.
    */
   preserveRuntimeCall?: boolean;
+  /**
+   * Additional className expressions to merge into the component's className attribute.
+   *
+   * Used for CSS modules or other class-based styles that StyleX cannot express
+   * (child selectors like `& > *`, ancestor selectors like `html:not(.class) &`, etc.).
+   *
+   * Each entry provides an expression string (e.g., `cssModuleStyles.myClass`)
+   * and its required imports.
+   *
+   * When present, the codemod merges these expressions into the rendered element's
+   * className alongside any existing static className from `.attrs()` or bridge classes.
+   */
+  extraClassNames?: ExprWithImports[];
 };
 type CallResolveRuntimeOnlyResult = {
   /**
@@ -275,7 +288,17 @@ type CallResolveRuntimeOnlyResult = {
    */
   usage?: "create";
 };
-type CallResolveResult = CallResolveResultWithExpr | CallResolveRuntimeOnlyResult;
+/**
+ * Resolved result containing only className expressions (no StyleX style object).
+ * Used for CSS modules or other class-based styles that StyleX cannot express.
+ */
+type CallResolveClassNamesResult = {
+  /**
+   * className expressions to merge into the component's className attribute.
+   */
+  extraClassNames: ExprWithImports[];
+};
+type CallResolveResult = CallResolveResultWithExpr | CallResolveRuntimeOnlyResult | CallResolveClassNamesResult;
 type ImportSource = {
   kind: "absolutePath";
   value: string;
@@ -290,6 +313,11 @@ type ImportSpec = {
     local?: string;
   }>;
 };
+/** An expression string with its required imports, used for className emission. */
+type ExprWithImports = {
+  expr: string;
+  imports: ImportSpec[];
+};
 type ResolveBaseComponentStaticValue = string | number | boolean;
 interface ResolveBaseComponentContext {
   /**
@@ -690,7 +718,7 @@ declare function defineAdapter<T extends AdapterInput>(adapter: T): T;
 //#endregion
 //#region src/internal/logger.d.ts
 type Severity = "info" | "warning" | "error";
-type WarningType = "`css` helper function switch must return css templates in all branches" | "`css` helper usage as a function call (css(...)) is not supported" | "`css` helper used outside of a styled component template cannot be statically transformed" | "Adapter helper call in border interpolation did not resolve to a single CSS value" | "Adapter resolveCall returned an unparseable styles expression" | "Adapter resolveCall returned an unparseable value expression" | "Adapter resolveCall returned StyleX styles for helper call where a CSS value was expected" | "Adapter resolveCall returned undefined for helper call" | "Adapter resolveBaseComponent threw an error" | "Adapter resolved StyleX styles cannot be applied under nested selectors/at-rules" | "Adapter resolved StyleX styles inside pseudo selector but did not provide cssText for property expansion — add cssText to resolveCall result to enable pseudo-wrapping" | 'Adapter resolveCall cssText could not be parsed as CSS declarations — expected semicolon-separated property: value pairs (e.g. "white-space: nowrap; overflow: hidden;")' | "Adapter resolveValue returned an unparseable value expression" | "Adapter resolveValue returned undefined for imported value" | "Arrow function: body is not a recognized pattern (expected ternary, logical, call, or member expression)" | "Arrow function: conditional branches could not be resolved to static or theme values" | "Arrow function: helper call body is not supported" | "Arrow function: indexed theme lookup pattern not matched" | "Arrow function: logical expression pattern not supported" | "Arrow function: prop access cannot be converted to style function for this CSS property" | "Arrow function: theme access path could not be resolved" | "Component selectors like `${OtherComponent}:hover &` are not directly representable in StyleX. Manual refactor is required" | "Conditional `css` block: !important is not supported in StyleX" | "Conditional `css` block: @-rules (e.g., @media, @supports) are not supported" | "CSS block contains unsupported at-rule (only @media and @container are supported; @supports, etc. require manual handling)" | "Conditional `css` block: dynamic interpolation could not be resolved to a single component prop" | "Conditional `css` block: failed to parse expression" | "Conditional `css` block: missing CSS property name" | "Conditional `css` block: missing interpolation expression" | "Conditional `css` block: mixed static/dynamic values with non-theme expressions cannot be safely transformed" | "Conditional `css` block: multiple interpolation slots in a single property value" | "Conditional `css` block: ternary branch value could not be resolved (imported values require adapter support)" | "Conditional `css` block: ternary expressions inside pseudo selectors are not supported" | "Conditional `css` block: media query interpolation must be a simple imported reference (expressions like `value + 1` are not supported)" | "Conditional `css` block: unsupported selector" | "Directional border helper styles are not supported" | "Multi-slot border interpolation could not be resolved" | "Resolved border helper value could not be expanded to longhand properties" | "Resolved conditional border variant could not be expanded to longhand properties" | "createGlobalStyle is not supported in StyleX. Global styles should be handled separately (e.g., in a CSS file or using CSS reset libraries)" | "Dynamic styles inside pseudo elements (::before/::after) are not supported by StyleX. See https://github.com/facebook/stylex/issues/1396" | "Failed to parse theme expressions" | "Heterogeneous background values (mix of gradients and colors) not currently supported" | "Higher-order styled factory wrappers (e.g. hoc(styled)) are not supported" | "Imported CSS helper mixins: cannot determine inherited properties for correct pseudo selector handling" | "Local helper function returns CSS that cannot be decomposed into individual properties" | "Local helper function computes CSS values that cannot be statically traced to the component prop" | "Styled-components specificity hacks like `&&` / `&&&` are not representable in StyleX" | "Theme-dependent block-level conditional could not be fully resolved (branches may contain dynamic interpolations)" | "Theme-dependant call expression could not be resolved (e.g. theme helper calls like theme.highlight() are not supported)" | "Theme value with fallback (props.theme.X ?? / || default) cannot be resolved statically — use adapter.resolveValue to map theme paths to StyleX tokens" | "Theme-dependent nested prop access requires a project-specific theme source (e.g. useTheme())" | "Theme-dependent template literals require a project-specific theme source (e.g. useTheme())" | "Theme prop overrides on styled components are not supported" | "Universal selectors (`*`) are currently unsupported" | "Unsupported call expression (expected imported helper(...) or imported helper(...)(...))" | "Unsupported conditional test in shouldForwardProp" | "Unsupported shouldForwardProp pattern (only !prop.startsWith(), ![].includes(prop), and prop !== are supported)" | "Unsupported interpolation: arrow function" | "Unsupported interpolation: call expression" | "Unsupported interpolation: identifier" | "Unsupported interpolation: member expression" | "Unsupported interpolation: property" | "Unsupported interpolation: unknown" | "Unsupported nested conditional interpolation" | "Unsupported prop-based inline style expression cannot be safely inlined" | "Unsupported prop-based inline style props.theme access is not supported" | "Unsupported selector interpolation: imported value in selector position" | "Unsupported: media query interpolation must be a simple imported reference (expressions like `value + 1` are not supported)" | "Unsupported selector: class selector" | "Unsupported selector: comma-separated selectors must all be simple pseudos or pseudo-elements" | "Unsupported selector: descendant pseudo selector (space before pseudo)" | "Unsupported selector: descendant/child/sibling selector" | "Unsupported selector: interpolated pseudo selector" | "Unsupported selector: sibling combinator" | "Unsupported selector: unresolved interpolation in sibling selector" | "Unsupported selector: ambiguous element selector" | "Unsupported selector: attribute selector on unsupported element" | "Unsupported selector: element selector on exported component" | "Unsupported selector: element selector with combined ancestor and child pseudos" | "Unsupported selector: element selector with dynamic children" | "Unsupported selector: element selector with plain intrinsic children" | "Unsupported selector: element selector pseudo collision" | "Unsupported selector: cross-file component selector target has no JSX usage in this file" | "Unsupported selector: unresolved interpolation in cross-file component selector" | "Unsupported selector: unresolved interpolation in descendant component selector" | "Unsupported selector: unresolved interpolation in element selector" | "Unsupported selector: unresolved interpolation in reverse component selector" | "Unsupported selector: grouped reverse selector references different components" | "Unsupported selector: unknown component selector" | "Unsupported css`` mixin: after-base mixin style is not a plain object" | "Unsupported css`` mixin: nested contextual conditions in after-base mixin" | "Unsupported css`` mixin: cannot infer base default for after-base contextual override (base value is non-literal)" | "css`` helper function interpolation references closure variable that cannot be hoisted" | "Sibling selector broadened: & + & (adjacent) becomes general sibling (~) in StyleX — interleaved non-matching elements will no longer block the match" | "Using styled-components components as mixins is not supported; use css`` mixins or strings instead" | "styled(ImportedComponent) wraps a component whose file contains internal styled-components — convert the base component's file first to avoid CSS cascade conflicts" | "Transient $-prefixed props renamed on exported component — update consumer call sites to use the new prop names" | "Shorthand property has an opaque value that StyleX will expand to longhands — use `directional` in resolveValue to return separate longhand tokens";
+type WarningType = "`css` helper function switch must return css templates in all branches" | "`css` helper usage as a function call (css(...)) is not supported" | "`css` helper used outside of a styled component template cannot be statically transformed" | "Adapter helper call in border interpolation did not resolve to a single CSS value" | "Adapter resolveCall returned an unparseable styles expression" | "Adapter resolveCall returned an unparseable value expression" | "Adapter resolveCall returned StyleX styles for helper call where a CSS value was expected" | "Adapter resolveCall returned undefined for helper call" | "Adapter resolveBaseComponent threw an error" | "Adapter resolved StyleX styles cannot be applied under nested selectors/at-rules" | "Adapter resolved StyleX styles inside pseudo selector but did not provide cssText for property expansion — add cssText to resolveCall result to enable pseudo-wrapping" | 'Adapter resolveCall cssText could not be parsed as CSS declarations — expected semicolon-separated property: value pairs (e.g. "white-space: nowrap; overflow: hidden;")' | "Adapter resolveValue returned an unparseable value expression" | "Adapter resolveValue returned undefined for imported value" | "Arrow function: body is not a recognized pattern (expected ternary, logical, call, or member expression)" | "Arrow function: conditional branches could not be resolved to static or theme values" | "Arrow function: helper call body is not supported" | "Arrow function: indexed theme lookup pattern not matched" | "Arrow function: logical expression pattern not supported" | "Arrow function: prop access cannot be converted to style function for this CSS property" | "Arrow function: theme access path could not be resolved" | "Component selectors like `${OtherComponent}:hover &` are not directly representable in StyleX. Manual refactor is required" | "Conditional `css` block: !important is not supported in StyleX" | "Conditional `css` block: @-rules (e.g., @media, @supports) are not supported" | "CSS block contains unsupported at-rule (only @media and @container are supported; @supports, etc. require manual handling)" | "Conditional `css` block: dynamic interpolation could not be resolved to a single component prop" | "Conditional `css` block: failed to parse expression" | "Conditional `css` block: missing CSS property name" | "Conditional `css` block: missing interpolation expression" | "Conditional `css` block: mixed static/dynamic values with non-theme expressions cannot be safely transformed" | "Conditional `css` block: multiple interpolation slots in a single property value" | "Conditional `css` block: ternary branch value could not be resolved (imported values require adapter support)" | "Conditional `css` block: ternary expressions inside pseudo selectors are not supported" | "Conditional `css` block: media query interpolation must be a simple imported reference (expressions like `value + 1` are not supported)" | "Conditional `css` block: unsupported selector" | "Directional border helper styles are not supported" | "Multi-slot border interpolation could not be resolved" | "Resolved border helper value could not be expanded to longhand properties" | "Resolved conditional border variant could not be expanded to longhand properties" | "createGlobalStyle is not supported in StyleX. Global styles should be handled separately (e.g., in a CSS file or using CSS reset libraries)" | "Failed to parse theme expressions" | "Heterogeneous background values (mix of gradients and colors) not currently supported" | "Higher-order styled factory wrappers (e.g. hoc(styled)) are not supported" | "Imported CSS helper mixins: cannot determine inherited properties for correct pseudo selector handling" | "Local helper function returns CSS that cannot be decomposed into individual properties" | "Local helper function computes CSS values that cannot be statically traced to the component prop" | "Styled-components specificity hacks like `&&` / `&&&` are not representable in StyleX" | "Theme-dependent block-level conditional could not be fully resolved (branches may contain dynamic interpolations)" | "Theme-dependant call expression could not be resolved (e.g. theme helper calls like theme.highlight() are not supported)" | "Theme value with fallback (props.theme.X ?? / || default) cannot be resolved statically — use adapter.resolveValue to map theme paths to StyleX tokens" | "Theme-dependent nested prop access requires a project-specific theme source (e.g. useTheme())" | "Theme-dependent template literals require a project-specific theme source (e.g. useTheme())" | "Theme prop overrides on styled components are not supported" | "Universal selectors (`*`) are currently unsupported" | "Unsupported call expression (expected imported helper(...) or imported helper(...)(...))" | "Unsupported conditional test in shouldForwardProp" | "Unsupported shouldForwardProp pattern (only !prop.startsWith(), ![].includes(prop), and prop !== are supported)" | "Unsupported interpolation: arrow function" | "Unsupported interpolation: call expression" | "Unsupported interpolation: identifier" | "Unsupported interpolation: member expression" | "Unsupported interpolation: property" | "Unsupported interpolation: unknown" | "Unsupported nested conditional interpolation" | "Unsupported prop-based inline style expression cannot be safely inlined" | "Unsupported prop-based inline style props.theme access is not supported" | "Unsupported selector interpolation: imported value in selector position" | "Unsupported: media query interpolation must be a simple imported reference (expressions like `value + 1` are not supported)" | "Unsupported selector: class selector" | "Unsupported selector: comma-separated selectors must all be simple pseudos or pseudo-elements" | "Unsupported selector: descendant pseudo selector (space before pseudo)" | "Unsupported selector: descendant/child/sibling selector" | "Unsupported selector: interpolated pseudo selector" | "Unsupported selector: sibling combinator" | "Unsupported selector: unresolved interpolation in sibling selector" | "Unsupported selector: ambiguous element selector" | "Unsupported selector: attribute selector on unsupported element" | "Unsupported selector: element selector on exported component" | "Unsupported selector: element selector with combined ancestor and child pseudos" | "Unsupported selector: element selector with dynamic children" | "Unsupported selector: element selector with plain intrinsic children" | "Unsupported selector: element selector pseudo collision" | "Unsupported selector: cross-file component selector target has no JSX usage in this file" | "Unsupported selector: unresolved interpolation in cross-file component selector" | "Unsupported selector: unresolved interpolation in descendant component selector" | "Unsupported selector: unresolved interpolation in element selector" | "Unsupported selector: unresolved interpolation in reverse component selector" | "Unsupported selector: unresolved interpolation in cross-component sibling selector" | "Unsupported selector: grouped reverse selector references different components" | "Unsupported selector: computed media query inside cross-component sibling selector" | "Unsupported selector: computed media query inside sibling selector" | "Unsupported selector: unknown component selector" | "Unsupported css`` mixin: after-base mixin style is not a plain object" | "Unsupported css`` mixin: nested contextual conditions in after-base mixin" | "Unsupported css`` mixin: cannot infer base default for after-base contextual override (base value is non-literal)" | "css`` helper function interpolation references closure variable that cannot be hoisted" | "Using styled-components components as mixins is not supported; use css`` mixins or strings instead" | "styled(ImportedComponent) wraps a component whose file contains internal styled-components — convert the base component's file first to avoid CSS cascade conflicts" | "Transient $-prefixed props renamed on exported component — update consumer call sites to use the new prop names" | "Shorthand property has an opaque value that StyleX will expand to longhands — use `directional` in resolveValue to return separate longhand tokens";
 interface WarningLog {
   severity: Severity;
   type: WarningType;