react-code-locator 0.1.4

package/dist/babelInjectComponentSource.cjs

@@ -0,0 +1,150 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/babelInjectComponentSource.ts
+var babelInjectComponentSource_exports = {};
+__export(babelInjectComponentSource_exports, {
+  babelInjectComponentSource: () => babelInjectComponentSource
+});
+module.exports = __toCommonJS(babelInjectComponentSource_exports);
+var import_node_path = __toESM(require("path"), 1);
+var import_core = require("@babel/core");
+
+// src/constants.ts
+var SOURCE_PROP = "__componentSourceLoc";
+
+// src/babelInjectComponentSource.ts
+function isComponentName(name) {
+  return /^[A-Z]/.test(name);
+}
+function getSourceValue(state, loc) {
+  const filename = state.file?.opts?.filename;
+  if (!filename || !loc) {
+    return null;
+  }
+  const relPath = import_node_path.default.relative(process.cwd(), filename).replace(/\\/g, "/");
+  return `${relPath}:${loc.line}:${loc.column + 1}`;
+}
+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 visitDeclaration(declarationPath, insertAfterPath, state, seen) {
+  if (declarationPath.isFunctionDeclaration() || declarationPath.isClassDeclaration()) {
+    const name = declarationPath.node.id?.name;
+    if (!name || !isComponentName(name) || seen.has(name)) {
+      return;
+    }
+    const sourceValue = getSourceValue(state, declarationPath.node.loc?.start);
+    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 (!import_core.types.isArrowFunctionExpression(declarator.init) && !import_core.types.isFunctionExpression(declarator.init)) {
+      return [];
+    }
+    const sourceValue = getSourceValue(state, declarator.loc?.start ?? declarator.init.loc?.start);
+    if (!sourceValue) {
+      return [];
+    }
+    seen.add(declarator.id.name);
+    return [buildAssignment(declarator.id.name, sourceValue)];
+  });
+  if (assignments.length > 0) {
+    insertAfterPath.insertAfter(assignments);
+  }
+}
+function babelInjectComponentSource() {
+  return {
+    name: "babel-inject-component-source",
+    visitor: {
+      JSXOpeningElement(pathNode, state) {
+        const hasSourceProp = pathNode.node.attributes.some(
+          (attr) => import_core.types.isJSXAttribute(attr) && import_core.types.isJSXIdentifier(attr.name) && attr.name.name === "__source"
+        );
+        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("__source"),
+            import_core.types.jsxExpressionContainer(
+              import_core.types.objectExpression([
+                import_core.types.objectProperty(import_core.types.identifier("fileName"), import_core.types.stringLiteral(filename)),
+                import_core.types.objectProperty(import_core.types.identifier("lineNumber"), import_core.types.numericLiteral(loc.line)),
+                import_core.types.objectProperty(import_core.types.identifier("columnNumber"), import_core.types.numericLiteral(loc.column + 1))
+              ])
+            )
+          )
+        );
+      },
+      Program(programPath, state) {
+        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);
+            }
+            continue;
+          }
+          visitDeclaration(childPath, childPath, state, seen);
+        }
+      }
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  babelInjectComponentSource
+});
+//# sourceMappingURL=babelInjectComponentSource.cjs.map

