@treelocator/runtime 0.1.8 → 0.2.0

package/src/functions/normalizeFilePath.ts

@@ -0,0 +1,41 @@
+/**
+ * Convert absolute file paths to relative paths for display.
+ *
+ * This ensures consistent path display across different sources:
+ * - React _debugSource may provide absolute paths
+ * - Next.js data-locatorjs attributes may have absolute paths
+ * - Phoenix comments use relative paths
+ *
+ * Examples:
+ *   - "/Users/name/project/src/App.tsx" → "src/App.tsx"
+ *   - "/workspace/apps/next-16/app/page.tsx" → "app/page.tsx"
+ *   - "src/components/Button.tsx" → "src/components/Button.tsx" (unchanged)
+ */
+export function normalizeFilePath(filePath: string): string {
+  // If it's already relative (doesn't start with /), return as-is
+  if (!filePath.startsWith("/")) {
+    return filePath;
+  }
+
+  // Find common project indicators to trim the path
+  const indicators = ["/app/", "/src/", "/pages/", "/components/", "/lib/"];
+
+  for (const indicator of indicators) {
+    const index = filePath.indexOf(indicator);
+    if (index !== -1) {
+      // Return from the indicator onwards (remove leading slash)
+      return filePath.substring(index + 1);
+    }
+  }
+
+  // If no indicator found, try to get just the last few path segments
+  const parts = filePath.split("/");
+
+  // Return last 3-4 segments if available (e.g., "apps/next-16/app/page.tsx")
+  if (parts.length > 3) {
+    return parts.slice(-4).join("/");
+  }
+
+  // Last resort: return as-is
+  return filePath;
+}

package/src/types/ServerComponentInfo.ts

@@ -0,0 +1,14 @@
+/**
+ * Represents a server-side component in the ancestry chain.
+ * Used for Phoenix LiveView, Rails ViewComponents, Next.js RSC, etc.
+ */
+export interface ServerComponentInfo {
+  /** Component name (e.g., "AppWeb.CoreComponents.button") or "@caller" for call site */
+  name: string;
+  /** File path (e.g., "lib/app_web/core_components.ex") */
+  filePath: string;
+  /** Line number in the source file */
+  line: number;
+  /** Type of server component annotation */
+  type: "component" | "caller";
+}