uidex 0.5.2 → 0.7.0

package/dist/react/index.js

@@ -74,6 +74,7 @@ function freezeEntity(entity, flows) {
 function createRegistry() {
   const store = emptyStore();
   let flowsCache = null;
+  const patternCache = /* @__PURE__ */ new Map();
   const getFlows = () => {
     if (flowsCache === null) flowsCache = Array.from(store.flow.values());
     return flowsCache;
@@ -83,6 +84,7 @@ function createRegistry() {
     const key = entityKey(entity);
     store[entity.kind].set(key, entity);
     flowsCache = null;
+    patternCache.delete(entity.kind);
   };
   const get = (kind, id) => {
     assertEntityKind(kind);
@@ -90,6 +92,51 @@ function createRegistry() {
     if (raw === void 0) return void 0;
     return freezeEntity(raw, getFlows());
   };
+  const getPatternsForKind = (kind) => {
+    const cached = patternCache.get(kind);
+    if (cached !== void 0) return cached;
+    const patterns = [];
+    for (const [key, entity] of store[kind]) {
+      if (key.includes("*")) {
+        const segments = key.split("*");
+        patterns.push({
+          segments,
+          staticLength: segments.reduce((n, s) => n + s.length, 0),
+          entity
+        });
+      }
+    }
+    patternCache.set(
+      kind,
+      patterns
+    );
+    return patterns;
+  };
+  const matchesSegments = (segments, id) => {
+    const first = segments[0];
+    const last = segments[segments.length - 1];
+    if (!id.startsWith(first)) return false;
+    let pos = first.length;
+    for (let i = 1; i < segments.length - 1; i++) {
+      const idx = id.indexOf(segments[i], pos);
+      if (idx === -1) return false;
+      pos = idx + segments[i].length;
+    }
+    return id.endsWith(last) && id.length - last.length >= pos;
+  };
+  const matchPattern = (kind, id) => {
+    assertEntityKind(kind);
+    const patterns = getPatternsForKind(kind);
+    if (patterns.length === 0) return void 0;
+    let best;
+    for (const entry of patterns) {
+      if (matchesSegments(entry.segments, id) && (best === void 0 || entry.staticLength > best.staticLength)) {
+        best = entry;
+      }
+    }
+    if (best === void 0) return void 0;
+    return freezeEntity(best.entity, getFlows());
+  };
   const list = (kind) => {
     assertEntityKind(kind);
     const flows = getFlows();
@@ -140,6 +187,7 @@ function createRegistry() {
   return {
     add,
     get,
+    matchPattern,
     list,
     query,
     byScope,
@@ -393,7 +441,7 @@ function createNetworkCapture(options = {}) {
 
 // src/browser/ingest/index.ts
 function createIngest(options = {}) {
-  const { session, ...opts } = options;
+  const opts = options;
   const wantConsole = opts.captureConsole !== false;
   const wantNetwork = opts.captureNetwork !== false;
   const consoleCapture = wantConsole ? createConsoleCapture({
@@ -412,14 +460,12 @@ function createIngest(options = {}) {
     consoleCapture?.start();
     networkCapture?.start();
     active = Boolean(consoleCapture?.isActive || networkCapture?.isActive);
-    if (active) session?.setIngest(true);
   }
   function stop() {
     if (!active) return;
     consoleCapture?.stop();
     networkCapture?.stop();
     active = false;
-    session?.setIngest(false);
   }
   return {
     start,
@@ -541,8 +587,7 @@ var COMMAND_PALETTE_ENTRY = {
 function createModeStore(options) {
   const { nav, bindings } = options;
   const store = createStore(() => ({
-    mode: "idle",
-    inspectorActive: false
+    mode: "idle"
   }));
   const transition = {
     openPalette() {
@@ -551,17 +596,17 @@ function createModeStore(options) {
         bindings?.destroyInspector?.();
       }
       nav.nav.reset([COMMAND_PALETTE_ENTRY]);
-      store.setState({ mode: "palette", inspectorActive: false });
+      store.setState({ mode: "palette" });
     },
     openInspector() {
       bindings?.mountInspector?.();
       nav.nav.clear();
-      store.setState({ mode: "inspecting", inspectorActive: true });
+      store.setState({ mode: "inspecting" });
     },
     closeInspector() {
       bindings?.destroyInspector?.();
       nav.nav.clear();
-      store.setState({ mode: "idle", inspectorActive: false });
+      store.setState({ mode: "idle" });
     },
     toggleInspector() {
       if (store.getState().mode === "inspecting") {
@@ -576,7 +621,7 @@ function createModeStore(options) {
         bindings?.destroyInspector?.();
       }
       nav.nav.reset(initialStack);
-      store.setState({ mode: "viewing", inspectorActive: false });
+      store.setState({ mode: "viewing" });
     },
     dismiss() {
       const prev = store.getState();
@@ -584,7 +629,7 @@ function createModeStore(options) {
         bindings?.destroyInspector?.();
       }
       nav.nav.clear();
-      store.setState({ mode: "idle", inspectorActive: false });
+      store.setState({ mode: "idle" });
     },
     popOrTransition() {
       const { stack } = nav.getState();
@@ -592,12 +637,12 @@ function createModeStore(options) {
         nav.nav.pop();
       } else if (stack.length === 2 && stack[0]?.id === "command-palette") {
         nav.nav.reset([COMMAND_PALETTE_ENTRY]);
-        store.setState({ mode: "palette", inspectorActive: false });
+        store.setState({ mode: "palette" });
       } else if (stack.length === 2) {
         nav.nav.pop();
       } else {
         nav.nav.clear();
-        store.setState({ mode: "idle", inspectorActive: false });
+        store.setState({ mode: "idle" });
       }
     },
     pushView(entry) {
@@ -614,7 +659,7 @@ function createModeStore(options) {
         case "inspecting":
           bindings?.destroyInspector?.();
           nav.nav.reset([entry]);
-          store.setState({ mode: "viewing", inspectorActive: false });
+          store.setState({ mode: "viewing" });
           break;
         case "palette":
         case "viewing":
@@ -649,14 +694,6 @@ function createNavigationStore() {
         store.setState({ stack: s.slice(0, -1) });
       }
     },
-    replace(entry) {
-      const s = store.getState().stack;
-      if (s.length === 0) {
-        store.setState({ stack: [entry] });
-      } else {
-        store.setState({ stack: [...s.slice(0, -1), entry] });
-      }
-    },
     clear() {
       store.setState({ stack: [] });
     },
@@ -671,14 +708,11 @@ function createNavigationStore() {
 
 // src/browser/session/store.ts
 var defaultSnapshot = {
-  hover: null,
-  selection: null,
   stack: [],
   pinnedHighlight: null,
-  inspectorActive: false,
+  mode: "idle",
   theme: "auto",
   resolvedTheme: "light",
-  ingestActive: false,
   user: null
 };
 function resolveTheme(preference, detect) {
@@ -729,7 +763,6 @@ function createSession(options = {}) {
       } else if (highlightMode === "transient") {
         onUpdateOverlay?.(hlCtx);
       }
-      store.setState({ hover: ref2 });
     },
     unhover() {
       if (highlightMode === "transient") {
@@ -739,7 +772,6 @@ function createSession(options = {}) {
         hlCtx.color = null;
         onHideOverlay?.();
       }
-      store.setState({ hover: null });
     },
     pin(ref2) {
       const pinRef = ref2 ?? hlCtx.ref;
@@ -767,14 +799,11 @@ function createSession(options = {}) {
   };
   const store = createStore3(() => ({
     ...defaultSnapshot,
-    hover: overrides.hover ?? null,
-    selection: overrides.selection ?? null,
     stack: [],
     pinnedHighlight: null,
-    inspectorActive: false,
+    mode: "idle",
     theme: initialPref,
     resolvedTheme: initialResolved,
-    ingestActive: overrides.ingestActive ?? false,
     user: overrides.user ?? null
   }));
   nav.subscribe(() => {
@@ -784,29 +813,21 @@ function createSession(options = {}) {
     }
   });
   modeStore.subscribe(() => {
-    const { inspectorActive } = modeStore.getState();
-    if (store.getState().inspectorActive !== inspectorActive) {
-      store.setState({ inspectorActive });
+    const { mode } = modeStore.getState();
+    if (store.getState().mode !== mode) {
+      store.setState({ mode });
     }
   });
   const session = store;
   session.nav = nav;
   session.mode = modeStore;
   session.highlight = highlightActions;
-  session.select = (ref2) => {
-    if (sameRef(store.getState().selection, ref2)) return;
-    store.setState({ selection: ref2 });
-  };
   session.setTheme = (theme, resolved) => {
     const state = store.getState();
     const nextResolved = resolved ?? resolveTheme(theme, detectTheme);
     if (state.theme === theme && state.resolvedTheme === nextResolved) return;
     store.setState({ theme, resolvedTheme: nextResolved });
   };
-  session.setIngest = (active) => {
-    if (store.getState().ingestActive === active) return;
-    store.setState({ ingestActive: active });
-  };
   if (initialStack.length > 0) {
     modeStore.transition.openPalette();
     for (let i = 1; i < initialStack.length; i++) {
@@ -1098,6 +1119,9 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .relative {
     position: relative;
   }
+  .static {
+    position: static;
+  }
   .inset-0 {
     inset: calc(var(--spacing) * 0);
   }
@@ -1116,9 +1140,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .right-0 {
     right: calc(var(--spacing) * 0);
   }
-  .right-2 {
-    right: calc(var(--spacing) * 2);
-  }
   .bottom-full {
     bottom: 100%;
   }
@@ -1161,9 +1182,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .mx-2 {
     margin-inline: calc(var(--spacing) * 2);
   }
-  .my-1 {
-    margin-block: calc(var(--spacing) * 1);
-  }
   .ms-auto {
     margin-inline-start: auto;
   }
@@ -1200,9 +1218,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .inline-flex {
     display: inline-flex;
   }
-  .list-item {
-    display: list-item;
-  }
   .table {
     display: table;
   }
@@ -1210,10 +1225,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
     width: calc(var(--spacing) * 2);
     height: calc(var(--spacing) * 2);
   }
-  .size-3 {
-    width: calc(var(--spacing) * 3);
-    height: calc(var(--spacing) * 3);
-  }
   .size-3\\.5 {
     width: calc(var(--spacing) * 3.5);
     height: calc(var(--spacing) * 3.5);
@@ -1271,15 +1282,9 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .h-\\[26rem\\] {
     height: 26rem;
   }
-  .h-auto {
-    height: auto;
-  }
   .h-full {
     height: 100%;
   }
-  .h-px {
-    height: 1px;
-  }
   .max-h-32 {
     max-height: calc(var(--spacing) * 32);
   }
@@ -1289,9 +1294,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .min-h-0 {
     min-height: calc(var(--spacing) * 0);
   }
-  .min-h-7 {
-    min-height: calc(var(--spacing) * 7);
-  }
   .min-h-8 {
     min-height: calc(var(--spacing) * 8);
   }
@@ -1316,9 +1318,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .w-56 {
     width: calc(var(--spacing) * 56);
   }
-  .w-auto {
-    width: auto;
-  }
   .w-full {
     width: 100%;
   }
@@ -1393,9 +1392,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .animate-spin {
     animation: var(--animate-spin);
   }
-  .cursor-default {
-    cursor: default;
-  }
   .cursor-pointer {
     cursor: pointer;
   }
@@ -1405,9 +1401,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .scroll-py-2 {
     scroll-padding-block: calc(var(--spacing) * 2);
   }
-  .list-none {
-    list-style-type: none;
-  }
   .appearance-none {
     appearance: none;
   }
@@ -1429,9 +1422,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .justify-center {
     justify-content: center;
   }
-  .justify-start {
-    justify-content: flex-start;
-  }
   .gap-0 {
     gap: calc(var(--spacing) * 0);
   }
@@ -1456,9 +1446,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .gap-6 {
     gap: calc(var(--spacing) * 6);
   }
-  .self-start {
-    align-self: flex-start;
-  }
   .truncate {
     overflow: hidden;
     text-overflow: ellipsis;
@@ -1673,9 +1660,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .p-6 {
     padding: calc(var(--spacing) * 6);
   }
-  .px-0 {
-    padding-inline: calc(var(--spacing) * 0);
-  }
   .px-1 {
     padding-inline: calc(var(--spacing) * 1);
   }
@@ -1700,9 +1684,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .px-6 {
     padding-inline: calc(var(--spacing) * 6);
   }
-  .py-0 {
-    padding-block: calc(var(--spacing) * 0);
-  }
   .py-1 {
     padding-block: calc(var(--spacing) * 1);
   }
@@ -1775,9 +1756,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
   .text-\\[9px\\] {
     font-size: 9px;
   }
-  .text-\\[10px\\] {
-    font-size: 10px;
-  }
   .text-\\[11px\\] {
     font-size: 11px;
   }
@@ -2017,10 +1995,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
     outline-style: var(--tw-outline-style);
     outline-width: 1px;
   }
-  .blur {
-    --tw-blur: blur(8px);
-    filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
-  }
   .filter {
     filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
   }
@@ -2186,25 +2160,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
       box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
     }
   }
-  .focus-within\\:border-ring {
-    &:focus-within {
-      border-color: var(--ring);
-    }
-  }
-  .focus-within\\:ring-\\[3px\\] {
-    &:focus-within {
-      --tw-ring-shadow: var(--tw-ring-inset,) 0 0 0 calc(3px + var(--tw-ring-offset-width)) var(--tw-ring-color, currentcolor);
-      box-shadow: var(--tw-inset-shadow), var(--tw-inset-ring-shadow), var(--tw-ring-offset-shadow), var(--tw-ring-shadow), var(--tw-shadow);
-    }
-  }
-  .focus-within\\:ring-ring\\/30 {
-    &:focus-within {
-      --tw-ring-color: var(--ring);
-      @supports (color: color-mix(in lab, red, red)) {
-        --tw-ring-color: color-mix(in oklab, var(--ring) 30%, transparent);
-      }
-    }
-  }
   .hover\\:border-destructive\\/30 {
     &:hover {
       @media (hover: hover) {
@@ -2348,11 +2303,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
       pointer-events: none;
     }
   }
-  .disabled\\:cursor-not-allowed {
-    &:disabled {
-      cursor: not-allowed;
-    }
-  }
   .disabled\\:opacity-50 {
     &:disabled {
       opacity: 50%;
@@ -2363,11 +2313,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
       opacity: 60%;
     }
   }
-  .has-disabled\\:opacity-60 {
-    &:has(*:disabled) {
-      opacity: 60%;
-    }
-  }
   .aria-invalid\\:border-destructive\\/40 {
     &[aria-invalid="true"] {
       border-color: var(--destructive);
@@ -2774,32 +2719,6 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
       height: calc(var(--spacing) * 4.5);
     }
   }
-  .\\[\\&\\>svg\\]\\:pointer-events-none {
-    &>svg {
-      pointer-events: none;
-    }
-  }
-  .\\[\\&\\>svg\\]\\:-mx-0\\.5 {
-    &>svg {
-      margin-inline: calc(var(--spacing) * -0.5);
-    }
-  }
-  .\\[\\&\\>svg\\]\\:shrink-0 {
-    &>svg {
-      flex-shrink: 0;
-    }
-  }
-  .\\[\\&\\>svg\\:not\\(\\[class\\*\\=\\'opacity-\\'\\]\\)\\]\\:opacity-80 {
-    &>svg:not([class*='opacity-']) {
-      opacity: 80%;
-    }
-  }
-  .\\[\\&\\>svg\\:not\\(\\[class\\*\\=\\'size-\\'\\]\\)\\]\\:size-4 {
-    &>svg:not([class*='size-']) {
-      width: calc(var(--spacing) * 4);
-      height: calc(var(--spacing) * 4);
-    }
-  }
   .\\[\\[data-kbd-nav\\]_\\&\\]\\:focus-within\\:bg-accent {
     [data-kbd-nav] & {
       &:focus-within {
@@ -3361,18 +3280,23 @@ var tailwind_built_default = `/*! tailwindcss v4.2.2 | MIT License | https://tai
 
 // src/browser/surface/constants.ts
 var SURFACE_HOST_CLASS = "uidex-surface-host";
-var SURFACE_CONTAINER_CLASS = "uidex-container";
 var Z_BASE = 2147483630;
 var Z_OVERLAY = 2147483635;
 var Z_PIN_LAYER = 2147483640;
 var Z_CHROME = 2147483645;
-var SURFACE_IGNORE_SELECTOR = `.${SURFACE_HOST_CLASS},.${SURFACE_CONTAINER_CLASS}`;
+var SURFACE_IGNORE_SELECTOR = `.${SURFACE_HOST_CLASS}`;
 var UIDEX_ATTR_TO_KIND = [
   ["data-uidex", "element"],
   ["data-uidex-region", "region"],
   ["data-uidex-widget", "widget"],
   ["data-uidex-primitive", "primitive"]
 ];
+var DOM_BACKED_KINDS = /* @__PURE__ */ new Set([
+  "element",
+  "region",
+  "widget",
+  "primitive"
+]);
 
 // src/browser/surface/host.ts
 function createSurfaceHost(options) {
@@ -3550,7 +3474,7 @@ function createCursorTooltip(deps) {
 // src/browser/surface/inspector.ts
 function entityForRef(ref2, registry) {
   if (registry) {
-    const found = registry.get(ref2.kind, ref2.id);
+    const found = registry.get(ref2.kind, ref2.id) ?? registry.matchPattern?.(ref2.kind, ref2.id);
     if (found) return found;
   }
   if (ref2.kind === "route") return { kind: "route", path: ref2.id, page: ref2.id };
@@ -3662,7 +3586,6 @@ function createInspector(options) {
     e.preventDefault();
     e.stopPropagation();
     const match = stack[layerIndex];
-    session.select(match.ref);
     onSelect?.(match, { x: e.clientX, y: e.clientY });
   };
   const onContextMenu = (e) => {
@@ -3711,8 +3634,6 @@ function createInspector(options) {
 
 // src/browser/surface/menu-bar.ts
 import {
-  ChevronLeft,
-  ChevronRight,
   Command,
   Highlighter,
   MapPin,
@@ -3990,49 +3911,12 @@ function createMenuBar(options) {
     },
     pinIcon
   );
-  const commitCycler = el("div", {
-    class: "relative z-1 inline-flex items-center gap-0.5",
-    attrs: { "data-uidex-menubar-commit-cycler": "" }
-  });
-  commitCycler.hidden = true;
-  const prevIcon = createLucideElement2(ChevronLeft);
-  prevIcon.setAttribute("class", "size-3");
-  prevIcon.setAttribute("aria-hidden", "true");
-  const prevBtn = el(
-    "button",
-    {
-      class: BUTTON_CLASS,
-      attrs: { type: "button", "aria-label": "Previous commit" },
-      style: { width: "18px", height: "18px" }
-    },
-    prevIcon
-  );
-  const commitLabel = el("span", {
-    class: "relative z-1 whitespace-nowrap px-1 text-[10px] font-mono text-muted-foreground",
-    attrs: { "data-uidex-menubar-commit-label": "" }
-  });
-  const nextIcon = createLucideElement2(ChevronRight);
-  nextIcon.setAttribute("class", "size-3");
-  nextIcon.setAttribute("aria-hidden", "true");
-  const nextBtn = el(
-    "button",
-    {
-      class: BUTTON_CLASS,
-      attrs: { type: "button", "aria-label": "Next commit" },
-      style: { width: "18px", height: "18px" }
-    },
-    nextIcon
-  );
-  commitCycler.appendChild(prevBtn);
-  commitCycler.appendChild(commitLabel);
-  commitCycler.appendChild(nextBtn);
   const pinWrapper = el("div", {
     class: "relative z-1 inline-flex items-center gap-0.5",
     attrs: { "data-uidex-menubar-pin-wrapper": "" }
   });
   pinWrapper.hidden = true;
   pinWrapper.appendChild(pinBtn);
-  pinWrapper.appendChild(commitCycler);
   root.appendChild(pinWrapper);
   const updatePinUI = () => {
     if (!activePinLayer) {
@@ -4040,16 +3924,7 @@ function createMenuBar(options) {
       return;
     }
     const pinsVisible = activePinLayer.visible;
-    const state = activePinLayer.filterState;
-    const hasCommits = state.commits.length > 0;
     pinWrapper.hidden = false;
-    commitCycler.hidden = !pinsVisible || !hasCommits;
-    if (state.commitIndex === -1 || !state.commits[state.commitIndex]) {
-      commitLabel.textContent = `all (${state.commits.length})`;
-    } else {
-      const sha = state.commits[state.commitIndex] ?? "";
-      commitLabel.textContent = sha.slice(0, 7);
-    }
     pinBtn.className = cn(BUTTON_CLASS, pinsVisible && BUTTON_ACTIVE_CLASS);
   };
   pinBtn.addEventListener("click", (e) => {
@@ -4058,14 +3933,6 @@ function createMenuBar(options) {
       activePinLayer.setVisible(!activePinLayer.visible);
     }
   });
-  prevBtn.addEventListener("click", (e) => {
-    e.stopPropagation();
-    activePinLayer?.prevCommit();
-  });
-  nextBtn.addEventListener("click", (e) => {
-    e.stopPropagation();
-    activePinLayer?.nextCommit();
-  });
   let unsubscribePinFilter = activePinLayer?.onFilterChange(() => updatePinUI());
   const presenceIcon = createLucideElement2(Users);
   presenceIcon.setAttribute("class", "size-3.5");
@@ -4159,7 +4026,7 @@ function createMenuBar(options) {
   container.appendChild(root);
   const syncButtonStates = () => {
     const state = session.getState();
-    const inspectActive = state.inspectorActive;
+    const inspectActive = state.mode === "inspecting";
     inspectBtn.setAttribute(
       "data-uidex-menubar-inspect-active",
       inspectActive ? "true" : "false"
@@ -4278,6 +4145,49 @@ function createMenuBar(options) {
   };
 }
 
+// src/browser/internal/repositioner.ts
+function createRepositioner(onReflow) {
+  let rafId = null;
+  let attached = false;
+  const schedule = () => {
+    if (rafId !== null) return;
+    rafId = typeof requestAnimationFrame === "function" ? requestAnimationFrame(() => {
+      rafId = null;
+      onReflow();
+    }) : setTimeout(() => {
+      rafId = null;
+      onReflow();
+    }, 0);
+  };
+  const cancel = () => {
+    if (rafId === null) return;
+    if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(rafId);
+    else clearTimeout(rafId);
+    rafId = null;
+  };
+  const onScroll = () => schedule();
+  const onResize = () => schedule();
+  const attach = () => {
+    if (attached) return;
+    attached = true;
+    window.addEventListener("resize", onResize);
+    window.addEventListener("scroll", onScroll, {
+      capture: true,
+      passive: true
+    });
+  };
+  const detach = () => {
+    if (!attached) return;
+    attached = false;
+    window.removeEventListener("resize", onResize);
+    window.removeEventListener("scroll", onScroll, {
+      capture: true
+    });
+    cancel();
+  };
+  return { schedule, cancel, attach, detach };
+}
+
 // src/browser/surface/overlay.ts
 var DEFAULT_COLOR = "#34d399";
 var DEFAULT_BORDER_WIDTH = 2;
@@ -4345,44 +4255,7 @@ function createOverlay(deps) {
     fillOpacity: DEFAULT_FILL_OPACITY,
     backdrop: false
   };
-  let rafId = null;
-  let attached = false;
-  const schedule = () => {
-    if (rafId !== null) return;
-    rafId = typeof requestAnimationFrame === "function" ? requestAnimationFrame(() => {
-      rafId = null;
-      updatePosition();
-    }) : setTimeout(() => {
-      rafId = null;
-      updatePosition();
-    }, 0);
-  };
-  const cancelSchedule = () => {
-    if (rafId === null) return;
-    if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(rafId);
-    else clearTimeout(rafId);
-    rafId = null;
-  };
-  const onScroll = () => schedule();
-  const onResize = () => schedule();
-  const attach = () => {
-    if (attached) return;
-    attached = true;
-    window.addEventListener("resize", onResize);
-    window.addEventListener("scroll", onScroll, {
-      capture: true,
-      passive: true
-    });
-  };
-  const detach = () => {
-    if (!attached) return;
-    attached = false;
-    window.removeEventListener("resize", onResize);
-    window.removeEventListener("scroll", onScroll, {
-      capture: true
-    });
-    cancelSchedule();
-  };
+  const repositioner = createRepositioner(() => updatePosition());
   function updatePosition() {
     if (!target) return;
     const rect = target.getBoundingClientRect();
@@ -4446,16 +4319,16 @@ function createOverlay(deps) {
         box.offsetHeight;
       }
       box.style.opacity = "1";
-      attach();
+      repositioner.attach();
     },
     hide() {
       target = null;
       box.style.opacity = "0";
       backdrop.style.opacity = "0";
-      detach();
+      repositioner.detach();
     },
     destroy() {
-      detach();
+      repositioner.detach();
       box.remove();
       backdrop.remove();
       target = null;
@@ -4572,8 +4445,7 @@ function createSurfaceShell(options) {
   const overlay = createOverlay({ container: host.shadowRoot });
   cleanup.add(overlay);
   const tooltip = createCursorTooltip({
-    container: host.chromeEl,
-    session: options.session
+    container: host.chromeEl
   });
   cleanup.add(tooltip);
   const afterHover = options.inspector?.onAfterHover;
@@ -4765,9 +4637,6 @@ function createPinLayer(options) {
   const seenIds = /* @__PURE__ */ new Set();
   const byComp = /* @__PURE__ */ new Map();
   const indicators = /* @__PURE__ */ new Map();
-  let filter = { branch: null, commit: null };
-  let commits = [];
-  let commitIndex = -1;
   const filterCbs = /* @__PURE__ */ new Set();
   const notifyFilter = () => {
     for (const cb of filterCbs) cb();
@@ -4782,8 +4651,6 @@ function createPinLayer(options) {
     }
   };
   const rerender = () => {
-    commits = [];
-    commitIndex = -1;
     rebuildFiltered();
     for (const id of Array.from(indicators.keys())) {
       if (!byComp.has(id)) removeIndicator(id);
@@ -4792,45 +4659,8 @@ function createPinLayer(options) {
     notifyFilter();
     onPinsChanged?.();
   };
-  let rafId = null;
-  let winAttached = false;
   let obs = null;
-  const schedulePos = () => {
-    if (rafId !== null) return;
-    rafId = typeof requestAnimationFrame === "function" ? requestAnimationFrame(() => {
-      rafId = null;
-      posAll();
-    }) : setTimeout(() => {
-      rafId = null;
-      posAll();
-    }, 0);
-  };
-  const cancelPos = () => {
-    if (rafId === null) return;
-    if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(rafId);
-    else clearTimeout(rafId);
-    rafId = null;
-  };
-  const onScroll = () => schedulePos();
-  const onResize = () => schedulePos();
-  const attachWin = () => {
-    if (winAttached) return;
-    winAttached = true;
-    window.addEventListener("scroll", onScroll, {
-      capture: true,
-      passive: true
-    });
-    window.addEventListener("resize", onResize);
-  };
-  const detachWin = () => {
-    if (!winAttached) return;
-    winAttached = false;
-    window.removeEventListener("scroll", onScroll, {
-      capture: true
-    });
-    window.removeEventListener("resize", onResize);
-    cancelPos();
-  };
+  const repositioner = createRepositioner(() => posAll());
   const attachObs = () => {
     if (obs || typeof MutationObserver === "undefined") return;
     obs = new MutationObserver((recs) => {
@@ -4854,7 +4684,7 @@ function createPinLayer(options) {
       s.anchor = resolveEntityElement(parseComponentRef(s.componentId));
       changed = true;
     }
-    if (changed) schedulePos();
+    if (changed) repositioner.schedule();
   };
   const expand = (st) => {
     if (st.expanded) return;
@@ -5096,7 +4926,7 @@ function createPinLayer(options) {
     if (!st) {
       st = buildIndicator(componentId);
       indicators.set(componentId, st);
-      attachWin();
+      repositioner.attach();
       attachObs();
     }
     if (st.pinIndex >= pins.length) st.pinIndex = 0;
@@ -5110,7 +4940,7 @@ function createPinLayer(options) {
     st.wrap.remove();
     indicators.delete(componentId);
     if (indicators.size === 0) {
-      detachWin();
+      repositioner.detach();
       detachObs();
     }
   };
@@ -5145,17 +4975,22 @@ function createPinLayer(options) {
       seenIds.clear();
       byComp.clear();
       for (const id of Array.from(indicators.keys())) removeIndicator(id);
-      commits = [];
-      commitIndex = -1;
       notifyFilter();
     },
     getPinsForElement: (id) => byComp.get(id) ?? [],
-    getAllPinsForElement: (id) => allPins.filter((p) => (p.entity ?? "") === id),
     getAllPins: () => allPins.slice(),
     attachChannel(channel) {
-      return channel.onPin((pin) => {
+      const offPin = channel.onPin((pin) => {
         layer.addPin(pin);
       });
+      const offArchived = channel.onPinArchived?.((reportId) => {
+        layer.removePin(reportId);
+      }) ?? (() => {
+      });
+      return () => {
+        offPin();
+        offArchived();
+      };
     },
     attachCloud(opts) {
       const offCh = opts.channel ? layer.attachChannel(opts.channel) : () => {
@@ -5186,39 +5021,6 @@ function createPinLayer(options) {
     async refresh() {
       if (activeRefresh) await activeRefresh();
     },
-    get filterState() {
-      return {
-        branch: filter.branch,
-        commit: filter.commit,
-        commits,
-        commitIndex
-      };
-    },
-    setFilter(next) {
-      filter = {
-        branch: next.branch !== void 0 ? next.branch : filter.branch,
-        commit: next.commit !== void 0 ? next.commit : filter.commit
-      };
-      rerender();
-    },
-    nextCommit() {
-      if (!commits.length) return;
-      commitIndex = commitIndex >= commits.length - 1 ? -1 : commitIndex + 1;
-      filter = {
-        ...filter,
-        commit: commitIndex === -1 ? null : commits[commitIndex]
-      };
-      rerender();
-    },
-    prevCommit() {
-      if (!commits.length) return;
-      commitIndex = commitIndex <= -1 ? commits.length - 1 : commitIndex - 1;
-      filter = {
-        ...filter,
-        commit: commitIndex === -1 ? null : commits[commitIndex]
-      };
-      rerender();
-    },
     onFilterChange(cb) {
       filterCbs.add(cb);
       return () => {
@@ -5237,7 +5039,7 @@ function createPinLayer(options) {
     },
     destroy() {
       layer.clear();
-      detachWin();
+      repositioner.detach();
       detachObs();
       layerEl.remove();
       activeRefresh = null;
@@ -5280,9 +5082,11 @@ function createRouter(options) {
     if (view === null || typeof view !== "object" || typeof view.id !== "string" || view.id.length === 0) {
       throw new ViewValidationError("View must have a non-empty string id");
     }
-    if (typeof view.surface !== "function") {
+    const hasSurface = typeof view.surface === "function";
+    const hasRender = typeof view.render === "function";
+    if (!hasSurface && !hasRender) {
       throw new ViewValidationError(
-        `View ${view.id}: 'surface' must be a function`
+        `View ${view.id}: a 'surface' function (or a 'render' override) is required`
       );
     }
     if (!view.matches && !view.palette) {
@@ -5340,7 +5144,6 @@ function createRouter(options) {
     if (idx >= 0) recentRefs.splice(idx, 1);
     recentRefs.unshift(ref2);
     if (recentRefs.length > MAX_RECENTS) recentRefs.length = MAX_RECENTS;
-    options.session.select(ref2);
     const entry = { id: match.view.id, ref: ref2 };
     const { mode } = options.session.mode.getState();
     if (mode === "idle" || mode === "inspecting") {
@@ -5395,74 +5198,24 @@ function detectDev() {
 
 // src/browser/internal/lit.ts
 import { html, svg, render, nothing } from "lit-html";
-import { repeat } from "lit-html/directives/repeat.js";
 import { ref, createRef } from "lit-html/directives/ref.js";
-import { classMap } from "lit-html/directives/class-map.js";
 
-// src/browser/internal/apply-props.ts
-function applyProps(node, props) {
-  const removers = [];
-  for (const [key, rawValue] of Object.entries(props)) {
-    if (key === "children" || key === "dangerouslySetInnerHTML") continue;
-    if (key.startsWith("on") && typeof rawValue === "function") {
-      const eventName = key.slice(2).toLowerCase();
-      const isTextControl = node instanceof HTMLInputElement && node.type !== "checkbox" && node.type !== "radio" || node instanceof HTMLTextAreaElement;
-      const effectiveEvent = eventName === "change" && isTextControl ? "input" : eventName;
-      const listener = rawValue;
-      node.addEventListener(effectiveEvent, listener);
-      removers.push(() => node.removeEventListener(effectiveEvent, listener));
-      continue;
-    }
-    if (rawValue === void 0 || rawValue === null) {
-      node.removeAttribute(key);
-      continue;
-    }
-    if (typeof rawValue === "boolean") {
-      if (rawValue) node.setAttribute(key, "");
-      else node.removeAttribute(key);
-      continue;
-    }
-    if (key === "style" && typeof rawValue === "object") {
-      Object.assign(
-        node.style,
-        rawValue
-      );
-      continue;
-    }
-    if (key === "className" || key === "class") {
-      node.setAttribute("class", String(rawValue));
-      continue;
-    }
-    if (key === "htmlFor") {
-      node.setAttribute("for", String(rawValue));
-      continue;
-    }
-    if (key === "tabIndex") {
-      ;
-      node.tabIndex = Number(rawValue);
-      continue;
-    }
-    node.setAttribute(key, String(rawValue));
-  }
-  return () => removers.forEach((fn) => fn());
-}
-
-// src/browser/internal/lit-icon.ts
-import { noChange } from "lit-html";
-import {
-  Directive,
-  directive,
-  PartType
-} from "lit-html/directive.js";
-import { createElement } from "lucide";
-var LucideIconDirective = class extends Directive {
-  _icon;
-  _class;
-  _el;
-  constructor(partInfo) {
-    super(partInfo);
-    if (partInfo.type !== PartType.CHILD) {
-      throw new Error("icon() can only be used in a child position");
+// src/browser/internal/lit-icon.ts
+import { noChange } from "lit-html";
+import {
+  Directive,
+  directive,
+  PartType
+} from "lit-html/directive.js";
+import { createElement } from "lucide";
+var LucideIconDirective = class extends Directive {
+  _icon;
+  _class;
+  _el;
+  constructor(partInfo) {
+    super(partInfo);
+    if (partInfo.type !== PartType.CHILD) {
+      throw new Error("icon() can only be used in a child position");
     }
   }
   update(_part, [iconNode, className]) {
@@ -5483,6 +5236,16 @@ var LucideIconDirective = class extends Directive {
 };
 var icon = directive(LucideIconDirective);
 
+// src/browser/views/primitives/chip.ts
+var CHIP_CLASS = "inline-flex items-center gap-1.5 text-xs font-medium text-muted-foreground";
+function createChip(options = {}, children = []) {
+  const { class: extra, ...rest } = options;
+  return el("span", { ...rest, class: cn(CHIP_CLASS, extra) }, children);
+}
+
+// src/browser/views/primitives/kind-icon.ts
+import { createElement as createLucideElement4 } from "lucide";
+
 // src/browser/ui/cva.ts
 function cva(base, config = {}) {
   return (props = {}) => {
@@ -5521,17 +5284,15 @@ var badgeVariants = cva(badgeBase, {
     }
   }
 });
-
-// src/browser/views/primitives/chip.ts
-var CHIP_CLASS = "inline-flex items-center gap-1.5 text-xs font-medium text-muted-foreground";
-function createChip(options = {}, children = []) {
-  const { class: extra, ...rest } = options;
-  return el("span", { ...rest, class: cn(CHIP_CLASS, extra) }, children);
+function badgeTpl(content, options = {}) {
+  const { variant, size, class: extra } = options;
+  return html`
+    <span class=${cn(badgeVariants({ variant, size }), extra)} data-slot="badge"
+      >${content}</span
+    >
+  `;
 }
 
-// src/browser/views/primitives/kind-icon.ts
-import { createElement as createLucideElement4 } from "lucide";
-
 // src/browser/views/primitives/icon-tile.ts
 var TILE_CLASS = "inline-flex size-6 shrink-0 items-center justify-center rounded-md bg-muted text-muted-foreground";
 var ICON_SIZE_CLASS_RE = /\b(h-\d+|w-\d+|size-\d+)\b/g;
@@ -6039,6 +5800,54 @@ function createScrollArea(props = {}) {
   );
 }
 
+// src/browser/internal/apply-props.ts
+function applyProps(node, props) {
+  const removers = [];
+  for (const [key, rawValue] of Object.entries(props)) {
+    if (key === "children" || key === "dangerouslySetInnerHTML") continue;
+    if (key.startsWith("on") && typeof rawValue === "function") {
+      const eventName = key.slice(2).toLowerCase();
+      const isTextControl = node instanceof HTMLInputElement && node.type !== "checkbox" && node.type !== "radio" || node instanceof HTMLTextAreaElement;
+      const effectiveEvent = eventName === "change" && isTextControl ? "input" : eventName;
+      const listener = rawValue;
+      node.addEventListener(effectiveEvent, listener);
+      removers.push(() => node.removeEventListener(effectiveEvent, listener));
+      continue;
+    }
+    if (rawValue === void 0 || rawValue === null) {
+      node.removeAttribute(key);
+      continue;
+    }
+    if (typeof rawValue === "boolean") {
+      if (rawValue) node.setAttribute(key, "");
+      else node.removeAttribute(key);
+      continue;
+    }
+    if (key === "style" && typeof rawValue === "object") {
+      Object.assign(
+        node.style,
+        rawValue
+      );
+      continue;
+    }
+    if (key === "className" || key === "class") {
+      node.setAttribute("class", String(rawValue));
+      continue;
+    }
+    if (key === "htmlFor") {
+      node.setAttribute("for", String(rawValue));
+      continue;
+    }
+    if (key === "tabIndex") {
+      ;
+      node.tabIndex = Number(rawValue);
+      continue;
+    }
+    node.setAttribute(key, String(rawValue));
+  }
+  return () => removers.forEach((fn) => fn());
+}
+
 // src/browser/views/builder/spread-props.ts
 function spreadProps(node, props) {
   return applyProps(node, props);
@@ -6058,21 +5867,6 @@ function createPersistentSpreads() {
   };
 }
 
-// src/browser/views/render/detail.ts
-import {
-  ArchiveX,
-  Camera,
-  ChevronDown,
-  Copy,
-  Highlighter as Highlighter2,
-  Inbox,
-  MessageCircleWarning,
-  StickyNote as StickyNote2,
-  TicketPlus,
-  View,
-  createElement as createLucideElement5
-} from "lucide";
-
 // src/browser/internal/arrow-nav.ts
 var NAV_KEYS = /* @__PURE__ */ new Set(["ArrowDown", "ArrowUp", "Home", "End"]);
 function bindArrowNav(options) {
@@ -6144,30 +5938,6 @@ function focusItem(items, idx) {
   items[idx].focus();
 }
 
-// src/browser/views/builder/filter.ts
-function normalizeQuery(query) {
-  return query.trim().toLowerCase();
-}
-function matchesQuery(haystack, query) {
-  const q = normalizeQuery(query);
-  if (!q) return true;
-  return haystack.toLowerCase().includes(q);
-}
-function filterEntities(entities, query) {
-  const q = normalizeQuery(query);
-  if (!q) return entities;
-  return entities.filter((e) => {
-    const name = displayName(e).toLowerCase();
-    const id = entityKey(e).toLowerCase();
-    return name.includes(q) || id.includes(q) || e.kind.toLowerCase().includes(q);
-  });
-}
-function filterIds(ids, query) {
-  const q = normalizeQuery(query);
-  if (!q) return ids;
-  return ids.filter((id) => id.toLowerCase().includes(q));
-}
-
 // src/browser/views/labels.ts
 var SECTION_LABELS = {
   acceptance: "Acceptance criteria",
@@ -6192,171 +5962,6 @@ var LIST_ITEM_STATE_CLASS = "data-[disabled]:pointer-events-none data-[disabled]
 var LIST_ITEM_INTERACTIVE_CLASS = "uidex-item-interactive [[data-kbd-nav]_&]:focus:bg-accent [[data-kbd-nav]_&]:focus:text-accent-foreground [[data-kbd-nav]_&]:focus-within:bg-accent [[data-kbd-nav]_&]:focus-within:text-accent-foreground";
 var LIST_GROUP_LABEL_CLASS = "text-muted-foreground px-2 py-1.5 text-xs font-medium";
 
-// src/browser/ui/button.ts
-var buttonBase = "focus-visible:ring-ring focus-visible:ring-offset-background disabled:opacity-60 relative inline-flex shrink-0 cursor-pointer items-center justify-center gap-2 whitespace-nowrap rounded-lg border text-sm font-medium outline-none transition-shadow focus-visible:ring-2 focus-visible:ring-offset-1 disabled:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='opacity-'])]:opacity-80 [&_svg]:pointer-events-none [&_svg]:shrink-0";
-var buttonVariants = cva(buttonBase, {
-  defaultVariants: { size: "default", variant: "default" },
-  variants: {
-    size: {
-      default: "h-8 px-3",
-      sm: "h-7 gap-1.5 px-2.5",
-      xs: "h-6 gap-1 rounded-md px-2 text-xs",
-      lg: "h-9 px-3.5",
-      xl: "h-10 px-4 text-base",
-      icon: "size-8",
-      "icon-sm": "size-7",
-      "icon-lg": "size-9",
-      "icon-xs": "size-6 rounded-md"
-    },
-    variant: {
-      default: "border-primary bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
-      destructive: "border-destructive bg-destructive shadow-xs hover:bg-destructive/90 text-white",
-      "destructive-outline": "border-input bg-popover text-destructive-foreground shadow-xs/5 hover:border-destructive/30 hover:bg-destructive/5 dark:bg-input/30",
-      ghost: "text-foreground hover:bg-accent hover:text-accent-foreground border-transparent",
-      link: "text-foreground border-transparent underline-offset-4 hover:underline",
-      outline: "border-input bg-popover text-foreground shadow-xs/5 hover:bg-accent hover:text-accent-foreground dark:bg-input/30",
-      secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/90 border-transparent"
-    }
-  }
-});
-
-// src/browser/views/primitives/entity-presence.ts
-var DOM_BACKED_KINDS = /* @__PURE__ */ new Set([
-  "element",
-  "region",
-  "widget",
-  "primitive"
-]);
-var TOUCH_RESOLVE_KINDS = [
-  "element",
-  "widget",
-  "region",
-  "primitive"
-];
-function isAbsentFromPage(ref2, registry) {
-  if (DOM_BACKED_KINDS.has(ref2.kind)) {
-    return !resolveEntityElement(ref2);
-  }
-  if (ref2.kind === "flow" && registry) {
-    const flow = registry.get("flow", ref2.id);
-    if (!flow) return true;
-    for (const touchId of flow.touches) {
-      for (const kind of TOUCH_RESOLVE_KINDS) {
-        const entity = registry.get(kind, touchId);
-        if (entity && resolveEntityElement({ kind, id: touchId })) return false;
-      }
-    }
-    return true;
-  }
-  return false;
-}
-
-// src/browser/ui/kbd.ts
-var KBD_CLASS = "bg-muted text-muted-foreground pointer-events-none inline-flex h-5 min-w-5 select-none items-center justify-center gap-1 rounded px-1 font-sans text-xs font-medium [&_svg:not([class*='size-'])]:size-3";
-var COMMAND_SHORTCUT_CLASS = "text-muted-foreground/70 ms-auto font-sans text-xs font-medium tracking-widest";
-function createCommandShortcut(options = {}, children = []) {
-  const { class: extra, attrs, ...rest } = options;
-  return el(
-    "kbd",
-    {
-      ...rest,
-      class: cn(COMMAND_SHORTCUT_CLASS, extra),
-      attrs: { "data-slot": "command-shortcut", ...attrs }
-    },
-    children
-  );
-}
-function kbdTpl(text, className) {
-  return html`<kbd class=${cn(KBD_CLASS, className)} data-slot="kbd"
-    >${text}</kbd
-  >`;
-}
-function commandShortcutTpl(text, className) {
-  return html`<kbd
-    class=${cn(COMMAND_SHORTCUT_CLASS, className)}
-    data-slot="command-shortcut"
-    >${text}</kbd
-  >`;
-}
-
-// src/browser/views/primitives/row.ts
-var LABEL_CLASS = "min-w-0 flex-1 truncate";
-var SUBTITLE_CLASS = "truncate text-xs text-muted-foreground";
-function fillRowWithHandle(host, content) {
-  if (content.leading) host.append(content.leading);
-  const label = el("span", { class: LABEL_CLASS, text: content.label });
-  host.append(label);
-  if (content.subtitle) {
-    host.append(
-      el("span", {
-        class: SUBTITLE_CLASS,
-        attrs: { "data-uidex-row-subtitle": "" },
-        text: content.subtitle
-      })
-    );
-  }
-  if (content.trailing != null) {
-    host.append(
-      typeof content.trailing === "string" ? createCommandShortcut({ text: content.trailing }) : content.trailing
-    );
-  }
-  return { label };
-}
-function rowTpl(content) {
-  return html`
-    ${content.leading ?? nothing}
-    <span class=${LABEL_CLASS}>${content.label}</span>
-    ${content.subtitle ? html`<span class=${SUBTITLE_CLASS} data-uidex-row-subtitle
-          >${content.subtitle}</span
-        >` : nothing}
-    ${content.trailing != null ? typeof content.trailing === "string" ? commandShortcutTpl(content.trailing) : content.trailing : nothing}
-  `;
-}
-
-// src/browser/views/primitives/entity-link.ts
-var ACTION_CLASS = cn(
-  LIST_ITEM_CLASS,
-  LIST_ITEM_INTERACTIVE_CLASS,
-  "w-full cursor-pointer text-left font-normal"
-);
-function entityLinkTpl(options) {
-  const { ctx, target, label, leading, class: extraClass } = options;
-  const absent = isAbsentFromPage(target);
-  const resolvedLabel = label ?? `${target.kind}: ${target.id}`;
-  const onClick = () => ctx.views.navigate(target);
-  const preview = () => {
-    ctx.highlight.show(target, { color: KIND_STYLE[target.kind].color });
-  };
-  const restoreParent = () => {
-    if (ctx.ref) {
-      ctx.highlight.show(ctx.ref, { color: KIND_STYLE[ctx.ref.kind].color });
-    } else {
-      ctx.highlight.hide();
-    }
-  };
-  return html`
-    <button
-      type="button"
-      class=${cn(ACTION_CLASS, "w-full", absent && "opacity-50", extraClass)}
-      data-slot="list-item-button"
-      data-uidex-entity-link
-      data-uidex-ref-kind=${target.kind}
-      data-uidex-ref-id=${target.id}
-      title=${absent ? "Not on this page" : ""}
-      @click=${onClick}
-      @mouseenter=${preview}
-      @mouseleave=${restoreParent}
-      @focus=${preview}
-      @blur=${restoreParent}
-    >
-      ${rowTpl({
-    leading,
-    label: resolvedLabel
-  })}
-    </button>
-  `;
-}
-
 // src/browser/views/primitives/text.ts
 var MUTED_CLASS = "text-sm text-muted-foreground";
 var HEADING_CLASS = LIST_GROUP_LABEL_CLASS;
@@ -6368,7 +5973,20 @@ function headingTpl(text, className) {
   return html`<h3 class=${cn(HEADING_CLASS, className)}>${text}</h3>`;
 }
 
-// src/browser/views/render/detail.ts
+// src/browser/views/render/detail-actions.ts
+import {
+  ArchiveX,
+  Camera,
+  ChevronDown,
+  Copy,
+  Highlighter as Highlighter2,
+  Inbox,
+  MessageCircleWarning,
+  StickyNote as StickyNote2,
+  TicketPlus,
+  View,
+  createElement as createLucideElement5
+} from "lucide";
 var ICON_MAP = {
   "archive-x": ArchiveX,
   copy: Copy,
@@ -6384,23 +6002,6 @@ var ICON_MAP = {
 function iconFor(icon2) {
   return icon2 ? ICON_MAP[icon2] : null;
 }
-function subtitleTpl(subtitle) {
-  const text = subtitle.extra ? `${subtitle.rawId} \xB7 ${subtitle.extra}` : subtitle.rawId;
-  return html`<p
-    class=${cn("text-muted-foreground font-mono text-xs", "px-2")}
-    data-uidex-detail-subtitle
-  >
-    ${text}
-  </p>`;
-}
-function notFoundTpl(ref2) {
-  return html`<p
-    class=${cn("text-muted-foreground text-sm", "p-4")}
-    data-uidex-detail-missing
-  >
-    ${ref2.kind}: ${ref2.id} not found in registry
-  </p>`;
-}
 function renderActions(actions, ctx, root, heading) {
   const cleanups = [];
   const buttons = [];
@@ -6511,6 +6112,169 @@ function renderActions(actions, ctx, root, heading) {
   }
   return { node: section, buttons, cleanup: composeCleanups(cleanups) };
 }
+
+// src/browser/views/render/detail-sections.ts
+import {
+  html as staticHtml,
+  literal
+} from "lit-html/static.js";
+
+// src/browser/views/builder/filter.ts
+function normalizeQuery(query) {
+  return query.trim().toLowerCase();
+}
+function matchesQuery(haystack, query) {
+  const q = normalizeQuery(query);
+  if (!q) return true;
+  return haystack.toLowerCase().includes(q);
+}
+function filterEntities(entities, query) {
+  const q = normalizeQuery(query);
+  if (!q) return entities;
+  return entities.filter((e) => {
+    const name = displayName(e).toLowerCase();
+    const id = entityKey(e).toLowerCase();
+    return name.includes(q) || id.includes(q) || e.kind.toLowerCase().includes(q);
+  });
+}
+function filterIds(ids, query) {
+  const q = normalizeQuery(query);
+  if (!q) return ids;
+  return ids.filter((id) => id.toLowerCase().includes(q));
+}
+
+// src/browser/views/primitives/entity-presence.ts
+var TOUCH_RESOLVE_KINDS = [
+  "element",
+  "widget",
+  "region",
+  "primitive"
+];
+function isAbsentFromPage(ref2, registry) {
+  if (DOM_BACKED_KINDS.has(ref2.kind)) {
+    return !resolveEntityElement(ref2);
+  }
+  if (ref2.kind === "flow" && registry) {
+    const flow = registry.get("flow", ref2.id);
+    if (!flow) return true;
+    for (const touchId of flow.touches) {
+      for (const kind of TOUCH_RESOLVE_KINDS) {
+        const entity = registry.get(kind, touchId);
+        if (entity && resolveEntityElement({ kind, id: touchId })) return false;
+      }
+    }
+    return true;
+  }
+  return false;
+}
+
+// src/browser/ui/kbd.ts
+var KBD_CLASS = "bg-muted text-muted-foreground pointer-events-none inline-flex h-5 min-w-5 select-none items-center justify-center gap-1 rounded px-1 font-sans text-xs font-medium [&_svg:not([class*='size-'])]:size-3";
+var COMMAND_SHORTCUT_CLASS = "text-muted-foreground/70 ms-auto font-sans text-xs font-medium tracking-widest";
+function createCommandShortcut(options = {}, children = []) {
+  const { class: extra, attrs, ...rest } = options;
+  return el(
+    "kbd",
+    {
+      ...rest,
+      class: cn(COMMAND_SHORTCUT_CLASS, extra),
+      attrs: { "data-slot": "command-shortcut", ...attrs }
+    },
+    children
+  );
+}
+function kbdTpl(text, className) {
+  return html`<kbd class=${cn(KBD_CLASS, className)} data-slot="kbd"
+    >${text}</kbd
+  >`;
+}
+function commandShortcutTpl(text, className) {
+  return html`<kbd
+    class=${cn(COMMAND_SHORTCUT_CLASS, className)}
+    data-slot="command-shortcut"
+    >${text}</kbd
+  >`;
+}
+
+// src/browser/views/primitives/row.ts
+var LABEL_CLASS = "min-w-0 flex-1 truncate";
+var SUBTITLE_CLASS = "truncate text-xs text-muted-foreground";
+function fillRowWithHandle(host, content) {
+  if (content.leading) host.append(content.leading);
+  const label = el("span", { class: LABEL_CLASS, text: content.label });
+  host.append(label);
+  if (content.subtitle) {
+    host.append(
+      el("span", {
+        class: SUBTITLE_CLASS,
+        attrs: { "data-uidex-row-subtitle": "" },
+        text: content.subtitle
+      })
+    );
+  }
+  if (content.trailing != null) {
+    host.append(
+      typeof content.trailing === "string" ? createCommandShortcut({ text: content.trailing }) : content.trailing
+    );
+  }
+  return { label };
+}
+function rowTpl(content) {
+  return html`
+    ${content.leading ?? nothing}
+    <span class=${LABEL_CLASS}>${content.label}</span>
+    ${content.subtitle ? html`<span class=${SUBTITLE_CLASS} data-uidex-row-subtitle
+          >${content.subtitle}</span
+        >` : nothing}
+    ${content.trailing != null ? typeof content.trailing === "string" ? commandShortcutTpl(content.trailing) : content.trailing : nothing}
+  `;
+}
+
+// src/browser/views/primitives/entity-link.ts
+var ACTION_CLASS = cn(
+  LIST_ITEM_CLASS,
+  LIST_ITEM_INTERACTIVE_CLASS,
+  "w-full cursor-pointer text-left font-normal"
+);
+function entityLinkTpl(options) {
+  const { ctx, target, label, leading, class: extraClass } = options;
+  const absent = isAbsentFromPage(target);
+  const resolvedLabel = label ?? `${target.kind}: ${target.id}`;
+  const onClick = () => ctx.views.navigate(target);
+  const preview = () => {
+    ctx.highlight.show(target, { color: KIND_STYLE[target.kind].color });
+  };
+  const restoreParent = () => {
+    if (ctx.ref) {
+      ctx.highlight.show(ctx.ref, { color: KIND_STYLE[ctx.ref.kind].color });
+    } else {
+      ctx.highlight.hide();
+    }
+  };
+  return html`
+    <button
+      type="button"
+      class=${cn(ACTION_CLASS, "w-full", absent && "opacity-50", extraClass)}
+      data-slot="list-item-button"
+      data-uidex-entity-link
+      data-uidex-ref-kind=${target.kind}
+      data-uidex-ref-id=${target.id}
+      title=${absent ? "Not on this page" : ""}
+      @click=${onClick}
+      @mouseenter=${preview}
+      @mouseleave=${restoreParent}
+      @focus=${preview}
+      @blur=${restoreParent}
+    >
+      ${rowTpl({
+    leading,
+    label: resolvedLabel
+  })}
+    </button>
+  `;
+}
+
+// src/browser/views/render/detail-sections.ts
 function entityListItems(ctx, entities) {
   return html`${entities.map((entity) => {
     const eRef = { kind: entity.kind, id: entityKey(entity) };
@@ -6524,71 +6288,29 @@ function entityListItems(ctx, entities) {
     </li>`;
   })}`;
 }
-function composesListTpl(ctx, label, entities) {
-  if (entities.length === 0) return null;
-  return html`
-    <section class="flex flex-col" data-uidex-detail-composes>
-      ${headingTpl(label)}
-      <ul class="flex flex-col">
-        ${entityListItems(ctx, entities)}
-      </ul>
-    </section>
-  `;
-}
-function usedByListTpl(ctx, label, entities) {
-  if (entities.length === 0) return null;
-  return html`
-    <section class="flex flex-col" data-uidex-detail-used-by>
-      ${headingTpl(label)}
-      <ul class="flex flex-col">
-        ${entityListItems(ctx, entities)}
-      </ul>
-    </section>
-  `;
-}
-function flowListTpl(ctx, flows) {
-  if (flows.length === 0) return null;
-  return html`
-    <section class="flex flex-col" data-uidex-detail-flows>
-      ${headingTpl(SECTION_LABELS.flows)}
-      <ul class="flex flex-col">
-        ${flows.map(
-    (flow) => html`<li>
-              ${entityLinkTpl({
-      ctx,
-      target: { kind: "flow", id: flow.id },
-      label: displayName(flow),
-      leading: kindIconTileTpl("flow")
-    })}
-            </li>`
-  )}
-      </ul>
-    </section>
-  `;
-}
-function touchesTpl(ctx, entities, query) {
+var DETAIL_SECTION_ATTRS = {
+  composes: literal`data-uidex-detail-composes`,
+  "used-by": literal`data-uidex-detail-used-by`,
+  flows: literal`data-uidex-detail-flows`,
+  touches: literal`data-uidex-detail-touches`
+};
+function entitySectionTpl(ctx, opts) {
+  const { label, entities, dataAttr, emptyText } = opts;
+  const attr = DETAIL_SECTION_ATTRS[dataAttr];
   if (entities.length === 0) {
-    return html`
-      <section class="flex flex-col gap-2" data-uidex-detail-touches>
-        ${headingTpl(SECTION_LABELS.touches)}
-        ${mutedTextTpl(query ? "No matches" : "No entities touched")}
+    if (emptyText === void 0) return null;
+    return staticHtml`
+      <section class="flex flex-col gap-2" ${attr}>
+        ${headingTpl(label)}
+        ${mutedTextTpl(emptyText)}
       </section>
     `;
   }
-  return html`
-    <section class="flex flex-col" data-uidex-detail-touches>
-      ${headingTpl(SECTION_LABELS.touches)}
+  return staticHtml`
+    <section class="flex flex-col" ${attr}>
+      ${headingTpl(label)}
       <ul class="flex flex-col">
-        ${entities.map(
-    (entity) => html`<li>
-              ${entityLinkTpl({
-      ctx,
-      target: { kind: entity.kind, id: entityKey(entity) },
-      label: displayName(entity),
-      leading: kindIconTileTpl(entity.kind)
-    })}
-            </li>`
-  )}
+        ${entityListItems(ctx, entities)}
       </ul>
     </section>
   `;
@@ -6745,6 +6467,20 @@ function screenshotTpl(url) {
     </section>
   `;
 }
+function lazyScreenshotEl(load) {
+  const holder = document.createElement("div");
+  holder.hidden = true;
+  void load().then(
+    (url) => {
+      if (!url) return;
+      render(screenshotTpl(url), holder);
+      holder.hidden = false;
+    },
+    () => {
+    }
+  );
+  return holder;
+}
 function metadataListTpl(entries) {
   return html`
     <div
@@ -6775,28 +6511,30 @@ function sectionTpl(section, ctx, query) {
       return acceptanceChecklistTpl(section.items);
     }
     case "composes":
-      return composesListTpl(
-        ctx,
-        section.label,
-        section.filterable ? filterEntities(section.entities, query) : section.entities
-      );
+      return entitySectionTpl(ctx, {
+        label: section.label,
+        entities: section.filterable ? filterEntities(section.entities, query) : section.entities,
+        dataAttr: "composes"
+      });
     case "used-by":
-      return usedByListTpl(
-        ctx,
-        section.label,
-        section.filterable ? filterEntities(section.entities, query) : section.entities
-      );
+      return entitySectionTpl(ctx, {
+        label: section.label,
+        entities: section.filterable ? filterEntities(section.entities, query) : section.entities,
+        dataAttr: "used-by"
+      });
     case "flows":
-      return flowListTpl(
-        ctx,
-        section.filterable ? filterEntities(section.flows, query) : section.flows
-      );
+      return entitySectionTpl(ctx, {
+        label: SECTION_LABELS.flows,
+        entities: section.filterable ? filterEntities(section.flows, query) : section.flows,
+        dataAttr: "flows"
+      });
     case "touches":
-      return touchesTpl(
-        ctx,
-        section.filterable ? filterEntities(section.entities, query) : section.entities,
-        query
-      );
+      return entitySectionTpl(ctx, {
+        label: SECTION_LABELS.touches,
+        entities: section.filterable ? filterEntities(section.entities, query) : section.entities,
+        dataAttr: "touches",
+        emptyText: query ? "No matches" : "No entities touched"
+      });
     case "steps":
       return stepsTpl(
         ctx,
@@ -6808,11 +6546,32 @@ function sectionTpl(section, ctx, query) {
         section.filterable ? filterIds(section.paths, query) : section.paths
       );
     case "screenshot":
-      return screenshotTpl(section.url);
+      if (section.url) return screenshotTpl(section.url);
+      if (section.load) return html`${lazyScreenshotEl(section.load)}`;
+      return null;
     case "metadata":
       return section.entries.length > 0 ? metadataListTpl(section.entries) : null;
   }
 }
+
+// src/browser/views/render/detail.ts
+function subtitleTpl(subtitle) {
+  const text = subtitle.extra ? `${subtitle.rawId} \xB7 ${subtitle.extra}` : subtitle.rawId;
+  return html`<p
+    class=${cn("text-muted-foreground font-mono text-xs", "px-2")}
+    data-uidex-detail-subtitle
+  >
+    ${text}
+  </p>`;
+}
+function notFoundTpl(ref2) {
+  return html`<p
+    class=${cn("text-muted-foreground text-sm", "p-4")}
+    data-uidex-detail-missing
+  >
+    ${ref2.kind}: ${ref2.id} not found in registry
+  </p>`;
+}
 function hasFilterableSections(sections) {
   return sections.some((s) => "filterable" in s && s.filterable === true);
 }
@@ -6877,7 +6636,10 @@ function renderDetailSurface(surface, ctx, root) {
               >
                 ${surface.title}
               </h2>` : nothing}
-          <span class="ml-auto">${kindBadgeTpl(surface.entityKind)}</span>
+          <span class="ml-auto flex items-center gap-1">
+            ${surface.unregistered ? badgeTpl("Unregistered", { variant: "warning", size: "sm" }) : nothing}
+            ${kindBadgeTpl(surface.entityKind)}
+          </span>
         </div>
         ${surface.subtitle ? subtitleTpl(surface.subtitle) : nothing}
         <div
@@ -7170,6 +6932,34 @@ function createScreenshotLightbox(trigger, dataUrl, options) {
   };
 }
 
+// src/browser/ui/button.ts
+var buttonBase = "focus-visible:ring-ring focus-visible:ring-offset-background disabled:opacity-60 relative inline-flex shrink-0 cursor-pointer items-center justify-center gap-2 whitespace-nowrap rounded-lg border text-sm font-medium outline-none transition-shadow focus-visible:ring-2 focus-visible:ring-offset-1 disabled:pointer-events-none [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='opacity-'])]:opacity-80 [&_svg]:pointer-events-none [&_svg]:shrink-0";
+var buttonVariants = cva(buttonBase, {
+  defaultVariants: { size: "default", variant: "default" },
+  variants: {
+    size: {
+      default: "h-8 px-3",
+      sm: "h-7 gap-1.5 px-2.5",
+      xs: "h-6 gap-1 rounded-md px-2 text-xs",
+      lg: "h-9 px-3.5",
+      xl: "h-10 px-4 text-base",
+      icon: "size-8",
+      "icon-sm": "size-7",
+      "icon-lg": "size-9",
+      "icon-xs": "size-6 rounded-md"
+    },
+    variant: {
+      default: "border-primary bg-primary text-primary-foreground shadow-xs hover:bg-primary/90",
+      destructive: "border-destructive bg-destructive shadow-xs hover:bg-destructive/90 text-white",
+      "destructive-outline": "border-input bg-popover text-destructive-foreground shadow-xs/5 hover:border-destructive/30 hover:bg-destructive/5 dark:bg-input/30",
+      ghost: "text-foreground hover:bg-accent hover:text-accent-foreground border-transparent",
+      link: "text-foreground border-transparent underline-offset-4 hover:underline",
+      outline: "border-input bg-popover text-foreground shadow-xs/5 hover:bg-accent hover:text-accent-foreground dark:bg-input/30",
+      secondary: "bg-secondary text-secondary-foreground hover:bg-secondary/90 border-transparent"
+    }
+  }
+});
+
 // src/browser/views/render/form.ts
 var fieldSeq = 0;
 var nextFieldId = () => `uidex-field-${++fieldSeq}`;
@@ -7366,9 +7156,9 @@ function iconMediaTpl(iconTpl) {
     </div>
   `;
 }
-function loadingViewTpl() {
+function loadingViewTpl(rootRef) {
   return html`
-    <div class=${EMPTY_ROOT} aria-live="polite" hidden>
+    <div class=${EMPTY_ROOT} aria-live="polite" hidden ${ref(rootRef)}>
       ${iconMediaTpl(icon(Loader2, "animate-spin"))}
       <div class="flex max-w-sm flex-col items-center text-center">
         <div class=${SKELETON + " h-6 w-36 rounded-md"}></div>
@@ -7381,42 +7171,47 @@ function loadingViewTpl() {
     </div>
   `;
 }
-function successViewTpl() {
+function successViewTpl(refs) {
   return html`
-    <div class=${EMPTY_ROOT} hidden data-uidex-success-view>
+    <div class=${EMPTY_ROOT} hidden data-uidex-success-view ${ref(refs.root)}>
       ${iconMediaTpl(icon(CircleCheck))}
       <div class="flex max-w-sm flex-col items-center text-center">
         <div
           class="font-heading text-xl font-semibold"
           data-uidex-success-title
+          ${ref(refs.title)}
         ></div>
       </div>
       <div
         class="flex w-full min-w-0 max-w-sm flex-col items-center gap-4 text-balance text-sm"
         data-uidex-success-actions
+        ${ref(refs.actions)}
       >
         <a
           class=${buttonVariants({ variant: "outline", size: "sm" })}
           target="_blank"
           rel="noreferrer"
           data-uidex-success-link
+          ${ref(refs.link)}
         ></a>
       </div>
     </div>
   `;
 }
-function errorViewTpl() {
+function errorViewTpl(refs) {
   return html`
-    <div class=${EMPTY_ROOT} hidden data-uidex-error-view>
+    <div class=${EMPTY_ROOT} hidden data-uidex-error-view ${ref(refs.root)}>
       ${iconMediaTpl(icon(CircleX))}
       <div class="flex max-w-sm flex-col items-center gap-1 text-center">
         <div
           class="font-heading text-xl font-semibold"
           data-uidex-error-title
+          ${ref(refs.title)}
         ></div>
         <p
           class="text-muted-foreground text-sm"
           data-uidex-error-description
+          ${ref(refs.description)}
         ></p>
       </div>
       <div
@@ -7427,6 +7222,7 @@ function errorViewTpl() {
           class=${buttonVariants({ variant: "outline", size: "sm" })}
           data-slot="button"
           data-uidex-retry-button
+          ${ref(refs.retry)}
         >
           Try Again
         </button>
@@ -7468,8 +7264,15 @@ function renderFormSurface(surface, ctx, root) {
     });
   }
   const formRef = createRef();
-  const statusRef = createRef();
-  const submitRef = createRef();
+  const loadingRef = createRef();
+  const successRef = createRef();
+  const successTitleRef = createRef();
+  const successLinkRef = createRef();
+  const successActionsRef = createRef();
+  const errorRef = createRef();
+  const errorTitleRef = createRef();
+  const errorDescriptionRef = createRef();
+  const retryRef = createRef();
   render(
     html`
       <section
@@ -7484,7 +7287,19 @@ function renderFormSurface(surface, ctx, root) {
           novalidate
           data-uidex-form=${surface.id}
         ></form>
-        ${loadingViewTpl()} ${successViewTpl()} ${errorViewTpl()}
+        ${loadingViewTpl(loadingRef)}
+        ${successViewTpl({
+      root: successRef,
+      title: successTitleRef,
+      link: successLinkRef,
+      actions: successActionsRef
+    })}
+        ${errorViewTpl({
+      root: errorRef,
+      title: errorTitleRef,
+      description: errorDescriptionRef,
+      retry: retryRef
+    })}
       </section>
     `,
     root
@@ -7514,32 +7329,15 @@ function renderFormSurface(surface, ctx, root) {
     }
   });
   form.append(status);
-  const sectionEl = root.querySelector(
-    "[data-uidex-form-surface]"
-  );
-  const loadingView = sectionEl.querySelector("[aria-live='polite'][hidden]") ?? sectionEl.children[1];
-  const successView = sectionEl.querySelector(
-    "[data-uidex-success-view]"
-  );
-  const successTitle = sectionEl.querySelector(
-    "[data-uidex-success-title]"
-  );
-  const successLink = sectionEl.querySelector(
-    "[data-uidex-success-link]"
-  );
-  const successActions = successLink.parentElement;
-  const errorView = sectionEl.querySelector(
-    "[data-uidex-error-view]"
-  );
-  const errorTitle = sectionEl.querySelector(
-    "[data-uidex-error-title]"
-  );
-  const errorDescription = sectionEl.querySelector(
-    "[data-uidex-error-description]"
-  );
-  const retryButton = sectionEl.querySelector(
-    "[data-uidex-retry-button]"
-  );
+  const loadingView = loadingRef.value;
+  const successView = successRef.value;
+  const successTitle = successTitleRef.value;
+  const successLink = successLinkRef.value;
+  const successActions = successActionsRef.value;
+  const errorView = errorRef.value;
+  const errorTitle = errorTitleRef.value;
+  const errorDescription = errorDescriptionRef.value;
+  const retryButton = retryRef.value;
   function clearAllFieldErrors() {
     for (const f of fields) f.setError(null);
   }
@@ -7940,7 +7738,7 @@ function defaultFilter(item, query) {
 function rowTag(item) {
   return item.tag ?? item.value;
 }
-function resolveLeadingTpl(item, ctx) {
+function resolveLeadingTpl(item) {
   if (item.entityChip) return kindIconTileTpl(item.entityChip.entity.kind);
   if (item.leading) {
     const node = item.leading();
@@ -8045,7 +7843,7 @@ function buildItemsDom(surface, ctx, filteredItems, allByValue, content) {
                       data-uidex-item-value=${item.value}
                     >
                       ${rowTpl({
-          leading: resolveLeadingTpl(item, ctx),
+          leading: resolveLeadingTpl(item),
           label: item.label,
           subtitle: item.subtitle,
           trailing: item.trailing ?? item.shortcut
@@ -8090,7 +7888,7 @@ function renderListSurface(surface, ctx, root) {
     return root.ownerDocument ?? document;
   };
   const hasDefault = surface.defaultHighlight !== void 0 && allByValue.has(surface.defaultHighlight);
-  const { section, scrollRoot, viewport, content } = renderShell(surface, root);
+  const { scrollRoot, viewport, content } = renderShell(surface, root);
   let maps = buildItemsDom(surface, ctx, filteredItems, allByValue, content);
   const controller = createListController({
     surfaceId: surface.id,
@@ -8786,52 +8584,16 @@ function sameRef2(a, b) {
   if (a === null || b === null) return false;
   return a.kind === b.kind && a.id === b.id;
 }
-function resolveHints(view, ctx) {
-  const h = view.hints;
-  if (!h) return [];
-  if (typeof h === "function") {
-    try {
-      return h(ctx) ?? [];
-    } catch (err) {
-      console.error(`[uidex] view "${view.id}" hints() threw`, err);
-      return [];
-    }
-  }
-  return h;
-}
-function resolveTitle(view, ctx) {
-  const t = view.title;
-  if (!t) return "";
-  if (typeof t === "function") {
-    try {
-      return t(ctx) ?? "";
-    } catch (err) {
-      console.error(`[uidex] view "${view.id}" title() threw`, err);
-      return "";
-    }
-  }
-  return t;
-}
-function resolveActions(view, ctx, globalActions) {
-  const result = [];
-  const fn = view.actions;
-  if (fn) {
-    try {
-      const viewActions2 = fn(ctx) ?? [];
-      result.push(...viewActions2);
-    } catch (err) {
-      console.error(`[uidex] view "${view.id}" actions() threw`, err);
-    }
-  }
-  if (globalActions) {
+function resolveProp(view, ctx, value, propName, fallback) {
+  if (typeof value === "function") {
     try {
-      const globals = globalActions(ctx) ?? [];
-      result.push(...globals);
+      return value(ctx) ?? fallback;
     } catch (err) {
-      console.error(`[uidex] globalActions() threw`, err);
+      console.error(`[uidex] view "${view.id}" ${propName}() threw`, err);
+      return fallback;
     }
   }
-  return result;
+  return value ?? fallback;
 }
 function createViewStack(options) {
   const { container, views, session, registry, highlight } = options;
@@ -8899,39 +8661,40 @@ function createViewStack(options) {
       color: KIND_STYLE[top.ctx.ref.kind].color
     });
   }
-  function updateChrome() {
-    if (!shell) return;
-    const top = mounted[mounted.length - 1];
-    if (!top) return;
+  function updateNavButtons(shell2, top) {
     const atRoot = mounted.length <= 1 && top.view.id === "command-palette";
-    shell.backBtn.hidden = atRoot;
-    shell.searchIcon.hidden = !atRoot;
+    shell2.backBtn.hidden = atRoot;
+    shell2.searchIcon.hidden = !atRoot;
+  }
+  function updateTitle(shell2, top) {
     const searchable = top.view.searchable !== false;
-    shell.searchInput.hidden = !searchable;
-    const titleText = searchable ? "" : resolveTitle(top.view, top.ctx);
-    shell.headerTitle.textContent = titleText;
-    shell.headerTitle.hidden = searchable || !titleText;
-    shell.footerLeft.replaceChildren();
+    shell2.searchInput.hidden = !searchable;
+    const titleText = searchable ? "" : resolveProp(top.view, top.ctx, top.view.title, "title", "");
+    shell2.headerTitle.textContent = titleText;
+    shell2.headerTitle.hidden = searchable || !titleText;
+  }
+  function updateFooterChip(shell2, top) {
+    shell2.footerLeft.replaceChildren();
     const refEntity = top.ctx.ref ? top.ctx.registry.get(top.ctx.ref.kind, top.ctx.ref.id) : null;
     if (refEntity) {
-      shell.footerLeft.append(
+      shell2.footerLeft.append(
         renderKindChip({
           entity: refEntity,
           withKindName: true
         })
       );
     } else {
-      shell.footerLeft.append(shell.logo);
+      shell2.footerLeft.append(shell2.logo);
     }
-    hintChangeSub?.();
-    hintChangeSub = null;
-    highlightActionsSub?.();
-    highlightActionsSub = null;
-    shell.footerRight.replaceChildren();
-    const footerItems = [];
-    const enterHint = resolveHints(top.view, top.ctx).find(
-      (h) => h.key.includes("\u21B5")
-    );
+  }
+  function buildEnterHint(top, footerItems) {
+    const enterHint = resolveProp(
+      top.view,
+      top.ctx,
+      top.view.hints,
+      "hints",
+      []
+    ).find((h) => h.key.includes("\u21B5"));
     const src = top.mounted.submitIntent;
     if (src) {
       const key = enterHint?.key ?? "\u21B5";
@@ -8952,28 +8715,52 @@ function createViewStack(options) {
     } else if (enterHint) {
       footerItems.push(createHint(enterHint.key, enterHint.label));
     }
+  }
+  function buildActions(shell2, top, footerItems) {
     const actionsDivider = createFooterDivider();
-    const viewActions2 = resolveActions(top.view, top.ctx);
+    const viewActions2 = resolveProp(
+      top.view,
+      top.ctx,
+      top.view.actions,
+      "actions",
+      []
+    );
     const hlSrc = top.mounted.highlightActions;
     const syncActions = () => {
       const hlActions = hlSrc?.get() ?? [];
       const combined = [...hlActions, ...viewActions2];
-      shell.actionsPopup.setActions(combined);
+      shell2.actionsPopup.setActions(combined);
       const visible = combined.length > 0;
-      shell.actionsPopup.trigger.hidden = !visible;
+      shell2.actionsPopup.trigger.hidden = !visible;
       actionsDivider.hidden = !visible || footerItems.length === 0;
     };
     if (hlSrc) {
       highlightActionsSub = hlSrc.subscribe(syncActions);
     }
     for (let i = 0; i < footerItems.length; i++) {
-      if (i > 0) shell.footerRight.append(createFooterDivider());
-      shell.footerRight.append(footerItems[i]);
+      if (i > 0) shell2.footerRight.append(createFooterDivider());
+      shell2.footerRight.append(footerItems[i]);
     }
-    shell.footerRight.append(actionsDivider);
-    shell.footerRight.append(shell.actionsPopup.trigger);
+    shell2.footerRight.append(actionsDivider);
+    shell2.footerRight.append(shell2.actionsPopup.trigger);
     syncActions();
   }
+  function updateChrome() {
+    if (!shell) return;
+    const top = mounted[mounted.length - 1];
+    if (!top) return;
+    updateNavButtons(shell, top);
+    updateTitle(shell, top);
+    updateFooterChip(shell, top);
+    hintChangeSub?.();
+    hintChangeSub = null;
+    highlightActionsSub?.();
+    highlightActionsSub = null;
+    shell.footerRight.replaceChildren();
+    const footerItems = [];
+    buildEnterHint(top, footerItems);
+    buildActions(shell, top, footerItems);
+  }
   function render2() {
     if (!container.isConnected) return;
     const stack = session.getState().stack;
@@ -9070,7 +8857,7 @@ function createViewStack(options) {
 
 // src/browser/views/built-in/ids.ts
 var BUILT_IN_VIEW_IDS = {
-  archiveReason: "archive-reason",
+  closeReason: "close-reason",
   commandPalette: "command-palette",
   elements: "elements",
   entityReports: "entity-reports",
@@ -9121,7 +8908,7 @@ function parentDetail(ref2) {
   return { id: DETAIL_VIEW_FOR_KIND[ref2.kind], ref: ref2 };
 }
 
-// src/browser/views/built-in/archive-reason.ts
+// src/browser/views/built-in/close-reason.ts
 import {
   Ban,
   BugOff,
@@ -9131,10 +8918,10 @@ import {
   createElement as createLucideElement6
 } from "lucide";
 var pendingReportId = null;
-var afterArchive = null;
-function setArchiveTarget(reportId, onDone) {
+var afterClose = null;
+function setCloseTarget(reportId, onDone) {
   pendingReportId = reportId;
-  afterArchive = onDone;
+  afterClose = onDone;
 }
 function leadingIcon(iconNode) {
   return () => {
@@ -9149,16 +8936,16 @@ function spinnerTile() {
   return createIconTile(spinner);
 }
 var REASONS = [
-  { value: "fixed", label: "Fixed", icon: CircleCheck2 },
+  { value: "fixed", label: "Resolved", icon: CircleCheck2 },
   { value: "not_a_bug", label: "Not a bug", icon: BugOff },
   { value: "duplicate", label: "Duplicate", icon: Copy2 },
   { value: "wont_fix", label: "Won't fix", icon: Ban }
 ];
-var archiveReasonView = {
-  id: BUILT_IN_VIEW_IDS.archiveReason,
+var closeReasonView = {
+  id: BUILT_IN_VIEW_IDS.closeReason,
   matches: () => false,
   parent: (ref2) => ref2 ? { id: BUILT_IN_VIEW_IDS.reportDetail, ref: ref2 } : null,
-  title: "Archive reason",
+  title: "Close reason",
   searchable: false,
   focusTarget: (host) => host.querySelector("[data-uidex-list-content]"),
   surface: () => ({ kind: "list", id: "unused", items: [] }),
@@ -9171,12 +8958,12 @@ var archiveReasonView = {
     }));
     const surface = {
       kind: "list",
-      id: "uidex-archive-reason",
+      id: "uidex-close-reason",
       searchable: false,
       items,
       emptyLabel: "No reasons available",
       onSelect: async (item) => {
-        if (busy || !pendingReportId || !ctx.registry.archiveReport) return;
+        if (busy || !pendingReportId || !ctx.registry.closeReport) return;
         busy = true;
         const row = root.querySelector(
           `[data-uidex-item-value="${item.value}"]`
@@ -9188,13 +8975,10 @@ var archiveReasonView = {
           row.style.pointerEvents = "none";
         }
         try {
-          await ctx.registry.archiveReport(
-            pendingReportId,
-            item.value
-          );
-          const done = afterArchive;
+          await ctx.registry.closeReport(pendingReportId, item.value);
+          const done = afterClose;
           pendingReportId = null;
-          afterArchive = null;
+          afterClose = null;
           done?.();
         } catch {
           busy = false;
@@ -9212,7 +8996,7 @@ var archiveReasonView = {
           }
           const error = document.createElement("p");
           error.className = "text-destructive px-4 py-2 text-xs";
-          error.textContent = "Archive failed \u2014 try again";
+          error.textContent = "Close failed \u2014 try again";
           root.querySelector("[data-uidex-list-content]")?.prepend(error);
           setTimeout(() => error.remove(), 3e3);
         }
@@ -9539,7 +9323,8 @@ function createCommandPaletteView(shortcut) {
 }
 
 // src/browser/internal/screenshot.ts
-import { domToPng } from "modern-screenshot";
+import { domToPng, domToWebp } from "modern-screenshot";
+var WEBP_QUALITY = 0.85;
 function resolveBackgroundColor(el2) {
   let node = el2;
   while (node) {
@@ -9553,8 +9338,7 @@ function isUidexChrome(node) {
   if (node.nodeType !== Node.ELEMENT_NODE) return false;
   const el2 = node;
   if (el2.shadowRoot !== null) return true;
-  const cls = el2.classList;
-  return cls.contains(SURFACE_HOST_CLASS) || cls.contains(SURFACE_CONTAINER_CLASS);
+  return el2.classList.contains(SURFACE_HOST_CLASS);
 }
 async function captureScreenshot(options = {}) {
   if (typeof document === "undefined") {
@@ -9566,8 +9350,10 @@ async function captureScreenshot(options = {}) {
   const scale = options.maxWidth && width > options.maxWidth ? options.maxWidth / width : 1;
   const padding = 16;
   const height = target.scrollHeight || target.clientHeight;
-  return domToPng(target, {
+  const encode = options.format === "png" ? domToPng : domToWebp;
+  return encode(target, {
     scale,
+    quality: WEBP_QUALITY,
     width: width + padding * 2,
     height: height + padding * 2,
     backgroundColor: resolveBackgroundColor(target),
@@ -9623,12 +9409,6 @@ function collectFlowsTouching(ctx, targetId) {
 }
 
 // src/browser/views/builder/detail-builder.ts
-var DOM_BACKED_KINDS2 = /* @__PURE__ */ new Set([
-  "element",
-  "region",
-  "widget",
-  "primitive"
-]);
 var DETAIL_HINTS = [{ key: "\u21B5", label: "Open" }];
 function copyPathAction(ref2, loc) {
   const identifier = `${ref2.kind}:${ref2.id}`;
@@ -9730,7 +9510,10 @@ function copyScreenshotAction(ref2) {
         const target = resolveEntityElement(ref2) ?? void 0;
         const dataUrl = await captureScreenshot({
           target,
-          maxWidth: 1280
+          maxWidth: 1280,
+          // Clipboard write requires PNG — the async Clipboard API rejects
+          // image/webp (`ClipboardItem` throws on Chrome/Safari).
+          format: "png"
         });
         const res = await fetch(dataUrl);
         const blob = await res.blob();
@@ -9763,12 +9546,11 @@ function createEntityDetailView(config) {
       if (!ctx.ref || ctx.ref.kind !== kind) {
         return { kind: "detail", entityKind: kind };
       }
-      const entity = ctx.registry.get(kind, ctx.ref.id);
-      if (!entity) {
-        return { kind: "detail", entityKind: kind, notFound: ctx.ref };
-      }
-      const metaEntity = entity;
-      const meta = metaEntity.meta;
+      const exactEntity = ctx.registry.get(kind, ctx.ref.id);
+      const patternEntity = exactEntity ? void 0 : ctx.registry.matchPattern?.(kind, ctx.ref.id);
+      const entity = exactEntity ?? patternEntity;
+      const metaEntity = entity ? entity : null;
+      const meta = metaEntity?.meta;
       const actions = [];
       const cloud = ctx.cloud;
       actions.push({ ...reportAction(ctx.ref), group: "Report" });
@@ -9782,18 +9564,20 @@ function createEntityDetailView(config) {
       if (cloud?.integrations.getCachedConfig()?.hasJira) {
         actions.push({ ...jiraAction(ctx.ref), group: "Report" });
       }
-      if (DOM_BACKED_KINDS2.has(kind) && resolveEntityElement(ctx.ref)) {
+      if (DOM_BACKED_KINDS.has(kind) && resolveEntityElement(ctx.ref)) {
         actions.push({ ...highlightElementAction(ctx.ref), group: "Inspect" });
         actions.push({ ...copyScreenshotAction(ctx.ref), group: "Inspect" });
       }
-      actions.push({
-        ...copyPathAction(ctx.ref, metaEntity.loc),
-        group: "Inspect"
-      });
-      actions.push({
-        ...copySnapshotAction(ctx.ref, metaEntity.loc),
-        group: "Inspect"
-      });
+      if (metaEntity?.loc) {
+        actions.push({
+          ...copyPathAction(ctx.ref, metaEntity.loc),
+          group: "Inspect"
+        });
+        actions.push({
+          ...copySnapshotAction(ctx.ref, metaEntity.loc),
+          group: "Inspect"
+        });
+      }
       const sections = [];
       if (meta?.description) {
         sections.push({ id: "description", text: meta.description });
@@ -9801,10 +9585,12 @@ function createEntityDetailView(config) {
       if (offerAcceptance && meta?.acceptance?.length) {
         sections.push({ id: "acceptance", items: meta.acceptance });
       }
-      for (const s of config.extraSections?.(ctx, entity) ?? []) {
-        sections.push(s);
+      if (entity) {
+        for (const s of config.extraSections?.(ctx, entity) ?? []) {
+          sections.push(s);
+        }
       }
-      if (!DOM_BACKED_KINDS2.has(kind)) {
+      if (!DOM_BACKED_KINDS.has(kind)) {
         sections.push({
           id: "composes",
           label: SECTION_LABELS.contains,
@@ -9812,7 +9598,7 @@ function createEntityDetailView(config) {
           filterable: true
         });
       }
-      if (DOM_BACKED_KINDS2.has(kind) && meta?.features?.length) {
+      if (DOM_BACKED_KINDS.has(kind) && meta?.features?.length) {
         const featureEntities = meta.features.map((fId) => ctx.registry.get("feature", fId)).filter((e) => !!e);
         if (featureEntities.length > 0) {
           sections.push({
@@ -9831,8 +9617,9 @@ function createEntityDetailView(config) {
       return {
         kind: "detail",
         entityKind: kind,
-        title: displayName(metaEntity),
-        subtitle: config.subtitle?.(ctx, entity),
+        title: patternEntity ? ctx.ref.id : metaEntity ? displayName(metaEntity) : ctx.ref.id,
+        subtitle: exactEntity ? config.subtitle?.(ctx, exactEntity) : void 0,
+        unregistered: !entity,
         actions,
         sections
       };
@@ -9841,35 +9628,14 @@ function createEntityDetailView(config) {
 }
 
 // src/browser/views/built-in/entity-detail.ts
-function collectDomParents(ctx, ref2) {
-  const el2 = resolveEntityElement(ref2);
-  if (!el2) return [];
-  const parents = [];
-  const seen = /* @__PURE__ */ new Set();
-  let node = el2.parentElement;
-  while (node) {
-    if (node instanceof HTMLElement) {
-      for (const [attr, kind] of UIDEX_ATTR_TO_KIND) {
-        const id = node.getAttribute(attr);
-        if (id) {
-          const key = `${kind}:${id}`;
-          if (!seen.has(key)) {
-            seen.add(key);
-            const entity = ctx.registry.get(kind, id);
-            if (entity) parents.push(entity);
-          }
-        }
-      }
-    }
-    node = node.parentElement;
-  }
-  return parents;
+function collectFeatureConsumers(ctx, featureId) {
+  return ctx.registry.list("page").filter((page) => page.meta?.features?.includes(featureId));
 }
-function usedBySection(ctx, ref2) {
+function usedBySection(ctx, featureId) {
   return {
     id: "used-by",
     label: SECTION_LABELS.usedBy,
-    entities: collectDomParents(ctx, ref2),
+    entities: collectFeatureConsumers(ctx, featureId),
     filterable: true
   };
 }
@@ -9890,9 +9656,7 @@ var featureDetailView = createEntityDetailView({
   id: "feature-detail",
   kind: "feature",
   fallbackTitle: "Feature",
-  extraSections: (ctx, entity) => [
-    usedBySection(ctx, { kind: "feature", id: entity.id })
-  ]
+  extraSections: (ctx, entity) => [usedBySection(ctx, entity.id)]
 });
 var regionDetailView = createEntityDetailView({
   id: "region-detail",
@@ -10020,6 +9784,15 @@ var reportDetailView = {
     }
     if (report.screenshot) {
       sections.push({ id: "screenshot", url: report.screenshot });
+    } else {
+      const pins = ctx.cloud?.pins;
+      const fetchScreenshot = pins?.screenshot;
+      if (pins && fetchScreenshot) {
+        sections.push({
+          id: "screenshot",
+          load: () => fetchScreenshot.call(pins, report.id)
+        });
+      }
     }
     const metaEntries = [];
     if (report.url) metaEntries.push({ label: "URL", value: report.url });
@@ -10030,14 +9803,14 @@ var reportDetailView = {
       sections.push({ id: "metadata", entries: metaEntries });
     }
     const actions = [];
-    if (ctx.registry.archiveReport) {
+    if (ctx.registry.closeReport) {
       actions.push({
-        id: "archive",
-        label: "Archive",
+        id: "close",
+        label: "Close",
         icon: "archive-x",
         run: () => {
-          setArchiveTarget(report.id, () => ctx.pop());
-          ctx.push({ id: BUILT_IN_VIEW_IDS.archiveReason });
+          setCloseTarget(report.id, () => ctx.pop());
+          ctx.push({ id: BUILT_IN_VIEW_IDS.closeReason });
         }
       });
     }
@@ -10075,13 +9848,13 @@ function reportToItem(report, ctx) {
   const label = raw.length > 80 ? raw.slice(0, 80) + "\u2026" : raw;
   const kind = ctx.ref?.kind ?? "element";
   const actions = [];
-  if (ctx.registry.archiveReport) {
+  if (ctx.registry.closeReport) {
     actions.push({
-      id: `archive-${report.id}`,
-      label: "Archive",
+      id: `close-${report.id}`,
+      label: "Close",
       perform: () => {
-        setArchiveTarget(report.id, () => ctx.pop());
-        ctx.push({ id: BUILT_IN_VIEW_IDS.archiveReason });
+        setCloseTarget(report.id, () => ctx.pop());
+        ctx.push({ id: BUILT_IN_VIEW_IDS.closeReason });
       }
     });
   }
@@ -10234,7 +10007,7 @@ function capitalize2(s) {
   return s.length === 0 ? s : s[0].toUpperCase() + s.slice(1);
 }
 function renderPayloadMarkdown(payload) {
-  const heading = payload.title ?? `${capitalize2(payload.type)} Report`;
+  const heading = payload.title ?? `${capitalize2(payload.type ?? "")} Report`;
   const ctx = payload.context;
   const lines = [
     `# ${heading}`,
@@ -10303,12 +10076,6 @@ var reportFields = [
 ];
 
 // src/browser/views/built-in/report/view-builder.ts
-var DOM_BACKED_KINDS3 = /* @__PURE__ */ new Set([
-  "element",
-  "region",
-  "widget",
-  "primitive"
-]);
 var KIND_TO_ATTR = new Map(
   UIDEX_ATTR_TO_KIND.map(([attr, kind]) => [kind, attr])
 );
@@ -10379,7 +10146,7 @@ function createReportView(config) {
       const cloud = resolveCloud(ctx);
       const extra = extraFields ? extraFields(ctx) : [];
       const fields = [...extra, ...baseFields ?? reportFields];
-      const isDomBacked = ctx.ref != null && DOM_BACKED_KINDS3.has(ctx.ref.kind);
+      const isDomBacked = ctx.ref != null && DOM_BACKED_KINDS.has(ctx.ref.kind);
       const targetEl = ctx.ref && isDomBacked ? resolveElement(ctx.ref) : null;
       const screenshotPromise = isDomBacked ? captureScreenshot({
         target: targetEl ?? void 0,
@@ -10962,7 +10729,7 @@ var pinSettingsView = {
 // src/browser/views/built-in/index.ts
 function buildDefaultViews(shortcut) {
   return [
-    archiveReasonView,
+    closeReasonView,
     createCommandPaletteView(shortcut),
     explorePageView,
     componentDetailView,
@@ -10990,6 +10757,27 @@ function buildDefaultViews(shortcut) {
 }
 
 // src/browser/create-uidex.ts
+function getVisibleEntities() {
+  if (typeof document === "undefined") return [];
+  const selector = UIDEX_ATTR_TO_KIND.map(([a]) => `[${a}]`).join(",");
+  const nodes = document.querySelectorAll(selector);
+  const ids = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const node of nodes) {
+    if (node.closest(SURFACE_IGNORE_SELECTOR)) continue;
+    for (const [attr, kind] of UIDEX_ATTR_TO_KIND) {
+      const id = node.getAttribute(attr);
+      if (!id) continue;
+      const key = `${kind}:${id}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        ids.push(key);
+      }
+      break;
+    }
+  }
+  return ids;
+}
 function createUidex(options = {}) {
   const registry = createRegistry();
   const inspectorRef = { current: null };
@@ -11024,7 +10812,7 @@ function createUidex(options = {}) {
   const views = createRouter({ session });
   const cloud = options.cloud ?? null;
   const ingestOpts = resolveIngestOptions(options.ingest, cloud !== null);
-  const ingest = ingestOpts ? createIngest({ session, ...ingestOpts }) : null;
+  const ingest = ingestOpts ? createIngest(ingestOpts) : null;
   if (options.defaultViews !== false) {
     for (const view of buildDefaultViews(options.shortcut)) views.add(view);
   }
@@ -11034,6 +10822,94 @@ function createUidex(options = {}) {
   let shadowRoot = null;
   const mountCleanup = createCleanupStack();
   let mounted = false;
+  function syncReportsToRegistry() {
+    const layer = pinLayerRef.current;
+    if (!layer) return;
+    const byEntity = /* @__PURE__ */ new Map();
+    for (const pin of layer.getAllPins()) {
+      const cid = pin.entity ?? "";
+      if (!cid) continue;
+      const list = byEntity.get(cid);
+      if (list) list.push(pin);
+      else byEntity.set(cid, [pin]);
+    }
+    for (const [cid, pins] of byEntity) {
+      const ref2 = parseComponentRef(cid);
+      registry.setReports(ref2.kind, ref2.id, pins);
+    }
+  }
+  function setupKeyBindings(root, viewStack) {
+    const bindings = bindShadowKeys({
+      shadowRoot: root,
+      session,
+      getActionsPopup: () => viewStack.getActionsPopup(),
+      getPinLayer: () => pinLayerRef.current,
+      shortcut: options.shortcut
+    });
+    mountCleanup.add(bindings);
+    return bindings;
+  }
+  function setupPinLayer(root, shell, channel, getCurrentRoute, getMatchMode, getPathname) {
+    if (cloud) {
+      registry.closeReport = async (reportId, status) => {
+        pinLayerRef.current?.removePin(reportId);
+        await cloud.pins.close(
+          reportId,
+          status
+        );
+        syncReportsToRegistry();
+      };
+    }
+    const pinLayer = createPinLayer({
+      container: root,
+      onOpenPinDetail: (componentId, reportId) => {
+        const ref2 = parseComponentRef(componentId);
+        setSelectedReportId(reportId);
+        const entry = { id: BUILT_IN_VIEW_IDS.reportDetail, ref: ref2 };
+        session.mode.transition.enterViewing(views.buildStack(entry));
+      },
+      onHoverPin: (anchor, componentId) => {
+        const overlay = overlayRef.current;
+        if (!overlay) return;
+        if (!anchor || !componentId) {
+          overlay.hide();
+          return;
+        }
+        overlay.show(anchor, {
+          color: isDarkMode() ? "#e4e4e7" : "#27272a"
+        });
+      },
+      onPinsChanged: syncReportsToRegistry
+    });
+    shell.menuBar.setPinLayer(pinLayer);
+    pinLayerRef.current = pinLayer;
+    mountCleanup.add(() => {
+      pinLayer.destroy();
+      pinLayerRef.current = null;
+      registry.closeReport = void 0;
+    });
+    if (cloud) {
+      const detach = pinLayer.attachCloud({
+        cloud,
+        channel,
+        getRoute: getCurrentRoute,
+        getPathname,
+        getVisibleEntities,
+        getMatchMode,
+        onError: (err) => console.warn("[uidex] pin fetch failed", err)
+      });
+      mountCleanup.add(detach);
+      if (channel && typeof window !== "undefined") {
+        const onRouteChange = () => {
+          const route = getCurrentRoute();
+          channel?.joinRoute(route);
+          void pinLayer.refresh();
+        };
+        const detachRoute = bindRouteChange(onRouteChange);
+        mountCleanup.add(detachRoute);
+      }
+    }
+  }
   function mount(target) {
     if (mounted) return;
     const mountTarget = target ?? (typeof document !== "undefined" ? document.body : null);
@@ -11042,28 +10918,7 @@ function createUidex(options = {}) {
     }
     const getPathname = () => typeof location !== "undefined" ? location.pathname : "/";
     const getCurrentRoute = () => options.getRoute?.() ?? findCurrentRoutePath(registry) ?? getPathname();
-    const getVisibleEntities = () => {
-      if (typeof document === "undefined") return [];
-      const selector = UIDEX_ATTR_TO_KIND.map(([a]) => `[${a}]`).join(",");
-      const nodes = document.querySelectorAll(selector);
-      const ids = [];
-      const seen = /* @__PURE__ */ new Set();
-      for (const node of nodes) {
-        if (node.closest(SURFACE_IGNORE_SELECTOR)) continue;
-        for (const [attr, kind] of UIDEX_ATTR_TO_KIND) {
-          const id = node.getAttribute(attr);
-          if (!id) continue;
-          const key = `${kind}:${id}`;
-          if (!seen.has(key)) {
-            seen.add(key);
-            ids.push(key);
-          }
-          break;
-        }
-      }
-      return ids;
-    };
-    const getMatchMode = () => (typeof localStorage !== "undefined" ? localStorage.getItem("uidex:pin-match-mode") : null) ?? "route";
+    const getMatchMode = () => readMode();
     let channel = null;
     if (cloud && options.user) {
       channel = cloud.realtime.connect({
@@ -11084,7 +10939,6 @@ function createUidex(options = {}) {
         onSelect: (match) => {
           const route = views.resolve(match.ref);
           if (!route) return;
-          session.select(match.ref);
           const entry = { id: route.view.id, ref: match.ref };
           session.mode.transition.enterViewing(views.buildStack(entry));
         }
@@ -11135,92 +10989,15 @@ function createUidex(options = {}) {
     });
     mountCleanup.add(viewStack);
     if (shadowRoot) {
-      keyBindings = bindShadowKeys({
+      keyBindings = setupKeyBindings(shadowRoot, viewStack);
+      setupPinLayer(
         shadowRoot,
-        session,
-        getActionsPopup: () => viewStack.getActionsPopup(),
-        getPinLayer: () => pinLayerRef.current,
-        shortcut: options.shortcut
-      });
-      mountCleanup.add(keyBindings);
-    }
-    if (shadowRoot) {
-      const syncReportsToRegistry = () => {
-        const layer = pinLayerRef.current;
-        if (!layer) return;
-        const byEntity = /* @__PURE__ */ new Map();
-        for (const pin of layer.getAllPins()) {
-          const cid = pin.entity ?? "";
-          if (!cid) continue;
-          const list = byEntity.get(cid);
-          if (list) list.push(pin);
-          else byEntity.set(cid, [pin]);
-        }
-        for (const [cid, pins] of byEntity) {
-          const ref2 = parseComponentRef(cid);
-          registry.setReports(ref2.kind, ref2.id, pins);
-        }
-      };
-      if (cloud) {
-        registry.archiveReport = async (reportId, reason) => {
-          pinLayerRef.current?.removePin(reportId);
-          await cloud.pins.archive(
-            reportId,
-            reason
-          );
-          syncReportsToRegistry();
-        };
-      }
-      const pinLayer = createPinLayer({
-        container: shadowRoot,
-        currentBranch: options.git?.branch ?? null,
-        onOpenPinDetail: (componentId, reportId) => {
-          const ref2 = parseComponentRef(componentId);
-          setSelectedReportId(reportId);
-          const entry = { id: BUILT_IN_VIEW_IDS.reportDetail, ref: ref2 };
-          session.mode.transition.enterViewing(views.buildStack(entry));
-        },
-        onHoverPin: (anchor, componentId) => {
-          const overlay = overlayRef.current;
-          if (!overlay) return;
-          if (!anchor || !componentId) {
-            overlay.hide();
-            return;
-          }
-          overlay.show(anchor, {
-            color: isDarkMode() ? "#e4e4e7" : "#27272a"
-          });
-        },
-        onPinsChanged: syncReportsToRegistry
-      });
-      shell.menuBar.setPinLayer(pinLayer);
-      pinLayerRef.current = pinLayer;
-      mountCleanup.add(() => {
-        pinLayer.destroy();
-        pinLayerRef.current = null;
-        registry.archiveReport = void 0;
-      });
-      if (cloud) {
-        const detach = pinLayer.attachCloud({
-          cloud,
-          channel,
-          getRoute: getCurrentRoute,
-          getPathname,
-          getVisibleEntities,
-          getMatchMode,
-          onError: (err) => console.warn("[uidex] pin fetch failed", err)
-        });
-        mountCleanup.add(detach);
-        if (channel && typeof window !== "undefined") {
-          const onRouteChange = () => {
-            const route = getCurrentRoute();
-            channel?.joinRoute(route);
-            void pinLayer.refresh();
-          };
-          const detachRoute = bindRouteChange(onRouteChange);
-          mountCleanup.add(detachRoute);
-        }
-      }
+        shell,
+        channel,
+        getCurrentRoute,
+        getMatchMode,
+        getPathname
+      );
     }
     if (ingest) {
       ingest.start();
@@ -11259,18 +11036,23 @@ function UidexProvider({
   config,
   children
 }) {
-  const [ownedInstance] = useState(() => {
+  const [owned] = useState(() => {
     if (externalInstance) return null;
-    const resolvedCloud = cloud !== void 0 ? cloud : projectKey ? createCloud({ projectKey }) : null;
-    return createUidex({ ...config, cloud: resolvedCloud, user });
+    const ownedCloud = cloud === void 0 && projectKey && typeof window !== "undefined" ? createCloud({ projectKey }) : null;
+    const resolvedCloud = cloud !== void 0 ? cloud : ownedCloud;
+    return {
+      instance: createUidex({ ...config, cloud: resolvedCloud, user }),
+      cloud: ownedCloud
+    };
   });
-  const instance = externalInstance ?? ownedInstance;
+  const instance = externalInstance ?? owned.instance;
   useEffect(() => {
-    if (!ownedInstance) return;
+    if (!owned) return;
     return () => {
-      ownedInstance.unmount();
+      owned.instance.unmount();
+      owned.cloud?.dispose?.();
     };
-  }, [ownedInstance]);
+  }, [owned]);
   return /* @__PURE__ */ jsx(UidexContext.Provider, { value: instance, children });
 }
 
@@ -11405,6 +11187,7 @@ function UidexDevtools({
     setInstance(inst);
     return () => {
       inst.unmount();
+      cloud?.dispose?.();
     };
   }, [projectKey, user?.id]);
   if (!instance) return null;