package/dist/babelInjectComponentSource.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/babelInjectComponentSource.ts","../src/constants.ts"],"sourcesContent":["import path from \"node:path\";\nimport { types as t, type NodePath, type PluginObj } from \"@babel/core\";\nimport { SOURCE_PROP } from \"./constants\";\n\ntype BabelState = {\n  file?: {\n    opts?: {\n      filename?: string;\n    };\n  };\n};\n\nfunction isComponentName(name: string) {\n  return /^[A-Z]/.test(name);\n}\n\nfunction getSourceValue(state: BabelState, loc: { line: number; column: number } | null | undefined) {\n  const filename = state.file?.opts?.filename;\n  if (!filename || !loc) {\n    return null;\n  }\n\n  const relPath = path.relative(process.cwd(), filename).replace(/\\\\/g, \"/\");\n  return `${relPath}:${loc.line}:${loc.column + 1}`;\n}\n\nfunction buildAssignment(name: string, sourceValue: string) {\n  return t.expressionStatement(\n    t.assignmentExpression(\n      \"=\",\n      t.memberExpression(t.identifier(name), t.identifier(SOURCE_PROP)),\n      t.stringLiteral(sourceValue),\n    ),\n  );\n}\n\nfunction visitDeclaration(\n  declarationPath: NodePath,\n  insertAfterPath: NodePath,\n  state: BabelState,\n  seen: Set<string>,\n) {\n  if (declarationPath.isFunctionDeclaration() || declarationPath.isClassDeclaration()) {\n    const name = declarationPath.node.id?.name;\n    if (!name || !isComponentName(name) || seen.has(name)) {\n      return;\n    }\n\n    const sourceValue = getSourceValue(state, declarationPath.node.loc?.start);\n    if (!sourceValue) {\n      return;\n    }\n\n    seen.add(name);\n    insertAfterPath.insertAfter(buildAssignment(name, sourceValue));\n    return;\n  }\n\n  if (!declarationPath.isVariableDeclaration()) {\n    return;\n  }\n\n  const assignments = declarationPath.node.declarations.flatMap((declarator) => {\n    if (!t.isIdentifier(declarator.id) || !isComponentName(declarator.id.name) || seen.has(declarator.id.name)) {\n      return [];\n    }\n\n    if (!declarator.init) {\n      return [];\n    }\n\n    if (!t.isArrowFunctionExpression(declarator.init) && !t.isFunctionExpression(declarator.init)) {\n      return [];\n    }\n\n    const sourceValue = getSourceValue(state, declarator.loc?.start ?? declarator.init.loc?.start);\n    if (!sourceValue) {\n      return [];\n    }\n\n    seen.add(declarator.id.name);\n    return [buildAssignment(declarator.id.name, sourceValue)];\n  });\n\n  if (assignments.length > 0) {\n    insertAfterPath.insertAfter(assignments);\n  }\n}\n\nexport function babelInjectComponentSource(): PluginObj<BabelState> {\n  return {\n    name: \"babel-inject-component-source\",\n    visitor: {\n      JSXOpeningElement(pathNode, state) {\n        const hasSourceProp = pathNode.node.attributes.some(\n          (attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === \"__source\",\n        );\n        if (hasSourceProp) {\n          return;\n        }\n\n        const filename = state.file?.opts?.filename;\n        const loc = pathNode.node.loc?.start;\n        if (!filename || !loc) {\n          return;\n        }\n\n        pathNode.node.attributes.push(\n          t.jsxAttribute(\n            t.jsxIdentifier(\"__source\"),\n            t.jsxExpressionContainer(\n              t.objectExpression([\n                t.objectProperty(t.identifier(\"fileName\"), t.stringLiteral(filename)),\n                t.objectProperty(t.identifier(\"lineNumber\"), t.numericLiteral(loc.line)),\n                t.objectProperty(t.identifier(\"columnNumber\"), t.numericLiteral(loc.column + 1)),\n              ]),\n            ),\n          ),\n        );\n      },\n      Program(programPath, state) {\n        const seen = new Set<string>();\n\n        for (const childPath of programPath.get(\"body\")) {\n          if (childPath.isExportNamedDeclaration() || childPath.isExportDefaultDeclaration()) {\n            const declarationPath = childPath.get(\"declaration\");\n            if (!Array.isArray(declarationPath) && declarationPath.node) {\n              visitDeclaration(declarationPath, childPath, state, seen);\n            }\n            continue;\n          }\n\n          visitDeclaration(childPath, childPath, state, seen);\n        }\n      },\n    },\n  };\n}\n","export const SOURCE_PROP = \"__componentSourceLoc\";\n\n"],"mappings":"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","names":["path","t"]}

package/dist/babelInjectComponentSource.d.cts

@@ -0,0 +1,12 @@
+import { PluginObj } from '@babel/core';
+
+type BabelState = {
+    file?: {
+        opts?: {
+            filename?: string;
+        };
+    };
+};
+declare function babelInjectComponentSource(): PluginObj<BabelState>;
+
+export { babelInjectComponentSource };

package/dist/babelInjectComponentSource.d.ts

@@ -0,0 +1,12 @@
+import { PluginObj } from '@babel/core';
+
+type BabelState = {
+    file?: {
+        opts?: {
+            filename?: string;
+        };
+    };
+};
+declare function babelInjectComponentSource(): PluginObj<BabelState>;
+
+export { babelInjectComponentSource };

package/dist/babelInjectComponentSource.js

