react-dev-panel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pavan Kumar Mistry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,130 @@
+# react-dev-panel
+
+A **framework-agnostic, self-contained** floating dev panel for any React app — no MUI, no
+Redux, no design-system coupling. One component, gated to internal/dev users, giving you:
+
+- **Developer Logs** — live console + network capture
+- **Page Performance** — Core Web Vitals with fix hints
+- **Component Graph Inspector** — hover-to-source, component tree, "what's on this page", open-in-editor
+
+Styles are injected once under a `.rdp-root` scope, so the panel can't clash with — or be
+clashed by — your app's theme. The only runtime requirement is React 18+.
+
+## Install
+
+```bash
+npm i -D react-dev-panel
+```
+
+## Usage
+
+Mount it once near your app root. It renders nothing in production by default.
+
+```tsx
+import { DevPanel } from 'react-dev-panel';
+
+export function Providers({ children }) {
+  return (
+    <>
+      {children}
+      <DevPanel
+        // Gate: who may see it. Defaults to NODE_ENV !== 'production'.
+        enabled={process.env.NODE_ENV !== 'production' || user?.isInternal}
+        // Current route, for tools that display it (optional).
+        getRoute={() => location.pathname}
+      />
+    </>
+  );
+}
+```
+
+That's it — a draggable launcher appears in the corner.
+
+### Configuration
+
+| Prop | Type | Default | Purpose |
+|------|------|---------|---------|
+| `enabled` | `boolean` | `NODE_ENV !== 'production'` | Master gate — the host owns the access decision. |
+| `getRoute` | `() => string` | `location.pathname` | Current route for display. Adapters wire your router. |
+| `openInEditor` | `(loc, editor?) => void` | protocol URL + copy | How source files open. Adapters provide a server-backed opener. |
+| `graphEndpoint` | `string` | — | URL serving the component graph JSON (Component Graph Inspector). |
+| `editor` | `'auto' \| 'vscode' \| 'cursor' \| 'webstorm' \| 'zed'` | `'auto'` | Preferred editor for protocol opens. |
+| `theme` | `{ accent?, accentContrast? }` | purple | Accent color override. |
+| `tools` | `string[]` | all | Restrict/reorder tools by id (`'logs'`, `'perf'`, `'graph'`). |
+
+### Custom tools
+
+```tsx
+import { registerTool } from 'react-dev-panel';
+
+registerTool({
+  id: 'my-tool',
+  title: 'My Tool',
+  subtitle: 'Does a thing',
+  icon: <MyIcon />,
+  Panel: ({ onClose }) => <div>…</div>,
+});
+```
+
+## Component Graph Inspector
+
+Reliable component inspection that works in normal dev (Turbopack/Vite — no special build):
+
+1. **Generate the graph** (components, files, parent/child/import/route edges):
+   ```bash
+   npx dev-panel-graph --scan src
+   # → .dev-panel/component-graph.json
+   ```
+2. **Serve it + enable open-in-editor** with an adapter (below).
+3. Open the panel → **Inspect mode** → hover (highlight + tooltip), click to lock, ⌘/Ctrl+click
+   to open. Tabs: **Graph** (search + relationship tree), **Page** (what's mounted on this
+   route), **File** (source + open).
+
+Resolution climbs the React fiber tree to the nearest component that's in the graph, so hovering
+a leaf still lands on your real app component. Open-in-editor uses the editor **running the
+project** (`launch-editor`) — VS Code, Cursor, WebStorm, Zed, … — via the adapter endpoint.
+
+### Adapters
+
+**Vite**
+```ts
+import { devPanel } from 'react-dev-panel/vite';
+export default defineConfig({ plugins: [react(), devPanel({ scan: ['src'] })] });
+```
+
+**Next.js (App Router)** — gate these yourself; dev/internal only.
+```ts
+// app/dev-panel/graph/route.ts
+export const { GET } = createGraphRoute({ enabled: () => process.env.NODE_ENV !== 'production' });
+// app/dev-panel/open-file/route.ts
+export const { POST } = createOpenFileRoute({ enabled: () => process.env.NODE_ENV !== 'production' });
+```
+
+**Any Node server (CRA/Express/custom)**
+```ts
+import { createDevPanelMiddleware } from 'react-dev-panel/server';
+app.use(createDevPanelMiddleware());
+```
+
+Then wire the client:
+```tsx
+import { DevPanel, serverOpenInEditor, DEFAULT_GRAPH_ENDPOINT } from 'react-dev-panel';
+<DevPanel enabled={isDev} graphEndpoint={DEFAULT_GRAPH_ENDPOINT} openInEditor={serverOpenInEditor} />
+```
+
+Without an adapter the inspector still works at runtime (component names, tree from the graph if
+served, page scan); open-in-editor falls back to `editor://` protocol URLs then copy.
+
+## Roadmap
+
+- [x] Framework-agnostic core (provider, launcher, self-contained styles, tool registry)
+- [x] Developer Logs · Page Performance · Component Graph Inspector
+- [x] CLI `dev-panel-graph` (TypeScript Compiler API)
+- [x] Adapters: `/next`, `/vite`, `/server`
+- [ ] Demo apps + browser-tested screenshots
+- [ ] Optional Babel/SWC transform for exact element line:col
+
+## License
+
+MIT
+

