browser-debugger-cli 0.11.0 → 0.12.0

package/dist/runtime/dom/inspectScripts.js

@@ -29,26 +29,105 @@ const FLAT_TREE_JS = `(view) => {
     while (p && style(p).display === 'contents') p = flatParent(p);
     return p;
   };
+  const via = new WeakMap();
+  const label = (n) => n.localName + (n.id ? '#' + n.id : n.classList && n.classList.length ? '.' + n.classList[0] : '');
+  const slotText = (slot) => slot.assignedNodes({ flatten: true }).some((t) => t.nodeType === 3 && t.data.trim() !== '');
   const children = (n) => {
     const out = [];
-    const add = (c) => {
+    const add = (c, through) => {
       if (skipped.test(c.localName)) return;
       if (c.localName === 'slot') {
         const assigned = c.assignedElements({ flatten: true });
-        (assigned.length ? assigned : Array.from(c.children)).forEach(add);
+        if (assigned.length === 0 && slotText(c)) out.push(c);
+        else (assigned.length ? assigned : Array.from(c.children)).forEach((a) => add(a, label(c)));
       } else if (style(c).display === 'contents') {
-        Array.from((c.shadowRoot || c).children).forEach(add);
+        Array.from((c.shadowRoot || c).children).forEach((a) => add(a, label(c) + ' (contents)'));
       } else {
+        if (through) via.set(c, through);
         out.push(c);
       }
     };
-    Array.from((n.shadowRoot || n).children).forEach(add);
+    Array.from((n.shadowRoot || n).children).forEach((c) => add(c, null));
     return out;
   };
   const rendered = (n) => n.getClientRects().length > 0 &&
     (!n.checkVisibility || n.checkVisibility({ visibilityProperty: true }));
   const container = (n) => children(n).some((c) => rendered(c) && !/^inline/.test(style(c).display));
-  return { style, flatParent, layoutParent, children, rendered, container };
+  return { style, skipped, flatParent, layoutParent, children, rendered, container, label, via, slotText };
+}`;
+/**
+ * Page-side holder of an element's text: the element whose styles draw most
+ * of the visible text in its flat tree (characters, whitespace aside), and
+ * the element whose child text nodes those are (for the rendered font).
+ * Text slotted into a shadow root is drawn with the slot's styles, and text
+ * of an element with a shadow root that is not slotted is not drawn. Null
+ * when there is no visible text.
+ */
+const TEXT_HOLDER_JS = `(el, tree) => {
+  const counts = new Map();
+  const parents = new Map();
+  let budget = 2000;
+  const shown = (n) => tree.style(n).display === 'contents' || tree.rendered(n);
+  const nodesOf = (n) => {
+    if (n.localName !== 'slot') return Array.from((n.shadowRoot || n).childNodes);
+    const assigned = n.assignedNodes({ flatten: true });
+    return assigned.length ? assigned : Array.from(n.childNodes);
+  };
+  const visit = (n) => {
+    if (budget-- <= 0) return;
+    for (const c of nodesOf(n)) {
+      if (budget <= 0) return;
+      if (c.nodeType === 3) {
+        const length = c.data.replace(/\\s+/g, '').length;
+        if (length === 0) continue;
+        counts.set(n, (counts.get(n) || 0) + length);
+        if (!parents.has(n)) parents.set(n, c.parentElement || n);
+      } else if (c.nodeType === 1 && !tree.skipped.test(c.localName) && shown(c)) {
+        visit(c);
+      }
+    }
+  };
+  visit(el);
+  let best = null;
+  for (const [holder, length] of counts) if (!best || length > counts.get(best)) best = holder;
+  let total = 0;
+  for (const length of counts.values()) total += length;
+  return best && { style: best, font: parents.get(best), share: counts.get(best) / total };
+}`;
+/**
+ * Page-side: whether loaded `@font-face` (or `FontFace`) faces of the first
+ * family of an element's `font-family` cover the characters of its text
+ * (their `unicode-range`): then that web font draws the text, whatever
+ * name its file gives. A subset that lacks the text's characters (latin
+ * loaded, Cyrillic text) does not count.
+ */
+const FAMILY_LOADED_JS = `(n, tree, text) => {
+  const unquote = (name) => name.trim().replace(/^["']|["']$/g, '').toLowerCase();
+  const match = /^\\s*("[^"]*"|'[^']*'|[^,]*)/.exec(tree.style(n).fontFamily);
+  const first = unquote(match ? match[1] : '');
+  if (!first || !n.ownerDocument.fonts) return false;
+  const ranges = [];
+  for (const face of n.ownerDocument.fonts) {
+    if (face.status !== 'loaded' || unquote(face.family) !== first) continue;
+    for (const part of face.unicodeRange.split(',')) {
+      const [from, to] = part.trim().replace(/^U\\+/i, '').split('-');
+      const low = parseInt(from.replace(/\\?/g, '0'), 16);
+      const high = parseInt((to || from).replace(/\\?/g, 'F'), 16);
+      if (!Number.isNaN(low) && !Number.isNaN(high)) ranges.push([low, high]);
+    }
+  }
+  if (ranges.length === 0) return false;
+  const covered = (code) => ranges.some(([low, high]) => code >= low && code <= high);
+  return Array.from(text.replace(/\\s+/g, '')).every((char) => covered(char.codePointAt(0)));
+}`;
+/**
+ * Page-side: whether a form control draws text of its own (a text field,
+ * a select, a button-like input); checkboxes, radios, ranges and color
+ * inputs do not. Buttons are not covered: their text is their content.
+ */
+const TEXT_CONTROL_JS = `(el) => {
+  if (el.localName === 'textarea' || el.localName === 'select') return true;
+  return el.localName === 'input' && !/^(checkbox|radio|range|color|hidden|image)$/.test(el.type);
 }`;
 /**
  * Page-side text of an element: a form control's value or a select's chosen
@@ -100,14 +179,19 @@ const PLACEMENT_JS = `(el, tree) => {
   const r = el.getBoundingClientRect();
   const p = parent.getBoundingClientRect();
   const ps = tree.style(parent);
-  const edge = (side) => parseFloat(ps['border-' + side + '-width']) + parseFloat(ps['padding-' + side]);
+  const zoom = parent.currentCSSZoom || 1;
+  const edge = (side) => (parseFloat(ps['border-' + side + '-width']) + parseFloat(ps['padding-' + side])) * zoom;
   const inParent = {
     left: r.left - (p.left + edge('left')),
     top: r.top - (p.top + edge('top')),
     right: (p.right - edge('right')) - r.right,
     bottom: (p.bottom - edge('bottom')) - r.bottom
   };
-  const inFlow = (n) => n !== el && tree.rendered(n) && !/^(absolute|fixed)$/.test(tree.style(n).position);
+  const inFlow = (n) => {
+    if (n === el || !tree.rendered(n) || /^(absolute|fixed)$/.test(tree.style(n).position)) return false;
+    const box = n.getBoundingClientRect();
+    return box.width > 0 || box.height > 0;
+  };
   const siblings = tree.children(parent);
   const at = siblings.indexOf(el);
   const before = siblings.slice(0, Math.max(at, 0)).reverse().find(inFlow);
@@ -135,8 +219,10 @@ const BACKGROUNDS_JS = `(el, tree, view) => {
   let opacity = 1;
   for (let n = el; n && backgrounds.length < 60; n = tree.flatParent(n)) {
     const s = tree.style(n);
-    backgrounds.push({ color: s.backgroundColor, image: s.backgroundImage !== 'none' });
-    opacity *= Number(s.opacity) || 0;
+    const own = Number(s.opacity) || 0;
+    const background = { color: s.backgroundColor, image: s.backgroundImage !== 'none' };
+    backgrounds.push(own < 1 ? Object.assign(background, { opacity: own }) : background);
+    opacity *= own;
   }
   const doc = el.ownerDocument;
   const meta = doc.querySelector('meta[name="color-scheme"]');
@@ -146,6 +232,61 @@ const BACKGROUNDS_JS = `(el, tree, view) => {
   const canvasDark = /dark/.test(scheme) && (!/light/.test(scheme) || prefersDark);
   return { backgrounds: backgrounds, canvasDark: canvasDark, opacity: opacity };
 }`;
+/**
+ * Page-side reasons the contrast of an element's text is approximate: a
+ * blend mode or filter on it or an ancestor, and, hit-testing the middle of
+ * its first line of text (else of its first box; only in the viewport), the
+ * nearest element below it that is not an ancestor, above the first opaque
+ * background of its own chain, and
+ * paints (a canvas, video, image, background) and the nearest one on top of
+ * it that paints (an overlay).
+ */
+const PAINT_RISKS_JS = `(el, tree, textParent) => {
+  const risks = [];
+  const chain = [];
+  for (let n = el; n && chain.length < 60; n = tree.flatParent(n)) chain.push(n);
+  for (const n of chain) {
+    const s = tree.style(n);
+    if (s.mixBlendMode !== 'normal') risks.push('mix-blend-mode ' + s.mixBlendMode + ' on ' + tree.label(n));
+    if (s.filter !== 'none') risks.push('filter on ' + tree.label(n));
+  }
+  const textNode = Array.from(textParent.childNodes).find((c) => c.nodeType === 3 && c.data.trim() !== '');
+  const range = el.ownerDocument.createRange();
+  if (textNode) range.selectNodeContents(textNode);
+  const box = tree.style(el).display === 'contents' ? tree.layoutParent(el) : el;
+  const rect = (textNode && range.getClientRects()[0]) || (box && box.getClientRects()[0]);
+  const view = el.ownerDocument.defaultView;
+  if (!rect) return risks;
+  const x = rect.left + rect.width / 2;
+  const y = rect.top + rect.height / 2;
+  if (x < 0 || y < 0 || x >= view.innerWidth || y >= view.innerHeight) return risks;
+  const root = el.getRootNode();
+  const hits = (root.elementsFromPoint ? root : el.ownerDocument).elementsFromPoint(x, y);
+  const at = hits.findIndex((h) => chain.includes(h));
+  if (at < 0) return risks;
+  const clear = (color) => color === 'transparent' || /^rgba\\(.*,\\s*0\\)$/.test(color) || /\\/\\s*0\\)$/.test(color);
+  const opaque = (n) => {
+    const s = tree.style(n);
+    return /^rgb\\(/.test(s.backgroundColor) && s.backgroundImage === 'none' && Number(s.opacity) === 1;
+  };
+  const paints = (n) => {
+    const s = tree.style(n);
+    return /^(canvas|video|img|iframe|embed|object|svg)$/.test(n.localName) || s.backgroundImage !== 'none' || !clear(s.backgroundColor);
+  };
+  let behind = null;
+  for (const h of hits.slice(at)) {
+    if (chain.includes(h)) {
+      if (opaque(h)) break;
+    } else if (paints(h)) {
+      behind = h;
+      break;
+    }
+  }
+  if (behind) risks.push(tree.label(behind) + ' behind');
+  const onTop = hits.slice(0, at).find((h) => !el.contains(h) && paints(h));
+  if (onTop) risks.push(tree.label(onTop) + ' on top');
+  return risks;
+}`;
 /**
  * Page-side child tree to `depth` levels: per element its label, size,
  * display, position relative to its parent's border box (like Figma's x/y
@@ -157,9 +298,8 @@ const BACKGROUNDS_JS = `(el, tree, view) => {
 const TREE_JS = `(el, tree, textOf, depth) => {
   let budget = ${TREE_NODE_CAP};
   let skipped = 0;
-  const labelOf = (n) => n.localName + (n.id ? '#' + n.id : n.classList && n.classList.length ? '.' + n.classList[0] : '');
   const walk = (kids, level, origin) => {
-    const shown = kids.filter(tree.rendered);
+    const shown = kids.filter((k) => tree.rendered(k) || k.localName === 'slot');
     const nodes = [];
     for (const k of shown) {
       if (budget <= 0) { skipped++; continue; }
@@ -170,7 +310,13 @@ const TREE_JS = `(el, tree, textOf, depth) => {
   };
   const nodeOf = (n, level, origin) => {
     const r = n.getBoundingClientRect();
-    const node = { label: labelOf(n), x: r.left - origin.left, y: r.top - origin.top, w: r.width, h: r.height, display: tree.style(n).display };
+    const node = { label: tree.label(n), x: r.left - origin.left, y: r.top - origin.top, w: r.width, h: r.height, display: tree.style(n).display };
+    if (tree.via.has(n)) node.via = tree.via.get(n);
+    if (n.parentNode && n.parentNode.nodeType === 11 && n.parentNode.host) node.shadow = true;
+    if (n.localName === 'slot') {
+      node.text = n.assignedNodes({ flatten: true }).map((t) => t.textContent).join(' ').replace(/\\s+/g, ' ').trim().slice(0, 60);
+      return node;
+    }
     const kids = tree.children(n);
     if (!tree.container(n)) node.text = textOf(n).slice(0, 60);
     if (level >= depth) {
@@ -186,12 +332,49 @@ const TREE_JS = `(el, tree, textOf, depth) => {
   const top = walk(tree.children(el), 1, el.getBoundingClientRect());
   return { tree: top.nodes, hiddenChildren: top.hidden, treeSkipped: skipped };
 }`;
+/**
+ * Page-side: rules for the element that set a property but sit under a
+ * `@media` or `@supports` condition that does not apply now (at most 5),
+ * from same-origin, `@import`ed, constructed and shadow-root stylesheets.
+ */
+const INACTIVE_RULES_JS = `(el, names) => {
+  const view = el.ownerDocument.defaultView;
+  const found = [];
+  let budget = 20000;
+  const unmet = (rule) => {
+    if (rule.media && rule.media.mediaText && !view.matchMedia(rule.media.mediaText).matches) return '@media ' + rule.media.mediaText;
+    if (typeof CSSSupportsRule !== 'undefined' && rule instanceof CSSSupportsRule && !CSS.supports(rule.conditionText)) return '@supports ' + rule.conditionText;
+    return null;
+  };
+  const sets = (rule) => names.map((name) => rule.style.getPropertyValue(name).trim()).find((value) => value !== '');
+  const matches = (selector) => {
+    try { return el.matches(selector); } catch (e) { return false; }
+  };
+  const visit = (rules, condition) => {
+    for (const rule of Array.from(rules)) {
+      if (budget-- <= 0 || found.length >= 5) return;
+      if (typeof CSSImportRule !== 'undefined' && rule instanceof CSSImportRule) {
+        try { if (rule.styleSheet) visit(rule.styleSheet.cssRules, condition); } catch (e) { continue; }
+        continue;
+      }
+      const value = condition && rule.style && rule.selectorText ? sets(rule) : undefined;
+      if (value !== undefined && matches(rule.selectorText)) found.push({ selector: rule.selectorText, condition: condition, value: value });
+      if (rule.cssRules) visit(rule.cssRules, condition || unmet(rule));
+    }
+  };
+  for (const scope of new Set([el.getRootNode(), el.ownerDocument])) {
+    for (const sheet of [...Array.from(scope.styleSheets || []), ...Array.from(scope.adoptedStyleSheets || [])]) {
+      try { visit(sheet.cssRules, null); } catch (e) { continue; }
+    }
+  }
+  return found;
+}`;
 /**
  * Page-side function run on the element (`this`), see {@link RawInspect}.
- * Arguments: tree depth, and the property names asked for with `--props`
- * (or null).
+ * Arguments: tree depth, the property names asked for with `--props` (or
+ * null) and the `--why` property (or null).
  */