@@ -0,0 +1,115 @@
+// src/babelInjectComponentSource.ts
+import path from "path";
+import { types as t } from "@babel/core";
+
+// src/constants.ts
+var SOURCE_PROP = "__componentSourceLoc";
+
+// src/babelInjectComponentSource.ts
+function isComponentName(name) {
+  return /^[A-Z]/.test(name);
+}
+function getSourceValue(state, loc) {
+  const filename = state.file?.opts?.filename;
+  if (!filename || !loc) {
+    return null;
+  }
+  const relPath = path.relative(process.cwd(), filename).replace(/\\/g, "/");
+  return `${relPath}:${loc.line}:${loc.column + 1}`;
+}
+function buildAssignment(name, sourceValue) {
+  return t.expressionStatement(
+    t.assignmentExpression(
+      "=",
+      t.memberExpression(t.identifier(name), t.identifier(SOURCE_PROP)),
+      t.stringLiteral(sourceValue)
+    )
+  );
+}
+function visitDeclaration(declarationPath, insertAfterPath, state, seen) {
+  if (declarationPath.isFunctionDeclaration() || declarationPath.isClassDeclaration()) {
+    const name = declarationPath.node.id?.name;
+    if (!name || !isComponentName(name) || seen.has(name)) {
+      return;
+    }
+    const sourceValue = getSourceValue(state, declarationPath.node.loc?.start);
+    if (!sourceValue) {
+      return;
+    }
+    seen.add(name);
+    insertAfterPath.insertAfter(buildAssignment(name, sourceValue));
+    return;
+  }
+  if (!declarationPath.isVariableDeclaration()) {
+    return;
+  }
+  const assignments = declarationPath.node.declarations.flatMap((declarator) => {
+    if (!t.isIdentifier(declarator.id) || !isComponentName(declarator.id.name) || seen.has(declarator.id.name)) {
+      return [];
+    }
+    if (!declarator.init) {
+      return [];
+    }
+    if (!t.isArrowFunctionExpression(declarator.init) && !t.isFunctionExpression(declarator.init)) {
+      return [];
+    }
+    const sourceValue = getSourceValue(state, declarator.loc?.start ?? declarator.init.loc?.start);
+    if (!sourceValue) {
+      return [];
+    }
+    seen.add(declarator.id.name);
+    return [buildAssignment(declarator.id.name, sourceValue)];
+  });
+  if (assignments.length > 0) {
+    insertAfterPath.insertAfter(assignments);
+  }
+}
+function babelInjectComponentSource() {
+  return {
+    name: "babel-inject-component-source",
+    visitor: {
+      JSXOpeningElement(pathNode, state) {
+        const hasSourceProp = pathNode.node.attributes.some(
+          (attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === "__source"
+        );
+        if (hasSourceProp) {
+          return;
+        }
+        const filename = state.file?.opts?.filename;
+        const loc = pathNode.node.loc?.start;
+        if (!filename || !loc) {
+          return;
+        }
+        pathNode.node.attributes.push(
+          t.jsxAttribute(
+            t.jsxIdentifier("__source"),
+            t.jsxExpressionContainer(
+              t.objectExpression([
+                t.objectProperty(t.identifier("fileName"), t.stringLiteral(filename)),
+                t.objectProperty(t.identifier("lineNumber"), t.numericLiteral(loc.line)),
+                t.objectProperty(t.identifier("columnNumber"), t.numericLiteral(loc.column + 1))
+              ])
+            )
+          )
+        );
+      },
+      Program(programPath, state) {
+        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);
+            }
+            continue;
+          }
+          visitDeclaration(childPath, childPath, state, seen);
+        }
+      }
+    }
+  };
+}
+export {
+  babelInjectComponentSource
+};
+//# sourceMappingURL=babelInjectComponentSource.js.map

