@sightmap/react 0.6.0 → 0.8.0

package/dist/index.d.ts

@@ -1,7 +1,18 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { S as SightmapSnapshot } from './runtime-types-Cvx7dsB4.js';
+export { C as CandidateSelector, a as ComponentNode, b as SelectorSource, c as SelectorStability, d as SightmapMarker, U as UnmarkedCandidate } from './runtime-types-Cvx7dsB4.js';
 import { ReactNode } from 'react';
 import { Sightmap, Diagnostic } from '@sightmap/sightmap';
-export { ComponentNode, SelectorProposal, SightmapHook } from './runtime-types.js';
+export { sightmap } from './vite.js';
+import 'vite';
+
+declare global {
+    interface Window {
+        __sightmap__?: {
+            snapshot: () => SightmapSnapshot;
+        };
+    }
+}
 
 type RuntimeMode = "dev" | "enabled" | "off";
 type SightmapProviderProps = {
@@ -14,4 +25,4 @@ type SightmapProviderProps = {
 declare function useSightmap(): Sightmap | null;
 declare function SightmapProvider(props: SightmapProviderProps): react_jsx_runtime.JSX.Element;
 
-export { SightmapProvider, type SightmapProviderProps, useSightmap };
+export { SightmapProvider, type SightmapProviderProps, SightmapSnapshot, useSightmap };

package/dist/index.js

@@ -1,3 +1,286 @@
+// src/runtime/bippy-install.ts
+import { instrument } from "bippy";
+
+// src/runtime/serialize.ts
+import {
+  traverseFiber,
+  getDisplayName,
+  isCompositeFiber
+} from "bippy";
+
+// src/runtime/rank-selectors.ts
+function rankSelectors(el) {
+  const out = [];
+  const dsm = el.getAttribute("data-sightmap");
+  if (dsm !== null) {
+    out.push({
+      selector: `[data-sightmap="${cssEsc(dsm)}"]`,
+      stability: "high",
+      source: "data-sightmap"
+    });
+  }
+  for (const attr of ["data-testid", "data-cy", "data-test"]) {
+    const v = el.getAttribute(attr);
+    if (v !== null) {
+      out.push({
+        selector: `[${attr}="${cssEsc(v)}"]`,
+        stability: "high",
+        source: attr
+      });
+    }
+  }
+  const role = el.getAttribute("role");
+  const aria = el.getAttribute("aria-label");
+  if (role && aria) {
+    out.push({
+      selector: `[role="${cssEsc(role)}"][aria-label="${cssEsc(aria)}"]`,
+      stability: "medium",
+      source: "aria"
+    });
+  } else if (aria) {
+    out.push({
+      selector: `[aria-label="${cssEsc(aria)}"]`,
+      stability: "medium",
+      source: "aria-label"
+    });
+  }
+  const name = el.getAttribute("name");
+  if (name !== null && /^(form|input|button|select|textarea|nav)$/i.test(el.tagName)) {
+    out.push({
+      selector: `${el.tagName.toLowerCase()}[name="${cssEsc(name)}"]`,
+      stability: "medium",
+      source: "semantic-name"
+    });
+  }
+  const id = el.id;
+  if (id && isHumanShapedId(id)) {
+    out.push({
+      selector: `#${cssEsc(id)}`,
+      stability: "high",
+      source: "id"
+    });
+  }
+  return out;
+}
+function cssEsc(v) {
+  return v.replace(/"/g, '\\"');
+}
+function isHumanShapedId(id) {
+  if (/[0-9]{6,}/.test(id)) return false;
+  if (/^[a-z]+-[a-f0-9]{8,}/i.test(id)) return false;
+  if (/:r[0-9a-z]+:/i.test(id)) return false;
+  return true;
+}
+
+// src/runtime/portal-aware-walker.ts
+var HOST_PORTAL_TAG = 4;
+var MAX_NODES_DEFAULT = 5e3;
+function findHostElementForFiber(fiber, inDocument, maxNodes = MAX_NODES_DEFAULT) {
+  if (!fiber.child) return null;
+  const stack = [fiber.child];
+  let walks = 0;
+  while (stack.length > 0 && walks < maxNodes) {
+    walks++;
+    const f = stack.pop();
+    if (!f) continue;
+    if (f.sibling) stack.push(f.sibling);
+    if (f.tag === HOST_PORTAL_TAG) continue;
+    const stateNode = f.stateNode;
+    if (stateNode && typeof stateNode === "object" && "tagName" in stateNode) {
+      if (inDocument(stateNode)) return stateNode;
+    }
+    if (f.child) stack.push(f.child);
+  }
+  return null;
+}
+
+// src/runtime/serialize.ts
+var FRAMEWORK_NOISE = /* @__PURE__ */ new Set([
+  "Routes",
+  "Route",
+  "RenderedRoute",
+  "Outlet",
+  "BrowserRouter",
+  "Router",
+  "RouterProvider",
+  "DataRouterProvider",
+  "RouterProviderImpl",
+  "LinkWithRef",
+  "StrictMode",
+  "SightmapProvider",
+  "Fragment",
+  "Anonymous",
+  "Suspense",
+  "ErrorBoundary",
+  "Provider",
+  "Consumer",
+  "ThemeProvider",
+  "Hydration",
+  "HydrateFallback",
+  "RemixErrorBoundary",
+  "HydratedRouter",
+  "DataRoutes",
+  "WithHydrateFallbackProps2",
+  "RenderErrorBoundary",
+  "Layout"
+]);
+function serializeSnapshot(opts) {
+  const roots = Array.from(opts.trackedRoots);
+  if (roots.length === 0) {
+    return {
+      capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      route: "?",
+      commits: 0,
+      components: [],
+      markers: [],
+      unmarkedCandidates: []
+    };
+  }
+  const root = roots.find((r) => r.current?.child !== null) ?? roots[0];
+  if (!root) {
+    return {
+      capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      route: "?",
+      commits: 0,
+      components: [],
+      markers: [],
+      unmarkedCandidates: []
+    };
+  }
+  const rootFiber = root.current;
+  const components = collectComponents(rootFiber);
+  const markers = collectMarkers();
+  const unmarkedCandidates = collectUnmarkedCandidates(rootFiber);
+  return {
+    capturedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    route: typeof window !== "undefined" && window.location ? window.location.pathname + (window.location.search ?? "") : "?",
+    commits: roots.length,
+    components,
+    markers,
+    unmarkedCandidates
+  };
+}
+function collectComponents(rootFiber) {
+  const out = [];
+  const depthByFiber = /* @__PURE__ */ new Map();
+  depthByFiber.set(rootFiber, 0);
+  traverseFiber(rootFiber, (f) => {
+    const depth = depthByFiber.get(f) ?? 0;
+    let c = f.child;
+    while (c) {
+      depthByFiber.set(c, depth + 1);
+      c = c.sibling;
+    }
+    if (!isCompositeFiber(f)) return false;
+    const name = getDisplayName(f);
+    if (!name) return false;
+    const childNames = [];
+    let cc = f.child;
+    while (cc) {
+      if (isCompositeFiber(cc)) {
+        const n = getDisplayName(cc);
+        if (n) childNames.push(n);
+      }
+      cc = cc.sibling;
+    }
+    out.push({ displayName: name, depth, children: childNames });
+    return false;
+  });
+  return out;
+}
+function collectMarkers() {
+  const out = [];
+  if (typeof document === "undefined") return out;
+  const els = document.querySelectorAll("[data-sightmap]");
+  for (let i = 0; i < els.length; i++) {
+    const el = els[i];
+    const name = el.getAttribute("data-sightmap") ?? "";
+    const fiber = bridgeDomToFiber(el);
+    const nearestComponent = nearestCompositeName(fiber);
+    out.push({
+      name,
+      hostTag: el.tagName.toLowerCase(),
+      ...nearestComponent !== void 0 ? { nearestComponent } : {},
+      domDepth: domDepth(el),
+      candidateSelectors: rankSelectors(el)
+    });
+  }
+  return out;
+}
+function collectUnmarkedCandidates(rootFiber) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  traverseFiber(rootFiber, (f) => {
+    if (!isCompositeFiber(f)) return false;
+    const name = getDisplayName(f);
+    if (!name || seen.has(name) || FRAMEWORK_NOISE.has(name)) return false;
+    seen.add(name);
+    const hostEl = findHostElementForFiber(f, (el) => document.contains(el));
+    if (!hostEl) return false;
+    const selectors = rankSelectors(hostEl);
+    if (selectors.length === 0) return false;
+    out.push({
+      displayName: name,
+      hostTag: hostEl.tagName.toLowerCase(),
+      selectors,
+      domDepth: domDepth(hostEl)
+    });
+    return false;
+  });
+  return out;
+}
+function bridgeDomToFiber(el) {
+  for (const key of Object.keys(el)) {
+    if (key.startsWith("__reactFiber$")) {
+      return el[key] ?? null;
+    }
+  }
+  return null;
+}
+function nearestCompositeName(fiber) {
+  let f = fiber;
+  let walks = 0;
+  while (f && walks < 50) {
+    if (isCompositeFiber(f)) {
+      const n = getDisplayName(f);
+      if (n) return n;
+    }
+    f = f.return;
+    walks++;
+  }
+  return void 0;
+}
+function domDepth(el) {
+  let d = 0;
+  let cur = el.parentElement;
+  while (cur && cur !== document.body) {
+    d++;
+    cur = cur.parentElement;
+  }
+  return d;
+}
+
+// src/runtime/bippy-install.ts
+var trackedRoots = /* @__PURE__ */ new Set();
+instrument({
+  onCommitFiberRoot: (_id, root) => {
+    trackedRoots.add(root);
+  }
+});
+if (typeof window !== "undefined") {
+  window.__sightmap__ = { snapshot: () => serializeSnapshot({ trackedRoots }) };
+  setTimeout(() => {
+    if (trackedRoots.size > 0) return;
+    if (typeof document === "undefined") return;
+    const rootEl = document.querySelector("#root, [data-reactroot], body > div");
+    const domHasContent = (rootEl?.children.length ?? 0) > 0;
+    if (!domHasContent) return;
+    console.error(
+      "[sightmap] Late registration: SightmapProvider's runtime hook missed React-DOM's renderer registration. Snapshots will be empty even though the DOM rendered.\n\nFix one of:\n  1. Import the @sightmap/react entry FIRST in your app entry file (before react-dom and your app code).\n  2. Use the auto-inject Vite plugin option (sightmap({ autoInject: true })).\n  3. If you must lazy-load the provider, force a no-op state update after install to flush a commit."
+    );
+  }, 1e3);
+}
+
 // src/provider.tsx
 import { createContext, useContext, useEffect, useRef, useState } from "react";
 import { parse, merge } from "@sightmap/sightmap";
@@ -154,7 +437,7 @@ var SDK_VERSION = "0.1.0";
 var SPEC_VERSION = "1";
 function SightmapProvider(props) {
   const { sightmap: initial, source = "/__sightmap__/sightmap.json", runtimeIntrospection = "dev", onError, children } = props;
-  const [sightmap, setSightmap] = useState(initial ?? null);
+  const [sightmap2, setSightmap] = useState(initial ?? null);
   const containerRef = useRef(null);
   useEffect(() => {
     if (initial) return;
@@ -179,10 +462,10 @@ function SightmapProvider(props) {
   }, [initial, source, onError]);
   useEffect(() => {
     const enabled = runtimeIntrospection === "enabled" || runtimeIntrospection === "dev" && process.env.NODE_ENV !== "production";
-    if (!enabled || !sightmap) return;
+    if (!enabled || !sightmap2) return;
     const hook = createHook({
       getContainer: () => containerRef.current,
-      getSightmap: () => sightmap,
+      getSightmap: () => sightmap2,
       // Read fresh on every call. Both popstate and pushState/replaceState (via react-router)
       // mutate window.location.pathname synchronously; reading on demand always sees the
       // current value without needing a listener.
@@ -191,11 +474,72 @@ function SightmapProvider(props) {
       specVersion: SPEC_VERSION
     });
     return installHook(hook);
-  }, [runtimeIntrospection, sightmap]);
-  return /* @__PURE__ */ jsx(SightmapContext.Provider, { value: sightmap, children: /* @__PURE__ */ jsx("div", { ref: containerRef, "data-sightmap-root": "", children }) });
+  }, [runtimeIntrospection, sightmap2]);
+  return /* @__PURE__ */ jsx(SightmapContext.Provider, { value: sightmap2, children: /* @__PURE__ */ jsx("div", { ref: containerRef, "data-sightmap-root": "", children }) });
+}
+
+// src/vite.ts
+function sightmap(options = {}) {
+  let cached = null;
+  const cache = {
+    set(s) {
+      cached = s;
+    },
+    get() {
+      return cached;
+    }
+  };
+  const ENTRY_PATTERN = /(src|app)\/(main|index|entry\.client)\.(t|j)sx?$/;
+  const INJECT_LINE = `import "@sightmap/react";
+`;
+  return {
+    name: "sightmap-react",
+    configureServer(server) {
+      server.middlewares.use("/__sightmap__/snapshot.json", (req, res) => {
+        if (req.method === "POST") {
+          const chunks = [];
+          req.on("data", (c) => chunks.push(c));
+          req.on("end", () => {
+            try {
+              const body = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+              cache.set(body);
+              res.statusCode = 204;
+              res.end();
+            } catch (e) {
+              res.statusCode = 400;
+              res.end(`bad json: ${e.message}`);
+            }
+          });
+          return;
+        }
+        if (req.method === "GET") {
+          const snap = cache.get();
+          if (!snap) {
+            res.statusCode = 404;
+            res.end(`{"error":"no snapshot cached yet \u2014 visit a page first"}`);
+            return;
+          }
+          res.statusCode = 200;
+          res.setHeader("content-type", "application/json");
+          res.end(JSON.stringify(snap));
+          return;
+        }
+        res.statusCode = 405;
+        res.end();
+      });
+    },
+    transform(code, id) {
+      if (!options.autoInject) return null;
+      if (!ENTRY_PATTERN.test(id)) return null;
+      if (code.includes("@sightmap/react")) return null;
+      return { code: INJECT_LINE + code, map: null };
+    },
+    __test_cache: cache
+  };
 }
 export {
   SightmapProvider,
+  sightmap,
   useSightmap
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/provider.tsx","../src/runtime/hook.ts","../src/runtime/surface.ts","../src/runtime/walker.ts"],"sourcesContent":["// src/provider.tsx\nimport { createContext, useContext, useEffect, useRef, useState, type ReactNode } from \"react\";\nimport type { Sightmap } from \"@sightmap/sightmap\";\nimport { parse, merge } from \"@sightmap/sightmap\";\nimport type { Diagnostic } from \"@sightmap/sightmap\";\nimport { installHook } from \"./runtime/hook.js\";\nimport { createHook } from \"./runtime/surface.js\";\n\ntype RuntimeMode = \"dev\" | \"enabled\" | \"off\";\n\nexport type SightmapProviderProps = {\n  sightmap?: Sightmap;\n  source?: string;\n  runtimeIntrospection?: RuntimeMode;\n  onError?: (diagnostic: Diagnostic) => void;\n  children: ReactNode;\n};\n\nconst SightmapContext = createContext<Sightmap | null>(null);\n\nexport function useSightmap(): Sightmap | null {\n  return useContext(SightmapContext);\n}\n\nconst SDK_VERSION = \"0.1.0\";\nconst SPEC_VERSION = \"1\";\n\nexport function SightmapProvider(props: SightmapProviderProps) {\n  const { sightmap: initial, source = \"/__sightmap__/sightmap.json\", runtimeIntrospection = \"dev\", onError, children } = props;\n  const [sightmap, setSightmap] = useState<Sightmap | null>(initial ?? null);\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  // Load from `source` if no initial sightmap was provided.\n  useEffect(() => {\n    if (initial) return;\n    let cancelled = false;\n    fetch(source, { credentials: \"same-origin\" })\n      .then((r) => r.json())\n      .then((json: unknown) => {\n        if (cancelled) return;\n        // The dev middleware returns a parsed Sightmap object; in the future, source could be a YAML string.\n        if (typeof json === \"string\") {\n          setSightmap(merge([parse(json)]));\n        } else {\n          setSightmap(json as Sightmap);\n        }\n      })\n      .catch((err) => {\n        onError?.({\n          severity: \"error\",\n          code: \"react.sightmap-fetch-failed\",\n          message: `Failed to load sightmap from ${source}: ${(err as Error).message}`,\n        });\n      });\n    return () => { cancelled = true; };\n  }, [initial, source, onError]);\n\n  // Install/teardown the hook based on lifetime mode.\n  useEffect(() => {\n    const enabled = runtimeIntrospection === \"enabled\"\n      || (runtimeIntrospection === \"dev\" && process.env.NODE_ENV !== \"production\");\n    if (!enabled || !sightmap) return;\n\n    const hook = createHook({\n      getContainer: () => containerRef.current,\n      getSightmap: () => sightmap,\n      // Read fresh on every call. Both popstate and pushState/replaceState (via react-router)\n      // mutate window.location.pathname synchronously; reading on demand always sees the\n      // current value without needing a listener.\n      getCurrentRoute: () => window.location.pathname,\n      sdkVersion: SDK_VERSION,\n      specVersion: SPEC_VERSION,\n    });\n    return installHook(hook);\n  }, [runtimeIntrospection, sightmap]);\n\n  return (\n    <SightmapContext.Provider value={sightmap}>\n      <div ref={containerRef} data-sightmap-root=\"\">{children}</div>\n    </SightmapContext.Provider>\n  );\n}\n","// src/runtime/hook.ts\nimport type { SightmapHook } from \"./types.js\";\n\nexport function installHook(hook: SightmapHook): () => void {\n  if (typeof window === \"undefined\") return () => {};\n  if (window.__SIGHTMAP__) return () => {};                  // already installed (StrictMode double-mount)\n  window.__SIGHTMAP__ = hook;\n  return () => {\n    if (window.__SIGHTMAP__ === hook) delete window.__SIGHTMAP__;\n  };\n}\n","// src/runtime/surface.ts\nimport type { Sightmap, ResolvedView, MatchResult } from \"@sightmap/sightmap\";\nimport { match as coreMatch } from \"@sightmap/sightmap\";\nimport type { SightmapHook, ComponentNode } from \"./types.js\";\nimport { walkFromRoot } from \"./walker.js\";\n\nexport type SurfaceContext = {\n  getContainer: () => Element | null;\n  getSightmap: () => Sightmap;\n  getCurrentRoute: () => string;\n  sdkVersion: string;\n  specVersion: string;\n};\n\nexport function createHook(ctx: SurfaceContext): SightmapHook {\n  return {\n    version: () => ({ sdk: ctx.sdkVersion, spec: ctx.specVersion }),\n    getSightmap: ctx.getSightmap,\n    getCurrentView: () => {\n      const result = coreMatch(ctx.getSightmap(), { url: ctx.getCurrentRoute() });\n      return result.view;\n    },\n    match: (req) => coreMatch(ctx.getSightmap(), req),\n    walkTree: (opts) => {\n      const container = ctx.getContainer();\n      if (!container) return [];\n      const all = walkFromRoot(container);\n      if (!opts) return all;\n      let scoped = all;\n      if (opts.rootId !== undefined) {\n        scoped = all.filter((n) => isDescendant(all, n.id, opts.rootId!));\n      }\n      if (opts.maxDepth !== undefined) {\n        const baseDepth = opts.rootId\n          ? (scoped.find((n) => n.id === opts.rootId)?.depth ?? 0)\n          : 0;\n        scoped = scoped.filter((n) => n.depth - baseDepth <= opts.maxDepth!);\n      }\n      return scoped;\n    },\n    inspectAt: (x, y) => {\n      const container = ctx.getContainer();\n      if (!container) return null;\n      const target = document.elementFromPoint(x, y);\n      if (!target) return null;\n      const all = walkFromRoot(container);\n      return all.find((n) => n.dom !== null && nodeMatchesEl(n, target as Element)) ?? null;\n    },\n    findByDataSightmap: (name) => {\n      const container = ctx.getContainer();\n      if (!container) return [];\n      return walkFromRoot(container).filter((n) => n.dom?.dataSightmap === name);\n    },\n  };\n}\n\nfunction isDescendant(all: ComponentNode[], id: string, rootId: string): boolean {\n  let cursor: ComponentNode | undefined = all.find((n) => n.id === id);\n  while (cursor) {\n    if (cursor.id === rootId) return true;\n    if (cursor.parentId === null) return false;\n    cursor = all.find((n) => n.id === cursor!.parentId);\n  }\n  return false;\n}\n\nfunction nodeMatchesEl(node: ComponentNode, el: Element): boolean {\n  return node.dom?.tagName === el.tagName.toLowerCase()\n    && node.dom?.dataSightmap === el.getAttribute(\"data-sightmap\");\n}\n","// src/runtime/walker.ts\nimport type { ComponentNode } from \"./types.js\";\n\n/**\n * Walk the React fiber tree starting from a DOM container.\n *\n * Implementation note: React 19 stores the fiber root on the container via an\n * internal property. We probe a few known shapes (the format has changed across\n * minor versions). If fiber access becomes load-bearing, replace this with a\n * subscription via the global DevTools-style hook (see Task 20) which calls us\n * with the FiberRoot directly.\n */\nexport function walkFromRoot(container: Element): ComponentNode[] {\n  const fiberRoot = findFiberRoot(container);\n  if (!fiberRoot) return [];\n  const nodes: ComponentNode[] = [];\n  let nextId = 0;\n  const stack: Array<{ fiber: any; parentId: string | null; depth: number }> = [\n    { fiber: fiberRoot.current, parentId: null, depth: 0 },\n  ];\n  while (stack.length > 0) {\n    const { fiber, parentId, depth } = stack.pop()!;\n    if (!fiber) continue;\n    const id = String(nextId++);\n    const node: ComponentNode = {\n      id,\n      parentId,\n      depth,\n      type: typeName(fiber),\n      key: fiber.key ?? null,\n      dom: fiber.stateNode instanceof Element ? domDescriptor(fiber.stateNode) : null,\n      source: sourceFromFiber(fiber),\n      childIds: [],\n    };\n    nodes.push(node);\n    if (parentId !== null) {\n      const parent = nodes.find((n) => n.id === parentId);\n      if (parent) parent.childIds.push(id);\n    }\n    // Push children in reverse so the natural traversal is depth-first left→right.\n    const children: any[] = [];\n    let child = fiber.child;\n    while (child) {\n      children.push(child);\n      child = child.sibling;\n    }\n    for (let i = children.length - 1; i >= 0; i--) {\n      stack.push({ fiber: children[i], parentId: id, depth: depth + 1 });\n    }\n  }\n  return nodes;\n}\n\nfunction findFiberRoot(container: Element): { current: any } | null {\n  for (const key of Object.keys(container)) {\n    if (key.startsWith(\"__reactContainer$\") || key.startsWith(\"__reactFiber$\")) {\n      const fiber = (container as any)[key];\n      let root = fiber;\n      while (root?.return) root = root.return;\n      if (root?.stateNode?.current) return root.stateNode;\n    }\n  }\n  return null;\n}\n\nfunction typeName(fiber: any): string {\n  const t = fiber.type;\n  if (typeof t === \"string\") return t;\n  if (t?.displayName) return t.displayName;\n  if (t?.name) return t.name;\n  return \"Unknown\";\n}\n\nfunction domDescriptor(el: Element): NonNullable<ComponentNode[\"dom\"]> {\n  return {\n    tagName: el.tagName.toLowerCase(),\n    dataSightmap: el.getAttribute(\"data-sightmap\"),\n    testId: el.getAttribute(\"data-testid\"),\n    classes: Array.from(el.classList),\n  };\n}\n\nfunction sourceFromFiber(fiber: any): ComponentNode[\"source\"] {\n  const src = fiber._debugSource ?? fiber.elementType?.__source ?? null;\n  if (src && typeof src.fileName === \"string\") {\n    return { file: src.fileName, line: src.lineNumber ?? 0, col: src.columnNumber ?? 0 };\n  }\n  return null;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/runtime/bippy-install.ts","../src/runtime/serialize.ts","../src/runtime/rank-selectors.ts","../src/runtime/portal-aware-walker.ts","../src/provider.tsx","../src/runtime/hook.ts","../src/runtime/surface.ts","../src/runtime/walker.ts","../src/vite.ts"],"sourcesContent":["// Module-init side effects only. Importing this file installs the bippy hook\n// and exposes window.__sightmap__.snapshot(). Provider renders Fragment.\n//\n// CRITICAL: This module must be imported BEFORE react-dom in the app entry.\n// The runtime guard below catches the common late-init mistake.\n\nimport { instrument, type FiberRoot } from \"bippy\";\nimport { serializeSnapshot } from \"./serialize.js\";\nimport type { SightmapSnapshot } from \"./types.js\";\n\ndeclare global {\n  interface Window {\n    __sightmap__?: { snapshot: () => SightmapSnapshot };\n  }\n}\n\nconst trackedRoots = new Set<FiberRoot>();\n\ninstrument({\n  onCommitFiberRoot: (_id, root) => {\n    trackedRoots.add(root);\n  },\n});\n\nif (typeof window !== \"undefined\") {\n  window.__sightmap__ = { snapshot: () => serializeSnapshot({ trackedRoots }) };\n\n  // 1s grace window. If DOM has content but we saw zero commits, the import\n  // ordering is wrong — fire a single actionable error.\n  setTimeout(() => {\n    if (trackedRoots.size > 0) return;\n    if (typeof document === \"undefined\") return;\n    const rootEl = document.querySelector(\"#root, [data-reactroot], body > div\");\n    const domHasContent = (rootEl?.children.length ?? 0) > 0;\n    if (!domHasContent) return;\n    // eslint-disable-next-line no-console\n    console.error(\n      \"[sightmap] Late registration: SightmapProvider's runtime hook \" +\n        \"missed React-DOM's renderer registration. Snapshots will be empty \" +\n        \"even though the DOM rendered.\\n\\n\" +\n        \"Fix one of:\\n\" +\n        \"  1. Import the @sightmap/react entry FIRST in your app entry file \" +\n        \"(before react-dom and your app code).\\n\" +\n        \"  2. Use the auto-inject Vite plugin option (sightmap({ autoInject: true })).\\n\" +\n        \"  3. If you must lazy-load the provider, force a no-op state update \" +\n        \"after install to flush a commit.\",\n    );\n  }, 1000);\n}\n\nexport { trackedRoots };\n","import {\n  traverseFiber,\n  getDisplayName,\n  isCompositeFiber,\n  type Fiber,\n  type FiberRoot,\n} from \"bippy\";\nimport { rankSelectors } from \"./rank-selectors.js\";\nimport { findHostElementForFiber } from \"./portal-aware-walker.js\";\nimport type {\n  SightmapSnapshot,\n  SightmapMarker,\n  UnmarkedCandidate,\n  SnapshotComponent,\n} from \"./types.js\";\n\nexport interface SerializeOptions {\n  trackedRoots: Set<unknown>;\n}\n\nconst FRAMEWORK_NOISE = new Set([\n  \"Routes\", \"Route\", \"RenderedRoute\", \"Outlet\", \"BrowserRouter\",\n  \"Router\", \"RouterProvider\", \"DataRouterProvider\", \"RouterProviderImpl\",\n  \"LinkWithRef\", \"StrictMode\", \"SightmapProvider\", \"Fragment\", \"Anonymous\",\n  \"Suspense\", \"ErrorBoundary\", \"Provider\", \"Consumer\",\n  \"ThemeProvider\", \"Hydration\", \"HydrateFallback\",\n  \"RemixErrorBoundary\", \"HydratedRouter\", \"DataRoutes\",\n  \"WithHydrateFallbackProps2\", \"RenderErrorBoundary\", \"Layout\",\n]);\n\nexport function serializeSnapshot(opts: SerializeOptions): SightmapSnapshot {\n  const roots = Array.from(opts.trackedRoots) as FiberRoot[];\n  if (roots.length === 0) {\n    return {\n      capturedAt: new Date().toISOString(),\n      route: \"?\",\n      commits: 0,\n      components: [],\n      markers: [],\n      unmarkedCandidates: [],\n    };\n  }\n  const root = roots.find((r) => r.current?.child !== null) ?? roots[0];\n  if (!root) {\n    return {\n      capturedAt: new Date().toISOString(),\n      route: \"?\",\n      commits: 0,\n      components: [],\n      markers: [],\n      unmarkedCandidates: [],\n    };\n  }\n  const rootFiber = root.current as Fiber;\n\n  const components = collectComponents(rootFiber);\n  const markers = collectMarkers();\n  const unmarkedCandidates = collectUnmarkedCandidates(rootFiber);\n\n  return {\n    capturedAt: new Date().toISOString(),\n    route:\n      typeof window !== \"undefined\" && window.location\n        ? window.location.pathname + (window.location.search ?? \"\")\n        : \"?\",\n    commits: roots.length,\n    components,\n    markers,\n    unmarkedCandidates,\n  };\n}\n\nfunction collectComponents(rootFiber: Fiber): SnapshotComponent[] {\n  const out: SnapshotComponent[] = [];\n  const depthByFiber = new Map<Fiber, number>();\n  depthByFiber.set(rootFiber, 0);\n\n  traverseFiber(rootFiber, (f) => {\n    const depth = depthByFiber.get(f) ?? 0;\n    let c = f.child;\n    while (c) {\n      depthByFiber.set(c, depth + 1);\n      c = c.sibling;\n    }\n    if (!isCompositeFiber(f)) return false;\n    const name = getDisplayName(f);\n    if (!name) return false;\n    const childNames: string[] = [];\n    let cc = f.child;\n    while (cc) {\n      if (isCompositeFiber(cc)) {\n        const n = getDisplayName(cc);\n        if (n) childNames.push(n);\n      }\n      cc = cc.sibling;\n    }\n    out.push({ displayName: name, depth, children: childNames });\n    return false;\n  });\n\n  return out;\n}\n\nfunction collectMarkers(): SightmapMarker[] {\n  const out: SightmapMarker[] = [];\n  if (typeof document === \"undefined\") return out;\n  const els = document.querySelectorAll<HTMLElement>(\"[data-sightmap]\");\n  for (let i = 0; i < els.length; i++) {\n    const el = els[i]!;\n    const name = el.getAttribute(\"data-sightmap\") ?? \"\";\n    const fiber = bridgeDomToFiber(el);\n    const nearestComponent = nearestCompositeName(fiber);\n    out.push({\n      name,\n      hostTag: el.tagName.toLowerCase(),\n      ...(nearestComponent !== undefined ? { nearestComponent } : {}),\n      domDepth: domDepth(el),\n      candidateSelectors: rankSelectors(el),\n    });\n  }\n  return out;\n}\n\nfunction collectUnmarkedCandidates(rootFiber: Fiber): UnmarkedCandidate[] {\n  const out: UnmarkedCandidate[] = [];\n  const seen = new Set<string>();\n  traverseFiber(rootFiber, (f) => {\n    if (!isCompositeFiber(f)) return false;\n    const name = getDisplayName(f);\n    if (!name || seen.has(name) || FRAMEWORK_NOISE.has(name)) return false;\n    seen.add(name);\n    const hostEl = findHostElementForFiber(f, (el) => document.contains(el));\n    if (!hostEl) return false;\n    const selectors = rankSelectors(hostEl);\n    if (selectors.length === 0) return false;\n    out.push({\n      displayName: name,\n      hostTag: hostEl.tagName.toLowerCase(),\n      selectors,\n      domDepth: domDepth(hostEl),\n    });\n    return false;\n  });\n  return out;\n}\n\nfunction bridgeDomToFiber(el: HTMLElement): Fiber | null {\n  for (const key of Object.keys(el)) {\n    if (key.startsWith(\"__reactFiber$\")) {\n      return (el as unknown as Record<string, Fiber>)[key] ?? null;\n    }\n  }\n  return null;\n}\n\nfunction nearestCompositeName(fiber: Fiber | null): string | undefined {\n  let f: Fiber | null = fiber;\n  let walks = 0;\n  while (f && walks < 50) {\n    if (isCompositeFiber(f)) {\n      const n = getDisplayName(f);\n      if (n) return n;\n    }\n    f = f.return;\n    walks++;\n  }\n  return undefined;\n}\n\nfunction domDepth(el: HTMLElement): number {\n  let d = 0;\n  let cur: HTMLElement | null = el.parentElement;\n  while (cur && cur !== document.body) {\n    d++;\n    cur = cur.parentElement;\n  }\n  return d;\n}\n","import type { CandidateSelector } from \"./types.js\";\n\n/**\n * Rank candidate selectors for a DOM element by stability/specificity:\n *   1. existing data-sightmap   — explicit author intent, high\n *   2. data-testid / data-cy / data-test — test attributes, high\n *   3. role + aria-label / aria-label alone — a11y, medium\n *   4. <form|input|button|select|textarea|nav> + name attr — semantic, medium\n *   5. ID, if human-shaped — high\n *\n * Skip \"generated\" IDs (long hex runs, headlessui-style :r9: tokens) which\n * change every render.\n *\n * Returns [] when nothing stable was found; callers should propose adding a\n * data-sightmap attribute for those composites.\n */\nexport function rankSelectors(el: HTMLElement): CandidateSelector[] {\n  const out: CandidateSelector[] = [];\n\n  const dsm = el.getAttribute(\"data-sightmap\");\n  if (dsm !== null) {\n    out.push({\n      selector: `[data-sightmap=\"${cssEsc(dsm)}\"]`,\n      stability: \"high\",\n      source: \"data-sightmap\",\n    });\n  }\n\n  for (const attr of [\"data-testid\", \"data-cy\", \"data-test\"] as const) {\n    const v = el.getAttribute(attr);\n    if (v !== null) {\n      out.push({\n        selector: `[${attr}=\"${cssEsc(v)}\"]`,\n        stability: \"high\",\n        source: attr,\n      });\n    }\n  }\n\n  const role = el.getAttribute(\"role\");\n  const aria = el.getAttribute(\"aria-label\");\n  if (role && aria) {\n    out.push({\n      selector: `[role=\"${cssEsc(role)}\"][aria-label=\"${cssEsc(aria)}\"]`,\n      stability: \"medium\",\n      source: \"aria\",\n    });\n  } else if (aria) {\n    out.push({\n      selector: `[aria-label=\"${cssEsc(aria)}\"]`,\n      stability: \"medium\",\n      source: \"aria-label\",\n    });\n  }\n\n  const name = el.getAttribute(\"name\");\n  if (name !== null && /^(form|input|button|select|textarea|nav)$/i.test(el.tagName)) {\n    out.push({\n      selector: `${el.tagName.toLowerCase()}[name=\"${cssEsc(name)}\"]`,\n      stability: \"medium\",\n      source: \"semantic-name\",\n    });\n  }\n\n  const id = el.id;\n  if (id && isHumanShapedId(id)) {\n    out.push({\n      selector: `#${cssEsc(id)}`,\n      stability: \"high\",\n      source: \"id\",\n    });\n  }\n\n  return out;\n}\n\nfunction cssEsc(v: string): string {\n  return v.replace(/\"/g, '\\\\\"');\n}\n\nfunction isHumanShapedId(id: string): boolean {\n  // Reject long hex runs (6+ digits or hex chars), headlessui-style `name-:r9:`,\n  // and other auto-generated identifiers that change between renders.\n  if (/[0-9]{6,}/.test(id)) return false;\n  if (/^[a-z]+-[a-f0-9]{8,}/i.test(id)) return false;\n  if (/:r[0-9a-z]+:/i.test(id)) return false;\n  return true;\n}\n","import type { Fiber } from \"bippy\";\n\n/**\n * Find the first HTMLElement rendered DOWN from a composite fiber, skipping\n * Portal subtrees. Portals mount elsewhere in the DOM and shouldn't be\n * attributed to ancestor composites.\n *\n * The `inDocument` predicate filters out detached / portal-mounted elements\n * that escaped the static tag check (e.g. via custom portals that don't use\n * React's portal API). Callers typically pass `(el) => document.contains(el)`.\n *\n * Returns null if no qualifying host element exists within `maxNodes` walked\n * fibers (default 5000 — generous but bounded to avoid runaway walks on\n * pathological trees).\n */\nconst HOST_PORTAL_TAG = 4;\nconst MAX_NODES_DEFAULT = 5000;\n\nexport function findHostElementForFiber(\n  fiber: Fiber,\n  inDocument: (el: HTMLElement) => boolean,\n  maxNodes: number = MAX_NODES_DEFAULT,\n): HTMLElement | null {\n  if (!fiber.child) return null;\n\n  // Iterative DFS using an explicit stack so we never blow the call stack.\n  const stack: Fiber[] = [fiber.child];\n  let walks = 0;\n\n  while (stack.length > 0 && walks < maxNodes) {\n    walks++;\n    const f = stack.pop();\n    if (!f) continue;\n\n    // Defer sibling traversal until after we've descended (LIFO depth-first).\n    if (f.sibling) stack.push(f.sibling);\n\n    // Portal subtree → skip entirely, don't push children.\n    if (f.tag === HOST_PORTAL_TAG) continue;\n\n    // Check if stateNode is an HTMLElement (or duck-typed as one in tests).\n    const stateNode = f.stateNode;\n    if (stateNode && typeof stateNode === \"object\" && \"tagName\" in stateNode) {\n      if (inDocument(stateNode as HTMLElement)) return stateNode as HTMLElement;\n    }\n\n    if (f.child) stack.push(f.child);\n  }\n\n  return null;\n}\n","// src/provider.tsx\n// Module side effects: install bippy hook, expose window.__sightmap__.snapshot.\n// MUST run before react-dom does any work, so it sits at the top of the\n// provider module and the provider should be imported first in app entries.\nimport \"./runtime/bippy-install.js\";\n\nimport { createContext, useContext, useEffect, useRef, useState, type ReactNode } from \"react\";\nimport type { Sightmap } from \"@sightmap/sightmap\";\nimport { parse, merge } from \"@sightmap/sightmap\";\nimport type { Diagnostic } from \"@sightmap/sightmap\";\nimport { installHook } from \"./runtime/hook.js\";\nimport { createHook } from \"./runtime/surface.js\";\n\ntype RuntimeMode = \"dev\" | \"enabled\" | \"off\";\n\nexport type SightmapProviderProps = {\n  sightmap?: Sightmap;\n  source?: string;\n  runtimeIntrospection?: RuntimeMode;\n  onError?: (diagnostic: Diagnostic) => void;\n  children: ReactNode;\n};\n\nconst SightmapContext = createContext<Sightmap | null>(null);\n\nexport function useSightmap(): Sightmap | null {\n  return useContext(SightmapContext);\n}\n\nconst SDK_VERSION = \"0.1.0\";\nconst SPEC_VERSION = \"1\";\n\nexport function SightmapProvider(props: SightmapProviderProps) {\n  const { sightmap: initial, source = \"/__sightmap__/sightmap.json\", runtimeIntrospection = \"dev\", onError, children } = props;\n  const [sightmap, setSightmap] = useState<Sightmap | null>(initial ?? null);\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  // Load from `source` if no initial sightmap was provided.\n  useEffect(() => {\n    if (initial) return;\n    let cancelled = false;\n    fetch(source, { credentials: \"same-origin\" })\n      .then((r) => r.json())\n      .then((json: unknown) => {\n        if (cancelled) return;\n        // The dev middleware returns a parsed Sightmap object; in the future, source could be a YAML string.\n        if (typeof json === \"string\") {\n          setSightmap(merge([parse(json)]));\n        } else {\n          setSightmap(json as Sightmap);\n        }\n      })\n      .catch((err) => {\n        onError?.({\n          severity: \"error\",\n          code: \"react.sightmap-fetch-failed\",\n          message: `Failed to load sightmap from ${source}: ${(err as Error).message}`,\n        });\n      });\n    return () => { cancelled = true; };\n  }, [initial, source, onError]);\n\n  // Install/teardown the hook based on lifetime mode.\n  useEffect(() => {\n    const enabled = runtimeIntrospection === \"enabled\"\n      || (runtimeIntrospection === \"dev\" && process.env.NODE_ENV !== \"production\");\n    if (!enabled || !sightmap) return;\n\n    const hook = createHook({\n      getContainer: () => containerRef.current,\n      getSightmap: () => sightmap,\n      // Read fresh on every call. Both popstate and pushState/replaceState (via react-router)\n      // mutate window.location.pathname synchronously; reading on demand always sees the\n      // current value without needing a listener.\n      getCurrentRoute: () => window.location.pathname,\n      sdkVersion: SDK_VERSION,\n      specVersion: SPEC_VERSION,\n    });\n    return installHook(hook);\n  }, [runtimeIntrospection, sightmap]);\n\n  return (\n    <SightmapContext.Provider value={sightmap}>\n      <div ref={containerRef} data-sightmap-root=\"\">{children}</div>\n    </SightmapContext.Provider>\n  );\n}\n","// src/runtime/hook.ts\nimport type { SightmapHook } from \"./types.js\";\n\nexport function installHook(hook: SightmapHook): () => void {\n  if (typeof window === \"undefined\") return () => {};\n  if (window.__SIGHTMAP__) return () => {};                  // already installed (StrictMode double-mount)\n  window.__SIGHTMAP__ = hook;\n  return () => {\n    if (window.__SIGHTMAP__ === hook) delete window.__SIGHTMAP__;\n  };\n}\n","// src/runtime/surface.ts\nimport type { Sightmap, ResolvedView, MatchResult } from \"@sightmap/sightmap\";\nimport { match as coreMatch } from \"@sightmap/sightmap\";\nimport type { SightmapHook, ComponentNode } from \"./types.js\";\nimport { walkFromRoot } from \"./walker.js\";\n\nexport type SurfaceContext = {\n  getContainer: () => Element | null;\n  getSightmap: () => Sightmap;\n  getCurrentRoute: () => string;\n  sdkVersion: string;\n  specVersion: string;\n};\n\nexport function createHook(ctx: SurfaceContext): SightmapHook {\n  return {\n    version: () => ({ sdk: ctx.sdkVersion, spec: ctx.specVersion }),\n    getSightmap: ctx.getSightmap,\n    getCurrentView: () => {\n      const result = coreMatch(ctx.getSightmap(), { url: ctx.getCurrentRoute() });\n      return result.view;\n    },\n    match: (req) => coreMatch(ctx.getSightmap(), req),\n    walkTree: (opts) => {\n      const container = ctx.getContainer();\n      if (!container) return [];\n      const all = walkFromRoot(container);\n      if (!opts) return all;\n      let scoped = all;\n      if (opts.rootId !== undefined) {\n        scoped = all.filter((n) => isDescendant(all, n.id, opts.rootId!));\n      }\n      if (opts.maxDepth !== undefined) {\n        const baseDepth = opts.rootId\n          ? (scoped.find((n) => n.id === opts.rootId)?.depth ?? 0)\n          : 0;\n        scoped = scoped.filter((n) => n.depth - baseDepth <= opts.maxDepth!);\n      }\n      return scoped;\n    },\n    inspectAt: (x, y) => {\n      const container = ctx.getContainer();\n      if (!container) return null;\n      const target = document.elementFromPoint(x, y);\n      if (!target) return null;\n      const all = walkFromRoot(container);\n      return all.find((n) => n.dom !== null && nodeMatchesEl(n, target as Element)) ?? null;\n    },\n    findByDataSightmap: (name) => {\n      const container = ctx.getContainer();\n      if (!container) return [];\n      return walkFromRoot(container).filter((n) => n.dom?.dataSightmap === name);\n    },\n  };\n}\n\nfunction isDescendant(all: ComponentNode[], id: string, rootId: string): boolean {\n  let cursor: ComponentNode | undefined = all.find((n) => n.id === id);\n  while (cursor) {\n    if (cursor.id === rootId) return true;\n    if (cursor.parentId === null) return false;\n    cursor = all.find((n) => n.id === cursor!.parentId);\n  }\n  return false;\n}\n\nfunction nodeMatchesEl(node: ComponentNode, el: Element): boolean {\n  return node.dom?.tagName === el.tagName.toLowerCase()\n    && node.dom?.dataSightmap === el.getAttribute(\"data-sightmap\");\n}\n","// src/runtime/walker.ts\nimport type { ComponentNode } from \"./types.js\";\n\n/**\n * Walk the React fiber tree starting from a DOM container.\n *\n * Implementation note: React 19 stores the fiber root on the container via an\n * internal property. We probe a few known shapes (the format has changed across\n * minor versions). If fiber access becomes load-bearing, replace this with a\n * subscription via the global DevTools-style hook (see Task 20) which calls us\n * with the FiberRoot directly.\n */\nexport function walkFromRoot(container: Element): ComponentNode[] {\n  const fiberRoot = findFiberRoot(container);\n  if (!fiberRoot) return [];\n  const nodes: ComponentNode[] = [];\n  let nextId = 0;\n  const stack: Array<{ fiber: any; parentId: string | null; depth: number }> = [\n    { fiber: fiberRoot.current, parentId: null, depth: 0 },\n  ];\n  while (stack.length > 0) {\n    const { fiber, parentId, depth } = stack.pop()!;\n    if (!fiber) continue;\n    const id = String(nextId++);\n    const node: ComponentNode = {\n      id,\n      parentId,\n      depth,\n      type: typeName(fiber),\n      key: fiber.key ?? null,\n      dom: fiber.stateNode instanceof Element ? domDescriptor(fiber.stateNode) : null,\n      source: sourceFromFiber(fiber),\n      childIds: [],\n    };\n    nodes.push(node);\n    if (parentId !== null) {\n      const parent = nodes.find((n) => n.id === parentId);\n      if (parent) parent.childIds.push(id);\n    }\n    // Push children in reverse so the natural traversal is depth-first left→right.\n    const children: any[] = [];\n    let child = fiber.child;\n    while (child) {\n      children.push(child);\n      child = child.sibling;\n    }\n    for (let i = children.length - 1; i >= 0; i--) {\n      stack.push({ fiber: children[i], parentId: id, depth: depth + 1 });\n    }\n  }\n  return nodes;\n}\n\nfunction findFiberRoot(container: Element): { current: any } | null {\n  for (const key of Object.keys(container)) {\n    if (key.startsWith(\"__reactContainer$\") || key.startsWith(\"__reactFiber$\")) {\n      const fiber = (container as any)[key];\n      let root = fiber;\n      while (root?.return) root = root.return;\n      if (root?.stateNode?.current) return root.stateNode;\n    }\n  }\n  return null;\n}\n\nfunction typeName(fiber: any): string {\n  const t = fiber.type;\n  if (typeof t === \"string\") return t;\n  if (t?.displayName) return t.displayName;\n  if (t?.name) return t.name;\n  return \"Unknown\";\n}\n\nfunction domDescriptor(el: Element): NonNullable<ComponentNode[\"dom\"]> {\n  return {\n    tagName: el.tagName.toLowerCase(),\n    dataSightmap: el.getAttribute(\"data-sightmap\"),\n    testId: el.getAttribute(\"data-testid\"),\n    classes: Array.from(el.classList),\n  };\n}\n\nfunction sourceFromFiber(fiber: any): ComponentNode[\"source\"] {\n  const src = fiber._debugSource ?? fiber.elementType?.__source ?? null;\n  if (src && typeof src.fileName === \"string\") {\n    return { file: src.fileName, line: src.lineNumber ?? 0, col: src.columnNumber ?? 0 };\n  }\n  return null;\n}\n","import type { Plugin } from \"vite\";\nimport type { SightmapSnapshot } from \"./runtime/types.js\";\n\nexport interface SightmapPluginOptions {\n  /**\n   * When true, the plugin prepends `import \"@sightmap/react\";` to the app\n   * entry (matched by filename ending in `main.tsx|tsx|jsx|ts|js` under\n   * the project's `src/` or `app/`). This guarantees the bippy hook\n   * installs before react-dom imports.\n   */\n  autoInject?: boolean;\n}\n\ninterface SnapshotCache {\n  set(s: SightmapSnapshot): void;\n  get(): SightmapSnapshot | null;\n}\n\nexport interface SightmapVitePlugin extends Plugin {\n  /** Test-only handle for unit tests. Stable contract: don't use in production. */\n  __test_cache: SnapshotCache;\n}\n\nexport function sightmap(options: SightmapPluginOptions = {}): SightmapVitePlugin {\n  let cached: SightmapSnapshot | null = null;\n  const cache: SnapshotCache = {\n    set(s) { cached = s; },\n    get() { return cached; },\n  };\n\n  const ENTRY_PATTERN = /(src|app)\\/(main|index|entry\\.client)\\.(t|j)sx?$/;\n  const INJECT_LINE = `import \"@sightmap/react\";\\n`;\n\n  return {\n    name: \"sightmap-react\",\n\n    configureServer(server) {\n      server.middlewares.use(\"/__sightmap__/snapshot.json\", (req, res) => {\n        if (req.method === \"POST\") {\n          const chunks: Buffer[] = [];\n          req.on(\"data\", (c: Buffer) => chunks.push(c));\n          req.on(\"end\", () => {\n            try {\n              const body = JSON.parse(Buffer.concat(chunks).toString(\"utf8\")) as SightmapSnapshot;\n              cache.set(body);\n              res.statusCode = 204;\n              res.end();\n            } catch (e) {\n              res.statusCode = 400;\n              res.end(`bad json: ${(e as Error).message}`);\n            }\n          });\n          return;\n        }\n        if (req.method === \"GET\") {\n          const snap = cache.get();\n          if (!snap) {\n            res.statusCode = 404;\n            res.end(`{\"error\":\"no snapshot cached yet — visit a page first\"}`);\n            return;\n          }\n          res.statusCode = 200;\n          res.setHeader(\"content-type\", \"application/json\");\n          res.end(JSON.stringify(snap));\n          return;\n        }\n        res.statusCode = 405;\n        res.end();\n      });\n    },\n\n    transform(code, id) {\n      if (!options.autoInject) return null;\n      if (!ENTRY_PATTERN.test(id)) return null;\n      if (code.includes(\"@sightmap/react\")) return null;\n      return { code: INJECT_LINE + code, map: null };\n    },\n\n    __test_cache: cache,\n  };\n}\n"],"mappings":"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","names":["sightmap"]}

package/dist/runtime-types-Cvx7dsB4.d.ts

@@ -0,0 +1,91 @@
+import { Sightmap, ResolvedView, MatchResult } from '@sightmap/sightmap';
+
+type ComponentNode = {
+    id: string;
+    parentId: string | null;
+    depth: number;
+    type: string;
+    key: string | null;
+    dom: {
+        tagName: string;
+        dataSightmap: string | null;
+        testId: string | null;
+        classes: string[];
+    } | null;
+    source: {
+        file: string;
+        line: number;
+        col: number;
+    } | null;
+    childIds: string[];
+};
+type SelectorProposal = {
+    selector: string;
+    strategy: "data-sightmap" | "data-testid" | "id" | "role-text" | "path";
+    matches: number;
+};
+type SightmapHook = {
+    version(): {
+        sdk: string;
+        spec: string;
+    };
+    getSightmap(): Sightmap;
+    getCurrentView(): ResolvedView | null;
+    match(req: {
+        url: string;
+        method?: string;
+    }): MatchResult;
+    walkTree(opts?: {
+        rootId?: string;
+        maxDepth?: number;
+    }): ComponentNode[];
+    inspectAt(x: number, y: number): ComponentNode | null;
+    findByDataSightmap(name: string): ComponentNode[];
+};
+declare global {
+    interface Window {
+        __SIGHTMAP__?: SightmapHook;
+    }
+}
+type SelectorStability = "high" | "medium" | "low";
+type SelectorSource = "data-sightmap" | "data-testid" | "data-cy" | "data-test" | "id" | "aria" | "aria-label" | "semantic-name" | "synthesized";
+interface CandidateSelector {
+    selector: string;
+    stability: SelectorStability;
+    source: SelectorSource;
+}
+interface SightmapMarker {
+    /** value of data-sightmap attribute */
+    name: string;
+    hostTag: string;
+    nearestComponent?: string;
+    domDepth: number;
+    candidateSelectors: CandidateSelector[];
+}
+interface UnmarkedCandidate {
+    displayName: string;
+    hostTag: string;
+    selectors: CandidateSelector[];
+    domDepth: number;
+}
+/**
+ * Lightweight fiber-tree component projection used in {@link SightmapSnapshot}.
+ * Distinct from {@link ComponentNode} (which is the legacy DOM-anchored walker
+ * shape consumed by `surface.ts` / `walker.ts`); this one is produced by the
+ * bippy-based snapshot serializer.
+ */
+interface SnapshotComponent {
+    displayName: string;
+    depth: number;
+    children: string[];
+}
+interface SightmapSnapshot {
+    capturedAt: string;
+    route: string;
+    commits: number;
+    components: SnapshotComponent[];
+    markers: SightmapMarker[];
+    unmarkedCandidates: UnmarkedCandidate[];
+}
+
+export type { CandidateSelector as C, SightmapSnapshot as S, UnmarkedCandidate as U, ComponentNode as a, SelectorSource as b, SelectorStability as c, SightmapMarker as d, SelectorProposal as e, SightmapHook as f };

package/dist/runtime-types.d.ts

@@ -1,51 +1,2 @@
-import { Sightmap, ResolvedView, MatchResult } from '@sightmap/sightmap';
-
-type ComponentNode = {
-    id: string;
-    parentId: string | null;
-    depth: number;
-    type: string;
-    key: string | null;
-    dom: {
-        tagName: string;
-        dataSightmap: string | null;
-        testId: string | null;
-        classes: string[];
-    } | null;
-    source: {
-        file: string;
-        line: number;
-        col: number;
-    } | null;
-    childIds: string[];
-};
-type SelectorProposal = {
-    selector: string;
-    strategy: "data-sightmap" | "data-testid" | "id" | "role-text" | "path";
-    matches: number;
-};
-type SightmapHook = {
-    version(): {
-        sdk: string;
-        spec: string;
-    };
-    getSightmap(): Sightmap;
-    getCurrentView(): ResolvedView | null;
-    match(req: {
-        url: string;
-        method?: string;
-    }): MatchResult;
-    walkTree(opts?: {
-        rootId?: string;
-        maxDepth?: number;
-    }): ComponentNode[];
-    inspectAt(x: number, y: number): ComponentNode | null;
-    findByDataSightmap(name: string): ComponentNode[];
-};
-declare global {
-    interface Window {
-        __SIGHTMAP__?: SightmapHook;
-    }
-}
-
-export type { ComponentNode, SelectorProposal, SightmapHook };
+export { a as ComponentNode, e as SelectorProposal, f as SightmapHook } from './runtime-types-Cvx7dsB4.js';
+import '@sightmap/sightmap';