hyperframes 0.8.142 → 0.8.144

package/dist/cli.js

@@ -9,13 +9,19 @@ import {
   registerRunningCli
 } from "./chunk-NXMYHJAL.js";
 import {
-  isTextFile
-} from "./chunk-K4WKGXRC.js";
+  resolveExtraPositionals
+} from "./chunk-GZVP4TWN.js";
+import "./chunk-K4WKGXRC.js";
+import {
+  assertKnownFlags,
+  guardSwallowedFlagValues
+} from "./chunk-UPFUC4DB.js";
 import {
   isRenderSucceeded
 } from "./chunk-L3YOGIPG.js";
 import {
   defineCommand,
+  parseArgs,
   runCommand
 } from "./chunk-S3S4TGEH.js";
 import {
@@ -34,7 +40,8 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-DZEVA7DI.js";
+} from "./chunk-4OC7MQNB.js";
+import "./chunk-ZTZA4UWZ.js";
 import "./chunk-M2WBOQ2Q.js";
 
 // src/cli.ts
@@ -42,110 +49,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)));
@@ -163,7 +66,7 @@ function wrapCommand(cmd, path) {
       const rawArgs = ctx?.rawArgs ?? [];
       const firstPositional = rawArgs.find((tok) => tok && !tok.startsWith("-"));
       const delegatesToSub = cmd.subCommands != null && firstPositional != null && Object.prototype.hasOwnProperty.call(cmd.subCommands, firstPositional);
-      if (!delegatesToSub) assertKnownFlags(cmd, rawArgs);
+      if (!delegatesToSub) guardLeafFlags(cmd, path, ctx, rawArgs);
       if (!cmd.subCommands) resolveExtraPositionals(cmd, path, ctx?.args);
       return await run(ctx);
     };
@@ -179,9 +82,16 @@ function wrapCommand(cmd, path) {
   }
   return wrapped;
 }