package/dist/babelInjectComponentSource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/babelInjectComponentSource.ts","../src/constants.ts"],"sourcesContent":["import path from \"node:path\";\nimport { types as t, type NodePath, type PluginObj } from \"@babel/core\";\nimport { SOURCE_PROP } from \"./constants\";\n\ntype BabelState = {\n  file?: {\n    opts?: {\n      filename?: string;\n    };\n  };\n};\n\nfunction isComponentName(name: string) {\n  return /^[A-Z]/.test(name);\n}\n\nfunction getSourceValue(state: BabelState, loc: { line: number; column: number } | null | undefined) {\n  const filename = state.file?.opts?.filename;\n  if (!filename || !loc) {\n    return null;\n  }\n\n  const relPath = path.relative(process.cwd(), filename).replace(/\\\\/g, \"/\");\n  return `${relPath}:${loc.line}:${loc.column + 1}`;\n}\n\nfunction buildAssignment(name: string, sourceValue: string) {\n  return t.expressionStatement(\n    t.assignmentExpression(\n      \"=\",\n      t.memberExpression(t.identifier(name), t.identifier(SOURCE_PROP)),\n      t.stringLiteral(sourceValue),\n    ),\n  );\n}\n\nfunction visitDeclaration(\n  declarationPath: NodePath,\n  insertAfterPath: NodePath,\n  state: BabelState,\n  seen: Set<string>,\n) {\n  if (declarationPath.isFunctionDeclaration() || declarationPath.isClassDeclaration()) {\n    const name = declarationPath.node.id?.name;\n    if (!name || !isComponentName(name) || seen.has(name)) {\n      return;\n    }\n\n    const sourceValue = getSourceValue(state, declarationPath.node.loc?.start);\n    if (!sourceValue) {\n      return;\n    }\n\n    seen.add(name);\n    insertAfterPath.insertAfter(buildAssignment(name, sourceValue));\n    return;\n  }\n\n  if (!declarationPath.isVariableDeclaration()) {\n    return;\n  }\n\n  const assignments = declarationPath.node.declarations.flatMap((declarator) => {\n    if (!t.isIdentifier(declarator.id) || !isComponentName(declarator.id.name) || seen.has(declarator.id.name)) {\n      return [];\n    }\n\n    if (!declarator.init) {\n      return [];\n    }\n\n    if (!t.isArrowFunctionExpression(declarator.init) && !t.isFunctionExpression(declarator.init)) {\n      return [];\n    }\n\n    const sourceValue = getSourceValue(state, declarator.loc?.start ?? declarator.init.loc?.start);\n    if (!sourceValue) {\n      return [];\n    }\n\n    seen.add(declarator.id.name);\n    return [buildAssignment(declarator.id.name, sourceValue)];\n  });\n\n  if (assignments.length > 0) {\n    insertAfterPath.insertAfter(assignments);\n  }\n}\n\nexport function babelInjectComponentSource(): PluginObj<BabelState> {\n  return {\n    name: \"babel-inject-component-source\",\n    visitor: {\n      JSXOpeningElement(pathNode, state) {\n        const hasSourceProp = pathNode.node.attributes.some(\n          (attr) => t.isJSXAttribute(attr) && t.isJSXIdentifier(attr.name) && attr.name.name === \"__source\",\n        );\n        if (hasSourceProp) {\n          return;\n        }\n\n        const filename = state.file?.opts?.filename;\n        const loc = pathNode.node.loc?.start;\n        if (!filename || !loc) {\n          return;\n        }\n\n        pathNode.node.attributes.push(\n          t.jsxAttribute(\n            t.jsxIdentifier(\"__source\"),\n            t.jsxExpressionContainer(\n              t.objectExpression([\n                t.objectProperty(t.identifier(\"fileName\"), t.stringLiteral(filename)),\n                t.objectProperty(t.identifier(\"lineNumber\"), t.numericLiteral(loc.line)),\n                t.objectProperty(t.identifier(\"columnNumber\"), t.numericLiteral(loc.column + 1)),\n              ]),\n            ),\n          ),\n        );\n      },\n      Program(programPath, state) {\n        const seen = new Set<string>();\n\n        for (const childPath of programPath.get(\"body\")) {\n          if (childPath.isExportNamedDeclaration() || childPath.isExportDefaultDeclaration()) {\n            const declarationPath = childPath.get(\"declaration\");\n            if (!Array.isArray(declarationPath) && declarationPath.node) {\n              visitDeclaration(declarationPath, childPath, state, seen);\n            }\n            continue;\n          }\n\n          visitDeclaration(childPath, childPath, state, seen);\n        }\n      },\n    },\n  };\n}\n","export const SOURCE_PROP = \"__componentSourceLoc\";\n\n"],"mappings":"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","names":[]}

package/dist/client.cjs