package/dist/adapters/next.cjs

@@ -0,0 +1,95 @@
+'use strict';
+
+var path = require('path');
+var fs = require('fs');
+var promises = require('fs/promises');
+
+// src/adapters/next.ts
+
+// src/core/server-open.ts
+var DEFAULT_GRAPH_ENDPOINT = "/dev-panel/graph";
+var DEFAULT_OPEN_ENDPOINT = "/dev-panel/open-file";
+function createServerOpenInEditor(endpoint = DEFAULT_OPEN_ENDPOINT) {
+  return async (loc, editor = "auto") => {
+    try {
+      const res = await fetch(endpoint, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ file: loc.file, line: loc.line, column: loc.column, editor })
+      });
+      if (res.ok) return true;
+    } catch {
+    }
+    if (typeof navigator !== "undefined" && navigator.clipboard) {
+      await navigator.clipboard.writeText(`${loc.file}${loc.line ? `:${loc.line}` : ""}`).catch(() => void 0);
+    }
+    return false;
+  };
+}
+var serverOpenInEditor = createServerOpenInEditor();
+
+// src/adapters/next.ts
+var EDITOR_BIN = {
+  auto: void 0,
+  vscode: "code",
+  cursor: "cursor",
+  webstorm: "webstorm",
+  zed: "zed"
+};
+var json = (body, status = 200) => new Response(typeof body === "string" ? body : JSON.stringify(body), {
+  status,
+  headers: { "Content-Type": "application/json", "Cache-Control": "no-store" }
+});
+async function gate(enabled) {
+  if (process.env.NODE_ENV === "production" && !enabled) return false;
+  if (enabled) return await enabled() === true;
+  return true;
+}
+function createGraphRoute(options = {}) {
+  const root = path.resolve(options.root ?? process.cwd());
+  const graphFile = path.resolve(root, options.graphFile ?? ".dev-panel/component-graph.json");
+  return {
+    async GET() {
+      if (!await gate(options.enabled)) return json({ error: "Not found" }, 404);
+      try {
+        return json(await promises.readFile(graphFile, "utf8"));
+      } catch {
+        return json({ error: "graph-not-generated", hint: "Run: npx dev-panel-graph" }, 404);
+      }
+    }
+  };
+}
+function createOpenFileRoute(options = {}) {
+  const root = path.resolve(options.root ?? process.cwd());
+  return {
+    async POST(req) {
+      if (!await gate(options.enabled)) return json({ error: "Not found" }, 404);
+      let body;
+      try {
+        body = await req.json();
+      } catch {
+        return json({ error: "invalid body" }, 400);
+      }
+      if (!body.file) return json({ error: "file required" }, 400);
+      const abs = path.isAbsolute(body.file) ? path.resolve(body.file) : path.resolve(root, body.file);
+      const rel = path.relative(root, abs);
+      if (rel.startsWith("..") || path.isAbsolute(rel)) return json({ error: "path escapes root" }, 403);
+      if (!fs.existsSync(abs) || !fs.statSync(abs).isFile()) return json({ error: "not found" }, 404);
+      try {
+        const launch = (await import('launch-editor')).default;
+        launch(`${abs}:${body.line ?? 1}:${body.column ?? 1}`, EDITOR_BIN[body.editor ?? "auto"]);
+        return json({ ok: true });
+      } catch (err) {
+        return json({ error: err instanceof Error ? err.message : "open failed" }, 500);
+      }
+    }
+  };
+}
+
+exports.DEFAULT_GRAPH_ENDPOINT = DEFAULT_GRAPH_ENDPOINT;
+exports.DEFAULT_OPEN_ENDPOINT = DEFAULT_OPEN_ENDPOINT;
+exports.createGraphRoute = createGraphRoute;
+exports.createOpenFileRoute = createOpenFileRoute;
+exports.serverOpenInEditor = serverOpenInEditor;
+//# sourceMappingURL=next.cjs.map
+//# sourceMappingURL=next.cjs.map

