styled-components-to-stylex-codemod 0.0.32 → 0.0.34

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { a as defineAdapter, i as AdapterInput, t as CollectedWarning } from "./logger-BFrY6Nmv.mjs";
+import { a as ImportSource, i as AdapterInput, o as MarkerFileContext, s as defineAdapter, t as CollectedWarning } from "./logger-xD1SimCA.mjs";
 
 //#region src/run.d.ts
 interface RunTransformOptions {
@@ -107,4 +107,4 @@ interface RunTransformResult {
  */
 declare function runTransform(options: RunTransformOptions): Promise<RunTransformResult>;
 //#endregion
-export { type AdapterInput, defineAdapter, runTransform };
+export { type AdapterInput, type ImportSource, type MarkerFileContext, defineAdapter, runTransform };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { a as assertValidAdapterInput, n as defineAdapter, o as describeValue } from "./adapter-BP7bn_pZ.mjs";
+import { o as assertValidAdapterInput, r as defineAdapter, s as describeValue, t as mergeMarkerDeclarations } from "./merge-markers-B58_cRdA.mjs";
 import { t as Logger } from "./logger-C2O81VeU.mjs";
 import { run } from "jscodeshift/src/Runner.js";
 import { fileURLToPath } from "node:url";
@@ -196,6 +196,7 @@ async function runTransform(options) {
 		styleMerger: resolvedAdapter.styleMerger,
 		themeHook: resolvedAdapter.themeHook,
 		useSxProp: resolvedAdapter.useSxProp,
+		usePhysicalProperties: resolvedAdapter.usePhysicalProperties,
 		externalInterface(ctx) {
 			return resolvedAdapter.externalInterface(ctx);
 		},
@@ -203,7 +204,8 @@ async function runTransform(options) {
 		resolveCall: resolveCallWithLogging,
 		resolveSelector: resolveSelectorWithLogging,
 		resolveBaseComponent: adapterInput.resolveBaseComponent ? resolveBaseComponentWithLogging : void 0,
-		resolveThemeCall: resolvedAdapter.resolveThemeCall
+		resolveThemeCall: resolvedAdapter.resolveThemeCall,
+		markerFile: resolvedAdapter.markerFile
 	};
 	const transformPath = (() => {
 		const adjacent = join(__dirname, "transform.mjs");
@@ -306,10 +308,6 @@ function createAutoPrepassFailureError(err, consumerPatterns, parser) {
 /**
 * 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;
@@ -318,17 +316,7 @@ function mergeSidecarContent(sidecarPath, newContent) {
 	} 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;
+	return mergeMarkerDeclarations(existing, newContent);
 }
 /** Run formatter commands on a list of files, logging warnings on failure. */
 async function runFormatters(commands, files) {

package/dist/{logger-BFrY6Nmv.d.mts → logger-xD1SimCA.d.mts}

@@ -500,6 +500,10 @@ type ExternalInterfaceResult = {
   elementProps?: boolean; /** Whether cross-file consumers use JSX spread ({...props}) */
   spreadProps?: boolean;
 };
+interface MarkerFileContext {
+  /** Absolute path of the file being transformed */
+  filePath: string;
+}
 /**
  * Configuration for a custom style merger function that combines stylex.props()
  * results with external className/style props.
@@ -647,6 +651,34 @@ interface Adapter {
    *
    */
   useSxProp: boolean;
+  /**
+   * Use physical CSS properties (`paddingTop`/`paddingRight`/`paddingBottom`/`paddingLeft`)
+   * instead of logical properties (`paddingBlock`/`paddingInline`) when expanding
+   * 2-value CSS shorthands like `padding: 4px 8px`.
+   *
+   * By default, the codemod uses logical properties which adapt to the writing direction
+   * (RTL/LTR), matching StyleX's ESLint plugin recommendations. Enable this if your
+   * codebase needs RTL support or prefer physical properties.
+   *
+   * @default false
+   */
+  usePhysicalProperties?: boolean;
+  /**
+   * Optional function to customize where marker sidecar files (`stylex.defineMarker()`)
+   * are written. By default, markers are placed in a `.stylex.ts` file next to the source.
+   *
+   * When provided, the function receives the source file path and returns an `ImportSource`
+   * that determines both the import path in the transformed file and the file path where
+   * markers are written.
+   *
+   * Example:
+   * ```typescript
+   * markerFile(ctx) {
+   *   return { kind: "absolutePath", value: "/path/to/shared/markers.stylex.ts" };
+   * }
+   * ```
+   */
+  markerFile?: (context: MarkerFileContext) => ImportSource;
 }
 /**
  * User-facing adapter input type accepted by `defineAdapter()`.
@@ -673,6 +705,8 @@ interface AdapterInput {
   styleMerger: Adapter["styleMerger"];
   themeHook?: Adapter["themeHook"];
   useSxProp: Adapter["useSxProp"];
+  usePhysicalProperties?: Adapter["usePhysicalProperties"];
+  markerFile?: Adapter["markerFile"];
 }
 /**
  * Helper for nicer user authoring + type inference.
@@ -736,6 +770,9 @@ interface AdapterInput {
  *     // Emit sx={} JSX attributes instead of {...stylex.props()} spreads (requires StyleX ≥0.18)
  *     useSxProp: false,
  *
+ *     // Opt out of logical properties — use paddingTop/Right/Bottom/Left instead of Block/Inline
+ *     // usePhysicalProperties: true,
+ *
  *     // Optional: customize runtime theme hook import/call used by emitted wrappers
  *     themeHook: {
  *       functionName: "useTheme",
@@ -747,7 +784,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)" | "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";
+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 ancestor attribute selector" | "Unsupported selector: computed media query inside cross-component sibling selector" | "Unsupported selector: computed media query inside sibling selector" | "Unsupported selector: computed media query inside :has() component selector" | "Unsupported selector: cross-file :has() component selector not yet supported" | "Unsupported selector: unresolved interpolation in :has() 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" | "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;
@@ -761,4 +798,4 @@ interface CollectedWarning extends WarningLog {
   filePath: string;
 }
 //#endregion
-export { defineAdapter as a, AdapterInput as i, WarningLog as n, Adapter as r, CollectedWarning as t };
+export { ImportSource as a, AdapterInput as i, WarningLog as n, MarkerFileContext as o, Adapter as r, defineAdapter as s, CollectedWarning as t };

package/dist/{adapter-BP7bn_pZ.mjs → merge-markers-B58_cRdA.mjs}

@@ -133,6 +133,14 @@ function assertAdapterShape(candidate, where, allowAutoExtIf) {
 			absolutePathExample: "/path/to/module.ts"
 		});
 	}
+	const markerFile = obj?.markerFile;
+	if (markerFile !== void 0 && markerFile !== null && typeof markerFile !== "function") throw new Error([
+		`${where}: adapter.markerFile must be a function when provided.`,
+		`Received: markerFile=${describeValue(markerFile)}`,
+		"",
+		"Expected signature:",
+		"  markerFile(ctx: { filePath: string }) => { kind: \"specifier\" | \"absolutePath\", value: string }"
+	].join("\n"));
 	const themeHook = obj?.themeHook;
 	if (themeHook !== null && themeHook !== void 0) {
 		if (typeof themeHook !== "object") throw new Error([
@@ -254,6 +262,9 @@ const DEFAULT_THEME_HOOK = {
 *     // Emit sx={} JSX attributes instead of {...stylex.props()} spreads (requires StyleX ≥0.18)
 *     useSxProp: false,
 *
+*     // Opt out of logical properties — use paddingTop/Right/Bottom/Left instead of Block/Inline
+*     // usePhysicalProperties: true,
+*
 *     // Optional: customize runtime theme hook import/call used by emitted wrappers
 *     themeHook: {
 *       functionName: "useTheme",
@@ -266,4 +277,33 @@ function defineAdapter(adapter) {
 	return adapter;
 }
 //#endregion
-export { assertValidAdapterInput as a, assertValidAdapter as i, defineAdapter as n, describeValue as o, isDirectionalResult as r, DEFAULT_THEME_HOOK as t };
+//#region src/internal/merge-markers.ts
+/**
+* Shared utility for merging marker sidecar content.
+* Core concepts: deduplication of defineMarker declarations across files.
+*/
+/** Regex matching a marker block: optional JSDoc comment followed by the export line. */
+const MARKER_BLOCK_RE = /(?:\/\*\*[^]*?\*\/\n)?export const \w+ = stylex\.defineMarker\(\);/gm;
+/** Regex matching just the export line (used for dedup checks). */
+const MARKER_EXPORT_RE = /^export const \w+ = stylex\.defineMarker\(\);$/gm;
+/**
+* Merge marker declarations from `incoming` into `base`, appending only new
+* marker blocks (JSDoc + export). Returns `base` unchanged if all markers already exist.
+*/
+function mergeMarkerDeclarations(base, incoming) {
+	const incomingExports = [...incoming.matchAll(MARKER_EXPORT_RE)].map((m) => m[0]);
+	if (incomingExports.length === 0) return base;
+	const newExportLines = incomingExports.filter((line) => !base.includes(line));
+	if (newExportLines.length === 0) return base;
+	const newExportSet = new Set(newExportLines);
+	const blocksToAdd = [...incoming.matchAll(MARKER_BLOCK_RE)].map((m) => m[0]).filter((block) => {
+		const exportLine = block.match(MARKER_EXPORT_RE);
+		return exportLine && newExportSet.has(exportLine[0]);
+	});
+	if (blocksToAdd.length === 0) return base;
+	let merged = base;
+	if (!merged.includes("@stylexjs/stylex")) merged = `import * as stylex from "@stylexjs/stylex";\n\n${merged}`;
+	return merged.trimEnd() + "\n\n" + blocksToAdd.join("\n\n") + "\n";
+}
+//#endregion
+export { assertValidAdapter as a, isDirectionalResult as i, DEFAULT_THEME_HOOK as n, assertValidAdapterInput as o, defineAdapter as r, describeValue as s, mergeMarkerDeclarations as t };

package/dist/transform.d.mts

@@ -1,4 +1,4 @@
-import { n as WarningLog, r as Adapter } from "./logger-BFrY6Nmv.mjs";
+import { n as WarningLog, r as Adapter } from "./logger-xD1SimCA.mjs";
 import { API, FileInfo, Options } from "jscodeshift";
 
 //#region src/internal/transform-types.d.ts
@@ -10,6 +10,8 @@ interface TransformResult {
   warnings: WarningLog[];
   /** Content for the sidecar .stylex.ts file (defineMarker declarations). Undefined when no markers needed. */
   sidecarContent?: string;
+  /** Absolute file path for the sidecar file, when adapter.markerFile provides a custom location. */
+  sidecarFilePath?: string;
   /** Bridge components emitted for unconverted consumer selectors. */
   bridgeResults?: BridgeComponentResult[];
   /** Transient prop renames for exported components, keyed by export name. */