@@ -0,0 +1,153 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  enableReactComponentJump: () => enableReactComponentJump,
+  locateComponentSource: () => locateComponentSource
+});
+module.exports = __toCommonJS(client_exports);
+
+// src/constants.ts
+var SOURCE_PROP = "__componentSourceLoc";
+
+// src/runtime.ts
+function isTriggerPressed(event, triggerKey) {
+  if (triggerKey === "none") {
+    return true;
+  }
+  if (triggerKey === "alt") {
+    return event.altKey;
+  }
+  if (triggerKey === "meta") {
+    return event.metaKey;
+  }
+  if (triggerKey === "ctrl") {
+    return event.ctrlKey;
+  }
+  return event.shiftKey;
+}
+function getReactFiberKey(element) {
+  return Object.keys(element).find((key) => key.startsWith("__reactFiber$") || key.startsWith("__reactInternalInstance$"));
+}
+function getClosestReactFiber(target) {
+  let current = target;
+  while (current) {
+    const fiberKey = getReactFiberKey(current);
+    if (fiberKey) {
+      return current[fiberKey];
+    }
+    current = current.parentElement;
+  }
+  return null;
+}
+function getSourceFromType(type) {
+  if (!type) {
+    return null;
+  }
+  if (typeof type === "function") {
+    const source2 = type[SOURCE_PROP];
+    return typeof source2 === "string" ? source2 : null;
+  }
+  if (typeof type !== "object") {
+    return null;
+  }
+  const record = type;
+  const source = record[SOURCE_PROP] ?? record.type?.[SOURCE_PROP] ?? record.render?.[SOURCE_PROP];
+  return typeof source === "string" ? source : null;
+}
+function resolveSourceFromFiber(fiber) {
+  let current = fiber;
+  while (current) {
+    const source = getSourceFromType(current.type) ?? getSourceFromType(current.elementType);
+    if (source) {
+      return source;
+    }
+    current = current.return ?? null;
+  }
+  return null;
+}
+function getDebugSource(fiber) {
+  let current = fiber;
+  while (current) {
+    const debugSource = current._debugSource;
+    if (debugSource?.fileName && typeof debugSource.lineNumber === "number") {
+      return `${debugSource.fileName.replace(/\\/g, "/")}:${debugSource.lineNumber}:${debugSource.columnNumber ?? 1}`;
+    }
+    current = current.return ?? null;
+  }
+  return null;
+}
+function locateComponentSource(target) {
+  const elementTarget = target instanceof Element ? target : target instanceof Node ? target.parentElement : null;
+  const fiber = getClosestReactFiber(elementTarget);
+  if (!fiber) {
+    return null;
+  }
+  const debugSource = getDebugSource(fiber);
+  if (debugSource) {
+    return {
+      source: debugSource,
+      mode: "jsx"
+    };
+  }
+  const componentSource = resolveSourceFromFiber(fiber);
+  if (!componentSource) {
+    return null;
+  }
+  return {
+    source: componentSource,
+    mode: "component"
+  };
+}
+function enableReactComponentJump(options = {}) {
+  const {
+    triggerKey = "shift",
+    onLocate = (result) => {
+      console.log(`[react-component-jump] ${result.source}`);
+    },
+    onError = (error) => {
+      console.error("[react-component-jump]", error);
+    }
+  } = options;
+  const handler = (event) => {
+    if (!isTriggerPressed(event, triggerKey)) {
+      return;
+    }
+    const result = locateComponentSource(event.target);
+    if (!result) {
+      onError(new Error("No React component source metadata found for clicked element."));
+      return;
+    }
+    event.preventDefault();
+    event.stopPropagation();
+    onLocate(result);
+  };
+  document.addEventListener("click", handler, true);
+  return () => {
+    document.removeEventListener("click", handler, true);
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  enableReactComponentJump,
+  locateComponentSource
+});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/constants.ts","../src/runtime.ts"],"sourcesContent":["export { enableReactComponentJump, locateComponentSource } from \"./runtime\";\nexport type { LocatorOptions, LocatorResult, TriggerKey } from \"./runtime\";\n\n","export const SOURCE_PROP = \"__componentSourceLoc\";\n\n","import { SOURCE_PROP } from \"./constants\";\n\nexport type TriggerKey = \"alt\" | \"meta\" | \"ctrl\" | \"shift\" | \"none\";\n\ntype ReactFiber = {\n  return?: ReactFiber | null;\n  type?: unknown;\n  elementType?: unknown;\n  _debugSource?: {\n    fileName?: string;\n    lineNumber?: number;\n    columnNumber?: number;\n  } | null;\n};\n\nexport type LocatorResult = {\n  source: string;\n  mode: \"jsx\" | \"component\";\n};\n\nexport type LocatorOptions = {\n  triggerKey?: TriggerKey;\n  onLocate?: (result: LocatorResult) => void;\n  onError?: (error: unknown) => void;\n};\n\nfunction isTriggerPressed(event: MouseEvent, triggerKey: TriggerKey) {\n  if (triggerKey === \"none\") {\n    return true;\n  }\n\n  if (triggerKey === \"alt\") {\n    return event.altKey;\n  }\n\n  if (triggerKey === \"meta\") {\n    return event.metaKey;\n  }\n\n  if (triggerKey === \"ctrl\") {\n    return event.ctrlKey;\n  }\n\n  return event.shiftKey;\n}\n\nfunction getReactFiberKey(element: Element) {\n  return Object.keys(element).find((key) => key.startsWith(\"__reactFiber$\") || key.startsWith(\"__reactInternalInstance$\"));\n}\n\nfunction getClosestReactFiber(target: Element | null) {\n  let current = target;\n\n  while (current) {\n    const fiberKey = getReactFiberKey(current);\n    if (fiberKey) {\n      return (current as unknown as Record<string, unknown>)[fiberKey] as ReactFiber;\n    }\n\n    current = current.parentElement;\n  }\n\n  return null;\n}\n\nfunction getSourceFromType(type: unknown) {\n  if (!type) {\n    return null;\n  }\n\n  if (typeof type === \"function\") {\n    const source = (type as unknown as Record<string, unknown>)[SOURCE_PROP];\n    return typeof source === \"string\" ? source : null;\n  }\n\n  if (typeof type !== \"object\") {\n    return null;\n  }\n\n  const record = type as {\n    type?: Record<string, unknown>;\n    render?: Record<string, unknown>;\n    [SOURCE_PROP]?: unknown;\n  };\n\n  const source = record[SOURCE_PROP] ?? record.type?.[SOURCE_PROP] ?? record.render?.[SOURCE_PROP];\n  return typeof source === \"string\" ? source : null;\n}\n\nfunction resolveSourceFromFiber(fiber: ReactFiber | null) {\n  let current = fiber;\n\n  while (current) {\n    const source = getSourceFromType(current.type) ?? getSourceFromType(current.elementType);\n    if (source) {\n      return source;\n    }\n\n    current = current.return ?? null;\n  }\n\n  return null;\n}\n\nfunction getDebugSource(fiber: ReactFiber | null) {\n  let current = fiber;\n\n  while (current) {\n    const debugSource = current._debugSource;\n    if (debugSource?.fileName && typeof debugSource.lineNumber === \"number\") {\n      return `${debugSource.fileName.replace(/\\\\/g, \"/\")}:${debugSource.lineNumber}:${debugSource.columnNumber ?? 1}`;\n    }\n\n    current = current.return ?? null;\n  }\n\n  return null;\n}\n\nexport function locateComponentSource(target: EventTarget | null): LocatorResult | null {\n  const elementTarget =\n    target instanceof Element ? target : target instanceof Node ? target.parentElement : null;\n  const fiber = getClosestReactFiber(elementTarget);\n  if (!fiber) {\n    return null;\n  }\n\n  const debugSource = getDebugSource(fiber);\n  if (debugSource) {\n    return {\n      source: debugSource,\n      mode: \"jsx\",\n    };\n  }\n\n  const componentSource = resolveSourceFromFiber(fiber);\n  if (!componentSource) {\n    return null;\n  }\n\n  return {\n    source: componentSource,\n    mode: \"component\",\n  };\n}\n\nexport function enableReactComponentJump(options: LocatorOptions = {}) {\n  const {\n    triggerKey = \"shift\",\n    onLocate = (result) => {\n      console.log(`[react-component-jump] ${result.source}`);\n    },\n    onError = (error) => {\n      console.error(\"[react-component-jump]\", error);\n    },\n  } = options;\n\n  const handler = (event: MouseEvent) => {\n    if (!isTriggerPressed(event, triggerKey)) {\n      return;\n    }\n\n    const result = locateComponentSource(event.target);\n    if (!result) {\n      onError(new Error(\"No React component source metadata found for clicked element.\"));\n      return;\n    }\n\n    event.preventDefault();\n    event.stopPropagation();\n    onLocate(result);\n  };\n\n  document.addEventListener(\"click\", handler, true);\n\n  return () => {\n    document.removeEventListener(\"click\", handler, true);\n  };\n}\n"],"mappings":"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","names":["source"]}

