1/**
2 * Browser-side DOM helpers for Impeccable live mode.
3 *
4 * Kept separate from live-browser.js so future browser script parts can share
5 * chrome mounting, lookup, focus, and picker helpers without depending on the
6 * full overlay UI bundle.
7 */
8(function (root) {
9  'use strict';
10  if (!root) return;
11 
12  function createLiveBrowserDomHelpers({
13    prefix,
14    skipTags,
15    document: doc = root.document,
16    css = root.CSS,
17    crypto = root.crypto,
18  } = {}) {
19    if (!prefix) throw new Error('prefix required');
20    if (!doc) throw new Error('document required');
21    const tagsToSkip = skipTags || new Set();
22 
23    function own(el) {
24      return el && (el.id?.startsWith(prefix) || el.closest?.('[id^="' + prefix + '"]'));
25    }
26 
27    function pickable(el) {
28      if (!el || el.nodeType !== 1) return false;
29      if (tagsToSkip.has(String(el.tagName || '').toLowerCase())) return false;
30      if (own(el)) return false;
31      const r = el.getBoundingClientRect();
32      return r.width >= 20 && r.height >= 20;
33    }
34 
35    function desc(el) {
36      if (!el) return '';
37      let s = el.tagName.toLowerCase();
38      if (el.id) s += '#' + el.id;
39      else if (el.classList.length) s += '.' + [...el.classList].slice(0, 2).join('.');
40      return s;
41    }
42 
43    function rectIsUsableAnchor(rect) {
44      return !!rect && rect.width > 0.5 && rect.height > 0.5;
45    }
46 
47    function makeFrozenAnchor(el) {
48      if (!el || !el.getBoundingClientRect) return null;
49      const r = el.getBoundingClientRect();
50      if (!rectIsUsableAnchor(r)) return null;
51      const rect = {
52        x: r.x, y: r.y,
53        top: r.top, left: r.left,
54        right: r.right, bottom: r.bottom,
55        width: r.width, height: r.height,
56      };
57      return {
58        __impeccableFrozenAnchor: true,
59        tagName: el.tagName || 'DIV',
60        id: el.id || '',
61        classList: el.classList ? [...el.classList] : [],
62        hasAttribute: () => false,
63        getBoundingClientRect: () => rect,
64      };
65    }
66 
67    function id8() {
68      if (crypto?.randomUUID) return crypto.randomUUID().replace(/-/g, '').slice(0, 8);
69      return (Math.random().toString(16).slice(2) + Date.now().toString(16)).slice(0, 8);
70    }
71 
72    function cssId(id) {
73      if (css?.escape) return css.escape(id);
74      return String(id).replace(/([ !"#$%&'()*+,./:;<=>?@[\\\]^`{|}~])/g, '\\$1');
75    }
76 
77    function liveUiRoot() {
78      const uiRoot = root.__IMPECCABLE_LIVE_UI_ROOT__;
79      if (uiRoot && typeof uiRoot.appendChild === 'function') return uiRoot;
80      return doc.body;
81    }
82 
83    function uiAppend(el) {
84      liveUiRoot().appendChild(el);
85      return el;
86    }
87 
88    function uiAppendStyle(styleEl) {
89      const uiRoot = liveUiRoot();
90      if (uiRoot && uiRoot !== doc.body) uiRoot.appendChild(styleEl);
91      else doc.head.appendChild(styleEl);
92      return styleEl;
93    }
94 
95    function uiGetById(id) {
96      const uiRoot = liveUiRoot();
97      if (uiRoot?.getElementById) {
98        const found = uiRoot.getElementById(id);
99        if (found) return found;
100      }
101      if (uiRoot?.querySelector) {
102        const found = uiRoot.querySelector('#' + cssId(id));
103        if (found) return found;
104      }
105      return doc.getElementById(id);
106    }
107 
108    function activeElementDeep() {
109      let active = doc.activeElement;
110      while (active?.shadowRoot?.activeElement) active = active.shadowRoot.activeElement;
111      return active;
112    }
113 
114    function defangOutsideHandlers(rootEl, { setPointerEvents = true } = {}) {
115      if (!rootEl) return;
116      if (setPointerEvents) {
117        rootEl.style.setProperty('pointer-events', 'auto', 'important');
118      }
119      const stop = (e) => e.stopPropagation();
120      rootEl.addEventListener('pointerdown', stop);
121      rootEl.addEventListener('mousedown', stop);
122      rootEl.addEventListener('focusin', stop);
123    }
124 
125    return {
126      own,
127      pickable,
128      desc,
129      rectIsUsableAnchor,
130      makeFrozenAnchor,
131      id8,
132      cssId,
133      liveUiRoot,
134      uiAppend,
135      uiAppendStyle,
136      uiGetById,
137      activeElementDeep,
138      defangOutsideHandlers,
139    };
140  }
141 
142  root.__IMPECCABLE_LIVE_DOM__ = {
143    version: 1,
144    createLiveBrowserDomHelpers,
145  };
146})(typeof window !== 'undefined' ? window : globalThis);
147