@whatitbroke/react 1.0.0

package/dist/adapter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WhatItBroke - React Adapter
+ * Captures React render errors, component stacks, props/state snapshots, and hook contexts.
+ */
+import { ComponentContext, DebugAdapter, DebugContext, RuntimeContext } from '@whatitbroke/shared';
+import { WhatItBrokeCore } from '@whatitbroke/core';
+export interface ReactErrorExtras {
+    componentStack?: string;
+    componentName?: string;
+    props?: Record<string, unknown>;
+    state?: Record<string, unknown>;
+    lifecyclePhase?: ComponentContext['lifecyclePhase'];
+}
+export declare class ReactAdapter implements DebugAdapter {
+    readonly name = "@whatitbroke/react";
+    readonly framework: "react";
+    private core;
+    private currentComponentContext?;
+    constructor(core?: WhatItBrokeCore);
+    detect(): boolean;
+    getComponentContext(): ComponentContext | undefined;
+    getRuntimeContext(): RuntimeContext;
+    /**
+     * Parses React's componentStack string into an array of component names from top to bottom
+     */
+    parseComponentStack(componentStack?: string): {
+        renderPath: string[];
+        primaryComponent: string;
+    };
+    captureContext(error: unknown, extras?: ReactErrorExtras): DebugContext;
+    analyzeReactError(error: unknown, extras?: ReactErrorExtras): Promise<import("@whatitbroke/shared").RootCauseReport>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,YAAY,EAGZ,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,gBAAgB;IAC/B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;CACrD;AAED,qBAAa,YAAa,YAAW,YAAY;IAC/C,SAAgB,IAAI,wBAAwB;IAC5C,SAAgB,SAAS,EAAG,OAAO,CAAU;IAE7C,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,uBAAuB,CAAC,CAAmB;gBAEvC,IAAI,CAAC,EAAE,eAAe;IAI3B,MAAM,IAAI,OAAO;IASjB,mBAAmB,IAAI,gBAAgB,GAAG,SAAS;IAInD,iBAAiB,IAAI,cAAc;IAO1C;;OAEG;IACI,mBAAmB,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG;QAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;IA4BhG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY;IAoEjE,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,gBAAgB;CAIzE"}

package/dist/adapter.js

@@ -0,0 +1,120 @@
+/**
+ * WhatItBroke - React Adapter
+ * Captures React render errors, component stacks, props/state snapshots, and hook contexts.
+ */
+import { StackParser, SourceMapResolver, getGlobalTimeline, getCore, } from '@whatitbroke/core';
+import { HooksDetector } from './hooks-detector.js';
+export class ReactAdapter {
+    name = '@whatitbroke/react';
+    framework = 'react';
+    core;
+    currentComponentContext;
+    constructor(core) {
+        this.core = core || getCore();
+    }
+    detect() {
+        const g = globalThis;
+        return Boolean(g.React ||
+            g.__REACT_DEVTOOLS_GLOBAL_HOOK__ ||
+            (typeof document !== 'undefined' && document.getElementById('root')));
+    }
+    getComponentContext() {
+        return this.currentComponentContext;
+    }
+    getRuntimeContext() {
+        return {
+            environment: 'browser',
+            platform: typeof navigator !== 'undefined' ? navigator.platform : undefined,
+        };
+    }
+    /**
+     * Parses React's componentStack string into an array of component names from top to bottom
+     */
+    parseComponentStack(componentStack) {
+        if (!componentStack) {
+            return { renderPath: ['App', 'Component'], primaryComponent: 'Component' };
+        }
+        const lines = componentStack.split('\n');
+        const components = [];
+        for (const rawLine of lines) {
+            const line = rawLine.trim();
+            const match = line.match(/^in\s+([A-Za-z0-9_]+)/);
+            if (match) {
+                components.push(match[1]);
+            }
+        }
+        // In React componentStack, the top line is the crashing leaf component,
+        // and subsequent lines are parent components (e.g. leaf -> parent -> root).
+        // Reverse it to create chronological root-to-leaf renderPath.
+        const reversed = [...components].reverse();
+        const primary = components[0] || 'Component';
+        return {
+            renderPath: reversed.length > 0 ? reversed : [primary],
+            primaryComponent: primary,
+        };
+    }
+    captureContext(error, extras) {
+        const errObj = error instanceof Error ? error : new Error(String(error));
+        const stackFrames = StackParser.parse(errObj.stack);
+        const primaryFrame = StackParser.getPrimaryFrame(stackFrames);
+        const source = primaryFrame
+            ? SourceMapResolver.resolveLocation(primaryFrame)
+            : {
+                file: 'unknown',
+                line: 0,
+                column: 0,
+            };
+        const parsedStack = this.parseComponentStack(extras?.componentStack);
+        const componentName = extras?.componentName || parsedStack.primaryComponent;
+        const componentCtx = {
+            name: componentName,
+            props: extras?.props,
+            state: extras?.state,
+            renderPath: parsedStack.renderPath,
+            lifecyclePhase: extras?.lifecyclePhase || 'render',
+            file: source.file,
+            line: source.line,
+        };
+        this.currentComponentContext = componentCtx;
+        // Check for hook errors
+        const hookInfo = HooksDetector.analyze(errObj);
+        if (hookInfo.isHookError) {
+            getGlobalTimeline().record('undefined_value_detected', `React Hook Error: ${hookInfo.message}`, {
+                file: source.file,
+                line: source.line,
+            });
+        }
+        const errorInfo = {
+            name: errObj.name || 'ReactRenderError',
+            message: errObj.message || 'React rendering crashed',
+            rawStack: errObj.stack,
+            timestamp: Date.now(),
+        };
+        const executionPath = parsedStack.renderPath.map((comp, idx) => ({
+            id: `render_${idx}_${comp}`,
+            timestamp: Date.now(),
+            category: 'render',
+            name: comp,
+            description: `Rendered component <${comp} />`,
+        }));
+        return {
+            id: `ctx_react_${Date.now()}`,
+            timestamp: Date.now(),
+            error: errorInfo,
+            source,
+            stack: stackFrames,
+            runtime: this.getRuntimeContext(),
+            executionPath,
+            timeline: getGlobalTimeline().getEvents(),
+            framework: {
+                name: 'react',
+                component: componentCtx,
+            },
+        };
+    }
+    async analyzeReactError(error, extras) {
+        const context = this.captureContext(error, extras);
+        return this.core.analyze(context);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/boundary.d.ts

@@ -0,0 +1,26 @@
+/**
+ * WhatItBroke - React Error Boundary Component
+ * Wraps React components, captures crashes, and renders an actionable root-cause overlay.
+ */
+import { Component, ErrorInfo as ReactErrorInfo, ReactNode } from 'react';
+import { RootCauseReport } from '@whatitbroke/shared';
+export interface WhatItBrokeBoundaryProps {
+    children: ReactNode;
+    fallback?: (report: RootCauseReport | null, error: Error) => ReactNode;
+    onError?: (report: RootCauseReport, error: Error) => void;
+    showOverlay?: boolean;
+}
+interface WhatItBrokeBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+    report: RootCauseReport | null;
+}
+export declare class WhatItBrokeBoundary extends Component<WhatItBrokeBoundaryProps, WhatItBrokeBoundaryState> {
+    private adapter;
+    constructor(props: WhatItBrokeBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<WhatItBrokeBoundaryState>;
+    componentDidCatch(error: Error, errorInfo: ReactErrorInfo): Promise<void>;
+    render(): ReactNode;
+}
+export {};
+//# sourceMappingURL=boundary.d.ts.map

package/dist/boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../src/boundary.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAc,EAAE,SAAS,EAAE,SAAS,IAAI,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,UAAU,wBAAwB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,wBAAwB,EAAE,wBAAwB,CAAC;IACpG,OAAO,CAAC,OAAO,CAAe;gBAElB,KAAK,EAAE,wBAAwB;IAU3C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY/E,MAAM,IAAI,SAAS;CA8G7B"}

package/dist/boundary.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * WhatItBroke - React Error Boundary Component
+ * Wraps React components, captures crashes, and renders an actionable root-cause overlay.
+ */
+import { Component } from 'react';
+import { ReactAdapter } from './adapter.js';
+export class WhatItBrokeBoundary extends Component {
+    adapter;
+    constructor(props) {
+        super(props);
+        this.state = {
+            hasError: false,
+            error: null,
+            report: null,
+        };
+        this.adapter = new ReactAdapter();
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    async componentDidCatch(error, errorInfo) {
+        const report = await this.adapter.analyzeReactError(error, {
+            componentStack: errorInfo.componentStack || undefined,
+        });
+        this.setState({ report });
+        if (this.props.onError) {
+            this.props.onError(report, error);
+        }
+    }
+    render() {
+        if (!this.state.hasError) {
+            return this.props.children;
+        }
+        if (this.props.fallback && this.state.error) {
+            return this.props.fallback(this.state.report, this.state.error);
+        }
+        // Default actionable overlay
+        const report = this.state.report;
+        const err = this.state.error;
+        return (_jsxs("div", { style: {
+                fontFamily: 'ui-sans-serif, system-ui, -apple-system, sans-serif',
+                background: '#0f172a',
+                color: '#f8fafc',
+                padding: '24px',
+                borderRadius: '12px',
+                border: '1px solid #ef4444',
+                margin: '20px',
+                boxShadow: '0 20px 25px -5px rgba(0, 0, 0, 0.5)',
+            }, children: [_jsxs("div", { style: { display: 'flex', alignItems: 'center', gap: '12px', marginBottom: '16px' }, children: [_jsx("span", { style: {
+                                background: '#ef4444',
+                                color: 'white',
+                                fontWeight: 800,
+                                padding: '4px 10px',
+                                borderRadius: '6px',
+                                fontSize: '12px',
+                                letterSpacing: '1px',
+                            }, children: "WHAT IT BROKE" }), _jsxs("h2", { style: { fontSize: '18px', margin: 0, color: '#f87171' }, children: [err?.name, ": ", err?.message] })] }), report ? (_jsxs("div", { children: [_jsxs("div", { style: { marginBottom: '12px', color: '#94a3b8', fontSize: '13px' }, children: ["\uD83D\uDCCD ", _jsxs("strong", { children: [report.affectedLocation.file, ":", report.affectedLocation.line] })] }), _jsxs("div", { style: {
+                                background: 'rgba(239, 68, 68, 0.1)',
+                                border: '1px solid rgba(239, 68, 68, 0.2)',
+                                padding: '12px',
+                                borderRadius: '8px',
+                                marginBottom: '16px',
+                            }, children: [_jsx("div", { style: { fontWeight: 700, fontSize: '12px', color: '#fca5a5', textTransform: 'uppercase' }, children: "Cause (Why)" }), _jsx("div", { style: { marginTop: '4px', fontSize: '14px', color: '#fef2f2' }, children: report.rootCause })] }), _jsxs("div", { style: {
+                                background: 'rgba(16, 185, 129, 0.1)',
+                                border: '1px solid rgba(16, 185, 129, 0.2)',
+                                padding: '12px',
+                                borderRadius: '8px',
+                                marginBottom: '16px',
+                            }, children: [_jsx("div", { style: { fontWeight: 700, fontSize: '12px', color: '#6ee7b7', textTransform: 'uppercase' }, children: "Recommended Fix (How)" }), _jsx("div", { style: { marginTop: '4px', fontSize: '14px', color: '#ecfdf5' }, children: report.suggestedFix.explanation })] }), report.suggestedFix.suggestedPatch && (_jsx("pre", { style: {
+                                background: '#090d16',
+                                padding: '12px',
+                                borderRadius: '6px',
+                                fontFamily: 'monospace',
+                                fontSize: '12px',
+                                overflowX: 'auto',
+                                border: '1px solid #1e293b',
+                                color: '#a7f3d0',
+                            }, children: report.suggestedFix.suggestedPatch }))] })) : (_jsx("div", { style: { color: '#94a3b8', fontSize: '14px' }, children: "Analyzing component crash and reconstructing execution path..." }))] }));
+    }
+}
+//# sourceMappingURL=boundary.js.map

package/dist/boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.js","sourceRoot":"","sources":["../src/boundary.tsx"],"names":[],"mappings":"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"}

package/dist/hooks-detector.d.ts

@@ -0,0 +1,18 @@
+/**
+ * WhatItBroke - React Hook Rules Detector
+ * Analyzes hook order violations, conditional hooks, and lifecycle hook mismatches.
+ */
+export interface HookErrorInfo {
+    isHookError: boolean;
+    type: 'conditional_hook' | 'invalid_call' | 'missing_dependency' | 'other';
+    message: string;
+    expectedOrder?: number;
+    actualOrder?: number;
+    advice: string;
+}
+export declare class HooksDetector {
+    static analyze(error: Error | {
+        message: string;
+    }): HookErrorInfo;
+}
+//# sourceMappingURL=hooks-detector.d.ts.map

package/dist/hooks-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-detector.d.ts","sourceRoot":"","sources":["../src/hooks-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,kBAAkB,GAAG,cAAc,GAAG,oBAAoB,GAAG,OAAO,CAAC;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,aAAa;WACV,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa;CAgDzE"}

package/dist/hooks-detector.js

@@ -0,0 +1,44 @@
+/**
+ * WhatItBroke - React Hook Rules Detector
+ * Analyzes hook order violations, conditional hooks, and lifecycle hook mismatches.
+ */
+export class HooksDetector {
+    static analyze(error) {
+        const msg = error.message || '';
+        if (msg.includes('Rendered fewer hooks than expected') ||
+            msg.includes('Rendered more hooks than expected') ||
+            msg.includes('rendered more hooks than during the previous render') ||
+            msg.includes('rendered fewer hooks than during the previous render')) {
+            return {
+                isHookError: true,
+                type: 'conditional_hook',
+                message: msg,
+                advice: 'React Hooks must be executed in the exact same order on every render. Ensure hooks are never called inside if statements, loops, or after conditional early returns.',
+            };
+        }
+        if (msg.includes('Invalid hook call') ||
+            msg.includes('Hooks can only be called inside of the body of a function component')) {
+            return {
+                isHookError: true,
+                type: 'invalid_call',
+                message: msg,
+                advice: 'Hooks can only be called at the top level of a React function component or custom hook. Check for mismatched React versions or calling hooks from regular JavaScript functions.',
+            };
+        }
+        if (msg.includes('missing dependency') || msg.includes('react-hooks/exhaustive-deps')) {
+            return {
+                isHookError: true,
+                type: 'missing_dependency',
+                message: msg,
+                advice: 'useEffect/useCallback/useMemo dependency array is missing referenced state or prop variables, which may cause stale closures.',
+            };
+        }
+        return {
+            isHookError: false,
+            type: 'other',
+            message: msg,
+            advice: '',
+        };
+    }
+}
+//# sourceMappingURL=hooks-detector.js.map

package/dist/hooks-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-detector.js","sourceRoot":"","sources":["../src/hooks-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,OAAO,aAAa;IACjB,MAAM,CAAC,OAAO,CAAC,KAAkC;QACtD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;QAEhC,IACE,GAAG,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAClD,GAAG,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YACjD,GAAG,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YACnE,GAAG,CAAC,QAAQ,CAAC,sDAAsD,CAAC,EACpE,CAAC;YACD,OAAO;gBACL,WAAW,EAAE,IAAI;gBACjB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,GAAG;gBACZ,MAAM,EACJ,sKAAsK;aACzK,CAAC;QACJ,CAAC;QAED,IACE,GAAG,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACjC,GAAG,CAAC,QAAQ,CAAC,qEAAqE,CAAC,EACnF,CAAC;YACD,OAAO;gBACL,WAAW,EAAE,IAAI;gBACjB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,GAAG;gBACZ,MAAM,EACJ,iLAAiL;aACpL,CAAC;QACJ,CAAC;QAED,IAAI,GAAG,CAAC,QAAQ,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;YACtF,OAAO;gBACL,WAAW,EAAE,IAAI;gBACjB,IAAI,EAAE,oBAAoB;gBAC1B,OAAO,EAAE,GAAG;gBACZ,MAAM,EACJ,+HAA+H;aAClI,CAAC;QACJ,CAAC;QAED,OAAO;YACL,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,GAAG;YACZ,MAAM,EAAE,EAAE;SACX,CAAC;IACJ,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './adapter.js';
+export * from './hooks-detector.js';
+export * from './boundary.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export * from './adapter.js';
+export * from './hooks-detector.js';
+export * from './boundary.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@whatitbroke/react",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "React adapter, Error Boundary, hook rule analyzer, and component tree inspector for WhatItBroke",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@whatitbroke/shared": "1.0.0",
+    "@whatitbroke/core": "1.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.10"
+  },
+  "keywords": ["debugger", "react", "error-boundary", "hooks", "root-cause"],
+  "author": "WhatItBroke Team",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}