package/dist/client.d.cts

@@ -0,0 +1,14 @@
+type TriggerKey = "alt" | "meta" | "ctrl" | "shift" | "none";
+type LocatorResult = {
+    source: string;
+    mode: "jsx" | "component";
+};
+type LocatorOptions = {
+    triggerKey?: TriggerKey;
+    onLocate?: (result: LocatorResult) => void;
+    onError?: (error: unknown) => void;
+};
+declare function locateComponentSource(target: EventTarget | null): LocatorResult | null;
+declare function enableReactComponentJump(options?: LocatorOptions): () => void;
+
+export { type LocatorOptions, type LocatorResult, type TriggerKey, enableReactComponentJump, locateComponentSource };

package/dist/client.d.ts

@@ -0,0 +1,14 @@
+type TriggerKey = "alt" | "meta" | "ctrl" | "shift" | "none";
+type LocatorResult = {
+    source: string;
+    mode: "jsx" | "component";
+};
+type LocatorOptions = {
+    triggerKey?: TriggerKey;
+    onLocate?: (result: LocatorResult) => void;
+    onError?: (error: unknown) => void;
+};
+declare function locateComponentSource(target: EventTarget | null): LocatorResult | null;
+declare function enableReactComponentJump(options?: LocatorOptions): () => void;
+
+export { type LocatorOptions, type LocatorResult, type TriggerKey, enableReactComponentJump, locateComponentSource };

