Function checkSourceLocationSupport

package/src/utils/source-location.ts:854–904

()

 * @returns Object describing support status
 */
export function checkSourceLocationSupport(): {
  supported: boolean;
  reason: string;
  suggestions: string[];
} {
  const reactInfo = detectReactApp();

  if (!reactInfo.isReact) {
    return {
      supported: false,
      reason: "No React application detected on this page",
      suggestions: [
        "Ensure you're on a page built with React",
        "The page may use a different framework (Vue, Angular, etc.)",
      ],
    };
  }

  if (reactInfo.isProduction) {
    return {
      supported: false,
      reason: "Production build detected - source info is stripped",
      suggestions: [
        "Run the application in development mode",
        "Set NODE_ENV=development",
        "Ensure your bundler includes source info in development",
      ],
    };
  }

  // Check for DevTools
  const hasDevTools = typeof window !== "undefined" &&
    !!(window as unknown as Record<string, unknown>).__REACT_DEVTOOLS_GLOBAL_HOOK__;

  if (!hasDevTools) {
    return {
      supported: true,
      reason: "Development mode detected, but React DevTools not installed",
      suggestions: [
        "Install React DevTools browser extension for best results",
        "Source detection may still work without it",
      ],
    };
  }

  return {
    supported: true,
    reason: `React ${reactInfo.version || "unknown"} development mode detected`,
    suggestions: [],
  };
}