react-code-locator 0.1.8 → 0.1.12

package/dist/index.cjs

@@ -20,13 +20,97 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  babelInjectComponentSource: () => babelInjectComponentSource,
+  babelSourceAdapter: () => babelSourceAdapter,
+  createBabelSourceAdapter: () => createBabelSourceAdapter,
+  createEsbuildSourceAdapter: () => createEsbuildSourceAdapter,
+  createSwcSourceAdapter: () => createSwcSourceAdapter,
+  createViteClientInjector: () => createViteClientInjector,
+  createViteSourceAdapter: () => createViteSourceAdapter,
+  defineSourceAdapter: () => defineSourceAdapter,
   enableReactComponentJump: () => enableReactComponentJump,
-  locateComponentSource: () => locateComponentSource
+  esbuildSourceAdapter: () => esbuildSourceAdapter,
+  locateComponentSource: () => locateComponentSource,
+  reactComponentJump: () => createViteClientInjector,
+  swcSourceAdapter: () => swcSourceAdapter,
+  viteSourceAdapter: () => viteSourceAdapter
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/constants.ts
 var SOURCE_PROP = "__componentSourceLoc";
+var JSX_SOURCE_PROP = "$componentSourceLoc";
+var JSX_SOURCE_REGISTRY_SYMBOL = "react-code-locator.jsxSourceRegistry";
+
+// src/sourceMetadata.ts
+function normalizeSlashes(value) {
+  return value.replace(/\\/g, "/");
+}
+function trimTrailingSlash(value) {
+  return value.replace(/\/+$/, "");
+}
+function splitPathSegments(value) {
+  return normalizeSlashes(value).split("/").filter(Boolean);
+}
+function computeRelativePath(fromPath, toPath) {
+  const fromSegments = splitPathSegments(fromPath);
+  const toSegments = splitPathSegments(toPath);
+  let sharedIndex = 0;
+  while (sharedIndex < fromSegments.length && sharedIndex < toSegments.length && fromSegments[sharedIndex] === toSegments[sharedIndex]) {
+    sharedIndex += 1;
+  }
+  const upSegments = new Array(Math.max(0, fromSegments.length - sharedIndex)).fill("..");
+  const downSegments = toSegments.slice(sharedIndex);
+  const relativeSegments = [...upSegments, ...downSegments];
+  return relativeSegments.length > 0 ? relativeSegments.join("/") : ".";
+}
+function normalizeProjectRoot(projectRoot) {
+  if (projectRoot) {
+    return trimTrailingSlash(normalizeSlashes(projectRoot));
+  }
+  if (typeof process !== "undefined" && typeof process.cwd === "function") {
+    return trimTrailingSlash(normalizeSlashes(process.cwd()));
+  }
+  return "";
+}
+function toRelativeSource(filename, loc, projectRoot) {
+  if (!filename || !loc) {
+    return null;
+  }
+  const root = normalizeProjectRoot(projectRoot);
+  const normalizedFilename = normalizeSlashes(filename);
+  const relPath = root && normalizedFilename.startsWith(`${root}/`) ? normalizedFilename.slice(root.length + 1) : root ? computeRelativePath(root, normalizedFilename) : normalizedFilename;
+  return `${relPath}:${loc.line}:${loc.column + 1}`;
+}
+function getSourceFile(source) {
+  if (!source) {
+    return null;
+  }
+  const match = source.match(/^(.*):\d+:\d+$/);
+  return match?.[1] ?? null;
+}
+function isProjectLocalFile(filename, projectRoot) {
+  if (!filename) {
+    return false;
+  }
+  const root = normalizeProjectRoot(projectRoot);
+  const normalizedFilename = normalizeSlashes(filename);
+  if (!root) {
+    return !normalizedFilename.startsWith("../") && !normalizedFilename.startsWith("/") && !/^[A-Za-z]:\//.test(normalizedFilename);
+  }
+  if (normalizedFilename.startsWith(`${root}/`) || normalizedFilename === root) {
+    return true;
+  }
+  const relativePath = computeRelativePath(root, normalizedFilename);
+  return !relativePath.startsWith("../");
+}
+function isExternalToProjectRoot(filename, projectRoot) {
+  return !isProjectLocalFile(filename, projectRoot);
+}
+function isProjectLocalSource(source, projectRoot) {
+  const file = getSourceFile(source);
+  return isProjectLocalFile(file ?? void 0, projectRoot);
+}
 
 // src/runtime.ts
 function isTriggerPressed(event, triggerKey) {
@@ -74,19 +158,17 @@ function getSourceFromType(type) {
   return typeof source === "string" ? source : null;
 }
 function getSourceFromProps(props) {
-  const source = props?.[SOURCE_PROP];
-  return typeof source === "string" ? source : null;
-}
-function resolveJsxSourceFromFiber(fiber) {
-  let current = fiber;
-  while (current) {
-    const source = getSourceFromProps(current.pendingProps) ?? getSourceFromProps(current.memoizedProps);
-    if (source) {
-      return source;
+  if (props && typeof props === "object") {
+    const registry = globalThis[Symbol.for(JSX_SOURCE_REGISTRY_SYMBOL)];
+    if (registry instanceof WeakMap) {
+      const intrinsicSource = registry.get(props);
+      if (typeof intrinsicSource === "string") {
+        return intrinsicSource;
+      }
     }
-    current = current.return ?? null;
   }
-  return null;
+  const source = props?.[JSX_SOURCE_PROP];
+  return typeof source === "string" ? source : null;
 }
 function resolveComponentSourceFromFiber(fiber) {
   let current = fiber;
@@ -99,24 +181,76 @@ function resolveComponentSourceFromFiber(fiber) {
   }
   return null;
 }
-function getDebugSource(fiber) {
+function getDirectDebugSource(fiber) {
+  const debugSource = fiber?._debugSource;
+  if (debugSource?.fileName && typeof debugSource.lineNumber === "number") {
+    return `${debugSource.fileName.replace(/\\/g, "/")}:${debugSource.lineNumber}:${debugSource.columnNumber ?? 1}`;
+  }
+  return null;
+}
+function resolveSourceCandidates(fiber) {
   let current = fiber;
+  const jsxCandidates = [];
+  const componentCandidates = [];
   while (current) {
-    const debugSource = current._debugSource;
-    if (debugSource?.fileName && typeof debugSource.lineNumber === "number") {
-      return `${debugSource.fileName.replace(/\\/g, "/")}:${debugSource.lineNumber}:${debugSource.columnNumber ?? 1}`;
+    const jsxSource = getSourceFromProps(current.pendingProps) ?? getSourceFromProps(current.memoizedProps) ?? getDirectDebugSource(current);
+    if (jsxSource) {
+      const file = getSourceFile(jsxSource);
+      if (file && !jsxCandidates.some((candidate) => candidate.source === jsxSource)) {
+        jsxCandidates.push({ source: jsxSource, file });
+      }
+    }
+    const componentSource = getSourceFromType(current.type) ?? getSourceFromType(current.elementType);
+    if (componentSource) {
+      const file = getSourceFile(componentSource);
+      if (file && !componentCandidates.some((candidate) => candidate.source === componentSource)) {
+        componentCandidates.push({ source: componentSource, file });
+      }
     }
     current = current.return ?? null;
   }
-  return null;
+  const direct = jsxCandidates[0]?.source ?? null;
+  const nearestProjectLocalComponentFile = componentCandidates.find((candidate) => isProjectLocalSource(candidate.source))?.file;
+  let screen = null;
+  if (nearestProjectLocalComponentFile) {
+    const matchingJsxCandidate = jsxCandidates.find((candidate) => candidate.file === nearestProjectLocalComponentFile);
+    if (matchingJsxCandidate) {
+      screen = matchingJsxCandidate.source;
+    } else {
+      const matchingComponentCandidate = componentCandidates.find(
+        (candidate) => candidate.file === nearestProjectLocalComponentFile
+      );
+      if (matchingComponentCandidate) {
+        screen = matchingComponentCandidate.source;
+      }
+    }
+  }
+  const implementationComponentCandidate = componentCandidates.find((candidate) => !isProjectLocalSource(candidate.source))?.source ?? null;
+  const implementationJsxCandidate = jsxCandidates.find((candidate) => !isProjectLocalSource(candidate.source))?.source ?? null;
+  const projectLocalJsxCandidate = jsxCandidates.find((candidate) => isProjectLocalSource(candidate.source))?.source ?? null;
+  const screenFallback = screen ?? projectLocalJsxCandidate ?? componentCandidates.find((candidate) => isProjectLocalSource(candidate.source))?.source ?? null;
+  return {
+    direct: direct ?? screenFallback,
+    screen: screenFallback,
+    implementation: implementationComponentCandidate ?? implementationJsxCandidate ?? screenFallback
+  };
+}
+function getModeDescription(mode) {
+  if (mode === "direct") {
+    return "Direct JSX";
+  }
+  if (mode === "screen") {
+    return "Screen source";
+  }
+  return "Implementation source";
 }
 function createStatusOverlay(triggerKey) {
   if (typeof document === "undefined") {
     return null;
   }
   const element = document.createElement("div");
-  let currentText = "";
   let copyValue = null;
+  let currentMode = "screen";
   let hideTimer = null;
   element.setAttribute("data-react-code-locator", "true");
   Object.assign(element.style, {
@@ -140,7 +274,6 @@ function createStatusOverlay(triggerKey) {
     transition: "opacity 120ms ease"
   });
   const show = (message, tone) => {
-    currentText = message;
     element.textContent = message;
     element.style.background = tone === "success" ? "rgba(6, 95, 70, 0.92)" : tone === "error" ? "rgba(153, 27, 27, 0.94)" : "rgba(17, 24, 39, 0.92)";
     element.style.opacity = "1";
@@ -151,7 +284,7 @@ function createStatusOverlay(triggerKey) {
     hideTimer = setTimeout(() => {
       element.style.opacity = "0";
       element.style.pointerEvents = "none";
-    }, 1500);
+    }, 2e3);
   };
   element.addEventListener("click", async () => {
     if (!copyValue) {
@@ -164,7 +297,7 @@ function createStatusOverlay(triggerKey) {
       show(`[react-code-locator] copy failed`, "error");
     }
   });
-  show(`[react-code-locator] enabled (${triggerKey}+click)`, "idle");
+  show(`[react-code-locator] enabled (${triggerKey}+click, alt+1/2/3 to switch mode)`, "idle");
   const mount = () => {
     if (!element.isConnected && document.body) {
       document.body.appendChild(element);
@@ -182,6 +315,10 @@ function createStatusOverlay(triggerKey) {
     setCopyValue(value) {
       copyValue = value;
     },
+    setMode(mode) {
+      currentMode = mode;
+      show(`[react-code-locator] ${getModeDescription(mode)}`, "idle");
+    },
     remove() {
       if (hideTimer) {
         clearTimeout(hideTimer);
@@ -190,17 +327,18 @@ function createStatusOverlay(triggerKey) {
     }
   };
 }
-function locateComponentSource(target) {
+function locateComponentSource(target, mode = "screen") {
   const elementTarget = target instanceof Element ? target : target instanceof Node ? target.parentElement : null;
   const fiber = getClosestReactFiber(elementTarget);
   if (!fiber) {
     return null;
   }
-  const jsxSource = resolveJsxSourceFromFiber(fiber) ?? getDebugSource(fiber);
-  if (jsxSource) {
+  const candidates = resolveSourceCandidates(fiber);
+  const source = candidates[mode] ?? candidates.screen ?? candidates.direct ?? candidates.implementation;
+  if (source) {
     return {
-      source: jsxSource,
-      mode: "jsx"
+      source,
+      mode
     };
   }
   const componentSource = resolveComponentSourceFromFiber(fiber);
@@ -209,11 +347,12 @@ function locateComponentSource(target) {
   }
   return {
     source: componentSource,
-    mode: "component"
+    mode
   };
 }
 function enableReactComponentJump(options = {}) {
   const overlay = createStatusOverlay(options.triggerKey ?? "shift");
+  let currentMode = "screen";
   const {
     triggerKey = "shift",
     onLocate = (result) => {
@@ -229,6 +368,28 @@ function enableReactComponentJump(options = {}) {
     }
   } = options;
   console.log("[react-code-locator] enabled", { triggerKey });
+  const keyHandler = (event) => {
+    if (!event.altKey) {
+      return;
+    }
+    if (event.code === "Digit1") {
+      currentMode = "direct";
+      overlay?.setMode(currentMode);
+      event.preventDefault();
+      return;
+    }
+    if (event.code === "Digit2") {
+      currentMode = "screen";
+      overlay?.setMode(currentMode);
+      event.preventDefault();
+      return;
+    }
+    if (event.code === "Digit3") {
+      currentMode = "implementation";
+      overlay?.setMode(currentMode);
+      event.preventDefault();
+    }
+  };
   const handler = (event) => {
     console.log("[react-code-locator] click", {
       triggerKey,
@@ -241,7 +402,7 @@ function enableReactComponentJump(options = {}) {
     if (!isTriggerPressed(event, triggerKey)) {
       return;
     }
-    const result = locateComponentSource(event.target);
+    const result = locateComponentSource(event.target, currentMode);
     if (!result) {
       onError(new Error("No React component source metadata found for clicked element."));
       return;
@@ -251,14 +412,657 @@ function enableReactComponentJump(options = {}) {
     onLocate(result);
   };
   document.addEventListener("click", handler, true);
+  document.addEventListener("keydown", keyHandler, true);
   return () => {
     document.removeEventListener("click", handler, true);
+    document.removeEventListener("keydown", keyHandler, true);
     overlay?.remove();
   };
 }
+
+// src/sourceAdapter.ts
+function defineSourceAdapter(descriptor) {
+  return descriptor;
+}
+
+// src/babelInjectComponentSource.ts
+var import_core = require("@babel/core");
+var SOURCE_PROP_LOCAL = "_componentSourceLoc";
+var SOURCE_PROPS_REST = "__reactCodeLocatorProps";
+function isComponentName(name) {
+  return /^[A-Z]/.test(name);
+}
+function isCustomComponentTag(name) {
+  if (import_core.types.isJSXIdentifier(name)) {
+    return isComponentName(name.name);
+  }
+  if (import_core.types.isJSXMemberExpression(name)) {
+    return true;
+  }
+  return false;
+}
+function isIntrinsicElementTag(name) {
+  return import_core.types.isJSXIdentifier(name) && /^[a-z]/.test(name.name);
+}
+function isElementFactoryIdentifier(name) {
+  return name === "jsx" || name === "jsxs" || name === "jsxDEV" || name === "_jsx" || name === "_jsxs" || name === "_jsxDEV" || name === "createElement";
+}
+function isReactElementFactoryCall(pathNode) {
+  const callee = pathNode.node.callee;
+  if (import_core.types.isIdentifier(callee)) {
+    return isElementFactoryIdentifier(callee.name);
+  }
+  return import_core.types.isMemberExpression(callee) && import_core.types.isIdentifier(callee.object, { name: "React" }) && import_core.types.isIdentifier(callee.property, { name: "createElement" });
+}
+function getRootJsxIdentifierName(name) {
+  if (import_core.types.isJSXIdentifier(name)) {
+    return name.name;
+  }
+  if (import_core.types.isJSXMemberExpression(name)) {
+    return getRootJsxIdentifierName(name.object);
+  }
+  return null;
+}
+function isStyledModuleImport(binding) {
+  if (!binding) {
+    return false;
+  }
+  if (!binding.path.isImportSpecifier() && !binding.path.isImportDefaultSpecifier() && !binding.path.isImportNamespaceSpecifier()) {
+    return false;
+  }
+  const source = binding.path.parentPath.isImportDeclaration() ? binding.path.parentPath.node.source.value : null;
+  if (typeof source !== "string") {
+    return false;
+  }
+  const normalized = source.replace(/\\/g, "/");
+  return normalized === "./styled" || normalized === "../styled" || normalized.endsWith("/styled");
+}
+function isSupportedComponentInit(node) {
+  if (!node) {
+    return false;
+  }
+  if (import_core.types.isArrowFunctionExpression(node) || import_core.types.isFunctionExpression(node)) {
+    return true;
+  }
+  if (!import_core.types.isCallExpression(node)) {
+    return false;
+  }
+  if (import_core.types.isIdentifier(node.callee) && (node.callee.name === "memo" || node.callee.name === "forwardRef")) {
+    return true;
+  }
+  return import_core.types.isMemberExpression(node.callee) && import_core.types.isIdentifier(node.callee.object, { name: "React" }) && import_core.types.isIdentifier(node.callee.property) && (node.callee.property.name === "memo" || node.callee.property.name === "forwardRef");
+}
+function hasSourcePropBinding(pattern) {
+  return pattern.properties.some((property) => {
+    if (!import_core.types.isObjectProperty(property)) {
+      return false;
+    }
+    return import_core.types.isIdentifier(property.key) && property.key.name === JSX_SOURCE_PROP;
+  });
+}
+function injectSourcePropBinding(pattern) {
+  if (hasSourcePropBinding(pattern)) {
+    return;
+  }
+  const sourceBinding = import_core.types.objectProperty(
+    import_core.types.identifier(JSX_SOURCE_PROP),
+    import_core.types.identifier(SOURCE_PROP_LOCAL),
+    false,
+    false
+  );
+  const restIndex = pattern.properties.findIndex(
+    (property) => import_core.types.isRestElement(property)
+  );
+  if (restIndex === -1) {
+    pattern.properties.push(sourceBinding);
+    return;
+  }
+  pattern.properties.splice(restIndex, 0, sourceBinding);
+}
+function injectSourcePropIntoIdentifierParam(node, param) {
+  if (!import_core.types.isBlockStatement(node.body)) {
+    node.body = import_core.types.blockStatement([import_core.types.returnStatement(node.body)]);
+  }
+  const alreadyInjected = node.body.body.some(
+    (statement) => import_core.types.isVariableDeclaration(statement) && statement.declarations.some(
+      (declaration) => import_core.types.isIdentifier(declaration.id) && declaration.id.name === SOURCE_PROPS_REST
+    )
+  );
+  if (alreadyInjected) {
+    return;
+  }
+  node.body.body.unshift(
+    import_core.types.variableDeclaration("const", [
+      import_core.types.variableDeclarator(
+        import_core.types.objectPattern([
+          import_core.types.objectProperty(
+            import_core.types.identifier(JSX_SOURCE_PROP),
+            import_core.types.identifier(SOURCE_PROP_LOCAL),
+            false,
+            false
+          ),
+          import_core.types.restElement(import_core.types.identifier(SOURCE_PROPS_REST))
+        ]),
+        param
+      )
+    ]),
+    import_core.types.expressionStatement(
+      import_core.types.assignmentExpression(
+        "=",
+        import_core.types.identifier(param.name),
+        import_core.types.identifier(SOURCE_PROPS_REST)
+      )
+    )
+  );
+}
+function injectSourcePropIntoFunctionParams(node) {
+  const firstParam = node.params[0];
+  if (!firstParam) {
+    return;
+  }
+  if (import_core.types.isObjectPattern(firstParam)) {
+    injectSourcePropBinding(firstParam);
+    return;
+  }
+  if (import_core.types.isIdentifier(firstParam)) {
+    injectSourcePropIntoIdentifierParam(node, firstParam);
+  }
+}
+function injectSourcePropIntoExpression(node) {
+  if (!node) {
+    return;
+  }
+  if (import_core.types.isFunctionExpression(node) || import_core.types.isArrowFunctionExpression(node)) {
+    injectSourcePropIntoFunctionParams(node);
+    return;
+  }
+  if (!import_core.types.isCallExpression(node)) {
+    return;
+  }
+  const firstArg = node.arguments[0];
+  if (firstArg && !import_core.types.isSpreadElement(firstArg) && (import_core.types.isFunctionExpression(firstArg) || import_core.types.isArrowFunctionExpression(firstArg))) {
+    injectSourcePropIntoFunctionParams(firstArg);
+  }
+}
+function getSourceValue(state, loc, projectRoot) {
+  const filename = state.file?.opts?.filename;
+  if (!filename || !loc) {
+    return null;
+  }
+  return toRelativeSource(filename, loc, projectRoot);
+}
+function buildAssignment(name, sourceValue) {
+  return import_core.types.expressionStatement(
+    import_core.types.assignmentExpression(
+      "=",
+      import_core.types.memberExpression(import_core.types.identifier(name), import_core.types.identifier(SOURCE_PROP)),
+      import_core.types.stringLiteral(sourceValue)
+    )
+  );
+}
+function buildIntrinsicSourceHelper() {
+  return import_core.types.functionDeclaration(
+    import_core.types.identifier("_markIntrinsicElementSource"),
+    [import_core.types.identifier("element"), import_core.types.identifier("source")],
+    import_core.types.blockStatement([
+      import_core.types.variableDeclaration("const", [
+        import_core.types.variableDeclarator(
+          import_core.types.identifier("registryKey"),
+          import_core.types.callExpression(
+            import_core.types.memberExpression(import_core.types.identifier("Symbol"), import_core.types.identifier("for")),
+            [import_core.types.stringLiteral(JSX_SOURCE_REGISTRY_SYMBOL)]
+          )
+        )
+      ]),
+      import_core.types.variableDeclaration("let", [
+        import_core.types.variableDeclarator(
+          import_core.types.identifier("registry"),
+          import_core.types.memberExpression(import_core.types.identifier("globalThis"), import_core.types.identifier("registryKey"), true)
+        )
+      ]),
+      import_core.types.ifStatement(
+        import_core.types.unaryExpression(
+          "!",
+          import_core.types.binaryExpression("instanceof", import_core.types.identifier("registry"), import_core.types.identifier("WeakMap"))
+        ),
+        import_core.types.blockStatement([
+          import_core.types.expressionStatement(
+            import_core.types.assignmentExpression(
+              "=",
+              import_core.types.identifier("registry"),
+              import_core.types.assignmentExpression(
+                "=",
+                import_core.types.memberExpression(import_core.types.identifier("globalThis"), import_core.types.identifier("registryKey"), true),
+                import_core.types.newExpression(import_core.types.identifier("WeakMap"), [])
+              )
+            )
+          )
+        ])
+      ),
+      import_core.types.ifStatement(
+        import_core.types.logicalExpression(
+          "&&",
+          import_core.types.identifier("element"),
+          import_core.types.logicalExpression(
+            "&&",
+            import_core.types.binaryExpression("===", import_core.types.unaryExpression("typeof", import_core.types.identifier("element")), import_core.types.stringLiteral("object")),
+            import_core.types.binaryExpression(
+              "===",
+              import_core.types.unaryExpression("typeof", import_core.types.memberExpression(import_core.types.identifier("element"), import_core.types.identifier("props"))),
+              import_core.types.stringLiteral("object")
+            )
+          )
+        ),
+        import_core.types.blockStatement([
+          import_core.types.expressionStatement(
+            import_core.types.callExpression(
+              import_core.types.memberExpression(import_core.types.identifier("registry"), import_core.types.identifier("set")),
+              [import_core.types.memberExpression(import_core.types.identifier("element"), import_core.types.identifier("props")), import_core.types.identifier("source")]
+            )
+          )
+        ])
+      ),
+      import_core.types.returnStatement(import_core.types.identifier("element"))
+    ])
+  );
+}
+function ensureIntrinsicSourceHelper(programPath, state) {
+  if (state.injectedIntrinsicHelper) {
+    return;
+  }
+  const alreadyExists = programPath.node.body.some(
+    (node) => import_core.types.isFunctionDeclaration(node) && import_core.types.isIdentifier(node.id, { name: "_markIntrinsicElementSource" })
+  );
+  if (!alreadyExists) {
+    programPath.unshiftContainer("body", buildIntrinsicSourceHelper());
+  }
+  state.injectedIntrinsicHelper = true;
+}
+function visitDeclaration(declarationPath, insertAfterPath, state, seen, projectRoot) {
+  if (declarationPath.isFunctionDeclaration() || declarationPath.isClassDeclaration()) {
+    const name = declarationPath.node.id?.name;
+    if (!name || !isComponentName(name) || seen.has(name)) {
+      return;
+    }
+    if (declarationPath.isFunctionDeclaration()) {
+      injectSourcePropIntoFunctionParams(declarationPath.node);
+    }
+    const sourceValue = getSourceValue(
+      state,
+      declarationPath.node.loc?.start,
+      projectRoot
+    );
+    if (!sourceValue) {
+      return;
+    }
+    seen.add(name);
+    insertAfterPath.insertAfter(buildAssignment(name, sourceValue));
+    return;
+  }
+  if (!declarationPath.isVariableDeclaration()) {
+    return;
+  }
+  const assignments = declarationPath.node.declarations.flatMap(
+    (declarator) => {
+      if (!import_core.types.isIdentifier(declarator.id) || !isComponentName(declarator.id.name) || seen.has(declarator.id.name)) {
+        return [];
+      }
+      if (!declarator.init) {
+        return [];
+      }
+      if (!isSupportedComponentInit(declarator.init)) {
+        return [];
+      }
+      injectSourcePropIntoExpression(declarator.init);
+      const sourceValue = getSourceValue(
+        state,
+        declarator.loc?.start ?? declarator.init.loc?.start,
+        projectRoot
+      );
+      if (!sourceValue) {
+        return [];
+      }
+      seen.add(declarator.id.name);
+      return [buildAssignment(declarator.id.name, sourceValue)];
+    }
+  );
+  if (assignments.length > 0) {
+    insertAfterPath.insertAfter(assignments);
+  }
+}
+function babelInjectComponentSource(options = {}) {
+  const {
+    injectJsxSource = true,
+    injectComponentSource = true,
+    projectRoot
+  } = options;
+  return {
+    name: "babel-inject-component-source",
+    visitor: {
+      CallExpression(pathNode, state) {
+        if (!injectJsxSource) {
+          return;
+        }
+        if (!isReactElementFactoryCall(pathNode)) {
+          return;
+        }
+        if (pathNode.parentPath.isCallExpression() && import_core.types.isIdentifier(pathNode.parentPath.node.callee, {
+          name: "_markIntrinsicElementSource"
+        })) {
+          return;
+        }
+        const sourceValue = getSourceValue(
+          state,
+          pathNode.node.loc?.start,
+          projectRoot
+        );
+        if (!sourceValue) {
+          return;
+        }
+        const programPath = pathNode.findParent((parent) => parent.isProgram());
+        if (!programPath || !programPath.isProgram()) {
+          return;
+        }
+        ensureIntrinsicSourceHelper(programPath, state);
+        pathNode.replaceWith(
+          import_core.types.callExpression(import_core.types.identifier("_markIntrinsicElementSource"), [
+            pathNode.node,
+            import_core.types.stringLiteral(sourceValue)
+          ])
+        );
+        pathNode.skip();
+      },
+      JSXElement: {
+        exit(pathNode, state) {
+          if (!injectJsxSource) {
+            return;
+          }
+          if (!isIntrinsicElementTag(pathNode.node.openingElement.name)) {
+            return;
+          }
+          if (pathNode.parentPath.isCallExpression() && import_core.types.isIdentifier(pathNode.parentPath.node.callee, { name: "_markIntrinsicElementSource" })) {
+            return;
+          }
+          const sourceValue = getSourceValue(
+            state,
+            pathNode.node.openingElement.loc?.start,
+            projectRoot
+          );
+          if (!sourceValue) {
+            return;
+          }
+          const programPath = pathNode.findParent((parent) => parent.isProgram());
+          if (!programPath || !programPath.isProgram()) {
+            return;
+          }
+          ensureIntrinsicSourceHelper(programPath, state);
+          const wrappedNode = import_core.types.callExpression(import_core.types.identifier("_markIntrinsicElementSource"), [
+            pathNode.node,
+            import_core.types.stringLiteral(sourceValue)
+          ]);
+          if (pathNode.parentPath.isJSXElement() || pathNode.parentPath.isJSXFragment()) {
+            pathNode.replaceWith(import_core.types.jsxExpressionContainer(wrappedNode));
+            return;
+          }
+          if (pathNode.parentPath.isJSXExpressionContainer()) {
+            pathNode.parentPath.replaceWith(import_core.types.jsxExpressionContainer(wrappedNode));
+            return;
+          }
+          pathNode.replaceWith(wrappedNode);
+        }
+      },
+      JSXOpeningElement(pathNode, state) {
+        if (!injectJsxSource) {
+          return;
+        }
+        if (!isCustomComponentTag(pathNode.node.name)) {
+          return;
+        }
+        const rootIdentifierName = getRootJsxIdentifierName(pathNode.node.name);
+        if (rootIdentifierName && isExternalToProjectRoot(state.file?.opts?.filename, projectRoot) && isStyledModuleImport(pathNode.scope.getBinding(rootIdentifierName))) {
+          return;
+        }
+        const hasSourceProp = pathNode.node.attributes.some(
+          (attr) => import_core.types.isJSXAttribute(attr) && import_core.types.isJSXIdentifier(attr.name) && attr.name.name === JSX_SOURCE_PROP
+        );
+        if (hasSourceProp) {
+          return;
+        }
+        const filename = state.file?.opts?.filename;
+        const loc = pathNode.node.loc?.start;
+        if (!filename || !loc) {
+          return;
+        }
+        pathNode.node.attributes.push(
+          import_core.types.jsxAttribute(
+            import_core.types.jsxIdentifier(JSX_SOURCE_PROP),
+            import_core.types.stringLiteral(
+              getSourceValue(state, loc, projectRoot) ?? `${filename.replace(/\\/g, "/")}:${loc.line}:${loc.column + 1}`
+            )
+          )
+        );
+      },
+      Program(programPath, state) {
+        if (!injectComponentSource) {
+          return;
+        }
+        const seen = /* @__PURE__ */ new Set();
+        for (const childPath of programPath.get("body")) {
+          if (childPath.isExportNamedDeclaration() || childPath.isExportDefaultDeclaration()) {
+            const declarationPath = childPath.get("declaration");
+            if (!Array.isArray(declarationPath) && declarationPath.node) {
+              visitDeclaration(declarationPath, childPath, state, seen, projectRoot);
+            }
+            continue;
+          }
+          visitDeclaration(childPath, childPath, state, seen, projectRoot);
+        }
+      }
+    }
+  };
+}
+
+// src/babel.ts
+function createBabelSourceAdapter(options = {}) {
+  return defineSourceAdapter({
+    kind: "babel",
+    name: "react-code-locator/babel",
+    options,
+    config: {
+      plugins: [[babelInjectComponentSource, options]]
+    }
+  });
+}
+var babelSourceAdapter = createBabelSourceAdapter();
+
+// src/sourceTransform.ts
+var import_core2 = require("@babel/core");
+async function transformSourceWithLocator(code, options) {
+  const { filename, sourceMaps = true, ...pluginOptions } = options;
+  const result = await (0, import_core2.transformAsync)(code, {
+    filename,
+    babelrc: false,
+    configFile: false,
+    sourceMaps,
+    parserOpts: {
+      sourceType: "module",
+      plugins: ["jsx", "typescript"]
+    },
+    generatorOpts: {
+      retainLines: true
+    },
+    plugins: [[babelInjectComponentSource, pluginOptions]]
+  });
+  return {
+    code: result?.code ?? code,
+    map: result?.map ?? null
+  };
+}
+
+// src/viteClientInjector.ts
+var VIRTUAL_CLIENT_MODULE_ID = "virtual:react-code-locator/client";
+var RESOLVED_VIRTUAL_CLIENT_MODULE_ID = `\0${VIRTUAL_CLIENT_MODULE_ID}`;
+function createClientInjector(locatorOptions = {}) {
+  const serialized = JSON.stringify(locatorOptions);
+  return {
+    name: "react-code-locator-client-injector",
+    apply: "serve",
+    resolveId(id) {
+      if (id === VIRTUAL_CLIENT_MODULE_ID) {
+        return RESOLVED_VIRTUAL_CLIENT_MODULE_ID;
+      }
+      return null;
+    },
+    load(id) {
+      if (id !== RESOLVED_VIRTUAL_CLIENT_MODULE_ID) {
+        return null;
+      }
+      return `
+        import { enableReactComponentJump } from "react-code-locator/client";
+
+        enableReactComponentJump(${serialized});
+      `;
+    },
+    transformIndexHtml() {
+      return [
+        {
+          tag: "script",
+          attrs: {
+            type: "module",
+            src: `/@id/__x00__${VIRTUAL_CLIENT_MODULE_ID}`
+          },
+          injectTo: "head"
+        }
+      ];
+    }
+  };
+}
+function createViteClientInjector(options = {}) {
+  const { command = "serve", locator = {}, injectClient = true } = options;
+  const isServe = command === "serve";
+  return [isServe && injectClient ? createClientInjector(locator) : null].filter(Boolean);
+}
+
+// src/vite.ts
+function shouldTransformSource(id) {
+  if (id.includes("/node_modules/") || id.startsWith("\0")) {
+    return false;
+  }
+  return /\.[mc]?[jt]sx?$/.test(id);
+}
+function viteSourceTransformPlugin(options = {}) {
+  return {
+    name: "react-code-locator-source-transform",
+    enforce: "pre",
+    async transform(code, id) {
+      if (!shouldTransformSource(id)) {
+        return null;
+      }
+      return transformSourceWithLocator(code, {
+        filename: id,
+        ...options
+      });
+    }
+  };
+}
+function createViteSourceAdapter(options = {}) {
+  const { babel = {}, ...viteOptions } = options;
+  const plugins = [
+    viteSourceTransformPlugin(babel),
+    ...createViteClientInjector(viteOptions)
+  ].filter(Boolean);
+  return defineSourceAdapter({
+    kind: "vite",
+    name: "react-code-locator/vite",
+    options,
+    config: {
+      plugins
+    }
+  });
+}
+var viteSourceAdapter = createViteSourceAdapter();
+
+// src/esbuild.ts
+var import_promises = require("fs/promises");
+function getEsbuildLoader(filename) {
+  if (filename.endsWith(".tsx")) {
+    return "tsx";
+  }
+  if (filename.endsWith(".ts")) {
+    return "ts";
+  }
+  if (filename.endsWith(".jsx")) {
+    return "jsx";
+  }
+  return "js";
+}
+function esbuildSourceTransformPlugin(options = {}) {
+  return {
+    name: "react-code-locator-source-transform",
+    setup(build) {
+      build.onLoad({ filter: /\.[mc]?[jt]sx?$/ }, async ({ path }) => {
+        if (path.includes("/node_modules/")) {
+          return null;
+        }
+        const code = await (0, import_promises.readFile)(path, "utf8");
+        const result = await transformSourceWithLocator(code, {
+          filename: path,
+          ...options
+        });
+        return {
+          contents: result.code,
+          loader: getEsbuildLoader(path)
+        };
+      });
+    }
+  };
+}
+function createEsbuildSourceAdapter(options = {}) {
+  return defineSourceAdapter({
+    kind: "esbuild",
+    name: "react-code-locator/esbuild",
+    options,
+    config: {
+      plugins: [esbuildSourceTransformPlugin(options)]
+    }
+  });
+}
+var esbuildSourceAdapter = createEsbuildSourceAdapter();
+
+// src/swc.ts
+async function transformSourceWithSwcLocator(code, options) {
+  return transformSourceWithLocator(code, options);
+}
+function createSwcSourceAdapter(options = {}) {
+  const transform = (code, transformOptions) => transformSourceWithSwcLocator(code, {
+    ...options,
+    ...transformOptions
+  });
+  return defineSourceAdapter({
+    kind: "swc",
+    name: "react-code-locator/swc",
+    options,
+    config: {
+      transform
+    }
+  });
+}
+var swcSourceAdapter = createSwcSourceAdapter();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  babelInjectComponentSource,
+  babelSourceAdapter,
+  createBabelSourceAdapter,
+  createEsbuildSourceAdapter,
+  createSwcSourceAdapter,
+  createViteClientInjector,
+  createViteSourceAdapter,
+  defineSourceAdapter,
   enableReactComponentJump,
-  locateComponentSource
+  esbuildSourceAdapter,
+  locateComponentSource,
+  reactComponentJump,
+  swcSourceAdapter,
+  viteSourceAdapter
 });
 //# sourceMappingURL=index.cjs.map