package/dist/client.js

@@ -0,0 +1,125 @@
+// src/constants.ts
+var SOURCE_PROP = "__componentSourceLoc";
+
+// src/runtime.ts
+function isTriggerPressed(event, triggerKey) {
+  if (triggerKey === "none") {
+    return true;
+  }
+  if (triggerKey === "alt") {
+    return event.altKey;
+  }
+  if (triggerKey === "meta") {
+    return event.metaKey;
+  }
+  if (triggerKey === "ctrl") {
+    return event.ctrlKey;
+  }
+  return event.shiftKey;
+}
+function getReactFiberKey(element) {
+  return Object.keys(element).find((key) => key.startsWith("__reactFiber$") || key.startsWith("__reactInternalInstance$"));
+}
+function getClosestReactFiber(target) {
+  let current = target;
+  while (current) {
+    const fiberKey = getReactFiberKey(current);
+    if (fiberKey) {
+      return current[fiberKey];
+    }
+    current = current.parentElement;
+  }
+  return null;
+}
+function getSourceFromType(type) {
+  if (!type) {
+    return null;
+  }
+  if (typeof type === "function") {
+    const source2 = type[SOURCE_PROP];
+    return typeof source2 === "string" ? source2 : null;
+  }
+  if (typeof type !== "object") {
+    return null;
+  }
+  const record = type;
+  const source = record[SOURCE_PROP] ?? record.type?.[SOURCE_PROP] ?? record.render?.[SOURCE_PROP];
+  return typeof source === "string" ? source : null;
+}
+function resolveSourceFromFiber(fiber) {
+  let current = fiber;
+  while (current) {
+    const source = getSourceFromType(current.type) ?? getSourceFromType(current.elementType);
+    if (source) {
+      return source;
+    }
+    current = current.return ?? null;
+  }
+  return null;
+}
+function getDebugSource(fiber) {
+  let current = fiber;
+  while (current) {
+    const debugSource = current._debugSource;
+    if (debugSource?.fileName && typeof debugSource.lineNumber === "number") {
+      return `${debugSource.fileName.replace(/\\/g, "/")}:${debugSource.lineNumber}:${debugSource.columnNumber ?? 1}`;
+    }
+    current = current.return ?? null;
+  }
+  return null;
+}
+function locateComponentSource(target) {
+  const elementTarget = target instanceof Element ? target : target instanceof Node ? target.parentElement : null;
+  const fiber = getClosestReactFiber(elementTarget);
+  if (!fiber) {
+    return null;
+  }
+  const debugSource = getDebugSource(fiber);
+  if (debugSource) {
+    return {
+      source: debugSource,
+      mode: "jsx"
+    };
+  }
+  const componentSource = resolveSourceFromFiber(fiber);
+  if (!componentSource) {
+    return null;
+  }
+  return {
+    source: componentSource,
+    mode: "component"
+  };
+}
+function enableReactComponentJump(options = {}) {
+  const {
+    triggerKey = "shift",
+    onLocate = (result) => {
+      console.log(`[react-component-jump] ${result.source}`);
+    },
+    onError = (error) => {
+      console.error("[react-component-jump]", error);
+    }
+  } = options;
+  const handler = (event) => {
+    if (!isTriggerPressed(event, triggerKey)) {
+      return;
+    }
+    const result = locateComponentSource(event.target);
+    if (!result) {
+      onError(new Error("No React component source metadata found for clicked element."));
+      return;
+    }
+    event.preventDefault();
+    event.stopPropagation();
+    onLocate(result);
+  };
+  document.addEventListener("click", handler, true);
+  return () => {
+    document.removeEventListener("click", handler, true);
+  };
+}
+export {
+  enableReactComponentJump,
+  locateComponentSource
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/constants.ts","../src/runtime.ts"],"sourcesContent":["export const SOURCE_PROP = \"__componentSourceLoc\";\n\n","import { SOURCE_PROP } from \"./constants\";\n\nexport type TriggerKey = \"alt\" | \"meta\" | \"ctrl\" | \"shift\" | \"none\";\n\ntype ReactFiber = {\n  return?: ReactFiber | null;\n  type?: unknown;\n  elementType?: unknown;\n  _debugSource?: {\n    fileName?: string;\n    lineNumber?: number;\n    columnNumber?: number;\n  } | null;\n};\n\nexport type LocatorResult = {\n  source: string;\n  mode: \"jsx\" | \"component\";\n};\n\nexport type LocatorOptions = {\n  triggerKey?: TriggerKey;\n  onLocate?: (result: LocatorResult) => void;\n  onError?: (error: unknown) => void;\n};\n\nfunction isTriggerPressed(event: MouseEvent, triggerKey: TriggerKey) {\n  if (triggerKey === \"none\") {\n    return true;\n  }\n\n  if (triggerKey === \"alt\") {\n    return event.altKey;\n  }\n\n  if (triggerKey === \"meta\") {\n    return event.metaKey;\n  }\n\n  if (triggerKey === \"ctrl\") {\n    return event.ctrlKey;\n  }\n\n  return event.shiftKey;\n}\n\nfunction getReactFiberKey(element: Element) {\n  return Object.keys(element).find((key) => key.startsWith(\"__reactFiber$\") || key.startsWith(\"__reactInternalInstance$\"));\n}\n\nfunction getClosestReactFiber(target: Element | null) {\n  let current = target;\n\n  while (current) {\n    const fiberKey = getReactFiberKey(current);\n    if (fiberKey) {\n      return (current as unknown as Record<string, unknown>)[fiberKey] as ReactFiber;\n    }\n\n    current = current.parentElement;\n  }\n\n  return null;\n}\n\nfunction getSourceFromType(type: unknown) {\n  if (!type) {\n    return null;\n  }\n\n  if (typeof type === \"function\") {\n    const source = (type as unknown as Record<string, unknown>)[SOURCE_PROP];\n    return typeof source === \"string\" ? source : null;\n  }\n\n  if (typeof type !== \"object\") {\n    return null;\n  }\n\n  const record = type as {\n    type?: Record<string, unknown>;\n    render?: Record<string, unknown>;\n    [SOURCE_PROP]?: unknown;\n  };\n\n  const source = record[SOURCE_PROP] ?? record.type?.[SOURCE_PROP] ?? record.render?.[SOURCE_PROP];\n  return typeof source === \"string\" ? source : null;\n}\n\nfunction resolveSourceFromFiber(fiber: ReactFiber | null) {\n  let current = fiber;\n\n  while (current) {\n    const source = getSourceFromType(current.type) ?? getSourceFromType(current.elementType);\n    if (source) {\n      return source;\n    }\n\n    current = current.return ?? null;\n  }\n\n  return null;\n}\n\nfunction getDebugSource(fiber: ReactFiber | null) {\n  let current = fiber;\n\n  while (current) {\n    const debugSource = current._debugSource;\n    if (debugSource?.fileName && typeof debugSource.lineNumber === \"number\") {\n      return `${debugSource.fileName.replace(/\\\\/g, \"/\")}:${debugSource.lineNumber}:${debugSource.columnNumber ?? 1}`;\n    }\n\n    current = current.return ?? null;\n  }\n\n  return null;\n}\n\nexport function locateComponentSource(target: EventTarget | null): LocatorResult | null {\n  const elementTarget =\n    target instanceof Element ? target : target instanceof Node ? target.parentElement : null;\n  const fiber = getClosestReactFiber(elementTarget);\n  if (!fiber) {\n    return null;\n  }\n\n  const debugSource = getDebugSource(fiber);\n  if (debugSource) {\n    return {\n      source: debugSource,\n      mode: \"jsx\",\n    };\n  }\n\n  const componentSource = resolveSourceFromFiber(fiber);\n  if (!componentSource) {\n    return null;\n  }\n\n  return {\n    source: componentSource,\n    mode: \"component\",\n  };\n}\n\nexport function enableReactComponentJump(options: LocatorOptions = {}) {\n  const {\n    triggerKey = \"shift\",\n    onLocate = (result) => {\n      console.log(`[react-component-jump] ${result.source}`);\n    },\n    onError = (error) => {\n      console.error(\"[react-component-jump]\", error);\n    },\n  } = options;\n\n  const handler = (event: MouseEvent) => {\n    if (!isTriggerPressed(event, triggerKey)) {\n      return;\n    }\n\n    const result = locateComponentSource(event.target);\n    if (!result) {\n      onError(new Error(\"No React component source metadata found for clicked element.\"));\n      return;\n    }\n\n    event.preventDefault();\n    event.stopPropagation();\n    onLocate(result);\n  };\n\n  document.addEventListener(\"click\", handler, true);\n\n  return () => {\n    document.removeEventListener(\"click\", handler, true);\n  };\n}\n"],"mappings":"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","names":["source"]}