@jobshimo/browser-link 0.35.0 → 0.37.0

package/dist/extension/inpage/builders.js

@@ -8,6 +8,99 @@
  */
 import { DEEP_QUERY_JS } from './deep-query.js';
 import { DOM_HELPERS_JS } from './dom-helpers.js';
+import { OBSERVER_GLOBAL } from './observer.js';
+/**
+ * In-page access to the page observer's element identity (spec v4 §5.6),
+ * injected verbatim into `buildSnapshotJs`, `buildFindJs` and `buildStateJs`.
+ * The observer global is looked up ONCE per evaluation and used only when it
+ * is present, not torn down, and exposes `refFor`:
+ *   - `refOf(el)` returns the observer's `<doc_tag>:e<N>` ref for `el`, or `null`;
+ *   - `withDocId(result)` adds `doc_id` to `result` and returns it;
+ *   - `snapshotStore()` returns the observer when it keeps snapshot records
+ *     (`recordSnapshot` / `getSnapshot`, used by `snapshot({ since })`), else
+ *     `null`.
+ * Without the observer (injection failed, pre-observer document) all are
+ * no-ops, so every result is byte-identical to the pre-ref output.
+ */
+export const PAGE_OBSERVER_JS = `
+  const pageObserver = (() => {
+    try {
+      const g = window[${JSON.stringify(OBSERVER_GLOBAL)}];
+      if (g && !g.dead && typeof g.refFor === 'function') return g;
+    } catch (e) {}
+    return null;
+  })();
+  function refOf(el) {
+    if (!pageObserver) return null;
+    try {
+      const ref = pageObserver.refFor(el);
+      return typeof ref === 'string' ? ref : null;
+    } catch (e) {
+      return null;
+    }
+  }
+  function withDocId(result) {
+    if (pageObserver && typeof pageObserver.doc_id === 'string') result.doc_id = pageObserver.doc_id;
+    return result;
+  }
+  function snapshotStore() {
+    if (
+      pageObserver &&
+      typeof pageObserver.recordSnapshot === 'function' &&
+      typeof pageObserver.getSnapshot === 'function'
+    ) {
+      return pageObserver;
+    }
+    return null;
+  }
+`;
+/**
+ * In-page action-target resolution (spec v4 §6.3), injected after
+ * `DEEP_QUERY_JS` and `PAGE_OBSERVER_JS` into the builders that take a
+ * `selector` or a `ref` (click, type, focus, element rect, `wait_for` by
+ * ref, `find` by ref):
+ * `resolveTarget(opts)` with a non-empty `opts.ref` asks the observer
+ * (`resolveRefDetailed`, which re-resolves a replaced node by its semantic
+ * key) and answers `{ ok: true, el, reresolved }`, `{ ok: false, reason:
+ * 'ref-stale', ref, doc_id }` or `{ ok: false, reason: 'observer-unavailable'
+ * }`; otherwise it resolves `opts.selector` exactly as the selector builders
+ * always did (`invalid-selector` checked against `document` first, then
+ * `deepQueryFirst`, `not-found`). Kept out of `PAGE_OBSERVER_JS` so the
+ * snapshot and state sources do not carry code they never call.
+ */
+export const RESOLVE_TARGET_JS = `
+  function resolveTarget(opts) {
+    if (typeof opts.ref === 'string' && opts.ref.length > 0) {
+      if (!pageObserver || typeof pageObserver.resolveRefDetailed !== 'function') {
+        return { ok: false, reason: 'observer-unavailable' };
+      }
+      let found = null;
+      try {
+        found = pageObserver.resolveRefDetailed(opts.ref);
+      } catch (e) {
+        found = null;
+      }
+      if (!found || !found.el) return withDocId({ ok: false, reason: 'ref-stale', ref: opts.ref });
+      return { ok: true, el: found.el, reresolved: found.reresolved === true };
+    }
+    try {
+      document.querySelector(opts.selector);
+    } catch (e) {
+      return { ok: false, reason: 'invalid-selector', error: e && e.message ? e.message : String(e) };
+    }
+    const el = deepQueryFirst(opts.selector);
+    if (!el) return { ok: false, reason: 'not-found' };
+    return { ok: true, el: el, reresolved: false };
+  }
+`;
+/** JSON for the `selector` / `ref` pair, embedded as data in the built
+ * source; `ref` is included only when given so a selector build keeps the
+ * same options object as before. */
+function targetJson(opts) {
+    return typeof opts.ref === 'string' && opts.ref.length > 0
+        ? { selector: opts.selector, ref: opts.ref }
+        : { selector: opts.selector };
+}
 export function buildSnapshotJs(opts = {}) {
     const optsJson = JSON.stringify({
         withinSelector: typeof opts.within_selector === 'string' ? opts.within_selector : null,
@@ -16,23 +109,25 @@ export function buildSnapshotJs(opts = {}) {
         maxInteractive: typeof opts.max_interactive === 'number' && opts.max_interactive > 0
             ? Math.min(opts.max_interactive, 500)
             : 120,
+        since: typeof opts.since === 'string' ? opts.since : null,
     });
     return `
 (() => {
   ${DEEP_QUERY_JS}
   ${DOM_HELPERS_JS}
+  ${PAGE_OBSERVER_JS}
   const opts = ${optsJson};
   let root = document;
   let notice = '';
   if (opts.withinSelector) {
     const sub = deepQueryFirst(opts.withinSelector);
     if (!sub) {
-      return {
+      return withDocId({
         title: document.title,
         url: location.href,
         interactive: [],
         notice: 'within_selector did not match any element',
-      };
+      });
     }
     root = sub;
   }
@@ -75,6 +170,8 @@ export function buildSnapshotJs(opts = {}) {
     const role = el.getAttribute('role') || tag;
     const selInfo = genSelectorInfo(el);
     const entry = { tag, role, selector: selInfo.selector };
+    const ref = refOf(el);
+    if (ref) entry.ref = ref;
     if (selInfo.ambiguous) entry.ambiguous = true;
     const txt = shortText(el);
     if (txt) entry.text = txt;
@@ -94,29 +191,118 @@ export function buildSnapshotJs(opts = {}) {
     if (frame) entry.frame = frame;
     interactive.push(entry);
   });
-  const result = {
-    title: document.title,
-    url: location.href,
-    interactive: interactive.slice(0, opts.maxInteractive),
-  };
+  let headings = null;
+  let visibleText = '';
   if (!opts.onlyInteractive) {
-    const headings = [];
+    const found = [];
     deepQueryAll('h1, h2, h3', root).forEach((h) => {
       if (!isVisible(h)) return;
       if (inExcludedLandmark(h)) return;
       const t = shortText(h);
-      if (t) headings.push({ level: h.tagName, text: t });
+      if (t) found.push({ level: h.tagName, text: t });
     });
-    result.headings = headings.slice(0, 30);
+    headings = found.slice(0, 30);
     const textRoot = (root === document) ? (document.body || document) : root;
-    const visibleText = (textRoot && textRoot.innerText) ? textRoot.innerText.slice(0, 4000) : '';
+    visibleText = (textRoot && textRoot.innerText) ? textRoot.innerText.slice(0, 4000) : '';
+  }
+  let snapshotId = null;
+  if (withDocId({}).doc_id && typeof pageObserver.nextSnapshotId === 'function') {
+    const issued = pageObserver.nextSnapshotId();
+    if (typeof issued === 'string') snapshotId = issued;
+  }
+  function fullResult() {
+    const result = {
+      title: document.title,
+      url: location.href,
+      interactive: interactive.slice(0, opts.maxInteractive),
+    };
+    if (headings) result.headings = headings;
     if (visibleText) result.text = visibleText;
+    if (notice) result.notice = notice;
+    withDocId(result);
+    if (snapshotId) result.snapshot_id = snapshotId;
+    return result;
   }
-  if (notice) result.notice = notice;
-  return result;
+  // Record every snapshot (with or without since) so a later call can diff
+  // against it. Entries are keyed by ref; the hash is the entry serialised
+  // without its ref, in emission order. Capped at the first 500 entries.
+  const store = snapshotId ? snapshotStore() : null;
+  // A snapshot_id is \`<doc_id>:s<N>\`: a since whose prefix (before the LAST
+  // ':') is not this document's doc_id, or that has no ':', came from another
+  // document and is never looked up.
+  const sinceCut = opts.since === null ? -1 : opts.since.lastIndexOf(':');
+  const sinceSameDoc =
+    sinceCut >= 0 && withDocId({}).doc_id === opts.since.slice(0, sinceCut);
+  const previous = store && sinceSameDoc ? store.getSnapshot(opts.since) : null;
+  const current = new Map();
+  const headingsHash = headings ? JSON.stringify(headings) : null;
+  const textHash = opts.onlyInteractive ? null : visibleText;
+  if (store) {
+    for (const entry of interactive) {
+      if (current.size >= 500) break;
+      if (typeof entry.ref !== 'string') continue;
+      const copy = {};
+      for (const key of Object.keys(entry)) if (key !== 'ref') copy[key] = entry[key];
+      current.set(entry.ref, { hash: JSON.stringify(copy), entry });
+    }
+    store.recordSnapshot(snapshotId, { entries: current, headings_hash: headingsHash, text_hash: textHash });
+  }
+  if (opts.since === null) return fullResult();
+  if (!store) {
+    const result = fullResult();
+    result.since = opts.since;
+    result.since_status = 'observer-unavailable';
+    return result;
+  }
+  if (!previous || !previous.entries || typeof previous.entries.get !== 'function') {
+    const result = fullResult();
+    result.since = opts.since;
+    result.since_status = sinceSameDoc ? 'evicted' : 'doc-changed';
+    return result;
+  }
+  const added = [];
+  const changed = [];
+  const removed = [];
+  current.forEach((item, ref) => {
+    const old = previous.entries.get(ref);
+    if (!old) added.push(item.entry);
+    else if (old.hash !== item.hash) changed.push(item.entry);
+  });
+  previous.entries.forEach((item, ref) => {
+    if (current.has(ref) || removed.length >= 500) return;
+    const gone = { ref, tag: item.entry.tag };
+    if (item.entry.text) gone.text = item.entry.text;
+    removed.push(gone);
+  });
+  // max_interactive applies after diffing (added first, then changed), so
+  // a window shift never masquerades as change.
+  const listed = added.concat(changed);
+  const kept = listed.slice(0, opts.maxInteractive);
+  const diff = withDocId({ title: document.title, url: location.href });
+  diff.snapshot_id = snapshotId;
+  diff.since = opts.since;
+  diff.added = kept.slice(0, Math.min(added.length, kept.length));
+  diff.removed = removed;
+  diff.changed = kept.slice(diff.added.length);
+  if (listed.length > kept.length) diff.overflow = listed.length - kept.length;
+  if (!opts.onlyInteractive) {
+    if (headingsHash !== previous.headings_hash) diff.headings = headings;
+    if (textHash !== previous.text_hash) diff.text = visibleText;
+  }
+  return diff;
 })()
 `;
 }
+/** Only the documented key fields reach the built source, as JSON data. */
+function findKeyJson(key) {
+    return Array.isArray(key.path)
+        ? {
+            role: key.role,
+            name: key.name,
+            path: key.path.map((step) => ({ tag: step.tag, index: step.index })),
+        }
+        : { role: key.role, name: key.name };
+}
 export function buildFindJs(opts) {
     const optsJson = JSON.stringify({
         text: opts.text,
@@ -124,12 +310,98 @@ export function buildFindJs(opts) {
         exact: opts.exact === true,
         candidateLimit: 5,
         nearMissLimit: 3,
+        ...(typeof opts.ref === 'string' && opts.ref.length > 0 ? { ref: opts.ref } : {}),
+        ...(opts.key ? { key: findKeyJson(opts.key) } : {}),
     });
     return `
 (() => {
   ${DEEP_QUERY_JS}
   ${DOM_HELPERS_JS}
+  ${PAGE_OBSERVER_JS}
+  ${typeof opts.ref === 'string' && opts.ref.length > 0 ? RESOLVE_TARGET_JS : ''}
   const opts = ${optsJson};
+  function semanticKeyOf(el) {
+    if (!pageObserver || typeof pageObserver.semanticKeyFor !== 'function') return null;
+    try {
+      const key = pageObserver.semanticKeyFor(el);
+      return key && typeof key === 'object' ? key : null;
+    } catch (e) {
+      return null;
+    }
+  }
+  function singleMatch(el, ref, reresolved) {
+    const center = viewportCenterOf(el);
+    const selInfo = genSelectorInfo(el);
+    const result = { matched: true, selector: selInfo.selector };
+    if (ref) result.ref = ref;
+    result.coords = {
+      x: Math.round(center.x),
+      y: Math.round(center.y),
+    };
+    result.tag = el.tagName.toLowerCase();
+    result.text = shortText(el);
+    if (selInfo.ambiguous) result.ambiguous = true;
+    const frame = frameSelectorFor(el);
+    if (frame) result.frame = frame;
+    if (reresolved) result.reresolved = true;
+    const key = semanticKeyOf(el);
+    if (key) result.semantic_key = key;
+    return withDocId(result);
+  }
+  if (typeof opts.ref === 'string') {
+    const target = resolveTarget(opts);
+    if (!target.ok) {
+      const failure = { matched: false, reason: target.reason, ref: opts.ref };
+      return withDocId(failure);
+    }
+    return singleMatch(target.el, opts.ref, target.reresolved);
+  }
+  if (opts.key) {
+    if (!pageObserver || typeof pageObserver.semanticKeyFor !== 'function') {
+      return { matched: false, reason: 'observer-unavailable' };
+    }
+    const wanted = opts.key;
+    const candidates = [];
+    for (const el of deepQueryAll('*')) {
+      const key = semanticKeyOf(el);
+      if (key && key.role === wanted.role && key.name === wanted.name) {
+        candidates.push({ el: el, path: Array.isArray(key.path) ? key.path : [] });
+      }
+    }
+    const count = candidates.length;
+    const shared = 'key: ' + count + ' candidates share role and name; ';
+    let picked = null;
+    let error = count > 1 ? shared + 'pass path to disambiguate' : null;
+    if (!Array.isArray(wanted.path)) {
+      if (count === 1) picked = candidates[0].el;
+    } else {
+      // Same rule as the observer's re-resolution: identical tag path and
+      // exactly one such candidate; identical rows are refused, never guessed.
+      let sameTags = 0;
+      let only = null;
+      for (const c of candidates) {
+        if (c.path.length !== wanted.path.length) continue;
+        let same = true;
+        for (let i = 0; i < c.path.length && same; i++) {
+          if (c.path[i].tag !== wanted.path[i].tag) same = false;
+        }
+        if (!same) continue;
+        sameTags++;
+        only = c.el;
+      }
+      if (sameTags === 1) {
+        picked = only;
+      } else if (sameTags > 1) {
+        error = 'key: ' + sameTags + ' candidates share role, name and tag path';
+      } else if (count > 0) {
+        error = shared + 'none has the same tag path';
+      }
+    }
+    if (picked) return singleMatch(picked, refOf(picked), false);
+    const failure = { matched: false, reason: 'not-found' };
+    if (error) failure.error = error;
+    return withDocId(failure);
+  }
   const needle = opts.text.toLowerCase();
   const needleTokens = needle.split(/[^a-z0-9]+/).filter(Boolean);
   const ROLE_SELECTORS = {
@@ -189,6 +461,8 @@ export function buildFindJs(opts) {
     }
     function toNearMiss(el) {
       const entry = { text: snippetOf(el), selector: genSelector(el) };
+      const ref = refOf(el);
+      if (ref) entry.ref = ref;
       const roleAttr = el.getAttribute('role');
       if (roleAttr) entry.role = roleAttr;
       return entry;
@@ -221,60 +495,46 @@ export function buildFindJs(opts) {
           ' but none with role "' + opts.role + '"' +
           (closest ? ' — closest: ' + describeForError(closest) + ' "' + snippetOf(closest) + '"' : '');
         result.near_misses = ranked.map(toNearMiss);
-        return result;
+        return withDocId(result);
       }
       const ranked = rankCandidates(broadAll);
       if (ranked.length > 0) result.near_misses = ranked.map(toNearMiss);
-      return result;
+      return withDocId(result);
     }
     const ranked = rankCandidates(all);
     if (ranked.length > 0) result.near_misses = ranked.map(toNearMiss);
-    return result;
+    return withDocId(result);
   }
   if (matches.length > 1) {
-    return {
+    return withDocId({
       matched: false,
       reason: 'multiple-matches',
-      candidates: matches.slice(0, opts.candidateLimit).map((el) => ({
-        selector: genSelector(el),
-        text: shortText(el),
-        tag: el.tagName.toLowerCase(),
-      })),
-    };
+      candidates: matches.slice(0, opts.candidateLimit).map((el) => {
+        const candidate = { selector: genSelector(el) };
+        const ref = refOf(el);
+        if (ref) candidate.ref = ref;
+        candidate.text = shortText(el);
+        candidate.tag = el.tagName.toLowerCase();
+        return candidate;
+      }),
+    });
   }
   const el = matches[0];
-  const center = viewportCenterOf(el);
-  const selInfo = genSelectorInfo(el);
-  const result = {
-    matched: true,
-    selector: selInfo.selector,
-    coords: {
-      x: Math.round(center.x),
-      y: Math.round(center.y),
-    },
-    tag: el.tagName.toLowerCase(),
-    text: shortText(el),
-  };
-  if (selInfo.ambiguous) result.ambiguous = true;
-  const frame = frameSelectorFor(el);
-  if (frame) result.frame = frame;
-  return result;
+  return singleMatch(el, refOf(el), false);
 })()
 `;
 }
 export function buildClickResolveJs(opts) {
-    const optsJson = JSON.stringify({ selector: opts.selector, force: opts.force });
+    const optsJson = JSON.stringify({ ...targetJson(opts), force: opts.force });
     return `
 (() => {
   ${DEEP_QUERY_JS}
+  ${PAGE_OBSERVER_JS}
+  ${RESOLVE_TARGET_JS}
   const opts = ${optsJson};
-  try {
-    document.querySelector(opts.selector);
-  } catch (e) {
-    return { ok: false, reason: 'invalid-selector', error: e && e.message ? e.message : String(e) };
-  }
-  const el = deepQueryFirst(opts.selector);
-  if (!el) return { ok: false, reason: 'not-found' };
+  const target = resolveTarget(opts);
+  if (!target.ok) return target;
+  const el = target.el;
   const chain = frameElementChain(el);
   for (const fe of chain) {
     if (fe.scrollIntoView) fe.scrollIntoView({ block: 'center', inline: 'center' });
@@ -289,41 +549,59 @@ export function buildClickResolveJs(opts) {
   const result = { ok: true, x: center.x, y: center.y, tag };
   const hit = occlusion.allowed ? occlusion.hit : occlusion.blocker;
   if (hit) result.hit_element = hit;
+  if (target.reresolved) result.reresolved = true;
   return result;
 })()
 `;
 }
 export function buildTypeResolveJs(opts) {
-    const optsJson = JSON.stringify({ selector: opts.selector });
+    const optsJson = JSON.stringify(targetJson(opts));
     return `
 (() => {
   ${DEEP_QUERY_JS}
+  ${PAGE_OBSERVER_JS}
+  ${RESOLVE_TARGET_JS}
   const opts = ${optsJson};
-  try {
-    document.querySelector(opts.selector);
-  } catch (e) {
-    return { ok: false, reason: 'invalid-selector', error: e && e.message ? e.message : String(e) };
-  }
-  const el = deepQueryFirst(opts.selector);
-  if (!el) return { ok: false, reason: 'not-found' };
+  const target = resolveTarget(opts);
+  if (!target.ok) return target;
+  const el = target.el;
   el.focus();
   ${opts.clear ? "if ('value' in el) { el.value = ''; el.dispatchEvent(new Event('input', { bubbles: true })); }" : ''}
-  return { ok: true };
+  return target.reresolved ? { ok: true, reresolved: true } : { ok: true };
 })()`;
 }
 export function buildFocusJs(opts) {
-    const optsJson = JSON.stringify({ selector: opts.selector });
+    const optsJson = JSON.stringify(targetJson(opts));
     return `
 (() => {
   ${DEEP_QUERY_JS}
+  ${PAGE_OBSERVER_JS}
+  ${RESOLVE_TARGET_JS}
   const opts = ${optsJson};
-  const el = deepQueryFirst(opts.selector);
-  if (!el) return false;
-  el.focus();
-  return true;
+  const target = resolveTarget(opts);
+  const byRef = typeof opts.ref === 'string';
+  if (!target.ok) return byRef ? target : false;
+  target.el.focus();
+  if (!byRef) return true;
+  return target.reresolved ? { ok: true, reresolved: true } : { ok: true };
 })()`;
 }
-export function buildWaitForSelectorJs(selector, condition) {
+export function buildWaitForSelectorJs(target, condition) {
+    if (typeof target !== 'string') {
+        const refOptsJson = JSON.stringify({ ref: target.ref, condition });
+        return `
+(() => {
+  ${DEEP_QUERY_JS}
+  ${PAGE_OBSERVER_JS}
+  ${RESOLVE_TARGET_JS}
+  const opts = ${refOptsJson};
+  const target = resolveTarget(opts);
+  if (!target.ok && target.reason === 'observer-unavailable') return target;
+  const el = target.ok ? target.el : null;
+  ${WAIT_FOR_CONDITION_JS}
+})()`;
+    }
+    const selector = target;
     const optsJson = JSON.stringify({ selector, condition });
     return `
 (() => {
@@ -331,7 +609,12 @@ export function buildWaitForSelectorJs(selector, condition) {
   const opts = ${optsJson};
   document.querySelector(opts.selector);
   const el = deepQueryFirst(opts.selector);
-  if (opts.condition === 'attached') return Boolean(el);
+  ${WAIT_FOR_CONDITION_JS}
+})()`;
+}
+/** The condition check shared by both `wait_for` probe targets; `el` is
+ * the resolved element or `null`. */
+const WAIT_FOR_CONDITION_JS = `if (opts.condition === 'attached') return Boolean(el);
   if (opts.condition === 'detached') return !el;
   const wantHidden = opts.condition === 'hidden';
   if (!el) return wantHidden;
@@ -340,22 +623,18 @@ export function buildWaitForSelectorJs(selector, condition) {
   if (s.display === 'none' || s.visibility === 'hidden' || s.opacity === '0') return wantHidden;
   const r = el.getBoundingClientRect();
   const shown = r.width > 0 && r.height > 0;
-  return wantHidden ? !shown : shown;
-})()`;
-}
+  return wantHidden ? !shown : shown;`;
 export function buildElementRectJs(opts) {
-    const optsJson = JSON.stringify({ selector: opts.selector });
+    const optsJson = JSON.stringify(targetJson(opts));
     return `
 (() => {
   ${DEEP_QUERY_JS}
+  ${PAGE_OBSERVER_JS}
+  ${RESOLVE_TARGET_JS}
   const opts = ${optsJson};
-  try {
-    document.querySelector(opts.selector);
-  } catch (e) {
-    return { ok: false, reason: 'invalid-selector', error: e && e.message ? e.message : String(e) };
-  }
-  const el = deepQueryFirst(opts.selector);
-  if (!el) return { ok: false, reason: 'not-found' };
+  const target = resolveTarget(opts);
+  if (!target.ok) return target;
+  const el = target.el;
   const chain = frameElementChain(el);
   // behavior 'instant' overrides CSS scroll-behavior: smooth, which would
   // leave the rect below stale while the scroll is still animating.
@@ -380,13 +659,15 @@ export function buildElementRectJs(opts) {
     scrollX = top.scrollX || 0;
     scrollY = top.scrollY || 0;
   } catch (_) {}
-  return {
+  const result = {
     ok: true,
     x: offsetX + rect.left + scrollX,
     y: offsetY + rect.top + scrollY,
     width: rect.width,
     height: rect.height,
   };
+  if (target.reresolved) result.reresolved = true;
+  return result;
 })()`;
 }
 export function buildDragProbeJs(opts) {
@@ -623,12 +904,16 @@ export function buildExpectProbeJs(opts) {
  * `focused` beyond `<body>`, no `dialogs` when none are open, and no
  * `scroll` when the page is at its default (0,0) position — token-lean by
  * construction, matching the omit-falsy convention the other builders use.
+ *
+ * With the page observer installed (see `PAGE_OBSERVER_JS`), `focused`
+ * carries `ref` right after `selector` and the result carries `doc_id`.
  */
 export function buildStateJs() {
     return `
 (() => {
   ${DEEP_QUERY_JS}
   ${DOM_HELPERS_JS}
+  ${PAGE_OBSERVER_JS}
   function deepActiveElement() {
     let el = document.activeElement;
     let guard = 0;
@@ -689,7 +974,10 @@ export function buildStateJs() {
   const active = deepActiveElement();
   if (active && active !== document.body && active.tagName) {
     const selInfo = genSelectorInfo(active);
-    const focused = { selector: selInfo.selector, tag: active.tagName.toLowerCase() };
+    const focused = { selector: selInfo.selector };
+    const ref = refOf(active);
+    if (ref) focused.ref = ref;
+    focused.tag = active.tagName.toLowerCase();
     if (selInfo.ambiguous) focused.ambiguous = true;
     result.focused = focused;
   }
@@ -709,7 +997,7 @@ export function buildStateJs() {
   const scrollY = Math.round(window.scrollY);
   if (scrollX !== 0 || scrollY !== 0) result.scroll = { x: scrollX, y: scrollY };
 
-  return result;
+  return withDocId(result);
 })()
 `;
 }

package/dist/extension/inpage/builders.js.map

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