+function guardLeafFlags(cmd, path, ctx, rawArgs) {
+  assertKnownFlags(cmd, rawArgs);
+  const guarded = guardSwallowedFlagValues(cmd, path, rawArgs);
+  if (!guarded.rewritten) return;
+  ctx.rawArgs = guarded.rawArgs;
+  ctx.args = parseArgs(guarded.rawArgs, cmd.args ?? {});
+}
 async function reportCommandFailure(command2, err) {
   try {
-    const { trackCommandFailure } = await import("./events-QJDVMKSR.js");
+    const { trackCommandFailure } = await import("./events-BRRUDPPT.js");
     trackCommandFailure(command2, err);
   } catch {
   }
@@ -253,54 +163,54 @@ async function assertStudioWorkspaceBuilt() {
   });
 }
 var commandLoaders = {
-  init: () => import("./init-A2XBDFGF.js").then((m) => m.default),
-  add: () => import("./add-YS2RCWEK.js").then((m) => m.default),
-  catalog: () => import("./catalog-DVJ3XPDN.js").then((m) => m.default),
+  init: () => import("./init-6BXK42VS.js").then((m) => m.default),
+  add: () => import("./add-CWRTVGDB.js").then((m) => m.default),
+  catalog: () => import("./catalog-HIWNAFHW.js").then((m) => m.default),
   "media-use": () => import("./media-use-4XXGABIL.js").then((m) => m.default),
-  play: () => import("./play-QMZEM6X3.js").then((m) => m.default),
-  present: () => import("./present-Y7IK3C4W.js").then((m) => m.default),
-  preview: () => assertStudioWorkspaceBuilt().then(() => import("./preview-5OQRYE6A.js").then((m) => m.default)),
-  publish: () => import("./publish-VZLFIGYY.js").then((m) => m.default),
-  open: () => import("./open-TYC5THVY.js").then((m) => m.default),
-  "catch-up": () => import("./catch-up-DF6AVSN2.js").then((m) => m.default),
-  render: () => import("./render-X3NFNVEQ.js").then((m) => m.default),
-  lint: () => import("./lint-V4GRFHOJ.js").then((m) => m.default),
-  check: () => import("./check-KXORRWAE.js").then((m) => m.default),
-  beats: () => import("./beats-7OT7ALV3.js").then((m) => m.default),
-  "normalize-audio": () => import("./normalize-audio-INKCLMS2.js").then((m) => m.default),
-  inspect: () => import("./inspect-CLTZHA5O.js").then((m) => m.default),
-  keyframes: () => import("./keyframes-3FYOK6H6.js").then((m) => m.default),
-  layout: () => import("./layout-4KP5O7IJ.js").then((m) => m.default),
-  info: () => import("./info-WBBQA2AX.js").then((m) => m.default),
-  compositions: () => import("./compositions-CUSY6ZYY.js").then((m) => m.default),
-  timeline: () => import("./timeline-N6ZASFNE.js").then((m) => m.default),
-  history: () => import("./history-ZRWYRY7R.js").then((m) => m.default),
-  benchmark: () => import("./benchmark-Q2XQCRTR.js").then((m) => m.default),
-  browser: () => import("./browser-7VAWQQZC.js").then((m) => m.default),
-  "remove-background": () => import("./remove-background-TKOEHBA5.js").then((m) => m.default),
-  transcribe: () => import("./transcribe-7YTUCXDX.js").then((m) => m.default),
+  play: () => import("./play-J2KP64UK.js").then((m) => m.default),
+  present: () => import("./present-MHHNRVRA.js").then((m) => m.default),
+  preview: () => assertStudioWorkspaceBuilt().then(() => import("./preview-CONUOFFQ.js").then((m) => m.default)),
+  publish: () => import("./publish-YZSPBFRD.js").then((m) => m.default),
+  open: () => import("./open-7IXXGO2E.js").then((m) => m.default),
+  "catch-up": () => import("./catch-up-HGS7KIAC.js").then((m) => m.default),
+  render: () => import("./render-MH4IUPWB.js").then((m) => m.default),
+  lint: () => import("./lint-DWCMVIX5.js").then((m) => m.default),
+  check: () => import("./check-FH6UYYLO.js").then((m) => m.default),
+  beats: () => import("./beats-N5JGEOFR.js").then((m) => m.default),
+  "normalize-audio": () => import("./normalize-audio-RFD776HQ.js").then((m) => m.default),
+  inspect: () => import("./inspect-VKU47TBH.js").then((m) => m.default),
+  keyframes: () => import("./keyframes-IEYVHRPI.js").then((m) => m.default),
+  layout: () => import("./layout-XOI4PT7A.js").then((m) => m.default),
+  info: () => import("./info-2CZOTNBC.js").then((m) => m.default),
+  compositions: () => import("./compositions-CPCMWF24.js").then((m) => m.default),
+  timeline: () => import("./timeline-T3QSGT3A.js").then((m) => m.default),
+  history: () => import("./history-4IQOLTHJ.js").then((m) => m.default),
+  benchmark: () => import("./benchmark-CUN3LN4V.js").then((m) => m.default),
+  browser: () => import("./browser-NCZT5AP6.js").then((m) => m.default),
+  "remove-background": () => import("./remove-background-4ATVLHLG.js").then((m) => m.default),
+  transcribe: () => import("./transcribe-FOLNOC5G.js").then((m) => m.default),
   usage: () => import("./usage-EC3KFUIJ.js").then((m) => m.default),
-  models: () => import("./models-DYBAD2GQ.js").then((m) => m.default),
-  tts: () => import("./tts-TOHSPWEG.js").then((m) => m.default),
+  models: () => import("./models-TY4PJ545.js").then((m) => m.default),
+  tts: () => import("./tts-B6AHFQEO.js").then((m) => m.default),
   docs: () => import("./docs-MPOM3PHH.js").then((m) => m.default),
-  doctor: () => import("./doctor-4ROTBL5U.js").then((m) => m.default),
-  clean: () => import("./clean-KTHTV5G5.js").then((m) => m.default),
-  upgrade: () => import("./upgrade-QAJEYB4X.js").then((m) => m.default),
-  skills: () => import("./skills-CZHVAD3J.js").then((m) => m.default),
-  feedback: () => import("./feedback-PQ7TWESA.js").then((m) => m.default),
+  doctor: () => import("./doctor-GWI3B6JT.js").then((m) => m.default),
+  clean: () => import("./clean-KPX27IKJ.js").then((m) => m.default),
+  upgrade: () => import("./upgrade-TVGXBUPJ.js").then((m) => m.default),
+  skills: () => import("./skills-VENERS5X.js").then((m) => m.default),
+  feedback: () => import("./feedback-CXMD7FWL.js").then((m) => m.default),
   telemetry: () => import("./telemetry-W5AKPI4R.js").then((m) => m.default),
-  events: () => import("./events-Q5PXT5UC.js").then((m) => m.default),
-  validate: () => import("./validate-GW5MDL36.js").then((m) => m.default),
-  snapshot: () => import("./snapshot-K7BTJPYQ.js").then((m) => m.default),
-  "media-treatment": () => import("./media-treatment-HJYL3EME.js").then((m) => m.mediaTreatmentCommand),
-  "grade-compare": () => import("./grade-compare-VS3RP73G.js").then((m) => m.default),
-  compare: () => import("./compare-CY4UO3RW.js").then((m) => m.default),
-  capture: () => import("./capture-U7ABPKS5.js").then((m) => m.default),
-  lambda: () => import("./lambda-Y2PA2BGS.js").then((m) => m.default),
-  cloudrun: () => import("./cloudrun-NM7RXOCL.js").then((m) => m.default),
-  cloud: () => import("./cloud-ARSZWALC.js").then((m) => m.default),
-  auth: () => import("./auth-DRZB7OAC.js").then((m) => m.default),
-  figma: () => import("./figma-JN5DDBDS.js").then((m) => m.default)
+  events: () => import("./events-V2QFN4YM.js").then((m) => m.default),
+  validate: () => import("./validate-ZMYGK4QI.js").then((m) => m.default),
+  snapshot: () => import("./snapshot-C6T74HTI.js").then((m) => m.default),
+  "media-treatment": () => import("./media-treatment-IFB7OSZ3.js").then((m) => m.mediaTreatmentCommand),
+  "grade-compare": () => import("./grade-compare-STXQPKYQ.js").then((m) => m.default),
+  compare: () => import("./compare-F6YAFZZM.js").then((m) => m.default),
+  capture: () => import("./capture-YLS32UHT.js").then((m) => m.default),
+  lambda: () => import("./lambda-TIKG25CK.js").then((m) => m.default),
+  cloudrun: () => import("./cloudrun-XM56TBOH.js").then((m) => m.default),
+  cloud: () => import("./cloud-P7DAOISN.js").then((m) => m.default),
+  auth: () => import("./auth-IDSOIQWG.js").then((m) => m.default),
+  figma: () => import("./figma-YABDWD66.js").then((m) => m.default)
 };
 var subCommands = Object.fromEntries(
   Object.entries(commandLoaders).map(([name, load]) => [name, trackCommandFailures(load)])
@@ -324,7 +234,7 @@ var _printStalePinNotice;
 var _printSkillsUpdateNotice;
 var telemetryReady = Promise.resolve();
 if (!isHelp && command !== "telemetry" && command !== "events" && command !== "usage" && command !== "unknown") {
-  telemetryReady = import("./telemetry-FQDKR5XA.js").then((mod) => {
+  telemetryReady = import("./telemetry-A23PPRD6.js").then((mod) => {
     _flushSync = mod.flushSync;
     _trackCliError = mod.trackCliError;
     _trackCommandResult = mod.trackCommandResult;
@@ -334,23 +244,23 @@ if (!isHelp && command !== "telemetry" && command !== "events" && command !== "u
   });
 }
 if (!isHelp && !hasJsonFlag && command !== "upgrade" && command !== "events" && command !== "telemetry" && command !== "skills" && command !== "usage") {
-  import("./autoUpdate-I5I3BOJK.js").then((mod) => mod.reportCompletedUpdate()).catch(() => {
+  import("./autoUpdate-373B4BA2.js").then((mod) => mod.reportCompletedUpdate()).catch(() => {
   });
-  import("./updateCheck-AZ2COZFR.js").then(async (mod) => {
+  import("./updateCheck-27PIP3AA.js").then(async (mod) => {
     _printUpdateNotice = mod.printUpdateNotice;
     _printStalePinNotice = mod.printStalePinNotice;
     const result = mod.cachedUpdateCheck();
     if (result.updateAvailable) {
-      const auto = await import("./autoUpdate-I5I3BOJK.js").catch(() => null);
+      const auto = await import("./autoUpdate-373B4BA2.js").catch(() => null);
       auto?.scheduleBackgroundInstall(result.latest, result.current);
     }
   }).catch(() => {
   });
-  import("./skillsUpdateCheck-6WLLX53A.js").then((mod) => {
+  import("./skillsUpdateCheck-UXFYTACG.js").then((mod) => {
     _printSkillsUpdateNotice = mod.printSkillsUpdateNotice;
   }).catch(() => {
   });
-  import("./backgroundChecks-VR2QHGNY.js").then((mod) => mod.launchBackgroundChecks()).catch(() => {
+  import("./backgroundChecks-53Q3NAMG.js").then((mod) => mod.launchBackgroundChecks()).catch(() => {
   });
 }
 var _appHistoryNotice = null;
@@ -468,7 +378,7 @@ process.on("unhandledRejection", (reason) => {
   emitCliErrorEvent("unhandled_rejection", error);
 });
 async function showUsage(cmd, parent) {
-  const { showUsage: impl } = await import("./help-AD6FIZIO.js");
+  const { showUsage: impl } = await import("./help-4H6BSFLB.js");
   return impl(cmd, parent);
 }
 async function showRequestedUsage() {

package/dist/{cloud-ARSZWALC.js → cloud-P7DAOISN.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-KIIIF6PS.js").then((m) => m.default),
-    list: () => import("./list-OQ4VED6E.js").then((m) => m.default),
-    get: () => import("./get-KT6OTERO.js").then((m) => m.default),
-    delete: () => import("./delete-KT3VHP4L.js").then((m) => m.default)
+    render: () => import("./render-6FBYLYGJ.js").then((m) => m.default),
+    list: () => import("./list-7GXKG5QM.js").then((m) => m.default),
+    get: () => import("./get-L2SOQKHX.js").then((m) => m.default),
+    delete: () => import("./delete-GYVKOKB6.js").then((m) => m.default)
   },
   async run({ args }) {
     if (!args._?.[0]) console.log(HELP);

package/dist/{cloudrun-NM7RXOCL.js → cloudrun-XM56TBOH.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-6UYZB4TY.js";
+} from "./chunk-7RAYSCYT.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-YFT3BL7N.js";
-import "./chunk-OZUQF4NB.js";
-import "./chunk-DPVXBVLL.js";
-import "./chunk-J4UX3RS3.js";
+import "./chunk-3VYNNWVA.js";
+import "./chunk-WJB7WI4J.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-BSQ7XANM.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

@@ -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,6 +1261,7 @@
       // 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",