rerender-lens 0.2.0 → 0.3.0

package/dist/types-BzUEVkxJ.d.ts

@@ -0,0 +1,177 @@
+/** Why a single prop/state/hook value differs between two renders. */
+type ChangeKind = 
+/** New reference, but deep-equal to the previous value. Avoidable. */
+'deep-equal'
+/** A new function with the same name/body shape. Almost always avoidable. */
+ | 'function'
+/** A new React element that renders the same type with deep-equal props. Avoidable. */
+ | 'element'
+/** The value genuinely changed. */
+ | 'different'
+/** Key was added. */
+ | 'added'
+/** Key was removed. */
+ | 'removed';
+interface Change {
+    /** Dot path from the root, e.g. `style.color` or `items[2]`. */
+    path: string;
+    kind: ChangeKind;
+    prev: unknown;
+    next: unknown;
+}
+/** What caused a re-render. */
+type RenderTrigger = 
+/** At least one prop genuinely changed. */
+'props'
+/** Props are equal by value, but the parent re-rendered. Wrap in React.memo. */
+ | 'parent'
+/** Own state (useState/useReducer/this.setState) changed. */
+ | 'state'
+/** A non-state hook value (useContext, useSyncExternalStore) changed. */
+ | 'hooks'
+/** More than one of the above. */
+ | 'mixed';
+interface HookChange extends Change {
+    /** `useState`, `useReducer`, `useContext`, `useSyncExternalStore`, or `state` when the exact hook is unknown. */
+    hook: string;
+    /** Position of the hook in call order (0-based). */
+    index: number;
+    /** `useContext` only: the component that renders the nearest matching Provider, and its ancestry. */
+    provider?: {
+        component: string | null;
+        path: string[];
+    };
+    /** `useContext` only, object values: top-level keys whose value changed (shallow), and how many keys the value has. */
+    changedKeys?: string[];
+    totalKeys?: number;
+    /** Custom hooks between the component and this primitive, innermost first (`resolveHookNames` option). */
+    custom?: string[];
+}
+/** Current value of one state-bearing hook (`useState`, `useReducer`, `useSyncExternalStore`) after the render. */
+interface HookSnapshot {
+    /** Same label as `HookChange.path`, e.g. `useState#0`. */
+    path: string;
+    hook: string;
+    index: number;
+    value: unknown;
+    /** Custom hooks between the component and this primitive, innermost first (`resolveHookNames` option). */
+    custom?: string[];
+}
+/** What made React commit, beyond the usual state/props story. */
+type CommitCause = 
+/** State was set right after the previous commit by a component that rendered in it: an effect → setState loop. */
+'effect-after-commit'
+/** A Suspense boundary switched from its fallback to content. */
+ | 'suspense-resolved';
+/** Scheduler priority of the commit, as React reports it to the DevTools hook (transitions run at `normal`). */
+type CommitPriority = 'immediate' | 'user-blocking' | 'normal' | 'low' | 'idle';
+interface ParentInfo {
+    /** Display name of the nearest ancestor component that also rendered in this commit. */
+    name: string;
+    /** Why that ancestor rendered. */
+    trigger: RenderTrigger;
+}
+/** Where a component's element was created (React <= 18: `_debugSource`; React 19: parsed from `_debugStack`). */
+interface SourceLocation {
+    fileName: string;
+    lineNumber?: number;
+    columnNumber?: number;
+}
+interface RenderReport {
+    /** Display name of the tracked component. */
+    component: string;
+    /** Stable id of this component instance (fiber) across its lifetime. */
+    instanceId: number;
+    /** Monotonic id of the React commit that produced this report. Reports from one commit share it. 0 for `useWhyRerender`. */
+    commitId: number;
+    /** Priority React assigned to the commit: `immediate` for discrete input (clicks, keys), `user-blocking` for continuous input, `normal` for transitions and async updates. */
+    commitPriority?: CommitPriority;
+    /** Components that scheduled the update (`setState`, dispatch) for this commit, from React's updater tracking (dev builds). */
+    updaters?: string[];
+    commitCause?: CommitCause;
+    /** For `effect-after-commit`: the commit whose effects set the state. */
+    afterCommit?: number;
+    /** The element's `key`, when it has one. */
+    key?: string | null;
+    /** Monotonic per-instance update count (1 = first update; mount is never reported). */
+    renderCount: number;
+    trigger: RenderTrigger;
+    /** True when the re-render produced no genuine change in props, state, or hooks. */
+    avoidable: boolean;
+    props: {
+        prev: Record<string, unknown>;
+        next: Record<string, unknown>;
+    };
+    propChanges: Change[];
+    /** Class components only. */
+    stateChanges: Change[];
+    /** Function components: state hooks and contexts that changed. */
+    hookChanges: HookChange[];
+    /** Function components: every state hook with its current value (changed or not). Omitted when `includeState` is off. */
+    hookState?: HookSnapshot[];
+    /** Every context the component reads, with its current value. Omitted when `includeState` is off. */
+    contexts?: {
+        name: string;
+        value: unknown;
+    }[];
+    /** Class components: `this.state` after the render. Omitted when `includeState` is off. */
+    state?: Record<string, unknown>;
+    /** Nearest ancestor that rendered in the same commit, or null when the update started here. */
+    parent: ParentInfo | null;
+    /** Component that created this element (dev builds only). */
+    owner: string | null;
+    /** Component ancestry from the root down to this component, display names only. */
+    path: string[];
+    /** True for `React.memo` components and `PureComponent` classes: props alone decide whether they re-render. */
+    memoized: boolean;
+    /** Time spent in this component's own render (children excluded), in ms, when React exposes it (dev/profiling builds). */
+    selfDuration?: number;
+    /** Time spent rendering this component and everything below it that rendered in the same commit, in ms. */
+    treeDuration?: number;
+    /** Source location of the element that rendered this component, when React exposes it (dev builds). */
+    source?: SourceLocation;
+    /** Human-readable explanations and suggested fixes. */
+    reasons: string[];
+    /** `performance.now()` (or `Date.now()`) when the report was produced. */
+    time: number;
+}
+type Notifier = (report: RenderReport) => void;
+type ComponentMatcher = string | RegExp | ((displayName: string) => boolean);
+interface Options {
+    /** Track every `React.memo`-wrapped component and every `PureComponent`. Default false. */
+    trackAllMemoized?: boolean;
+    /** Track every component, memoized or not. Noisy. Default false. */
+    trackAllComponents?: boolean;
+    /** Components to track by display name (string = exact match). */
+    include?: ComponentMatcher[];
+    /** Components never to track, even when marked. */
+    exclude?: ComponentMatcher[];
+    /** Diff hook state and contexts of function components. Default true. */
+    trackHooks?: boolean;
+    /** Put the current values of every state hook, context and class state on each report (`hookState`, `contexts`, `state`). Default true. */
+    includeState?: boolean;
+    /**
+     * Resolve custom hook names (`useCart › useState#0`) by re-running each reported component type once
+     * with a stand-in dispatcher, as React DevTools does. Off by default: the extra render is visible to
+     * anything the component does during render (logging, counters). Dev builds only.
+     */
+    resolveHookNames?: boolean;
+    /** Report re-renders caused by genuine changes too, not only avoidable ones. Default false. */
+    logAll?: boolean;
+    /** Do not print to the console. Reports still reach `notifier`. Default false. */
+    silent?: boolean;
+    /** Receive every report. Combine several with `combineNotifiers`. */
+    notifier?: Notifier;
+    /** Use `console.groupCollapsed` instead of `console.group`. Default true. */
+    collapse?: boolean;
+    /** Console-like sink used for printing. Default `console`. */
+    console?: Pick<Console, 'log' | 'group' | 'groupCollapsed' | 'groupEnd' | 'warn'>;
+    /** Skip commits caused by Fast Refresh / hot module replacement. Default true. */
+    ignoreHotReload?: boolean;
+    /** Stop printing a component after this many reports (0 = unlimited). The notifier still receives them. Default 0. */
+    maxReportsPerComponent?: number;
+}
+/** Marker static: `MyComponent.rerenderLens = true` opts a component in. */
+declare const MARKER: "rerenderLens";
+
+export { type ChangeKind as C, type HookChange as H, MARKER as M, type Notifier as N, type Options as O, type ParentInfo as P, type RenderReport as R, type SourceLocation as S, type Change as a, type HookSnapshot as b, type CommitPriority as c, type CommitCause as d, type ComponentMatcher as e, type RenderTrigger as f };

