hyperframes 0.8.141 → 0.8.143

package/dist/cli.js

@@ -9,8 +9,10 @@ import {
   registerRunningCli
 } from "./chunk-NXMYHJAL.js";
 import {
-  isTextFile
-} from "./chunk-K4WKGXRC.js";
+  assertKnownFlags,
+  resolveExtraPositionals
+} from "./chunk-KJJLA674.js";
+import "./chunk-K4WKGXRC.js";
 import {
   isRenderSucceeded
 } from "./chunk-L3YOGIPG.js";
@@ -34,7 +36,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-W6HTOVHU.js";
+} from "./chunk-W35EKBS6.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/cli.ts
@@ -42,110 +44,6 @@ import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import { existsSync } from "fs";
 
-// src/utils/reject-extra-positionals.ts
-var ACCEPTS_EXTRA_POSITIONALS = /* @__PURE__ */ new Set([
-  "compare",
-  "figma asset",
-  "skills update",
-  "timeline set"
-]);
-var JOINS_EXTRA_POSITIONALS = /* @__PURE__ */ new Set(["catalog", "tts"]);
-var EXTRA_POSITIONAL_HINTS = {
-  add: "Run add once per item, or pass a single tag to install every item tagged with it."
-};
-function wantsJson(value) {
-  return value === true || typeof value === "string" && value !== "false" && value !== "0";
-}
-function declaredArgs(cmd) {
-  const raw = cmd.args;
-  return raw && typeof raw === "object" ? raw : {};
-}
-function usageLine(path, args) {
-  const parts = ["hyperframes", path];
-  let hasOptions = false;
-  for (const [name, def] of Object.entries(args)) {
-    if (def.type !== "positional") {
-      hasOptions = true;
-      continue;
-    }
-    const optional = def.required === false || def.default !== void 0;
-    parts.push(optional ? `[${name.toUpperCase()}]` : `<${name.toUpperCase()}>`);
-  }
-  if (hasOptions) parts.push("[OPTIONS]");
-  return parts.join(" ");
-}
-function resolveExtraPositionals(cmd, path, parsed) {
-  if (ACCEPTS_EXTRA_POSITIONALS.has(path)) return;
-  const args = declaredArgs(cmd);
-  const positionals = Object.entries(args).filter(([, def]) => def.type === "positional");
-  const given = (Array.isArray(parsed?._) ? parsed._ : []).map(String);
-  const extra = given.slice(positionals.length);
-  if (extra.length === 0) return;
-  const last = positionals.at(-1)?.[0];
-  const words = given.slice(positionals.length - 1);
-  const ttsFile = path === "tts" && isTextFile(words[0]);
-  if (parsed && last && JOINS_EXTRA_POSITIONALS.has(path) && !ttsFile) {
-    parsed[last] = words.join(" ");
-    return;
-  }
-  const plural = extra.length === 1 ? "" : "s";
-  const message = `Unexpected extra argument${plural} for hyperframes ${path}: ${extra.join(", ")}
-Usage: ${usageLine(path, args)}` + (EXTRA_POSITIONAL_HINTS[path] ? `
-${EXTRA_POSITIONAL_HINTS[path]}` : "");
-  if (wantsJson(parsed?.json)) console.log(JSON.stringify({ ok: false, error: message }));
-  else console.error(message);
-  throw new CliUsageError(
-    `${extra.length} unexpected extra argument${plural} for hyperframes ${path}`,
-    {
-      presented: true
-    }
-  );
-}
-
-// src/utils/reject-unknown-flags.ts
-var ALWAYS_KNOWN = /* @__PURE__ */ new Set(["help", "h", "version", "v", "json"]);
-function nameVariants(name) {
-  const kebab = name.replace(/[A-Z]/g, (c) => "-" + c.toLowerCase());
-  const camel = name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-  return [name, kebab, camel];
-}
-function knownFlags(args) {
-  const known = new Set(ALWAYS_KNOWN);
-  for (const [name, def] of Object.entries(args ?? {})) {
-    for (const v of nameVariants(name)) known.add(v);
-    const alias = def?.alias;
-    if (typeof alias === "string") known.add(alias);
-    else if (Array.isArray(alias)) for (const a of alias) known.add(a);
-  }
-  return known;
-}
-function longFlagName(tok) {
-  const name = tok.slice(2).split("=")[0] ?? "";
-  return name.startsWith("no-") ? name.slice(3) : name;
-}
-function unknownFlagIn(tok, known) {
-  if (tok === "-" || !tok.startsWith("-")) return null;
-  if (tok.startsWith("--")) {
-    const name = longFlagName(tok);
-    return name && !known.has(name) ? `--${name}` : null;
-  }
-  for (const ch of tok.slice(1).split("=")[0] ?? "") {
-    if (!known.has(ch)) return `-${ch}`;
-  }
-  return null;
-}
-function assertKnownFlags(cmd, rawArgs) {
-  if (!Array.isArray(rawArgs)) return;
-  const rawDef = cmd.args;
-  const args = rawDef && typeof rawDef === "object" ? rawDef : void 0;
-  const known = knownFlags(args);
-  for (const tok of rawArgs) {
-    if (tok === "--") break;
-    const bad = unknownFlagIn(tok, known);
-    if (bad) throw new Error(`Unknown flag: ${bad}`);
-  }
-}
-
 // src/utils/command-failure-tracking.ts
 function trackCommandFailures(load) {
   return () => load().then((cmd) => wrapCommand(cmd, commandName(cmd)));
@@ -181,7 +79,7 @@ function wrapCommand(cmd, path) {
 }
 async function reportCommandFailure(command2, err) {
   try {
-    const { trackCommandFailure } = await import("./events-YFFXKAQQ.js");
+    const { trackCommandFailure } = await import("./events-NIZBS6S7.js");
     trackCommandFailure(command2, err);
   } catch {
   }
@@ -253,54 +151,54 @@ async function assertStudioWorkspaceBuilt() {
   });
 }
 var commandLoaders = {
-  init: () => import("./init-BGHSDODI.js").then((m) => m.default),
-  add: () => import("./add-KH2CF4FD.js").then((m) => m.default),
-  catalog: () => import("./catalog-4S33QWJJ.js").then((m) => m.default),
+  init: () => import("./init-OSDMJZJV.js").then((m) => m.default),
+  add: () => import("./add-Q5EYDUAY.js").then((m) => m.default),
+  catalog: () => import("./catalog-RKORTIUE.js").then((m) => m.default),
   "media-use": () => import("./media-use-4XXGABIL.js").then((m) => m.default),
-  play: () => import("./play-DSELK7G3.js").then((m) => m.default),
-  present: () => import("./present-N72YFDKP.js").then((m) => m.default),
-  preview: () => assertStudioWorkspaceBuilt().then(() => import("./preview-XTYN4NJ2.js").then((m) => m.default)),
-  publish: () => import("./publish-3XEEFWMF.js").then((m) => m.default),
-  open: () => import("./open-VVISXIII.js").then((m) => m.default),
-  "catch-up": () => import("./catch-up-RW7YXXNT.js").then((m) => m.default),
-  render: () => import("./render-2DVYTVLQ.js").then((m) => m.default),
-  lint: () => import("./lint-FQ6CEI7E.js").then((m) => m.default),
-  check: () => import("./check-XVTRRN4Y.js").then((m) => m.default),
-  beats: () => import("./beats-XJ7WP6QS.js").then((m) => m.default),
-  "normalize-audio": () => import("./normalize-audio-C2IM7OID.js").then((m) => m.default),
-  inspect: () => import("./inspect-MZK5B5RP.js").then((m) => m.default),
-  keyframes: () => import("./keyframes-2EBF7OSS.js").then((m) => m.default),
-  layout: () => import("./layout-TP5ERKEF.js").then((m) => m.default),
-  info: () => import("./info-I2VDAWT7.js").then((m) => m.default),
-  compositions: () => import("./compositions-B5GQSXH7.js").then((m) => m.default),
-  timeline: () => import("./timeline-6UV3JJXD.js").then((m) => m.default),
-  history: () => import("./history-2S42ZXKL.js").then((m) => m.default),
-  benchmark: () => import("./benchmark-HCGFBEZJ.js").then((m) => m.default),
-  browser: () => import("./browser-VQKO2FKG.js").then((m) => m.default),
-  "remove-background": () => import("./remove-background-2QKJ7XOD.js").then((m) => m.default),
-  transcribe: () => import("./transcribe-V7F6QDSN.js").then((m) => m.default),
+  play: () => import("./play-NBH4B7PL.js").then((m) => m.default),
+  present: () => import("./present-XAX55CFS.js").then((m) => m.default),
+  preview: () => assertStudioWorkspaceBuilt().then(() => import("./preview-OLANKNFA.js").then((m) => m.default)),
+  publish: () => import("./publish-4VBWP2UB.js").then((m) => m.default),
+  open: () => import("./open-AKQTGNXF.js").then((m) => m.default),
+  "catch-up": () => import("./catch-up-4OBERRQO.js").then((m) => m.default),
+  render: () => import("./render-TSE75QUL.js").then((m) => m.default),
+  lint: () => import("./lint-PLXOXY5R.js").then((m) => m.default),
+  check: () => import("./check-P2XDN57S.js").then((m) => m.default),
+  beats: () => import("./beats-U6KJWF35.js").then((m) => m.default),
+  "normalize-audio": () => import("./normalize-audio-MQ7NFCOV.js").then((m) => m.default),
+  inspect: () => import("./inspect-RQQSAYIJ.js").then((m) => m.default),
+  keyframes: () => import("./keyframes-V75Q6GRM.js").then((m) => m.default),
+  layout: () => import("./layout-IZAI5SFC.js").then((m) => m.default),
+  info: () => import("./info-TXV7MLFO.js").then((m) => m.default),
+  compositions: () => import("./compositions-OQNZZTKF.js").then((m) => m.default),
+  timeline: () => import("./timeline-VQ34WH7J.js").then((m) => m.default),
+  history: () => import("./history-D65XFJ6D.js").then((m) => m.default),
+  benchmark: () => import("./benchmark-5ONT7V7B.js").then((m) => m.default),
+  browser: () => import("./browser-R4DU46IE.js").then((m) => m.default),
+  "remove-background": () => import("./remove-background-REB7427G.js").then((m) => m.default),
+  transcribe: () => import("./transcribe-XOHPPL2O.js").then((m) => m.default),
   usage: () => import("./usage-EC3KFUIJ.js").then((m) => m.default),
-  models: () => import("./models-GOD6ARB3.js").then((m) => m.default),
-  tts: () => import("./tts-TOHSPWEG.js").then((m) => m.default),
+  models: () => import("./models-CEZM6XZ7.js").then((m) => m.default),
+  tts: () => import("./tts-MUV42JXT.js").then((m) => m.default),
   docs: () => import("./docs-MPOM3PHH.js").then((m) => m.default),
-  doctor: () => import("./doctor-PJX7MLFG.js").then((m) => m.default),
-  clean: () => import("./clean-L2E4VD57.js").then((m) => m.default),
-  upgrade: () => import("./upgrade-BX3KDDZJ.js").then((m) => m.default),
-  skills: () => import("./skills-ICJ22CZZ.js").then((m) => m.default),
-  feedback: () => import("./feedback-UETLWREV.js").then((m) => m.default),
+  doctor: () => import("./doctor-UOL3OI2A.js").then((m) => m.default),
+  clean: () => import("./clean-YHGPY33K.js").then((m) => m.default),
+  upgrade: () => import("./upgrade-NBNOT7J2.js").then((m) => m.default),
+  skills: () => import("./skills-I65FU5HD.js").then((m) => m.default),
+  feedback: () => import("./feedback-QMP4E6L7.js").then((m) => m.default),
   telemetry: () => import("./telemetry-W5AKPI4R.js").then((m) => m.default),
-  events: () => import("./events-SBC54MHO.js").then((m) => m.default),
-  validate: () => import("./validate-7UX4I443.js").then((m) => m.default),
-  snapshot: () => import("./snapshot-XHKOAWF4.js").then((m) => m.default),
-  "media-treatment": () => import("./media-treatment-DCANGWSV.js").then((m) => m.mediaTreatmentCommand),
-  "grade-compare": () => import("./grade-compare-LBIHMAUN.js").then((m) => m.default),
-  compare: () => import("./compare-VYBWSP3Y.js").then((m) => m.default),
-  capture: () => import("./capture-XD3P3YQR.js").then((m) => m.default),
-  lambda: () => import("./lambda-XKFPAOFE.js").then((m) => m.default),
-  cloudrun: () => import("./cloudrun-R3JXWXGG.js").then((m) => m.default),
-  cloud: () => import("./cloud-IDUQRYLO.js").then((m) => m.default),
-  auth: () => import("./auth-WYQCOYE5.js").then((m) => m.default),
-  figma: () => import("./figma-QDSJPIRW.js").then((m) => m.default)
+  events: () => import("./events-K2DB2PBC.js").then((m) => m.default),
+  validate: () => import("./validate-Y2QDHAEP.js").then((m) => m.default),
+  snapshot: () => import("./snapshot-YROOGY22.js").then((m) => m.default),
+  "media-treatment": () => import("./media-treatment-PXGMZ4A4.js").then((m) => m.mediaTreatmentCommand),
+  "grade-compare": () => import("./grade-compare-HV5AFZ6P.js").then((m) => m.default),
+  compare: () => import("./compare-SMMIZN2C.js").then((m) => m.default),
+  capture: () => import("./capture-OGQAEYKO.js").then((m) => m.default),
+  lambda: () => import("./lambda-RODV4RCX.js").then((m) => m.default),
+  cloudrun: () => import("./cloudrun-KTZ4XDHL.js").then((m) => m.default),
+  cloud: () => import("./cloud-DOFI5ISR.js").then((m) => m.default),
+  auth: () => import("./auth-FRWLCO36.js").then((m) => m.default),
+  figma: () => import("./figma-2AUJRNVC.js").then((m) => m.default)
 };
 var subCommands = Object.fromEntries(
   Object.entries(commandLoaders).map(([name, load]) => [name, trackCommandFailures(load)])
@@ -324,7 +222,7 @@ var _printStalePinNotice;
 var _printSkillsUpdateNotice;
 var telemetryReady = Promise.resolve();
 if (!isHelp && command !== "telemetry" && command !== "events" && command !== "usage" && command !== "unknown") {
-  telemetryReady = import("./telemetry-65LFHIWH.js").then((mod) => {
+  telemetryReady = import("./telemetry-CXAX3TO3.js").then((mod) => {
     _flushSync = mod.flushSync;
     _trackCliError = mod.trackCliError;
     _trackCommandResult = mod.trackCommandResult;
@@ -334,23 +232,23 @@ if (!isHelp && command !== "telemetry" && command !== "events" && command !== "u
   });
 }
 if (!isHelp && !hasJsonFlag && command !== "upgrade" && command !== "events" && command !== "telemetry" && command !== "skills" && command !== "usage") {
-  import("./autoUpdate-PC5TN3NL.js").then((mod) => mod.reportCompletedUpdate()).catch(() => {
+  import("./autoUpdate-E4OZXQK6.js").then((mod) => mod.reportCompletedUpdate()).catch(() => {
   });
-  import("./updateCheck-GZELANMA.js").then(async (mod) => {
+  import("./updateCheck-POYNH3B5.js").then(async (mod) => {
     _printUpdateNotice = mod.printUpdateNotice;
     _printStalePinNotice = mod.printStalePinNotice;
     const result = mod.cachedUpdateCheck();
     if (result.updateAvailable) {
-      const auto = await import("./autoUpdate-PC5TN3NL.js").catch(() => null);
+      const auto = await import("./autoUpdate-E4OZXQK6.js").catch(() => null);
       auto?.scheduleBackgroundInstall(result.latest, result.current);
     }
   }).catch(() => {
   });
-  import("./skillsUpdateCheck-GXZN56I5.js").then((mod) => {
+  import("./skillsUpdateCheck-J57RNNIV.js").then((mod) => {
     _printSkillsUpdateNotice = mod.printSkillsUpdateNotice;
   }).catch(() => {
   });
-  import("./backgroundChecks-7M3T44EP.js").then((mod) => mod.launchBackgroundChecks()).catch(() => {
+  import("./backgroundChecks-FSUVHN5L.js").then((mod) => mod.launchBackgroundChecks()).catch(() => {
   });
 }
 var _appHistoryNotice = null;
@@ -468,7 +366,7 @@ process.on("unhandledRejection", (reason) => {
   emitCliErrorEvent("unhandled_rejection", error);
 });
 async function showUsage(cmd, parent) {
-  const { showUsage: impl } = await import("./help-XBP6A6LT.js");
+  const { showUsage: impl } = await import("./help-3TSTXBLN.js");
   return impl(cmd, parent);
 }
 async function showRequestedUsage() {

package/dist/{cloud-IDUQRYLO.js → cloud-DOFI5ISR.js}

@@ -55,10 +55,10 @@ ${c.bold("AUTH:")}
 var cloud_default = defineCommand({
   meta: { name: "cloud", description: "Render HyperFrames compositions on the HeyGen cloud" },
   subCommands: {
-    render: () => import("./render-S73DW4KK.js").then((m) => m.default),
-    list: () => import("./list-FRNUJXZ3.js").then((m) => m.default),
-    get: () => import("./get-B5TS6C7H.js").then((m) => m.default),
-    delete: () => import("./delete-EAX2U3WI.js").then((m) => m.default)
+    render: () => import("./render-K25YOG3M.js").then((m) => m.default),
+    list: () => import("./list-BQBPNKDZ.js").then((m) => m.default),
+    get: () => import("./get-P5NC7SRM.js").then((m) => m.default),
+    delete: () => import("./delete-EL5LVSEP.js").then((m) => m.default)
   },
   async run({ args }) {
     if (!args._?.[0]) console.log(HELP);

package/dist/{cloudrun-R3JXWXGG.js → cloudrun-KTZ4XDHL.js}

@@ -6,37 +6,38 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   parseOutputResolutionFlag
-} from "./chunk-D2KNWIQ6.js";
+} from "./chunk-QFSCCQIR.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BM5PX3DJ.js";
+} from "./chunk-LW6HO6U3.js";
 import {
   readAllowedCompositionFpsFromDir
-} from "./chunk-YEIFI443.js";
-import "./chunk-IHFUKJOR.js";
-import "./chunk-PFCFR3KZ.js";
+} from "./chunk-WPNE5NEP.js";
+import "./chunk-K2FLNJVB.js";
+import "./chunk-442JNXRM.js";
 import {
   defineCommand
 } from "./chunk-S3S4TGEH.js";
 import {
   failCommand
 } from "./chunk-PBN6GBJE.js";
-import "./chunk-6E6CM7WS.js";
-import "./chunk-OZUQF4NB.js";
-import "./chunk-DPVXBVLL.js";
-import "./chunk-SYKKFAUW.js";
+import "./chunk-4M4EC7JX.js";
+import "./chunk-6TPZSTCL.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-YA62XGXS.js";
+import "./chunk-MQZVBHEY.js";
 import "./chunk-OFQWTKPW.js";
+import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
 import "./chunk-FXMKHHPO.js";
 import "./chunk-RQVDTPGD.js";
-import "./chunk-TQFG7HTI.js";
-import "./chunk-GK4AIFIH.js";
+import "./chunk-3RM2ETQT.js";
+import "./chunk-ZLW2V65P.js";
+import "./chunk-SDYDNHEE.js";
 import "./chunk-2PSPARWP.js";
-import "./chunk-PMRBLBUP.js";
+import "./chunk-T42U2W2R.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/commands/contrast-audit.browser.js

@@ -104,7 +104,57 @@ window.__contrastAuditPrepare = function () {
   var CLIP_PROBE_COLS = [0.05, 0.25, 0.5, 0.75, 0.95];
   var CLIP_PROBE_ROWS = [0.25, 0.5, 0.75];
 
-  function paintsAnyProbePoint(el, rect) {
+  var compositionBoxPaint = new WeakMap();
+  var COMPOSITION_BOX_TAGS = new Set(["DIV", "SECTION"]);
+
+  function hasContainerPaint(style) {
+    var background = parseColor(style.backgroundColor);
+    if (
+      style.backgroundColor &&
+      style.backgroundColor !== "transparent" &&
+      (!background || background[3] > 0)
+    )
+      return true;
+    if (
+      ["backgroundImage", "boxShadow", "filter", "backdropFilter"].some(function (property) {
+        return style[property] && style[property] !== "none";
+      })
+    )
+      return true;
+    if (parseFloat(style.outlineWidth) > 0 && style.outlineStyle !== "none") return true;
+    return ["Top", "Right", "Bottom", "Left"].some(function (side) {
+      return (
+        parseFloat(style["border" + side + "Width"]) > 0 &&
+        style["border" + side + "Style"] !== "none"
+      );
+    });
+  }
+
+  function isUnpaintedCompositionBox(el) {
+    if (!el || !el.matches("[data-composition-id], [data-hf-inner-root]")) return false;
+    if (!el.closest("[data-composition-id]")) return false;
+    if (
+      el.namespaceURI !== "http://www.w3.org/1999/xhtml" ||
+      !COMPOSITION_BOX_TAGS.has(el.tagName) ||
+      el.shadowRoot
+    )
+      return false;
+    if (compositionBoxPaint.has(el)) return !compositionBoxPaint.get(el);
+    var painted =
+      Array.from(el.childNodes).some(function (child) {
+        return child.nodeType === 3 && (child.textContent || "").trim().length > 0;
+      }) || hasContainerPaint(getComputedStyle(el));
+    if (!painted) {
+      painted = ["::before", "::after"].some(function (pseudo) {
+        var content = getComputedStyle(el, pseudo).content;
+        return content && content !== "none" && content !== "normal";
+      });
+    }
+    compositionBoxPaint.set(el, !!painted);
+    return !painted;
+  }
+
+  function paintsAnyProbePoint(el, rect, skipCompositionBoxes) {
     // Keep probe resolution aligned with layout-audit.browser.js. Edge strips
     // narrower than the nearest probe point are treated as clipped away to
     // avoid noisy typewriter pre-reveal contrast reports.
@@ -112,8 +162,14 @@ window.__contrastAuditPrepare = function () {
       for (var ri = 0; ri < CLIP_PROBE_ROWS.length; ri++) {
         var x = rect.left + rect.width * CLIP_PROBE_COLS[ci];
         var y = rect.top + rect.height * CLIP_PROBE_ROWS[ri];
-        var hit = document.elementFromPoint(x, y);
-        if (hit === el || el.contains(hit)) return true;
+        var hits =
+          skipCompositionBoxes && typeof document.elementsFromPoint === "function"
+            ? document.elementsFromPoint(x, y)
+            : [document.elementFromPoint(x, y)];
+        for (var hit of hits) {
+          if (hit === el || el.contains(hit)) return true;
+          if (!skipCompositionBoxes || !isUnpaintedCompositionBox(hit)) break;
+        }
       }
     }
     return false;
@@ -135,7 +191,7 @@ window.__contrastAuditPrepare = function () {
   function isIntentionallyOccluded(el, rect) {
     if (typeof document.elementFromPoint !== "function") return false;
     if (!el.closest || !el.closest("[data-layout-allow-occlusion]")) return false;
-    return !paintsAnyProbePoint(el, rect);
+    return !paintsAnyProbePoint(el, rect, true);
   }
 
   var out = [];

package/dist/commands/layout-audit.browser.js

@@ -454,7 +454,7 @@
     const overflow = {};
     if (overflowX > tolerance) overflow.right = round(overflowX);
     if (overflowY > tolerance) overflow.bottom = round(overflowY);
-    const selector = selectorFor(element);
+    const selector = uniqueSelectorFor(element);
     const text = textContentFor(element);
     const rect = toRect(element.getBoundingClientRect());
     const fontSize = parsePx(style.fontSize);
@@ -537,7 +537,7 @@
     const textRect = unionRects(lineRects);
     if (!textRect) return [];
     const text = textContentFor(element, true);
-    const selector = selectorFor(element);
+    const selector = uniqueSelectorFor(element);
     const issues = [];
 
     const container = nearestConstraint(element, root, rootRect);
@@ -568,7 +568,7 @@
         severity: "error",
         time,
         selector,
-        containerSelector: selectorFor(container),
+        containerSelector: uniqueSelectorFor(container),
         text,
         message: "Text extends outside its nearest visual/container box.",
         rect: visibleTextRect,
@@ -591,7 +591,7 @@
         severity: "info",
         time,
         selector,
-        containerSelector: selectorFor(root),
+        containerSelector: uniqueSelectorFor(root),
         text,
         message: "Text extends outside the composition canvas.",
         rect: textRect,
@@ -644,8 +644,8 @@
           code: "container_overflow",
           severity: "warning",
           time,
-          selector: selectorFor(child),
-          containerSelector: selectorFor(container),
+          selector: uniqueSelectorFor(child),
+          containerSelector: uniqueSelectorFor(container),
           message: checksEveryChild
             ? "Element extends outside a clipping layout container."
             : "Nowrap text is wider than its container.",
@@ -1163,6 +1163,73 @@
     };
   }
 
+  function layoutOffset(element) {
+    let left = 0;
+    let top = 0;
+    for (let current = element; current instanceof HTMLElement; current = current.offsetParent) {
+      left += current.offsetLeft;
+      top += current.offsetTop;
+      if (current !== element) {
+        left += current.clientLeft;
+        top += current.clientTop;
+      }
+    }
+    return { left, top };
+  }
+
+  function ancestorBackgroundPaintsText(element, textRect) {
+    // Chromium 150+ includes independently painted descendants in text masks;
+    // older builds drop their glyphs: https://github.com/heygen-com/hyperframes/issues/5117.
+    const chromium = window.navigator.userAgent.match(/(?:HeadlessChrome|Chrome)\/(\d+)/);
+    if (!chromium || Number(chromium[1]) < 150 || !(element instanceof HTMLElement)) return false;
+
+    for (
+      let ancestor = element.parentElement;
+      ancestor instanceof HTMLElement;
+      ancestor = ancestor.parentElement
+    ) {
+      const style = getComputedStyle(ancestor);
+      const clips = splitTopLevelCommas(
+        style.webkitBackgroundClip || style.backgroundClip || "border-box",
+      ).map((clip) => clip.trim());
+      if (!clips.includes("text")) continue;
+      // Chromium builds the mask before descendant transforms, so moving the
+      // child must not move its glyphs out of the mask for this check.
+      const offset = layoutOffset(element);
+      const parentOffset = layoutOffset(ancestor);
+      const elementRect = element.getBoundingClientRect();
+      const scaleX = elementRect.width > 0 ? element.offsetWidth / elementRect.width : 1;
+      const scaleY = elementRect.height > 0 ? element.offsetHeight / elementRect.height : 1;
+      const backgroundRect = rectFromOrigin(0, 0, ancestor.offsetWidth, ancestor.offsetHeight);
+      const overlaps =
+        element.offsetWidth > 0 && element.offsetHeight > 0
+          ? textClientRects(element, true).some((rect) => {
+              const layoutRect = rectFromOrigin(
+                offset.left - parentOffset.left + (rect.left - elementRect.left) * scaleX,
+                offset.top - parentOffset.top + (rect.top - elementRect.top) * scaleY,
+                rect.width * scaleX,
+                rect.height * scaleY,
+              );
+              return intersectionArea(layoutRect, backgroundRect) > 0;
+            })
+          : !overflowFor(textRect, ancestor.getBoundingClientRect(), 2);
+      if (!overlaps) continue;
+
+      const images = splitTopLevelCommas(style.backgroundImage || "none");
+      const imagePaints = images.some(
+        (image, index) =>
+          clips[index % clips.length] === "text" &&
+          /(?:linear|radial|conic)-gradient\(/i.test(image) &&
+          gradientMaxAlpha(image) > 0.05,
+      );
+      const colorPaints =
+        clips[(images.length - 1) % clips.length] === "text" &&
+        colorAlpha(style.backgroundColor || "rgba(0, 0, 0, 0)") > 0.05;
+      if (imagePaints || colorPaints) return true;
+    }
+    return false;
+  }
+
   // Text whose glyphs paint with an effectively transparent fill renders
   // invisibly even though the element, its box, opacity and color all read as
   // present — so geometry/occlusion/contrast audits miss it (contrast reads
@@ -1194,11 +1261,12 @@
       // clipped text. If nothing paints, fall through and report it.
       if (paintsGlyphs) return null;
     }
+    if (ancestorBackgroundPaintsText(element, textRect)) return null;
     return {
       code: "text_not_painted",
       severity: "error",
       time,
-      selector: selectorFor(element),
+      selector: uniqueSelectorFor(element),
       text,
       message:
         "Text paints with an effectively transparent fill (-webkit-text-fill-color / color), so its glyphs are invisible.",
@@ -1242,8 +1310,8 @@
         code: "escaped_container",
         severity: "warning",
         time,
-        selector: selectorFor(element),
-        containerSelector: selectorFor(parent),
+        selector: uniqueSelectorFor(element),
+        containerSelector: uniqueSelectorFor(parent),
         text: textContentFor(element),
         message:
           "Positioned element renders far outside its offset parent — its coordinates were likely computed in a different frame (canvas/viewport pixels).",
@@ -1319,8 +1387,8 @@
         code: "panel_out_of_canvas",
         severity: rectArea(rect) >= rootArea * PANEL_HERO_AREA_FRACTION ? "warning" : "info",
         time,
-        selector: selectorFor(element),
-        containerSelector: selectorFor(root),
+        selector: uniqueSelectorFor(element),
+        containerSelector: uniqueSelectorFor(root),
         text: textContentFor(element).slice(0, 48),
         message: "Painted panel extends outside the composition canvas.",
         rect,
@@ -1436,8 +1504,8 @@
         code: "canvas_content_at_edge",
         severity: "warning",
         time,
-        selector: selectorFor(canvas),
-        containerSelector: selectorFor(root),
+        selector: uniqueSelectorFor(canvas),
+        containerSelector: uniqueSelectorFor(root),
         message: `Canvas content touches the frame edge (${sides.join(", ")}).`,
         rect,
         containerRect: rootRect,
@@ -1605,8 +1673,8 @@
         code: "connector_detached",
         severity: "warning",
         time,
-        selector: selectorFor(path),
-        containerSelector: selectorFor(svg),
+        selector: uniqueSelectorFor(path),
+        containerSelector: uniqueSelectorFor(svg),
         message: pasteBug
           ? `Connector path endpoints render ${gap}px from the nearest anchorable element, but the path's user-space coordinates would attach if read as screen pixels — screen/viewport numbers were likely written into SVG \`d\` without inverting the CTM.`
           : `Connector path endpoints render ${gap}px from the nearest anchorable element — a marked shaft that meets no node.`,
@@ -1743,9 +1811,9 @@
         code: "connector_orphan",
         severity: "warning",
         time,
-        selector: selectorFor(path),
-        containerSelector: selectorFor(svg),
-        message: `Connector shaft is visible while ${dark.length === 2 ? "both endpoints are" : `its endpoint ${selectorFor(dark[0].element)} is`} not on stage.`,
+        selector: uniqueSelectorFor(path),
+        containerSelector: uniqueSelectorFor(svg),
+        message: `Connector shaft is visible while ${dark.length === 2 ? "both endpoints are" : `its endpoint ${uniqueSelectorFor(dark[0].element)} is`} not on stage.`,
         rect: toRect({
           left: Math.min(rendered.start.x, rendered.end.x),
           top: Math.min(rendered.start.y, rendered.end.y),
@@ -1925,7 +1993,7 @@
       const box = element.getBoundingClientRect();
       if (box.width * box.height <= 400) continue;
       samples.push({
-        selector: selectorFor(element),
+        selector: uniqueSelectorFor(element),
         cx: round(box.left + box.width / 2),
         cy: round(box.top + box.height / 2),
         w: round(box.width),
@@ -2113,7 +2181,7 @@
         hubCache.set(svg, hub);
       }
       samples.push({
-        selector: selectorFor(element),
+        selector: uniqueSelectorFor(element),
         ax: round(a.x),
         ay: round(a.y),
         bx: round(b.x),