-export const INSPECT_PAGE_JS = `function (depth, props) {
+export const INSPECT_PAGE_JS = `function (depth, props, why) {
   const el = this;
   const view = el.ownerDocument.defaultView;
   const tree = (${FLAT_TREE_JS})(view);
@@ -199,6 +382,11 @@ export const INSPECT_PAGE_JS = `function (depth, props) {
   const describe = ${ELEMENT_DESCRIPTION_JS};
   const s = tree.style(el);
   const formControl = /^(input|textarea|select|button)$/.test(el.localName);
+  const textControl = (${TEXT_CONTROL_JS})(el);
+  const holder = textControl ? null : (${TEXT_HOLDER_JS})(el, tree);
+  const textChildren = tree.children(el).filter((c) => tree.rendered(c) && (c.textContent || '').trim() !== '').length;
+  const textual = textControl || Boolean(holder && (holder.style === el || (holder.share >= 0.9 && textChildren <= 1) || !tree.container(el)));
+  const textFrom = holder && holder.style !== el ? holder.style : el;
   const content = textOf(el);
   const parent = tree.layoutParent(el);
   const typedMap = el.computedStyleMap ? el.computedStyleMap() : null;
@@ -209,15 +397,26 @@ export const INSPECT_PAGE_JS = `function (depth, props) {
     classes: el.classList ? Array.from(el.classList) : [],
     context: (${ELEMENT_CONTEXT_JS})(el),
     content: content,
-    textual: formControl || (content !== '' && !tree.container(el)),
+    textual: textual,
     formControl: formControl,
-    replaced: el instanceof SVGElement || /^(img|video|canvas|iframe|embed|object|input|textarea|select|button|meter|progress)$/.test(el.localName),
+    rendered: textual && textFrom !== el
+      ? tree.style(textFrom).visibility !== 'hidden' && tree.rendered(tree.style(textFrom).display === 'contents' ? tree.layoutParent(textFrom) : textFrom)
+      : tree.rendered(el),
+    hasText: textControl || holder !== null,
+    replaced: el instanceof SVGElement || /^(img|video|audio|canvas|iframe|embed|object|input|textarea|select|button|meter|progress)$/.test(el.localName),
     svg: el.namespaceURI === 'http://www.w3.org/2000/svg',
-    ownText: Array.from(el.childNodes).some((n) => n.nodeType === 3 && n.data.trim() !== ''),
     typed: { width: typed('width'), height: typed('height') },
     parent: parent ? describe(parent) : undefined,
-    animating: el.getAnimations ? [...new Set(el.getAnimations().filter((a) => a.playState === 'running').map((a) => a.transitionProperty || a.animationName || 'animation'))] : []
+    animating: el.getAnimations ? [...new Set(el.getAnimations().filter((a) => a.playState === 'running' && (!a.timeline || a.timeline === el.ownerDocument.timeline)).map((a) => a.transitionProperty || a.animationName || 'animation'))] : []
   };
+  if (textFrom !== el) result.textHolder = tree.label(textFrom);
+  const clipped = (n) => {
+    const cs = tree.style(n);
+    if (cs.overflowX !== 'visible' && n.scrollWidth > n.clientWidth + 1) return true;
+    return cs.webkitLineClamp !== 'none' && cs.overflowY !== 'visible' && n.scrollHeight > n.clientHeight + 1;
+  };
+  if (textual && !textControl && (clipped(el) || (textFrom !== el && clipped(textFrom)))) result.truncated = true;
+  if ((${FAMILY_LOADED_JS})(textFrom, tree, textOf(textFrom))) result.familyLoaded = true;
   if (/^(input|textarea)$/.test(el.localName) && el.placeholder && !el.value) {
     result.placeholder = el.placeholder.replace(/\\s+/g, ' ').trim();
     const placeholderStyle = tree.style(el, '::placeholder');
@@ -236,28 +435,115 @@ export const INSPECT_PAGE_JS = `function (depth, props) {
       return sides.map((side) => side.slice(name.length + 1) + ' ' + s.getPropertyValue(side).trim()).join(' / ');
     };
     result.props = Object.fromEntries(props.filter(known).map((name) => [name, valueOf(name)]));
+    result.rootFontSize = parseFloat(tree.style(el.ownerDocument.documentElement).fontSize) || 16;
     result.unknownProps = props.filter((name) => !known(name));
   }
+  if (why && !why.startsWith('--')) {
+    if (!CSS.supports(why, 'inherit')) result.unknownWhy = true;
+    else {
+      const probe = el.ownerDocument.createElement('div').style;
+      probe.setProperty(why, 'inherit');
+      if (probe.length > 1) {
+        result.whyLonghands = Array.from(probe);
+        result.whyComputed = s.getPropertyValue(why).trim();
+      }
+      const inactive = (${INACTIVE_RULES_JS})(el, [why].concat(result.whyLonghands || []));
+      if (inactive.length > 0) result.whyInactive = inactive;
+    }
+  }
   return Object.assign(result,
     (${PLACEMENT_JS})(el, tree),
-    (${BACKGROUNDS_JS})(el, tree, view),
+    (${BACKGROUNDS_JS})(textual ? textFrom : el, tree, view),
+    textual ? { paintRisks: (${PAINT_RISKS_JS})(textFrom, tree, holder ? holder.font : el) } : {},
     (${TREE_JS})(el, tree, textOf, depth));
 }`;
 /**
  * Page-side function run on the element (`this`) that returns another
  * element whose styles CDP reads: `"parent"`, the parent that lays it out
- * (`display: contents` skipped, through shadow roots and slots), or
- * `"textHolder"`, for an element whose text is in a descendant
- * (`<button><span>Buy</span></button>`), the first element holding text,
- * whose rendered font is the one shown. Null when there is none.
+ * (`display: contents` skipped, through shadow roots and slots),
+ * `"textHolder"`, the element whose styles draw most of its text
+ * ({@link TEXT_HOLDER_JS}; the element itself when that is its own text), or
+ * `"fontHolder"`, the parent of that text's nodes (for the rendered font: a
+ * slot's text nodes belong to the host's light DOM). Null when there is none.
  */
 export const RELATED_NODE_JS = `function (which) {
   const tree = (${FLAT_TREE_JS})(this.ownerDocument.defaultView);
   if (which === 'parent') return tree.layoutParent(this);
-  const walker = this.ownerDocument.createTreeWalker(this, NodeFilter.SHOW_TEXT);
-  while (walker.nextNode()) {
-    if (walker.currentNode.data.trim() !== '') return walker.currentNode.parentElement;
+  const holder = (${TEXT_HOLDER_JS})(this, tree);
+  if (!holder) return null;
+  return which === 'textHolder' ? holder.style : holder.font;
+}`;
+/**
+ * Page-side function run on the element (`this`): for each custom property
+ * name, a rule in the page's stylesheets (same-origin, `@import`ed,
+ * constructed and the element's shadow root's) that sets it, keyframes
+ * included: the first one that matches the element or an ancestor now
+ * (across shadow roots, so `:root` matches inside a component), else the
+ * first that would match without its state (`.btn:hover` for this `.btn`),
+ * else the first one, with the `@media`/`@supports` condition it is under
+ * when that does not apply. At most 20000 rules are read; cross-origin sheets are
+ * skipped.
+ */
+export const VARIABLE_SETTERS_JS = `function (names) {
+  const el = this;
+  const view = el.ownerDocument.defaultView;
+  const matching = {};
+  const related = {};
+  const other = {};
+  let budget = 20000;
+  const closestAcross = (selector) => {
+    for (let n = el; n; n = n.getRootNode().host || null) {
+      if (n.closest(selector)) return true;
+    }
+    return false;
+  };
+  const matches = (selector) => {
+    try { return closestAcross(selector); } catch (e) { return null; }
+  };
+  const stateless = (selector) => selector.replace(/:(focus-visible|focus-within|focus|hover|active|visited|checked|target|open)(?![\\w-])/g, '');
+  const applies = (rule) => {
+    if (rule.media && rule.media.mediaText && !view.matchMedia(rule.media.mediaText).matches) return '@media ' + rule.media.mediaText;
+    if (typeof CSSSupportsRule !== 'undefined' && rule instanceof CSSSupportsRule && !CSS.supports(rule.conditionText)) return '@supports ' + rule.conditionText;
+    return null;
+  };
+  const record = (name, rule, keyframes, condition) => {
+    const selector = keyframes ? '@keyframes ' + keyframes : rule.selectorText || '';
+    const match = keyframes || condition ? false : matches(selector);
+    const setter = Object.assign(
+      { selector: selector, value: rule.style.getPropertyValue(name).trim(), matches: match },
+      keyframes ? { keyframes: keyframes } : {},
+      condition ? { condition: condition } : {}
+    );
+    if (match && !matching[name]) matching[name] = setter;
+    else if (!match && !keyframes && !related[name] && matches(stateless(selector))) related[name] = setter;
+    else if (!match && !other[name]) other[name] = setter;
+  };
+  const visit = (rules, keyframes, condition) => {
+    for (const rule of Array.from(rules)) {
+      if (budget-- <= 0 || names.every((name) => matching[name])) return;
+      if (typeof CSSImportRule !== 'undefined' && rule instanceof CSSImportRule) {
+        try { if (rule.styleSheet) visit(rule.styleSheet.cssRules, keyframes, condition); } catch (e) { continue; }
+        continue;
+      }
+      if (typeof CSSKeyframesRule !== 'undefined' && rule instanceof CSSKeyframesRule) {
+        visit(rule.cssRules, rule.name, condition);
+        continue;
+      }
+      if (rule.style) {
+        for (const name of names) {
+          if (!matching[name] && Array.from(rule.style).includes(name)) record(name, rule, keyframes, condition);
+        }
+      }
+      if (rule.cssRules) visit(rule.cssRules, keyframes, condition || applies(rule));
+    }
+  };
+  const sheets = [];
+  for (const scope of new Set([el.getRootNode(), el.ownerDocument])) {
+    sheets.push(...Array.from(scope.styleSheets || []), ...Array.from(scope.adoptedStyleSheets || []));
+  }
+  for (const sheet of sheets) {
+    try { visit(sheet.cssRules, null, null); } catch (e) { continue; }
   }
-  return null;
+  return Object.assign({}, other, related, matching);
 }`;
 //# sourceMappingURL=inspectScripts.js.map

package/dist/runtime/dom/inspectTree.js

@@ -40,6 +40,9 @@ function toNode(raw) {
         h: Math.round(raw.h),
         ...(layout && { layout }),
         ...(raw.text && { text: rowText(raw.text) }),
+        ...(raw.display === 'contents' && { contents: true }),
+        ...(raw.via && { via: raw.via }),
+        ...(raw.shadow && { shadow: true }),
         ...(children && children.length > 0 && { children }),
         ...(raw.childCount && { childCount: raw.childCount }),
         ...(raw.hidden && { hiddenChildren: raw.hidden }),
@@ -50,10 +53,15 @@ function toNode(raw) {
  *
  * @param a - Row
  * @param b - Row
- * @returns True for the same label, size and layout
+ * @returns True for the same label, size, layout and path (slot, shadow root)
  */
 function identical(a, b) {
-    return a.element === b.element && a.w === b.w && a.h === b.h && a.layout === b.layout;
+    return (a.element === b.element &&
+        a.w === b.w &&
+        a.h === b.h &&
+        a.layout === b.layout &&
+        a.via === b.via &&
+        a.shadow === b.shadow);
 }
 /**
  * Group runs of identical siblings into one row with a count. A group keeps

package/dist/runtime/dom/inspectWhyModel.d.ts

@@ -8,6 +8,7 @@
 import type { InspectWhy } from '../../ipc/protocol/inspectTypes.js';
 import { type Resolution } from './inspectCascade.js';
 import type { CascadeInput, PropertyGroup } from './inspectCascadeModel.js';
+import type { CssHint } from './inspectHints.js';
 /**
  * `--why` for a property.
  *
@@ -16,5 +17,5 @@ import type { CascadeInput, PropertyGroup } from './inspectCascadeModel.js';
  * @param input - Matched rules, computed style and the label function
  * @returns One entry, or one per longhand when they differ
  */
-export declare function buildWhy(group: PropertyGroup, cascade: Map<string, Resolution>, input: CascadeInput): InspectWhy[];
+export declare function buildWhy(group: PropertyGroup, cascade: Map<string, Resolution>, input: CascadeInput, hints?: readonly CssHint[]): InspectWhy[];
 //# sourceMappingURL=inspectWhyModel.d.ts.map

package/dist/runtime/dom/inspectWhyModel.js

@@ -5,8 +5,8 @@
  * declaration sets all its longhands (listing every declaration it beats on
  * any of them), else one per longhand.
  */
-import { normalizeProperty } from './inspectAllStyles.js';
-import { resolveCascade } from './inspectCascade.js';
+import { collapsedValue, normalizeProperty } from './inspectAllStyles.js';
+import { isInherited, resolveCascade, ruleField, } from './inspectCascade.js';
 import { substituteVariables, unsetVariables, usedVariables, } from './inspectVariables.js';
 /**
  * `--why` for a property.
@@ -16,8 +16,8 @@ import { substituteVariables, unsetVariables, usedVariables, } from './inspectVa
  * @param input - Matched rules, computed style and the label function
  * @returns One entry, or one per longhand when they differ
  */
-export function buildWhy(group, cascade, input) {
-    const whys = group.longhands.map((longhand) => whyOf(longhand, cascade.get(longhand), input));
+export function buildWhy(group, cascade, input, hints = []) {
+    const whys = group.longhands.map((longhand) => whyOf(longhand, cascade.get(longhand), input, hints));
     const [first] = whys;
     if (!first || group.shorthand === undefined)
         return whys;
@@ -25,9 +25,13 @@ export function buildWhy(group, cascade, input) {
     if (!whys.every((why) => JSON.stringify(why.chain[0]) === winner))
         return whys;
     const values = whys.map((why) => why.computed);
-    const computed = values.every((value) => value === first.computed)
+    const joined = values.every((value) => value === first.computed)
         ? first.computed
         : values.join(' ');
+    const fromPage = input.whyComputed
+        ? normalizeProperty(group.shorthand, input.whyComputed)
+        : undefined;
+    const computed = collapsedValue(group.shorthand, input.style) ?? fromPage ?? joined;
     const beaten = whys.flatMap((why) => why.chain.slice(1));
     const overridden = [...new Map(beaten.map((entry) => [JSON.stringify(entry), entry])).values()];
     const chain = [...first.chain.slice(0, 1), ...overridden];
@@ -39,14 +43,14 @@ export function buildWhy(group, cascade, input) {
  * @param property - Longhand
  * @param resolution - Its resolution
  * @param input - Matched rules, computed style and the label function
+ * @param hints - Hints, for a winner that has no effect
  * @returns Why
  */
-function whyOf(property, resolution, input) {
+function whyOf(property, resolution, input, hints) {
     const winner = resolution?.winner;
+    const status = winner?.ancestor !== undefined ? 'inherited' : 'applied';
     const chain = [
-        ...(winner
-            ? [whyEntry(winner, winner.ancestor !== undefined ? 'inherited' : 'applied', input)]
-            : []),
+        ...(winner ? [withNote(whyEntry(winner, status, input), winner, property, hints)] : []),
         ...(resolution?.overridden ?? []).map((d) => whyEntry(d, 'overridden', input)),
     ];
     const variables = winner ? variableSources(winner, input) : [];
@@ -68,7 +72,10 @@ function whyOf(property, resolution, input) {
  * @returns Entry
  */
 function whyEntry(declaration, status, input) {
-    const value = declaration.via ? (declaration.written ?? declaration.value) : declaration.value;
+    const written = declaration.via ? (declaration.written ?? declaration.value) : declaration.value;
+    const value = written === ''
+        ? `${input.style[declaration.property] ?? ''} (set by the browser)`.trim()
+        : written;
     const unset = value.includes('var(') ? unsetVariables(value, input.style) : [];
     const resolved = value.includes('var(') ? resolvedValue(declaration, value, input) : value;
     const { specificity, layer, condition } = declaration.source;
@@ -77,6 +84,7 @@ function whyEntry(declaration, status, input) {
         ...(declaration.via && { via: declaration.via }),
         ...(unset.length > 0 ? { unset } : resolved !== value && { resolved }),
         source: input.label(declaration),
+        ...ruleField(declaration),
         ...(specificity && { specificity }),
         status,
         ...(declaration.important && { important: true }),
@@ -84,6 +92,40 @@ function whyEntry(declaration, status, input) {
         ...(condition && { condition }),
     };
 }
+/**
+ * The winner's entry with why it changes nothing: the hint that says it has
+ * no effect, or what applies instead of an invalid `var()`.
+ *
+ * @param entry - Winner's entry
+ * @param winner - Winning declaration
+ * @param property - Longhand
+ * @param hints - Hints
+ * @returns Entry, with `note` when there is one
+ */
+function withNote(entry, winner, property, hints) {
+    if (entry.unset) {
+        const fallback = isInherited(property) ? 'the inherited value' : 'the initial value';
+        return { ...entry, note: `falls back to ${fallback}` };
+    }
+    const inactive = hints.find((hint) => hint.kind === 'inactive' &&
+        sameDeclaration(hint.declaration, winner) &&
+        (hint.only?.includes(property) ?? true));
+    return inactive ? { ...entry, note: `no effect: ${inactive.reason}` } : entry;
+}
+/**
+ * Whether two longhand declarations come from the same declaration as written.
+ *
+ * @param a - Declaration
+ * @param b - Declaration
+ * @returns True for the same place and property
+ */
+function sameDeclaration(a, b) {
+    return (a.source.kind === b.source.kind &&
+        a.source.styleSheetId === b.source.styleSheetId &&
+        a.source.line === b.source.line &&
+        a.source.column === b.source.column &&
+        (a.via ?? a.property) === (b.via ?? b.property));
+}
 /** How many levels of custom properties set from others are followed */
 const MAX_VARIABLE_DEPTH = 5;
 /**