package/dist/vite.cjs

@@ -0,0 +1,113 @@
+'use strict';
+
+var fs = require('fs');
+var path = require('path');
+var url = require('url');
+
+// node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+var VIRTUAL_ID = "virtual:rerender-lens";
+var RESOLVED_ID = "\0" + VIRTUAL_ID;
+var VIRTUAL_URL = "/@id/__x00__" + VIRTUAL_ID;
+var DEFAULT_PANEL_PATH = "/__rerender-lens/";
+var serializeMatcher = (m) => m instanceof RegExp ? `new RegExp(${JSON.stringify(m.source)}, ${JSON.stringify(m.flags)})` : JSON.stringify(m);
+function renderSetupModule(options = {}) {
+  const { devtools = true, applyInBuild: _applyInBuild, panel, channel, pages: _pages, include, exclude, ...rest } = options;
+  const entries = [];
+  for (const [k, v] of Object.entries(rest)) if (v !== void 0) entries.push(`${JSON.stringify(k)}: ${JSON.stringify(v)}`);
+  if (include) entries.push(`include: [${include.map(serializeMatcher).join(", ")}]`);
+  if (exclude) entries.push(`exclude: [${exclude.map(serializeMatcher).join(", ")}]`);
+  const notifierOptions = panel ? `{ channel: ${JSON.stringify(channel || "rerender-lens")} }` : "";
+  if (devtools || panel) entries.push(`notifier: createDevtoolsNotifier(${notifierOptions})`);
+  return [
+    `import { init${devtools || panel ? ", createDevtoolsNotifier" : ""} } from 'rerender-lens';`,
+    `init({ ${entries.join(", ")} });`,
+    ""
+  ].join("\n");
+}
+function panelDir() {
+  const here = path.dirname(url.fileURLToPath(importMetaUrl));
+  for (const dir of [path.join(here, "..", "panel"), path.join(here, "..", "extension"), path.join(here, "..", "..", "extension")]) {
+    if (fs.existsSync(path.join(dir, "panel.html")) && fs.existsSync(path.join(dir, "panel.js"))) return dir;
+  }
+  return null;
+}
+var MIME = { ".html": "text/html; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".css": "text/css; charset=utf-8" };
+function panelMiddleware(mount, channel, dir) {
+  const base = mount.endsWith("/") ? mount : mount + "/";
+  return (req, res, next) => {
+    const url = req.url || "/";
+    if (!url.startsWith(base.slice(0, -1))) return next();
+    const [pathOnly, query = ""] = url.split("?", 2);
+    if (pathOnly === base.slice(0, -1) || pathOnly === base) {
+      res.statusCode = 302;
+      res.setHeader("Location", `${base}panel.html?channel=${encodeURIComponent(channel)}${query ? "&" + query : ""}`);
+      res.end();
+      return;
+    }
+    const file = pathOnly.slice(base.length);
+    if (!/^panel\.(html|js|css)$/.test(file)) return next();
+    if (!dir) {
+      res.statusCode = 500;
+      res.setHeader("Content-Type", "text/plain");
+      res.end("rerender-lens: panel files not found (is the package built?)");
+      return;
+    }
+    res.statusCode = 200;
+    res.setHeader("Content-Type", MIME[file.slice(file.lastIndexOf("."))] || "application/octet-stream");
+    res.setHeader("Cache-Control", "no-store");
+    res.end(fs.readFileSync(path.join(dir, file)));
+  };
+}
+function rerenderLens(options = {}) {
+  const defaults = { trackAllMemoized: true };
+  const merged = { ...defaults, ...options };
+  const pages = merged.pages;
+  const wants = (path) => {
+    if (!pages) return true;
+    const p = path || "/";
+    if (typeof pages === "function") return pages(p);
+    return pages.some((x) => x === p || x === "/" && p === "/index.html" || x === "/index.html" && p === "/");
+  };
+  const mount = typeof merged.panel === "string" ? merged.panel : DEFAULT_PANEL_PATH;
+  const plugin = {
+    name: "rerender-lens",
+    enforce: "pre",
+    resolveId(id) {
+      return id === VIRTUAL_ID ? RESOLVED_ID : void 0;
+    },
+    load(id) {
+      return id === RESOLVED_ID ? renderSetupModule(merged) : void 0;
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(_html, ctx) {
+        if (!wants(ctx?.path)) return [];
+        return [{ tag: "script", attrs: { type: "module", src: VIRTUAL_URL }, injectTo: "head-prepend" }];
+      }
+    }
+  };
+  if (!merged.applyInBuild) plugin.apply = "serve";
+  if (merged.panel) {
+    plugin.configureServer = (server) => {
+      server.middlewares.use(panelMiddleware(mount, merged.channel || "rerender-lens", panelDir()));
+      const announce = () => {
+        const local = server.resolvedUrls?.local?.[0];
+        server.config?.logger?.info(`  \u279C  rerender-lens panel: ${local ? local.replace(/\/$/, "") : ""}${mount}`);
+      };
+      if (server.httpServer) server.httpServer.once("listening", () => setTimeout(announce, 0));
+    };
+  }
+  return plugin;
+}
+
+exports.DEFAULT_PANEL_PATH = DEFAULT_PANEL_PATH;
+exports.VIRTUAL_ID = VIRTUAL_ID;
+exports.VIRTUAL_URL = VIRTUAL_URL;
+exports.panelDir = panelDir;
+exports.panelMiddleware = panelMiddleware;
+exports.renderSetupModule = renderSetupModule;
+exports.rerenderLens = rerenderLens;
+//# sourceMappingURL=vite.cjs.map
+//# sourceMappingURL=vite.cjs.map

package/dist/vite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../node_modules/tsup/assets/cjs_shims.js","../src/vite.ts"],"names":["dirname","fileURLToPath","join","existsSync","readFileSync"],"mappings":"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","file":"vite.cjs","sourcesContent":["// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * Vite plugin: `rerenderLens()` in `vite.config.ts` starts rerender-lens in dev before React loads,\n * with the DevTools notifier, so the extension panel works without touching the app.\n *\n * With `panel: true` it also serves the panel itself at `/__rerender-lens/` (no extension needed): the\n * app publishes on a same-origin `BroadcastChannel`, the panel tab listens and sends commands back.\n *\n * The plugin serves a virtual module that imports `rerender-lens` and calls `init`, and injects a\n * `<script type=\"module\">` for it at the top of `<head>`. Module scripts execute in document order,\n * so it runs before the app entry (and after Vite's Fast Refresh preamble, which is fine: `init`\n * wraps whatever DevTools hook exists). Nothing happens in `vite build`.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Options } from './types';\n\n/** `Options` minus the parts that cannot be serialized into a module (functions). Matchers may be strings or RegExps. */\nexport type VitePluginOptions = Omit<Options, 'notifier' | 'console' | 'include' | 'exclude'> & {\n  include?: (string | RegExp)[];\n  exclude?: (string | RegExp)[];\n  /** Also post reports to the DevTools bridge for the extension. Default true. */\n  devtools?: boolean;\n  /** Apply in `vite build` too (for staging builds you want to inspect). Default false. */\n  applyInBuild?: boolean;\n  /**\n   * Serve the panel from the dev server (default path `/__rerender-lens/`) and publish reports on a\n   * BroadcastChannel so it works without the extension. `true`, or a mount path. Default false.\n   */\n  panel?: boolean | string;\n  /** BroadcastChannel name used with `panel`. Default `rerender-lens`. */\n  channel?: string;\n  /** Which HTML pages get the setup script: an allow-list of paths (`/`, `/admin.html`) or a predicate. Default all. */\n  pages?: string[] | ((path: string) => boolean);\n};\n\nexport const VIRTUAL_ID = 'virtual:rerender-lens';\nconst RESOLVED_ID = '\\0' + VIRTUAL_ID;\n/** URL Vite serves the virtual module under (the `\\0` prefix is spelled `__x00__`). */\nexport const VIRTUAL_URL = '/@id/__x00__' + VIRTUAL_ID;\nexport const DEFAULT_PANEL_PATH = '/__rerender-lens/';\n\nconst serializeMatcher = (m: string | RegExp): string => (m instanceof RegExp ? `new RegExp(${JSON.stringify(m.source)}, ${JSON.stringify(m.flags)})` : JSON.stringify(m));\n\n/** Source of the virtual module. Exported for tests and for other bundlers' loaders. */\nexport function renderSetupModule(options: VitePluginOptions = {}): string {\n  const { devtools = true, applyInBuild: _applyInBuild, panel, channel, pages: _pages, include, exclude, ...rest } = options;\n  const entries: string[] = [];\n  for (const [k, v] of Object.entries(rest)) if (v !== undefined) entries.push(`${JSON.stringify(k)}: ${JSON.stringify(v)}`);\n  if (include) entries.push(`include: [${include.map(serializeMatcher).join(', ')}]`);\n  if (exclude) entries.push(`exclude: [${exclude.map(serializeMatcher).join(', ')}]`);\n  const notifierOptions = panel ? `{ channel: ${JSON.stringify(channel || 'rerender-lens')} }` : '';\n  if (devtools || panel) entries.push(`notifier: createDevtoolsNotifier(${notifierOptions})`);\n  return [\n    `import { init${devtools || panel ? ', createDevtoolsNotifier' : ''} } from 'rerender-lens';`,\n    `init({ ${entries.join(', ')} });`,\n    '',\n  ].join('\\n');\n}\n\n/** Minimal shape of a Vite plugin, so `vite` stays an optional peer. */\nexport interface RerenderLensVitePlugin {\n  name: string;\n  apply?: 'serve' | 'build';\n  enforce?: 'pre' | 'post';\n  resolveId(id: string): string | undefined;\n  load(id: string): string | undefined;\n  transformIndexHtml: {\n    order: 'pre';\n    handler(html: string, ctx?: { path?: string; filename?: string }): { tag: string; attrs: Record<string, string>; injectTo: 'head-prepend' }[];\n  };\n  configureServer?(server: ViteServerLike): void;\n}\n\n/** The parts of Vite's dev server the plugin uses. */\nexport interface ViteServerLike {\n  /** Connect-style; mounting without a path keeps `req.url` intact (a mount path would strip the prefix). */\n  middlewares: { use(handler: (req: IncomingLike, res: ResponseLike, next: () => void) => void): void };\n  config?: { logger?: { info(msg: string): void }; server?: { port?: number; host?: string | boolean } };\n  resolvedUrls?: { local?: string[] } | null;\n  httpServer?: { once(event: 'listening', cb: () => void): void } | null;\n}\ninterface IncomingLike {\n  url?: string;\n  method?: string;\n}\ninterface ResponseLike {\n  statusCode: number;\n  setHeader(name: string, value: string): void;\n  end(body?: string | Uint8Array): void;\n}\n\n/** Directory holding panel.html/js/css: `panel/` next to `dist/` in the package, or the extension folder in this repo. */\nexport function panelDir(): string | null {\n  const here = dirname(fileURLToPath(import.meta.url));\n  for (const dir of [join(here, '..', 'panel'), join(here, '..', 'extension'), join(here, '..', '..', 'extension')]) {\n    if (existsSync(join(dir, 'panel.html')) && existsSync(join(dir, 'panel.js'))) return dir;\n  }\n  return null;\n}\n\nconst MIME: Record<string, string> = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8' };\n\n/** Middleware serving the panel under `mount` (exported for tests). */\nexport function panelMiddleware(mount: string, channel: string, dir: string | null): (req: IncomingLike, res: ResponseLike, next: () => void) => void {\n  const base = mount.endsWith('/') ? mount : mount + '/';\n  return (req, res, next) => {\n    const url = req.url || '/';\n    if (!url.startsWith(base.slice(0, -1))) return next();\n    const [pathOnly, query = ''] = url.split('?', 2);\n    if (pathOnly === base.slice(0, -1) || pathOnly === base) {\n      // The panel boots in channel mode from its query string.\n      res.statusCode = 302;\n      res.setHeader('Location', `${base}panel.html?channel=${encodeURIComponent(channel)}${query ? '&' + query : ''}`);\n      res.end();\n      return;\n    }\n    const file = pathOnly!.slice(base.length);\n    if (!/^panel\\.(html|js|css)$/.test(file)) return next();\n    if (!dir) {\n      res.statusCode = 500;\n      res.setHeader('Content-Type', 'text/plain');\n      res.end('rerender-lens: panel files not found (is the package built?)');\n      return;\n    }\n    res.statusCode = 200;\n    res.setHeader('Content-Type', MIME[file.slice(file.lastIndexOf('.'))] || 'application/octet-stream');\n    res.setHeader('Cache-Control', 'no-store');\n    res.end(readFileSync(join(dir, file)));\n  };\n}\n\nexport function rerenderLens(options: VitePluginOptions = {}): RerenderLensVitePlugin {\n  const defaults: VitePluginOptions = { trackAllMemoized: true };\n  const merged = { ...defaults, ...options };\n  const pages = merged.pages;\n  const wants = (path: string | undefined): boolean => {\n    if (!pages) return true;\n    const p = path || '/';\n    if (typeof pages === 'function') return pages(p);\n    return pages.some((x) => x === p || (x === '/' && p === '/index.html') || (x === '/index.html' && p === '/'));\n  };\n  const mount = typeof merged.panel === 'string' ? merged.panel : DEFAULT_PANEL_PATH;\n  const plugin: RerenderLensVitePlugin = {\n    name: 'rerender-lens',\n    enforce: 'pre',\n    resolveId(id) {\n      return id === VIRTUAL_ID ? RESOLVED_ID : undefined;\n    },\n    load(id) {\n      return id === RESOLVED_ID ? renderSetupModule(merged) : undefined;\n    },\n    transformIndexHtml: {\n      order: 'pre',\n      handler(_html, ctx) {\n        if (!wants(ctx?.path)) return [];\n        return [{ tag: 'script', attrs: { type: 'module', src: VIRTUAL_URL }, injectTo: 'head-prepend' }];\n      },\n    },\n  };\n  if (!merged.applyInBuild) plugin.apply = 'serve';\n  if (merged.panel) {\n    plugin.configureServer = (server) => {\n      server.middlewares.use(panelMiddleware(mount, merged.channel || 'rerender-lens', panelDir()));\n      const announce = (): void => {\n        const local = server.resolvedUrls?.local?.[0];\n        server.config?.logger?.info(`  ➜  rerender-lens panel: ${local ? local.replace(/\\/$/, '') : ''}${mount}`);\n      };\n      if (server.httpServer) server.httpServer.once('listening', () => setTimeout(announce, 0));\n    };\n  }\n  return plugin;\n}\n"]}

package/dist/vite.d.cts

@@ -0,0 +1,84 @@
+import { O as Options } from './types-BzUEVkxJ.cjs';
+
+/** `Options` minus the parts that cannot be serialized into a module (functions). Matchers may be strings or RegExps. */
+type VitePluginOptions = Omit<Options, 'notifier' | 'console' | 'include' | 'exclude'> & {
+    include?: (string | RegExp)[];
+    exclude?: (string | RegExp)[];
+    /** Also post reports to the DevTools bridge for the extension. Default true. */
+    devtools?: boolean;
+    /** Apply in `vite build` too (for staging builds you want to inspect). Default false. */
+    applyInBuild?: boolean;
+    /**
+     * Serve the panel from the dev server (default path `/__rerender-lens/`) and publish reports on a
+     * BroadcastChannel so it works without the extension. `true`, or a mount path. Default false.
+     */
+    panel?: boolean | string;
+    /** BroadcastChannel name used with `panel`. Default `rerender-lens`. */
+    channel?: string;
+    /** Which HTML pages get the setup script: an allow-list of paths (`/`, `/admin.html`) or a predicate. Default all. */
+    pages?: string[] | ((path: string) => boolean);
+};
+declare const VIRTUAL_ID = "virtual:rerender-lens";
+/** URL Vite serves the virtual module under (the `\0` prefix is spelled `__x00__`). */
+declare const VIRTUAL_URL: string;
+declare const DEFAULT_PANEL_PATH = "/__rerender-lens/";
+/** Source of the virtual module. Exported for tests and for other bundlers' loaders. */
+declare function renderSetupModule(options?: VitePluginOptions): string;
+/** Minimal shape of a Vite plugin, so `vite` stays an optional peer. */
+interface RerenderLensVitePlugin {
+    name: string;
+    apply?: 'serve' | 'build';
+    enforce?: 'pre' | 'post';
+    resolveId(id: string): string | undefined;
+    load(id: string): string | undefined;
+    transformIndexHtml: {
+        order: 'pre';
+        handler(html: string, ctx?: {
+            path?: string;
+            filename?: string;
+        }): {
+            tag: string;
+            attrs: Record<string, string>;
+            injectTo: 'head-prepend';
+        }[];
+    };
+    configureServer?(server: ViteServerLike): void;
+}
+/** The parts of Vite's dev server the plugin uses. */
+interface ViteServerLike {
+    /** Connect-style; mounting without a path keeps `req.url` intact (a mount path would strip the prefix). */
+    middlewares: {
+        use(handler: (req: IncomingLike, res: ResponseLike, next: () => void) => void): void;
+    };
+    config?: {
+        logger?: {
+            info(msg: string): void;
+        };
+        server?: {
+            port?: number;
+            host?: string | boolean;
+        };
+    };
+    resolvedUrls?: {
+        local?: string[];
+    } | null;
+    httpServer?: {
+        once(event: 'listening', cb: () => void): void;
+    } | null;
+}
+interface IncomingLike {
+    url?: string;
+    method?: string;
+}
+interface ResponseLike {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    end(body?: string | Uint8Array): void;
+}
+/** Directory holding panel.html/js/css: `panel/` next to `dist/` in the package, or the extension folder in this repo. */
+declare function panelDir(): string | null;
+/** Middleware serving the panel under `mount` (exported for tests). */
+declare function panelMiddleware(mount: string, channel: string, dir: string | null): (req: IncomingLike, res: ResponseLike, next: () => void) => void;
+declare function rerenderLens(options?: VitePluginOptions): RerenderLensVitePlugin;
+
+export { DEFAULT_PANEL_PATH, type RerenderLensVitePlugin, VIRTUAL_ID, VIRTUAL_URL, type VitePluginOptions, type ViteServerLike, panelDir, panelMiddleware, renderSetupModule, rerenderLens };

package/dist/vite.d.ts

@@ -0,0 +1,84 @@
+import { O as Options } from './types-BzUEVkxJ.js';
+
+/** `Options` minus the parts that cannot be serialized into a module (functions). Matchers may be strings or RegExps. */
+type VitePluginOptions = Omit<Options, 'notifier' | 'console' | 'include' | 'exclude'> & {
+    include?: (string | RegExp)[];
+    exclude?: (string | RegExp)[];
+    /** Also post reports to the DevTools bridge for the extension. Default true. */
+    devtools?: boolean;
+    /** Apply in `vite build` too (for staging builds you want to inspect). Default false. */
+    applyInBuild?: boolean;
+    /**
+     * Serve the panel from the dev server (default path `/__rerender-lens/`) and publish reports on a
+     * BroadcastChannel so it works without the extension. `true`, or a mount path. Default false.
+     */
+    panel?: boolean | string;
+    /** BroadcastChannel name used with `panel`. Default `rerender-lens`. */
+    channel?: string;
+    /** Which HTML pages get the setup script: an allow-list of paths (`/`, `/admin.html`) or a predicate. Default all. */
+    pages?: string[] | ((path: string) => boolean);
+};
+declare const VIRTUAL_ID = "virtual:rerender-lens";
+/** URL Vite serves the virtual module under (the `\0` prefix is spelled `__x00__`). */
+declare const VIRTUAL_URL: string;
+declare const DEFAULT_PANEL_PATH = "/__rerender-lens/";
+/** Source of the virtual module. Exported for tests and for other bundlers' loaders. */
+declare function renderSetupModule(options?: VitePluginOptions): string;
+/** Minimal shape of a Vite plugin, so `vite` stays an optional peer. */
+interface RerenderLensVitePlugin {
+    name: string;
+    apply?: 'serve' | 'build';
+    enforce?: 'pre' | 'post';
+    resolveId(id: string): string | undefined;
+    load(id: string): string | undefined;
+    transformIndexHtml: {
+        order: 'pre';
+        handler(html: string, ctx?: {
+            path?: string;
+            filename?: string;
+        }): {
+            tag: string;
+            attrs: Record<string, string>;
+            injectTo: 'head-prepend';
+        }[];
+    };
+    configureServer?(server: ViteServerLike): void;
+}
+/** The parts of Vite's dev server the plugin uses. */
+interface ViteServerLike {
+    /** Connect-style; mounting without a path keeps `req.url` intact (a mount path would strip the prefix). */
+    middlewares: {
+        use(handler: (req: IncomingLike, res: ResponseLike, next: () => void) => void): void;
+    };
+    config?: {
+        logger?: {
+            info(msg: string): void;
+        };
+        server?: {
+            port?: number;
+            host?: string | boolean;
+        };
+    };
+    resolvedUrls?: {
+        local?: string[];
+    } | null;
+    httpServer?: {
+        once(event: 'listening', cb: () => void): void;
+    } | null;
+}
+interface IncomingLike {
+    url?: string;
+    method?: string;
+}
+interface ResponseLike {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    end(body?: string | Uint8Array): void;
+}
+/** Directory holding panel.html/js/css: `panel/` next to `dist/` in the package, or the extension folder in this repo. */
+declare function panelDir(): string | null;
+/** Middleware serving the panel under `mount` (exported for tests). */
+declare function panelMiddleware(mount: string, channel: string, dir: string | null): (req: IncomingLike, res: ResponseLike, next: () => void) => void;
+declare function rerenderLens(options?: VitePluginOptions): RerenderLensVitePlugin;
+
+export { DEFAULT_PANEL_PATH, type RerenderLensVitePlugin, VIRTUAL_ID, VIRTUAL_URL, type VitePluginOptions, type ViteServerLike, panelDir, panelMiddleware, renderSetupModule, rerenderLens };

package/dist/vite.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+
+// src/vite.ts
+var VIRTUAL_ID = "virtual:rerender-lens";
+var RESOLVED_ID = "\0" + VIRTUAL_ID;
+var VIRTUAL_URL = "/@id/__x00__" + VIRTUAL_ID;
+var DEFAULT_PANEL_PATH = "/__rerender-lens/";
+var serializeMatcher = (m) => m instanceof RegExp ? `new RegExp(${JSON.stringify(m.source)}, ${JSON.stringify(m.flags)})` : JSON.stringify(m);
+function renderSetupModule(options = {}) {
+  const { devtools = true, applyInBuild: _applyInBuild, panel, channel, pages: _pages, include, exclude, ...rest } = options;
+  const entries = [];
+  for (const [k, v] of Object.entries(rest)) if (v !== void 0) entries.push(`${JSON.stringify(k)}: ${JSON.stringify(v)}`);
+  if (include) entries.push(`include: [${include.map(serializeMatcher).join(", ")}]`);
+  if (exclude) entries.push(`exclude: [${exclude.map(serializeMatcher).join(", ")}]`);
+  const notifierOptions = panel ? `{ channel: ${JSON.stringify(channel || "rerender-lens")} }` : "";
+  if (devtools || panel) entries.push(`notifier: createDevtoolsNotifier(${notifierOptions})`);
+  return [
+    `import { init${devtools || panel ? ", createDevtoolsNotifier" : ""} } from 'rerender-lens';`,
+    `init({ ${entries.join(", ")} });`,
+    ""
+  ].join("\n");
+}
+function panelDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  for (const dir of [join(here, "..", "panel"), join(here, "..", "extension"), join(here, "..", "..", "extension")]) {
+    if (existsSync(join(dir, "panel.html")) && existsSync(join(dir, "panel.js"))) return dir;
+  }
+  return null;
+}
+var MIME = { ".html": "text/html; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".css": "text/css; charset=utf-8" };
+function panelMiddleware(mount, channel, dir) {
+  const base = mount.endsWith("/") ? mount : mount + "/";
+  return (req, res, next) => {
+    const url = req.url || "/";
+    if (!url.startsWith(base.slice(0, -1))) return next();
+    const [pathOnly, query = ""] = url.split("?", 2);
+    if (pathOnly === base.slice(0, -1) || pathOnly === base) {
+      res.statusCode = 302;
+      res.setHeader("Location", `${base}panel.html?channel=${encodeURIComponent(channel)}${query ? "&" + query : ""}`);
+      res.end();
+      return;
+    }
+    const file = pathOnly.slice(base.length);
+    if (!/^panel\.(html|js|css)$/.test(file)) return next();
+    if (!dir) {
+      res.statusCode = 500;
+      res.setHeader("Content-Type", "text/plain");
+      res.end("rerender-lens: panel files not found (is the package built?)");
+      return;
+    }
+    res.statusCode = 200;
+    res.setHeader("Content-Type", MIME[file.slice(file.lastIndexOf("."))] || "application/octet-stream");
+    res.setHeader("Cache-Control", "no-store");
+    res.end(readFileSync(join(dir, file)));
+  };
+}
+function rerenderLens(options = {}) {
+  const defaults = { trackAllMemoized: true };
+  const merged = { ...defaults, ...options };
+  const pages = merged.pages;
+  const wants = (path) => {
+    if (!pages) return true;
+    const p = path || "/";
+    if (typeof pages === "function") return pages(p);
+    return pages.some((x) => x === p || x === "/" && p === "/index.html" || x === "/index.html" && p === "/");
+  };
+  const mount = typeof merged.panel === "string" ? merged.panel : DEFAULT_PANEL_PATH;
+  const plugin = {
+    name: "rerender-lens",
+    enforce: "pre",
+    resolveId(id) {
+      return id === VIRTUAL_ID ? RESOLVED_ID : void 0;
+    },
+    load(id) {
+      return id === RESOLVED_ID ? renderSetupModule(merged) : void 0;
+    },
+    transformIndexHtml: {
+      order: "pre",
+      handler(_html, ctx) {
+        if (!wants(ctx?.path)) return [];
+        return [{ tag: "script", attrs: { type: "module", src: VIRTUAL_URL }, injectTo: "head-prepend" }];
+      }
+    }
+  };
+  if (!merged.applyInBuild) plugin.apply = "serve";
+  if (merged.panel) {
+    plugin.configureServer = (server) => {
+      server.middlewares.use(panelMiddleware(mount, merged.channel || "rerender-lens", panelDir()));
+      const announce = () => {
+        const local = server.resolvedUrls?.local?.[0];
+        server.config?.logger?.info(`  \u279C  rerender-lens panel: ${local ? local.replace(/\/$/, "") : ""}${mount}`);
+      };
+      if (server.httpServer) server.httpServer.once("listening", () => setTimeout(announce, 0));
+    };
+  }
+  return plugin;
+}
+
+export { DEFAULT_PANEL_PATH, VIRTUAL_ID, VIRTUAL_URL, panelDir, panelMiddleware, renderSetupModule, rerenderLens };
+//# sourceMappingURL=vite.js.map
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/vite.ts"],"names":[],"mappings":"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","file":"vite.js","sourcesContent":["/**\n * Vite plugin: `rerenderLens()` in `vite.config.ts` starts rerender-lens in dev before React loads,\n * with the DevTools notifier, so the extension panel works without touching the app.\n *\n * With `panel: true` it also serves the panel itself at `/__rerender-lens/` (no extension needed): the\n * app publishes on a same-origin `BroadcastChannel`, the panel tab listens and sends commands back.\n *\n * The plugin serves a virtual module that imports `rerender-lens` and calls `init`, and injects a\n * `<script type=\"module\">` for it at the top of `<head>`. Module scripts execute in document order,\n * so it runs before the app entry (and after Vite's Fast Refresh preamble, which is fine: `init`\n * wraps whatever DevTools hook exists). Nothing happens in `vite build`.\n */\nimport { existsSync, readFileSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { Options } from './types';\n\n/** `Options` minus the parts that cannot be serialized into a module (functions). Matchers may be strings or RegExps. */\nexport type VitePluginOptions = Omit<Options, 'notifier' | 'console' | 'include' | 'exclude'> & {\n  include?: (string | RegExp)[];\n  exclude?: (string | RegExp)[];\n  /** Also post reports to the DevTools bridge for the extension. Default true. */\n  devtools?: boolean;\n  /** Apply in `vite build` too (for staging builds you want to inspect). Default false. */\n  applyInBuild?: boolean;\n  /**\n   * Serve the panel from the dev server (default path `/__rerender-lens/`) and publish reports on a\n   * BroadcastChannel so it works without the extension. `true`, or a mount path. Default false.\n   */\n  panel?: boolean | string;\n  /** BroadcastChannel name used with `panel`. Default `rerender-lens`. */\n  channel?: string;\n  /** Which HTML pages get the setup script: an allow-list of paths (`/`, `/admin.html`) or a predicate. Default all. */\n  pages?: string[] | ((path: string) => boolean);\n};\n\nexport const VIRTUAL_ID = 'virtual:rerender-lens';\nconst RESOLVED_ID = '\\0' + VIRTUAL_ID;\n/** URL Vite serves the virtual module under (the `\\0` prefix is spelled `__x00__`). */\nexport const VIRTUAL_URL = '/@id/__x00__' + VIRTUAL_ID;\nexport const DEFAULT_PANEL_PATH = '/__rerender-lens/';\n\nconst serializeMatcher = (m: string | RegExp): string => (m instanceof RegExp ? `new RegExp(${JSON.stringify(m.source)}, ${JSON.stringify(m.flags)})` : JSON.stringify(m));\n\n/** Source of the virtual module. Exported for tests and for other bundlers' loaders. */\nexport function renderSetupModule(options: VitePluginOptions = {}): string {\n  const { devtools = true, applyInBuild: _applyInBuild, panel, channel, pages: _pages, include, exclude, ...rest } = options;\n  const entries: string[] = [];\n  for (const [k, v] of Object.entries(rest)) if (v !== undefined) entries.push(`${JSON.stringify(k)}: ${JSON.stringify(v)}`);\n  if (include) entries.push(`include: [${include.map(serializeMatcher).join(', ')}]`);\n  if (exclude) entries.push(`exclude: [${exclude.map(serializeMatcher).join(', ')}]`);\n  const notifierOptions = panel ? `{ channel: ${JSON.stringify(channel || 'rerender-lens')} }` : '';\n  if (devtools || panel) entries.push(`notifier: createDevtoolsNotifier(${notifierOptions})`);\n  return [\n    `import { init${devtools || panel ? ', createDevtoolsNotifier' : ''} } from 'rerender-lens';`,\n    `init({ ${entries.join(', ')} });`,\n    '',\n  ].join('\\n');\n}\n\n/** Minimal shape of a Vite plugin, so `vite` stays an optional peer. */\nexport interface RerenderLensVitePlugin {\n  name: string;\n  apply?: 'serve' | 'build';\n  enforce?: 'pre' | 'post';\n  resolveId(id: string): string | undefined;\n  load(id: string): string | undefined;\n  transformIndexHtml: {\n    order: 'pre';\n    handler(html: string, ctx?: { path?: string; filename?: string }): { tag: string; attrs: Record<string, string>; injectTo: 'head-prepend' }[];\n  };\n  configureServer?(server: ViteServerLike): void;\n}\n\n/** The parts of Vite's dev server the plugin uses. */\nexport interface ViteServerLike {\n  /** Connect-style; mounting without a path keeps `req.url` intact (a mount path would strip the prefix). */\n  middlewares: { use(handler: (req: IncomingLike, res: ResponseLike, next: () => void) => void): void };\n  config?: { logger?: { info(msg: string): void }; server?: { port?: number; host?: string | boolean } };\n  resolvedUrls?: { local?: string[] } | null;\n  httpServer?: { once(event: 'listening', cb: () => void): void } | null;\n}\ninterface IncomingLike {\n  url?: string;\n  method?: string;\n}\ninterface ResponseLike {\n  statusCode: number;\n  setHeader(name: string, value: string): void;\n  end(body?: string | Uint8Array): void;\n}\n\n/** Directory holding panel.html/js/css: `panel/` next to `dist/` in the package, or the extension folder in this repo. */\nexport function panelDir(): string | null {\n  const here = dirname(fileURLToPath(import.meta.url));\n  for (const dir of [join(here, '..', 'panel'), join(here, '..', 'extension'), join(here, '..', '..', 'extension')]) {\n    if (existsSync(join(dir, 'panel.html')) && existsSync(join(dir, 'panel.js'))) return dir;\n  }\n  return null;\n}\n\nconst MIME: Record<string, string> = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8' };\n\n/** Middleware serving the panel under `mount` (exported for tests). */\nexport function panelMiddleware(mount: string, channel: string, dir: string | null): (req: IncomingLike, res: ResponseLike, next: () => void) => void {\n  const base = mount.endsWith('/') ? mount : mount + '/';\n  return (req, res, next) => {\n    const url = req.url || '/';\n    if (!url.startsWith(base.slice(0, -1))) return next();\n    const [pathOnly, query = ''] = url.split('?', 2);\n    if (pathOnly === base.slice(0, -1) || pathOnly === base) {\n      // The panel boots in channel mode from its query string.\n      res.statusCode = 302;\n      res.setHeader('Location', `${base}panel.html?channel=${encodeURIComponent(channel)}${query ? '&' + query : ''}`);\n      res.end();\n      return;\n    }\n    const file = pathOnly!.slice(base.length);\n    if (!/^panel\\.(html|js|css)$/.test(file)) return next();\n    if (!dir) {\n      res.statusCode = 500;\n      res.setHeader('Content-Type', 'text/plain');\n      res.end('rerender-lens: panel files not found (is the package built?)');\n      return;\n    }\n    res.statusCode = 200;\n    res.setHeader('Content-Type', MIME[file.slice(file.lastIndexOf('.'))] || 'application/octet-stream');\n    res.setHeader('Cache-Control', 'no-store');\n    res.end(readFileSync(join(dir, file)));\n  };\n}\n\nexport function rerenderLens(options: VitePluginOptions = {}): RerenderLensVitePlugin {\n  const defaults: VitePluginOptions = { trackAllMemoized: true };\n  const merged = { ...defaults, ...options };\n  const pages = merged.pages;\n  const wants = (path: string | undefined): boolean => {\n    if (!pages) return true;\n    const p = path || '/';\n    if (typeof pages === 'function') return pages(p);\n    return pages.some((x) => x === p || (x === '/' && p === '/index.html') || (x === '/index.html' && p === '/'));\n  };\n  const mount = typeof merged.panel === 'string' ? merged.panel : DEFAULT_PANEL_PATH;\n  const plugin: RerenderLensVitePlugin = {\n    name: 'rerender-lens',\n    enforce: 'pre',\n    resolveId(id) {\n      return id === VIRTUAL_ID ? RESOLVED_ID : undefined;\n    },\n    load(id) {\n      return id === RESOLVED_ID ? renderSetupModule(merged) : undefined;\n    },\n    transformIndexHtml: {\n      order: 'pre',\n      handler(_html, ctx) {\n        if (!wants(ctx?.path)) return [];\n        return [{ tag: 'script', attrs: { type: 'module', src: VIRTUAL_URL }, injectTo: 'head-prepend' }];\n      },\n    },\n  };\n  if (!merged.applyInBuild) plugin.apply = 'serve';\n  if (merged.panel) {\n    plugin.configureServer = (server) => {\n      server.middlewares.use(panelMiddleware(mount, merged.channel || 'rerender-lens', panelDir()));\n      const announce = (): void => {\n        const local = server.resolvedUrls?.local?.[0];\n        server.config?.logger?.info(`  ➜  rerender-lens panel: ${local ? local.replace(/\\/$/, '') : ''}${mount}`);\n      };\n      if (server.httpServer) server.httpServer.once('listening', () => setTimeout(announce, 0));\n    };\n  }\n  return plugin;\n}\n"]}