styled-components-to-stylex-codemod 0.0.13 → 0.0.15

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { n as assertValidAdapter, r as describeValue, t as Logger } from "./logger-D3j-qxgZ.mjs";
+import { i as describeValue, r as assertValidAdapterInput, t as Logger } from "./logger-D-R2KB6I.mjs";
 import { run } from "jscodeshift/src/Runner.js";
 import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-import { existsSync } from "node:fs";
-import { glob } from "node:fs/promises";
+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/adapter.ts
@@ -63,7 +63,7 @@ import { spawn } from "node:child_process";
 *   });
 */
 function defineAdapter(adapter) {
-	assertValidAdapter(adapter, "defineAdapter(adapter)");
+	assertValidAdapterInput(adapter, "defineAdapter(adapter)");
 	return adapter;
 }
 
@@ -94,6 +94,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 *
 * await runTransform({
 *   files: 'src/**\/*.tsx',
+*   consumerPaths: null,
 *   adapter,
 *   dryRun: true,
 * });
@@ -108,7 +109,7 @@ async function runTransform(options) {
 		"Example (plain JS):",
 		"  import { runTransform, defineAdapter } from \"styled-components-to-stylex-codemod\";",
 		"  const adapter = defineAdapter({ resolveValue() { return null; } });",
-		"  await runTransform({ files: \"src/**/*.tsx\", adapter });"
+		"  await runTransform({ files: \"src/**/*.tsx\", consumerPaths: null, adapter });"
 	].join("\n"));
 	const filesValue = options.files;
 	if (typeof filesValue !== "string" && !Array.isArray(filesValue)) throw new Error([
@@ -121,47 +122,52 @@ async function runTransform(options) {
 		if (filesValue.length === 0) throw new Error(["runTransform(options): `files` must not be an empty array.", "Example: files: [\"src/**/*.ts\", \"src/**/*.tsx\"]"].join("\n"));
 		if (filesValue.find((p) => typeof p !== "string" || p.trim() === "") !== void 0) throw new Error(["runTransform(options): `files` array must contain non-empty strings.", `Received: files=${describeValue(filesValue)}`].join("\n"));
 	}
-	const { files, dryRun = false, print = false, parser = "tsx", formatterCommands, maxExamples } = options;
+	if (options.consumerPaths === void 0) throw new Error([
+		"runTransform(options): `consumerPaths` is required.",
+		"Pass a glob pattern to enable cross-file selector scanning, or `null` to opt out.",
+		"Example: consumerPaths: \"src/**/*.tsx\"  // scan for cross-file usage",
+		"Example: consumerPaths: null             // opt out"
+	].join("\n"));
+	const { files, consumerPaths: consumerPathsOption, dryRun = false, print = false, parser = "tsx", formatterCommands, maxExamples } = options;
 	if (maxExamples !== void 0) Logger.setMaxExamples(maxExamples);
-	const adapter = options.adapter;
-	assertValidAdapter(adapter, "runTransform(options)");
+	const adapterInput = options.adapter;
+	assertValidAdapterInput(adapterInput, "runTransform(options)");
+	if (adapterInput.externalInterface === "auto" && consumerPathsOption === null) throw new Error([
+		"runTransform(options): externalInterface is \"auto\" but consumerPaths is null.",
+		"Auto-detection needs consumer file globs to scan for styled(Component) and as-prop usage.",
+		"Example: consumerPaths: \"src/**/*.tsx\""
+	].join("\n"));
 	const resolveValueWithLogging = (ctx) => {
 		try {
-			return adapter.resolveValue(ctx);
+			return adapterInput.resolveValue(ctx);
 		} catch (e) {
 			const msg = `adapter.resolveValue threw an error: ${e instanceof Error ? e.message : String(e)}`;
 			const filePath = ctx.filePath ?? "<unknown>";
 			Logger.logError(msg, filePath, ctx.loc, ctx);
+			Logger.markErrorAsLogged(e);
 			throw e;
 		}
 	};
 	const resolveCallWithLogging = (ctx) => {
 		try {
-			return adapter.resolveCall(ctx);
+			return adapterInput.resolveCall(ctx);
 		} catch (e) {
 			const msg = `adapter.resolveCall threw an error: ${e instanceof Error ? e.message : String(e)}`;
 			Logger.logError(msg, ctx.callSiteFilePath, ctx.loc, ctx);
+			Logger.markErrorAsLogged(e);
 			throw e;
 		}
 	};
 	const resolveSelectorWithLogging = (ctx) => {
 		try {
-			return adapter.resolveSelector(ctx);
+			return adapterInput.resolveSelector(ctx);
 		} catch (e) {
 			const msg = `adapter.resolveSelector threw an error: ${e instanceof Error ? e.message : String(e)}`;
 			Logger.logError(msg, ctx.filePath, ctx.loc, ctx);
+			Logger.markErrorAsLogged(e);
 			throw e;
 		}
 	};
-	const adapterWithLogging = {
-		styleMerger: adapter.styleMerger,
-		externalInterface(ctx) {
-			return adapter.externalInterface(ctx);
-		},
-		resolveValue: resolveValueWithLogging,
-		resolveCall: resolveCallWithLogging,
-		resolveSelector: resolveSelectorWithLogging
-	};
 	const patterns = Array.isArray(files) ? files : [files];
 	const filePaths = [];
 	const cwd = process.cwd();
@@ -178,7 +184,73 @@ async function runTransform(options) {
 		};
 	}
 	Logger.setFileCount(filePaths.length);
-	const result = await run((() => {
+	const consumerPatterns = consumerPathsOption ? Array.isArray(consumerPathsOption) ? consumerPathsOption : [consumerPathsOption] : [];
+	const consumerFilePaths = [];
+	for (const pattern of consumerPatterns) for await (const file of glob(pattern, { cwd })) consumerFilePaths.push(file);
+	if (consumerPatterns.length > 0 && consumerFilePaths.length === 0) throw new Error([
+		"runTransform(options): consumerPaths matched no files.",
+		`Pattern(s): ${consumerPatterns.join(", ")}`,
+		"Check that the glob pattern is correct and files exist."
+	].join("\n"));
+	const { createModuleResolver } = await import("./resolve-imports-BDk6Ms09.mjs");
+	const sharedResolver = createModuleResolver();
+	const { runPrepass } = await import("./run-prepass-BcidTT9f.mjs");
+	const absoluteFiles = filePaths.map((f) => resolve(f));
+	const absoluteConsumers = consumerFilePaths.map((f) => resolve(f));
+	let prepassResult;
+	try {
+		prepassResult = await runPrepass({
+			filesToTransform: absoluteFiles,
+			consumerPaths: absoluteConsumers,
+			resolver: sharedResolver,
+			parserName: parser,
+			createExternalInterface: adapterInput.externalInterface === "auto",
+			enableAstCache: true
+		});
+	} catch (err) {
+		if (adapterInput.externalInterface === "auto") throw createAutoPrepassFailureError(err, consumerPatterns, parser);
+		Logger.warn(`Prepass failed, continuing without cross-file analysis: ${err instanceof Error ? err.message : String(err)}`);
+		prepassResult = {
+			crossFileInfo: {
+				selectorUsages: /* @__PURE__ */ new Map(),
+				componentsNeedingMarkerSidecar: /* @__PURE__ */ new Map(),
+				componentsNeedingGlobalSelectorBridge: /* @__PURE__ */ new Map()
+			},
+			consumerAnalysis: void 0
+		};
+	}
+	const crossFilePrepassResult = prepassResult.crossFileInfo;
+	const resolvedAdapter = (() => {
+		if (adapterInput.externalInterface === "auto" && prepassResult.consumerAnalysis) {
+			const analysisMap = prepassResult.consumerAnalysis;
+			return {
+				...adapterInput,
+				externalInterface: (ctx) => {
+					let realPath;
+					try {
+						realPath = realpathSync(resolve(ctx.filePath));
+					} catch {
+						realPath = resolve(ctx.filePath);
+					}
+					return analysisMap.get(`${realPath}:${ctx.componentName}`) ?? {
+						styles: false,
+						as: false
+					};
+				}
+			};
+		}
+		return adapterInput;
+	})();
+	const adapterWithLogging = {
+		styleMerger: resolvedAdapter.styleMerger,
+		externalInterface(ctx) {
+			return resolvedAdapter.externalInterface(ctx);
+		},
+		resolveValue: resolveValueWithLogging,
+		resolveCall: resolveCallWithLogging,
+		resolveSelector: resolveSelectorWithLogging
+	};
+	const transformPath = (() => {
 		const adjacent = join(__dirname, "transform.mjs");
 		if (existsSync(adjacent)) return adjacent;
 		const distSibling = join(__dirname, "..", "dist", "transform.mjs");
@@ -189,31 +261,34 @@ async function runTransform(options) {
 			`       ${distSibling}`,
 			"Run `pnpm build` to generate dist artifacts."
 		].join("\n"));
-	})(), filePaths, {
+	})();
+	const sidecarFiles = /* @__PURE__ */ new Map();
+	const bridgeResults = /* @__PURE__ */ new Map();
+	const result = await run(transformPath, filePaths, {
 		parser,
 		dry: dryRun,
 		print,
 		adapter: adapterWithLogging,
+		crossFilePrepassResult,
+		sidecarFiles,
+		bridgeResults,
 		runInBand: true
 	});
-	if (formatterCommands && formatterCommands.length > 0 && result.ok > 0 && !dryRun) for (const formatterCommand of formatterCommands) {
-		const [cmd, ...cmdArgs] = formatterCommand.split(/\s+/);
-		if (cmd) try {
-			await new Promise((resolve, reject) => {
-				const proc = spawn(cmd, [...cmdArgs, ...filePaths], {
-					stdio: "inherit",
-					shell: true
-				});
-				proc.on("close", (code) => {
-					if (code === 0) resolve();
-					else reject(/* @__PURE__ */ new Error(`Formatter command exited with code ${code}`));
-				});
-				proc.on("error", reject);
-			});
-		} catch (e) {
-			Logger.warn(`Formatter command failed: ${e instanceof Error ? e.message : String(e)}`);
+	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-D3fRIEkZ.mjs");
+		const consumerReplacements = buildConsumerReplacements(crossFilePrepassResult.selectorUsages, bridgeResults);
+		const patchedFiles = [];
+		for (const [consumerPath, replacements] of consumerReplacements) {
+			const patched = patchConsumerFile(consumerPath, replacements);
+			if (patched !== null) {
+				await writeFile(consumerPath, patched, "utf-8");
+				patchedFiles.push(consumerPath);
+			}
 		}
+		if (formatterCommands && patchedFiles.length > 0) await runFormatters(formatterCommands, patchedFiles);
 	}
+	if (formatterCommands && formatterCommands.length > 0 && result.ok > 0 && !dryRun) await runFormatters(formatterCommands, filePaths);
 	const report = Logger.createReport();
 	report.print();
 	return {
@@ -225,6 +300,70 @@ async function runTransform(options) {
 		warnings: report.getWarnings()
 	};
 }
+function createAutoPrepassFailureError(err, consumerPatterns, parser) {
+	const reason = err instanceof Error ? err.message : String(err);
+	return new Error([
+		"runTransform(options): prepass failed while using externalInterface: \"auto\".",
+		"\"auto\" depends on successful prepass scanning and cannot continue without it.",
+		`Underlying error: ${reason}`,
+		"",
+		"Troubleshooting:",
+		"  - Verify `consumerPaths` glob(s) and file syntax.",
+		`  - Confirm parser setting matches your code (current parser: ${JSON.stringify(parser)}).`,
+		"  - Check module resolution inputs (tsconfig paths / imports).",
+		"  - Use a manual `externalInterface(ctx)` function to continue without auto-detection.",
+		"",
+		`consumerPaths: ${consumerPatterns.length > 0 ? consumerPatterns.join(", ") : "(none)"}`
+	].join("\n"));
+}
+/**
+* Merge new sidecar marker content into an existing .stylex.ts file, preserving
+* user-owned exports (e.g. defineVars). If the file doesn't exist, returns content as-is.
+*
+* New marker declarations (`export const XMarker = stylex.defineMarker()`) are
+* appended only if they don't already exist in the file. The stylex import is
+* ensured at the top.
+*/
+function mergeSidecarContent(sidecarPath, newContent) {
+	let existing;
+	try {
+		existing = readFileSync(sidecarPath, "utf-8");
+	} catch {
+		return newContent;
+	}
+	const markerLineRe = /^export const \w+ = stylex\.defineMarker\(\);$/gm;
+	const newMarkers = [];
+	for (const m of newContent.matchAll(markerLineRe)) newMarkers.push(m[0]);
+	if (newMarkers.length === 0) return newContent;
+	const markersToAdd = newMarkers.filter((line) => !existing.includes(line));
+	if (markersToAdd.length === 0) return existing;
+	let merged = existing;
+	if (!merged.includes("@stylexjs/stylex")) merged = `import * as stylex from "@stylexjs/stylex";\n\n${merged}`;
+	const trailingNewline = merged.endsWith("\n") ? "" : "\n";
+	merged = merged + trailingNewline + markersToAdd.join("\n") + "\n";
+	return merged;
+}
+/** Run formatter commands on a list of files, logging warnings on failure. */
+async function runFormatters(commands, files) {
+	for (const formatterCommand of commands) {
+		const [cmd, ...cmdArgs] = formatterCommand.split(/\s+/);
+		if (cmd) try {
+			await new Promise((res, rej) => {
+				const proc = spawn(cmd, [...cmdArgs, ...files], {
+					stdio: "inherit",
+					shell: true
+				});
+				proc.on("close", (code) => {
+					if (code === 0) res();
+					else rej(/* @__PURE__ */ new Error(`Formatter command exited with code ${code}`));
+				});
+				proc.on("error", rej);
+			});
+		} catch (e) {
+			Logger.warn(`Formatter command failed: ${e instanceof Error ? e.message : String(e)}`);
+		}
+	}
+}
 
 //#endregion
 export { defineAdapter, runTransform };

package/dist/{logger-kU4pnRpt.d.mts → logger-B7SOfCti.d.mts}

@@ -80,6 +80,12 @@ type CallResolveContext = {
    * Example: `import { transitionSpeed as ts } ...; ts("x")` -> "transitionSpeed"
    */
   calleeImportedName: string;
+  /**
+   * Member path segments on the callee (e.g., for `ColorConverter.cssWithAlpha()`, `["cssWithAlpha"]`).
+   * Only present when the callee is a member expression. The root object's import info
+   * is in `calleeImportedName`/`calleeSource`.
+   */
+  calleeMemberPath?: string[];
   /**
    * Import source for this call: either an absolute file path (relative imports)
    * or the module specifier (package imports).
@@ -190,6 +196,16 @@ type CallResolveResult = {
    * returns a StyleX styles object even when used with a CSS property like `border:`.
    */
   usage?: "create" | "props";
+  /**
+   * When the resolved expression is combined with a dynamic argument (e.g., from a prop),
+   * this field controls how they are joined:
+   * - `"call"` (default): `resolvedExpr(arg)` — treat as a function call
+   * - `"memberAccess"`: `resolvedExpr[arg]` — treat as a computed member access
+   *
+   * Only relevant when the original code uses a pattern like `${(props) => helper(props.x)}`
+   * and the adapter returns a resolved expression for the helper.
+   */
+  dynamicArgUsage?: "call" | "memberAccess";
   /**
    * Optional raw CSS text for helpers that return CSS declaration blocks.
    *
@@ -396,6 +412,28 @@ interface Adapter {
    */
   styleMerger: StyleMergerConfig | null;
 }
+/**
+ * User-facing adapter input type accepted by `defineAdapter()`.
+ *
+ * Same as `Adapter` except `externalInterface` may also be the string `"auto"`.
+ * When `"auto"` is used, `runTransform()` automatically scans consumer code
+ * (using `consumerPaths` / `files` globs) to detect which exported components
+ * are re-styled or used with the `as` prop.
+ */
+interface AdapterInput {
+  resolveValue: Adapter["resolveValue"];
+  resolveCall: Adapter["resolveCall"];
+  resolveSelector: Adapter["resolveSelector"];
+  /**
+   * Called for exported styled components to determine their external interface.
+   *
+   * - Pass a function for manual control.
+   * - Pass `"auto"` to auto-detect usage from consumer code (requires `consumerPaths`
+   *   in `runTransform()`).
+   */
+  externalInterface: "auto" | Adapter["externalInterface"];
+  styleMerger: Adapter["styleMerger"];
+}
 /**
  * Helper for nicer user authoring + type inference.
  *
@@ -447,11 +485,11 @@ interface Adapter {
  *     styleMerger: null,
  *   });
  */
-declare function defineAdapter(adapter: Adapter): Adapter;
+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 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" | "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: unsupported selector" | "Directional border helper styles are not supported" | "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" | "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 selector: class selector" | "Unsupported selector: comma-separated selectors must all be simple pseudos" | "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: 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: unresolved interpolation in descendant component selector" | "Unsupported selector: unresolved interpolation in element selector" | "Unsupported selector: unresolved interpolation in reverse component 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";
+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 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" | "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: unsupported selector" | "Directional border helper styles are not supported" | "Multi-slot border interpolation could not be resolved" | "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" | "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 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: 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";
 interface WarningLog {
   severity: Severity;
   type: WarningType;
@@ -465,4 +503,4 @@ interface CollectedWarning extends WarningLog {
   filePath: string;
 }
 //#endregion
-export { defineAdapter as i, WarningLog as n, Adapter as r, CollectedWarning as t };
+export { defineAdapter as a, AdapterInput as i, WarningLog as n, Adapter as r, CollectedWarning as t };

package/dist/{logger-D3j-qxgZ.mjs → logger-D-R2KB6I.mjs}

@@ -22,7 +22,15 @@ function describeValue(value) {
 	}
 	return "[Unknown]";
 }
+/** Validates that the candidate is a fully-resolved `Adapter` (externalInterface must be a function). */
 function assertValidAdapter(candidate, where) {
+	assertAdapterShape(candidate, where, false);
+}
+/** Validates that the candidate is a valid `AdapterInput` (externalInterface may be `"auto"` or a function). */
+function assertValidAdapterInput(candidate, where) {
+	assertAdapterShape(candidate, where, true);
+}
+function assertAdapterShape(candidate, where, allowAutoExtIf) {
 	const obj = candidate;
 	const resolveValue = obj?.resolveValue;
 	const resolveCall = obj?.resolveCall;
@@ -87,7 +95,10 @@ function assertValidAdapter(candidate, where) {
 		"",
 		`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"));
+	if (!(typeof externalInterface === "function" || allowAutoExtIf && externalInterface === "auto")) {
+		const expected = allowAutoExtIf ? "adapter.externalInterface must be a function or \"auto\"." : "adapter.externalInterface must be a function.";
+		throw new Error([`${where}: ${expected}`, `Received: externalInterface=${describeValue(externalInterface)}`].join("\n"));
+	}
 	const styleMerger = obj?.styleMerger;
 	if (styleMerger !== null && styleMerger !== void 0) {
 		if (typeof styleMerger !== "object") throw new Error([
@@ -151,6 +162,18 @@ var Logger = class Logger {
 		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.
@@ -189,10 +212,12 @@ var Logger = class Logger {
 	static _clearCollected() {
 		Logger.collected = [];
 		Logger.fileCount = null;
+		Logger.loggedErrors = /* @__PURE__ */ new WeakSet();
 	}
 	static collected = [];
 	static fileCount = null;
-	static maxExamples = 15;
+	static maxExamples = 3;
+	static loggedErrors = /* @__PURE__ */ new WeakSet();
 	static writeWithSpacing(message, context) {
 		const trimmed = message.replace(/\s+$/u, "");
 		const serialized = Logger.formatContext(context);
@@ -225,7 +250,7 @@ var LoggerReport = class {
 	fileCount;
 	maxExamples;
 	fileCache = /* @__PURE__ */ new Map();
-	constructor(warnings, fileCount, maxExamples = 15) {
+	constructor(warnings, fileCount, maxExamples = 3) {
 		this.warnings = warnings;
 		this.fileCount = fileCount;
 		this.maxExamples = maxExamples;
@@ -336,4 +361,4 @@ const SECTION_COLOR = "\x1B[36m";
 const RESET_COLOR = "\x1B[0m";
 
 //#endregion
-export { assertValidAdapter as n, describeValue as r, Logger as t };
+export { describeValue as i, assertValidAdapter as n, assertValidAdapterInput as r, Logger as t };

package/dist/resolve-imports-BDk6Ms09.mjs

@@ -0,0 +1,66 @@
+import { ResolverFactory } from "oxc-resolver";
+
+//#region src/internal/prepass/resolve-imports.ts
+/**
+* Module resolution using oxc-resolver.
+* Resolves import specifiers to absolute file paths, handling:
+* - Extension probing (.ts, .tsx, .js, .jsx, /index.*)
+* - tsconfig.json paths aliases (auto-discovered)
+* - tsconfig.json project references
+* - .js → .ts remapping (ESM with moduleResolution: "bundler")
+* - Package exports field
+* - Symlink resolution (pnpm/Yarn workspaces)
+*/
+/**
+* Shared resolver config for TypeScript projects.
+*
+* - `.tsx` before `.ts` so React component files win when both exist
+* - `"types"` condition for type-aware resolution; `"default"` as fallback
+* - `tsconfig: "auto"` auto-discovers the nearest tsconfig.json per file
+*   for path alias resolution
+* - `extensionAlias` handles ESM `.js`→`.ts` remapping AND `.ts`→`.tsx`
+*   fallback for package.json `"exports"` wildcards
+*/
+const DEFAULT_CONFIG = {
+	extensions: [
+		".tsx",
+		".ts",
+		".jsx",
+		".js"
+	],
+	conditionNames: [
+		"import",
+		"types",
+		"default"
+	],
+	mainFields: ["module", "main"],
+	extensionAlias: {
+		".js": [
+			".ts",
+			".tsx",
+			".js"
+		],
+		".jsx": [".tsx", ".jsx"],
+		".ts": [".ts", ".tsx"]
+	},
+	tsconfig: "auto"
+};
+/**
+* Create a module resolver with configurable options.
+*
+* The returned `resolve` function resolves a specifier relative to
+* a source file path, returning the absolute path or `undefined` on failure.
+*/
+function createModuleResolver(config = DEFAULT_CONFIG) {
+	const resolver = new ResolverFactory(config);
+	return { resolve(fromFile, specifier) {
+		try {
+			return resolver.resolveFileSync(fromFile, specifier).path ?? void 0;
+		} catch {
+			return;
+		}
+	} };
+}
+
+//#endregion
+export { createModuleResolver };