package/dist/adapters/next.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/server-open.ts","../../src/adapters/next.ts"],"names":["resolve","readFile","isAbsolute","relative","existsSync","statSync"],"mappings":"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","file":"next.cjs","sourcesContent":["import type { OpenInEditor } from './types';\n\n/**\n * Default endpoint paths the adapters mount and the client talks to. No leading underscore —\n * Next.js App Router treats `_`-prefixed segments as private (non-routable), so this path works\n * uniformly across the Next, Vite, and generic-server adapters.\n */\nexport const DEFAULT_GRAPH_ENDPOINT = '/dev-panel/graph';\nexport const DEFAULT_OPEN_ENDPOINT = '/dev-panel/open-file';\n\n/**\n * A client `openInEditor` that POSTs to a server endpoint (mounted by an adapter), which opens\n * the file in the editor running the project via `launch-editor`. Falls back to copying the\n * path when the endpoint is unreachable. Pass to `<DevPanel openInEditor={serverOpenInEditor} />`.\n */\nexport function createServerOpenInEditor(endpoint = DEFAULT_OPEN_ENDPOINT): OpenInEditor {\n  return async (loc, editor = 'auto') => {\n    try {\n      const res = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ file: loc.file, line: loc.line, column: loc.column, editor }),\n      });\n      if (res.ok) return true;\n    } catch {\n      /* fall through to copy */\n    }\n    if (typeof navigator !== 'undefined' && navigator.clipboard) {\n      await navigator.clipboard\n        .writeText(`${loc.file}${loc.line ? `:${loc.line}` : ''}`)\n        .catch(() => undefined);\n    }\n    return false;\n  };\n}\n\n/** Ready-to-use server opener pointed at the default endpoint. */\nexport const serverOpenInEditor: OpenInEditor = createServerOpenInEditor();\n","/**\n * Next.js App Router adapter for react-dev-panel. Provides route-handler factories that serve\n * the component graph and open files in the running editor.\n *\n *   // app/dev-panel/graph/route.ts\n *   import { createGraphRoute } from 'react-dev-panel/next';\n *   export const { GET } = createGraphRoute();\n *\n *   // app/dev-panel/open-file/route.ts\n *   import { createOpenFileRoute } from 'react-dev-panel/next';\n *   export const { POST } = createOpenFileRoute();\n *\n * Then on the client:\n *   import { DevPanel, serverOpenInEditor, DEFAULT_GRAPH_ENDPOINT } from 'react-dev-panel';\n *   <DevPanel enabled={isDev} graphEndpoint={DEFAULT_GRAPH_ENDPOINT} openInEditor={serverOpenInEditor} />\n *\n * IMPORTANT: gate these routes yourself (NODE_ENV / auth) — pass `enabled` or wrap the handler.\n * They are intended for development and internal use only.\n */\nimport { resolve, relative, isAbsolute } from 'node:path';\nimport { existsSync, statSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\n\nexport interface NextGraphRouteOptions {\n  root?: string;\n  graphFile?: string;\n  /** Extra gate — return false to 404 (e.g. NODE_ENV check + developer auth). */\n  enabled?: () => boolean | Promise<boolean>;\n}\n\nconst EDITOR_BIN: Record<string, string | undefined> = {\n  auto: undefined,\n  vscode: 'code',\n  cursor: 'cursor',\n  webstorm: 'webstorm',\n  zed: 'zed',\n};\n\nconst json = (body: unknown, status = 200): Response =>\n  new Response(typeof body === 'string' ? body : JSON.stringify(body), {\n    status,\n    headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' },\n  });\n\nasync function gate(enabled?: () => boolean | Promise<boolean>): Promise<boolean> {\n  if (process.env.NODE_ENV === 'production' && !enabled) return false;\n  if (enabled) return (await enabled()) === true;\n  return true;\n}\n\nexport function createGraphRoute(options: NextGraphRouteOptions = {}) {\n  const root = resolve(options.root ?? process.cwd());\n  const graphFile = resolve(root, options.graphFile ?? '.dev-panel/component-graph.json');\n  return {\n    async GET() {\n      if (!(await gate(options.enabled))) return json({ error: 'Not found' }, 404);\n      try {\n        return json(await readFile(graphFile, 'utf8'));\n      } catch {\n        return json({ error: 'graph-not-generated', hint: 'Run: npx dev-panel-graph' }, 404);\n      }\n    },\n  };\n}\n\nexport function createOpenFileRoute(options: NextGraphRouteOptions = {}) {\n  const root = resolve(options.root ?? process.cwd());\n  return {\n    async POST(req: Request) {\n      if (!(await gate(options.enabled))) return json({ error: 'Not found' }, 404);\n      let body: { file?: string; line?: number; column?: number; editor?: string };\n      try {\n        body = await req.json();\n      } catch {\n        return json({ error: 'invalid body' }, 400);\n      }\n      if (!body.file) return json({ error: 'file required' }, 400);\n      const abs = isAbsolute(body.file) ? resolve(body.file) : resolve(root, body.file);\n      const rel = relative(root, abs);\n      if (rel.startsWith('..') || isAbsolute(rel)) return json({ error: 'path escapes root' }, 403);\n      if (!existsSync(abs) || !statSync(abs).isFile()) return json({ error: 'not found' }, 404);\n      try {\n        const launch = (await import('launch-editor')).default;\n        launch(`${abs}:${body.line ?? 1}:${body.column ?? 1}`, EDITOR_BIN[body.editor ?? 'auto']);\n        return json({ ok: true });\n      } catch (err) {\n        return json({ error: err instanceof Error ? err.message : 'open failed' }, 500);\n      }\n    },\n  };\n}\n\nexport { DEFAULT_GRAPH_ENDPOINT, DEFAULT_OPEN_ENDPOINT, serverOpenInEditor } from '../core/server-open';\n"]}

package/dist/adapters/next.d.cts

@@ -0,0 +1,17 @@
+export { D as DEFAULT_GRAPH_ENDPOINT, a as DEFAULT_OPEN_ENDPOINT, s as serverOpenInEditor } from '../server-open-B4FK0jQF.cjs';
+import 'react';
+
+interface NextGraphRouteOptions {
+    root?: string;
+    graphFile?: string;
+    /** Extra gate — return false to 404 (e.g. NODE_ENV check + developer auth). */
+    enabled?: () => boolean | Promise<boolean>;
+}
+declare function createGraphRoute(options?: NextGraphRouteOptions): {
+    GET(): Promise<Response>;
+};
+declare function createOpenFileRoute(options?: NextGraphRouteOptions): {
+    POST(req: Request): Promise<Response>;
+};
+
+export { type NextGraphRouteOptions, createGraphRoute, createOpenFileRoute };

package/dist/adapters/next.d.ts

@@ -0,0 +1,17 @@
+export { D as DEFAULT_GRAPH_ENDPOINT, a as DEFAULT_OPEN_ENDPOINT, s as serverOpenInEditor } from '../server-open-B4FK0jQF.js';
+import 'react';
+
+interface NextGraphRouteOptions {
+    root?: string;
+    graphFile?: string;
+    /** Extra gate — return false to 404 (e.g. NODE_ENV check + developer auth). */
+    enabled?: () => boolean | Promise<boolean>;
+}
+declare function createGraphRoute(options?: NextGraphRouteOptions): {
+    GET(): Promise<Response>;
+};
+declare function createOpenFileRoute(options?: NextGraphRouteOptions): {
+    POST(req: Request): Promise<Response>;
+};
+
+export { type NextGraphRouteOptions, createGraphRoute, createOpenFileRoute };

package/dist/adapters/next.js

@@ -0,0 +1,65 @@
+export { DEFAULT_GRAPH_ENDPOINT, DEFAULT_OPEN_ENDPOINT, serverOpenInEditor } from '../chunk-2ZAPVMUL.js';
+import { resolve, isAbsolute, relative } from 'path';
+import { existsSync, statSync } from 'fs';
+import { readFile } from 'fs/promises';
+
+var EDITOR_BIN = {
+  auto: void 0,
+  vscode: "code",
+  cursor: "cursor",
+  webstorm: "webstorm",
+  zed: "zed"
+};
+var json = (body, status = 200) => new Response(typeof body === "string" ? body : JSON.stringify(body), {
+  status,
+  headers: { "Content-Type": "application/json", "Cache-Control": "no-store" }
+});
+async function gate(enabled) {
+  if (process.env.NODE_ENV === "production" && !enabled) return false;
+  if (enabled) return await enabled() === true;
+  return true;
+}
+function createGraphRoute(options = {}) {
+  const root = resolve(options.root ?? process.cwd());
+  const graphFile = resolve(root, options.graphFile ?? ".dev-panel/component-graph.json");
+  return {
+    async GET() {
+      if (!await gate(options.enabled)) return json({ error: "Not found" }, 404);
+      try {
+        return json(await readFile(graphFile, "utf8"));
+      } catch {
+        return json({ error: "graph-not-generated", hint: "Run: npx dev-panel-graph" }, 404);
+      }
+    }
+  };
+}
+function createOpenFileRoute(options = {}) {
+  const root = resolve(options.root ?? process.cwd());
+  return {
+    async POST(req) {
+      if (!await gate(options.enabled)) return json({ error: "Not found" }, 404);
+      let body;
+      try {
+        body = await req.json();
+      } catch {
+        return json({ error: "invalid body" }, 400);
+      }
+      if (!body.file) return json({ error: "file required" }, 400);
+      const abs = isAbsolute(body.file) ? resolve(body.file) : resolve(root, body.file);
+      const rel = relative(root, abs);
+      if (rel.startsWith("..") || isAbsolute(rel)) return json({ error: "path escapes root" }, 403);
+      if (!existsSync(abs) || !statSync(abs).isFile()) return json({ error: "not found" }, 404);
+      try {
+        const launch = (await import('launch-editor')).default;
+        launch(`${abs}:${body.line ?? 1}:${body.column ?? 1}`, EDITOR_BIN[body.editor ?? "auto"]);
+        return json({ ok: true });
+      } catch (err) {
+        return json({ error: err instanceof Error ? err.message : "open failed" }, 500);
+      }
+    }
+  };
+}
+
+export { createGraphRoute, createOpenFileRoute };
+//# sourceMappingURL=next.js.map
+//# sourceMappingURL=next.js.map

package/dist/adapters/next.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/next.ts"],"names":[],"mappings":"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","file":"next.js","sourcesContent":["/**\n * Next.js App Router adapter for react-dev-panel. Provides route-handler factories that serve\n * the component graph and open files in the running editor.\n *\n *   // app/dev-panel/graph/route.ts\n *   import { createGraphRoute } from 'react-dev-panel/next';\n *   export const { GET } = createGraphRoute();\n *\n *   // app/dev-panel/open-file/route.ts\n *   import { createOpenFileRoute } from 'react-dev-panel/next';\n *   export const { POST } = createOpenFileRoute();\n *\n * Then on the client:\n *   import { DevPanel, serverOpenInEditor, DEFAULT_GRAPH_ENDPOINT } from 'react-dev-panel';\n *   <DevPanel enabled={isDev} graphEndpoint={DEFAULT_GRAPH_ENDPOINT} openInEditor={serverOpenInEditor} />\n *\n * IMPORTANT: gate these routes yourself (NODE_ENV / auth) — pass `enabled` or wrap the handler.\n * They are intended for development and internal use only.\n */\nimport { resolve, relative, isAbsolute } from 'node:path';\nimport { existsSync, statSync } from 'node:fs';\nimport { readFile } from 'node:fs/promises';\n\nexport interface NextGraphRouteOptions {\n  root?: string;\n  graphFile?: string;\n  /** Extra gate — return false to 404 (e.g. NODE_ENV check + developer auth). */\n  enabled?: () => boolean | Promise<boolean>;\n}\n\nconst EDITOR_BIN: Record<string, string | undefined> = {\n  auto: undefined,\n  vscode: 'code',\n  cursor: 'cursor',\n  webstorm: 'webstorm',\n  zed: 'zed',\n};\n\nconst json = (body: unknown, status = 200): Response =>\n  new Response(typeof body === 'string' ? body : JSON.stringify(body), {\n    status,\n    headers: { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' },\n  });\n\nasync function gate(enabled?: () => boolean | Promise<boolean>): Promise<boolean> {\n  if (process.env.NODE_ENV === 'production' && !enabled) return false;\n  if (enabled) return (await enabled()) === true;\n  return true;\n}\n\nexport function createGraphRoute(options: NextGraphRouteOptions = {}) {\n  const root = resolve(options.root ?? process.cwd());\n  const graphFile = resolve(root, options.graphFile ?? '.dev-panel/component-graph.json');\n  return {\n    async GET() {\n      if (!(await gate(options.enabled))) return json({ error: 'Not found' }, 404);\n      try {\n        return json(await readFile(graphFile, 'utf8'));\n      } catch {\n        return json({ error: 'graph-not-generated', hint: 'Run: npx dev-panel-graph' }, 404);\n      }\n    },\n  };\n}\n\nexport function createOpenFileRoute(options: NextGraphRouteOptions = {}) {\n  const root = resolve(options.root ?? process.cwd());\n  return {\n    async POST(req: Request) {\n      if (!(await gate(options.enabled))) return json({ error: 'Not found' }, 404);\n      let body: { file?: string; line?: number; column?: number; editor?: string };\n      try {\n        body = await req.json();\n      } catch {\n        return json({ error: 'invalid body' }, 400);\n      }\n      if (!body.file) return json({ error: 'file required' }, 400);\n      const abs = isAbsolute(body.file) ? resolve(body.file) : resolve(root, body.file);\n      const rel = relative(root, abs);\n      if (rel.startsWith('..') || isAbsolute(rel)) return json({ error: 'path escapes root' }, 403);\n      if (!existsSync(abs) || !statSync(abs).isFile()) return json({ error: 'not found' }, 404);\n      try {\n        const launch = (await import('launch-editor')).default;\n        launch(`${abs}:${body.line ?? 1}:${body.column ?? 1}`, EDITOR_BIN[body.editor ?? 'auto']);\n        return json({ ok: true });\n      } catch (err) {\n        return json({ error: err instanceof Error ? err.message : 'open failed' }, 500);\n      }\n    },\n  };\n}\n\nexport { DEFAULT_GRAPH_ENDPOINT, DEFAULT_OPEN_ENDPOINT, serverOpenInEditor } from '../core/server-open';\n"]}

package/dist/adapters/server.cjs

@@ -0,0 +1,72 @@
+'use strict';
+
+var path = require('path');
+var fs = require('fs');
+
+// src/adapters/server.ts
+
+// src/core/server-open.ts
+var DEFAULT_GRAPH_ENDPOINT = "/dev-panel/graph";
+var DEFAULT_OPEN_ENDPOINT = "/dev-panel/open-file";
+
+// src/adapters/server.ts
+var EDITOR_BIN = {
+  auto: void 0,
+  vscode: "code",
+  cursor: "cursor",
+  webstorm: "webstorm",
+  zed: "zed"
+};
+function send(res, status, body) {
+  res.statusCode = status;
+  res.setHeader("Content-Type", "application/json");
+  res.setHeader("Cache-Control", "no-store");
+  res.end(typeof body === "string" ? body : JSON.stringify(body));
+}
+async function readBody(req) {
+  const chunks = [];
+  for await (const c of req) chunks.push(c);
+  const raw = Buffer.concat(chunks).toString("utf8");
+  return raw ? JSON.parse(raw) : {};
+}
+function createDevPanelMiddleware(options = {}) {
+  const root = path.resolve(options.root ?? process.cwd());
+  const graphFile = path.resolve(root, options.graphFile ?? ".dev-panel/component-graph.json");
+  const graphEndpoint = options.graphEndpoint ?? DEFAULT_GRAPH_ENDPOINT;
+  const openEndpoint = options.openEndpoint ?? DEFAULT_OPEN_ENDPOINT;
+  return function devPanelMiddleware(req, res, next) {
+    const url = (req.url ?? "").split("?")[0];
+    if (req.method === "GET" && url === graphEndpoint) {
+      try {
+        send(res, 200, fs.readFileSync(graphFile, "utf8"));
+      } catch {
+        send(res, 404, { error: "graph-not-generated", hint: "Run: npx dev-panel-graph" });
+      }
+      return;
+    }
+    if (req.method === "POST" && url === openEndpoint) {
+      void (async () => {
+        try {
+          const body = await readBody(req);
+          if (!body.file) return send(res, 400, { error: "file required" });
+          const abs = path.isAbsolute(body.file) ? path.resolve(body.file) : path.resolve(root, body.file);
+          const rel = path.relative(root, abs);
+          if (rel.startsWith("..") || path.isAbsolute(rel)) return send(res, 403, { error: "path escapes root" });
+          if (!fs.existsSync(abs) || !fs.statSync(abs).isFile()) return send(res, 404, { error: "not found" });
+          const launch = (await import('launch-editor')).default;
+          const target = `${abs}:${body.line ?? 1}:${body.column ?? 1}`;
+          launch(target, EDITOR_BIN[body.editor ?? "auto"]);
+          return send(res, 200, { ok: true });
+        } catch (err) {
+          return send(res, 500, { error: err instanceof Error ? err.message : "open failed" });
+        }
+      })();
+      return;
+    }
+    next();
+  };
+}
+
+exports.createDevPanelMiddleware = createDevPanelMiddleware;
+//# sourceMappingURL=server.cjs.map
+//# sourceMappingURL=server.cjs.map

package/dist/adapters/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/core/server-open.ts","../../src/adapters/server.ts"],"names":["resolve","readFileSync","isAbsolute","relative","existsSync","statSync"],"mappings":"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","file":"server.cjs","sourcesContent":["import type { OpenInEditor } from './types';\n\n/**\n * Default endpoint paths the adapters mount and the client talks to. No leading underscore —\n * Next.js App Router treats `_`-prefixed segments as private (non-routable), so this path works\n * uniformly across the Next, Vite, and generic-server adapters.\n */\nexport const DEFAULT_GRAPH_ENDPOINT = '/dev-panel/graph';\nexport const DEFAULT_OPEN_ENDPOINT = '/dev-panel/open-file';\n\n/**\n * A client `openInEditor` that POSTs to a server endpoint (mounted by an adapter), which opens\n * the file in the editor running the project via `launch-editor`. Falls back to copying the\n * path when the endpoint is unreachable. Pass to `<DevPanel openInEditor={serverOpenInEditor} />`.\n */\nexport function createServerOpenInEditor(endpoint = DEFAULT_OPEN_ENDPOINT): OpenInEditor {\n  return async (loc, editor = 'auto') => {\n    try {\n      const res = await fetch(endpoint, {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ file: loc.file, line: loc.line, column: loc.column, editor }),\n      });\n      if (res.ok) return true;\n    } catch {\n      /* fall through to copy */\n    }\n    if (typeof navigator !== 'undefined' && navigator.clipboard) {\n      await navigator.clipboard\n        .writeText(`${loc.file}${loc.line ? `:${loc.line}` : ''}`)\n        .catch(() => undefined);\n    }\n    return false;\n  };\n}\n\n/** Ready-to-use server opener pointed at the default endpoint. */\nexport const serverOpenInEditor: OpenInEditor = createServerOpenInEditor();\n","/**\n * Framework-agnostic dev middleware (connect/express/http style) that powers the Component\n * Graph Inspector's server features:\n *   GET  /__dev-panel/graph      → serves the generated component-graph JSON\n *   POST /__dev-panel/open-file  → opens a file in the editor running the project (launch-editor)\n *\n * Dev-only by design — mount it only in your dev server. Opens are path-traversal-guarded to\n * the repo root. Used directly for CRA/Express/custom servers, and internally by the Vite plugin.\n */\nimport type { IncomingMessage, ServerResponse } from 'node:http';\nimport { resolve, relative, isAbsolute } from 'node:path';\nimport { existsSync, statSync, readFileSync } from 'node:fs';\n\nimport { DEFAULT_GRAPH_ENDPOINT, DEFAULT_OPEN_ENDPOINT } from '../core/server-open';\n\nexport interface DevPanelServerOptions {\n  /** Repo root (absolute). Default: process.cwd(). */\n  root?: string;\n  /** Path to the generated graph JSON, relative to root. Default: .dev-panel/component-graph.json */\n  graphFile?: string;\n  graphEndpoint?: string;\n  openEndpoint?: string;\n}\n\nconst EDITOR_BIN: Record<string, string | undefined> = {\n  auto: undefined,\n  vscode: 'code',\n  cursor: 'cursor',\n  webstorm: 'webstorm',\n  zed: 'zed',\n};\n\ntype Next = (err?: unknown) => void;\n\nfunction send(res: ServerResponse, status: number, body: unknown) {\n  res.statusCode = status;\n  res.setHeader('Content-Type', 'application/json');\n  res.setHeader('Cache-Control', 'no-store');\n  res.end(typeof body === 'string' ? body : JSON.stringify(body));\n}\n\nasync function readBody(req: IncomingMessage): Promise<unknown> {\n  const chunks: Buffer[] = [];\n  for await (const c of req) chunks.push(c as Buffer);\n  const raw = Buffer.concat(chunks).toString('utf8');\n  return raw ? JSON.parse(raw) : {};\n}\n\nexport function createDevPanelMiddleware(options: DevPanelServerOptions = {}) {\n  const root = resolve(options.root ?? process.cwd());\n  const graphFile = resolve(root, options.graphFile ?? '.dev-panel/component-graph.json');\n  const graphEndpoint = options.graphEndpoint ?? DEFAULT_GRAPH_ENDPOINT;\n  const openEndpoint = options.openEndpoint ?? DEFAULT_OPEN_ENDPOINT;\n\n  return function devPanelMiddleware(req: IncomingMessage, res: ServerResponse, next: Next): void {\n    const url = (req.url ?? '').split('?')[0];\n\n    if (req.method === 'GET' && url === graphEndpoint) {\n      try {\n        send(res, 200, readFileSync(graphFile, 'utf8'));\n      } catch {\n        send(res, 404, { error: 'graph-not-generated', hint: 'Run: npx dev-panel-graph' });\n      }\n      return;\n    }\n\n    if (req.method === 'POST' && url === openEndpoint) {\n      void (async () => {\n        try {\n          const body = (await readBody(req)) as {\n            file?: string;\n            line?: number;\n            column?: number;\n            editor?: string;\n          };\n          if (!body.file) return send(res, 400, { error: 'file required' });\n          const abs = isAbsolute(body.file) ? resolve(body.file) : resolve(root, body.file);\n          const rel = relative(root, abs);\n          if (rel.startsWith('..') || isAbsolute(rel)) return send(res, 403, { error: 'path escapes root' });\n          if (!existsSync(abs) || !statSync(abs).isFile()) return send(res, 404, { error: 'not found' });\n\n          const launch = (await import('launch-editor')).default;\n          const target = `${abs}:${body.line ?? 1}:${body.column ?? 1}`;\n          launch(target, EDITOR_BIN[body.editor ?? 'auto']);\n          return send(res, 200, { ok: true });\n        } catch (err) {\n          return send(res, 500, { error: err instanceof Error ? err.message : 'open failed' });\n        }\n      })();\n      return;\n    }\n\n    next();\n  };\n}\n"]}

package/dist/adapters/server.d.cts

@@ -0,0 +1,24 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+
+/**
+ * Framework-agnostic dev middleware (connect/express/http style) that powers the Component
+ * Graph Inspector's server features:
+ *   GET  /__dev-panel/graph      → serves the generated component-graph JSON
+ *   POST /__dev-panel/open-file  → opens a file in the editor running the project (launch-editor)
+ *
+ * Dev-only by design — mount it only in your dev server. Opens are path-traversal-guarded to
+ * the repo root. Used directly for CRA/Express/custom servers, and internally by the Vite plugin.
+ */
+
+interface DevPanelServerOptions {
+    /** Repo root (absolute). Default: process.cwd(). */
+    root?: string;
+    /** Path to the generated graph JSON, relative to root. Default: .dev-panel/component-graph.json */
+    graphFile?: string;
+    graphEndpoint?: string;
+    openEndpoint?: string;
+}
+type Next = (err?: unknown) => void;
+declare function createDevPanelMiddleware(options?: DevPanelServerOptions): (req: IncomingMessage, res: ServerResponse, next: Next) => void;
+
+export { type DevPanelServerOptions, createDevPanelMiddleware };

package/dist/adapters/server.d.ts

@@ -0,0 +1,24 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+
+/**
+ * Framework-agnostic dev middleware (connect/express/http style) that powers the Component
+ * Graph Inspector's server features:
+ *   GET  /__dev-panel/graph      → serves the generated component-graph JSON
+ *   POST /__dev-panel/open-file  → opens a file in the editor running the project (launch-editor)
+ *
+ * Dev-only by design — mount it only in your dev server. Opens are path-traversal-guarded to
+ * the repo root. Used directly for CRA/Express/custom servers, and internally by the Vite plugin.
+ */
+
+interface DevPanelServerOptions {
+    /** Repo root (absolute). Default: process.cwd(). */
+    root?: string;
+    /** Path to the generated graph JSON, relative to root. Default: .dev-panel/component-graph.json */
+    graphFile?: string;
+    graphEndpoint?: string;
+    openEndpoint?: string;
+}
+type Next = (err?: unknown) => void;
+declare function createDevPanelMiddleware(options?: DevPanelServerOptions): (req: IncomingMessage, res: ServerResponse, next: Next) => void;
+
+export { type DevPanelServerOptions, createDevPanelMiddleware };

package/dist/adapters/server.js

@@ -0,0 +1,4 @@
+export { createDevPanelMiddleware } from '../chunk-MAYMGQIM.js';
+import '../chunk-2ZAPVMUL.js';
+//# sourceMappingURL=server.js.map
+//# sourceMappingURL=server.js.map

package/dist/adapters/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"server.js"}