hyperframes 0.8.149 → 0.8.151

package/dist/{check-TGXIICEF.js → check-6KQ433E6.js}

@@ -4,15 +4,19 @@ import { dirname as __hf_dirname } from "node:path";
 var require = __hf_createRequire(import.meta.url);
 var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
+import {
+  reportArtifacts,
+  withProjectLock
+} from "./chunk-DHPFXAUF.js";
 import {
   rectToBbox
 } from "./chunk-WBLXWOYK.js";
 import {
   loadProducer
-} from "./chunk-ZK3BQXHC.js";
+} from "./chunk-POEEDPJI.js";
 import {
   trackLintRun
-} from "./chunk-MI6U3OIN.js";
+} from "./chunk-L6RIMCMG.js";
 import {
   assertionTargets,
   buildLayoutSampleTimes,
@@ -31,37 +35,37 @@ import {
   mergeSampleTimes,
   parseAt,
   readMotionSpec
-} from "./chunk-U7SASZC5.js";
-import "./chunk-K44HCHZN.js";
+} from "./chunk-RJRGR5KF.js";
+import "./chunk-L3N7RJHS.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-BNYRD7PQ.js";
+import "./chunk-QLGBNGXC.js";
 import "./chunk-X7MTZ4T2.js";
-import "./chunk-TPIG7ZBX.js";
+import "./chunk-RYL6ZIJP.js";
 import "./chunk-FH7WODJH.js";
-import "./chunk-4S4VUXW3.js";
-import "./chunk-KQHJKJ3V.js";
+import "./chunk-RRBKEHST.js";
+import "./chunk-HVXRYMGQ.js";
 import "./chunk-WPNE5NEP.js";
-import "./chunk-NKM53WMI.js";
-import "./chunk-2HWB4TCI.js";
+import "./chunk-BRF3O35X.js";
+import "./chunk-XNDXENJQ.js";
 import "./chunk-FJWEYVEM.js";
-import "./chunk-ZFN6GQU4.js";
-import "./chunk-KMJLHHBF.js";
+import "./chunk-XXPYZBZ3.js";
+import "./chunk-3ZPFRDEJ.js";
 import "./chunk-AIJS74LG.js";
 import {
   resolveProject
-} from "./chunk-SFUBSJFP.js";
+} from "./chunk-KXX6NLOT.js";
 import "./chunk-K2FLNJVB.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-QIJLIULK.js";
+} from "./chunk-ZGCRVM5M.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-SP6XL3NP.js";
+import "./chunk-FAIYEIZ4.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-PR7QQBSC.js";
-import "./chunk-Q2Y5OZCY.js";
-import "./chunk-K35E45SI.js";
+import "./chunk-XGLNQDLN.js";
+import "./chunk-N4IXP3MY.js";
+import "./chunk-YZTVHRJ2.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
@@ -69,8 +73,8 @@ import "./chunk-374QQGBQ.js";
 import {
   trackCheckReport,
   trackCommandFailure
-} from "./chunk-Y475GD4L.js";
-import "./chunk-LACFOFWX.js";
+} from "./chunk-ZD3RDNZI.js";
+import "./chunk-IZ7L6V76.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-XBSPQ52S.js";
 import {
@@ -94,25 +98,25 @@ import "./chunk-TJSTGSAW.js";
 import "./chunk-Q5X2B5WT.js";
 import {
   withMeta
-} from "./chunk-GESJSXFH.js";
+} from "./chunk-35PWWBGZ.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OMBSUO4T.js";
+import "./chunk-TCWMDCBX.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-AMKC3AXA.js";
 import {
   extractMediaMetadata,
   findHdrAutoPromotion
-} from "./chunk-VC7JBNPS.js";
-import "./chunk-62RUQJ5J.js";
+} from "./chunk-IZPN423R.js";
+import "./chunk-3SVC7SW4.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-JYVGYKXG.js";
-import "./chunk-AHBYQRGI.js";
-import "./chunk-3WD4JNMU.js";
+import "./chunk-XQKVEQNY.js";
+import "./chunk-QBYHNRHU.js";
 import "./chunk-VC76R6W2.js";
-import "./chunk-YA62XGXS.js";
+import "./chunk-UJKQWGFF.js";
 import "./chunk-LFNQDTSH.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
@@ -123,7 +127,7 @@ import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-JDB65PPT.js";
+} from "./chunk-GNTVYF7E.js";
 import {
   resolveProjectRelativeSrc
 } from "./chunk-IWFLMU2N.js";
@@ -140,13 +144,16 @@ import {
 import "./chunk-3GXQPCJC.js";
 import "./chunk-M2WBOQ2Q.js";
 
+// src/commands/check.ts
+import { resolve } from "path";
+
 // src/utils/checkPipeline.ts
 import { mkdirSync, writeFileSync } from "fs";
 import { join, relative } from "path";
 
 // src/utils/hdrPromotion.ts
 async function bundleProjectHtml(projectDir) {
-  const { bundleToSingleHtml } = await import("./compiler-NPD3MYMO.js");
+  const { bundleToSingleHtml } = await import("./compiler-ZXT27Z62.js");
   return bundleToSingleHtml(projectDir);
 }
 async function collectBundledRenderMedia(html) {
@@ -255,22 +262,61 @@ function gateSampleTimes(duration, seeks, fallback) {
   const fractions = seeks && seeks.length > 0 ? seeks : [fallback];
   return mergeSampleTimes(fractions.map((fraction) => fraction * duration));
 }
-async function buildSampleGrid(driver, options) {
-  const duration = await driver.getDuration();
+function validateSampleRange([start, end], duration) {
+  if (!Number.isFinite(start + end) || start < 0 || end <= start || end > duration)
+    throw new Error(`Check range must lie within the composition duration (${duration} seconds)`);
+}
+function gateSamplesInRange(flag, samples, inRange, range) {
+  if (!range) return samples;
+  const selected = samples.filter(inRange);
+  if (samples.length > 0 && selected.length === 0) {
+    throw new Error(`No ${flag} seek samples lie within --range`);
+  }
+  return selected;
+}
+function layoutSamplesInRange(options, duration) {
+  if (!options.range)
+    return {
+      inRange: (_t) => true,
+      baseSamples: buildLayoutSampleTimes({ duration, samples: options.samples, at: options.at })
+    };
+  validateSampleRange(options.range, duration);
+  const [start, end] = options.range;
+  const inRange = (t) => t >= start && t <= end;
+  const selected = (options.at ?? []).filter(inRange);
+  if (options.at?.length && !selected.length) throw new Error("No --at samples lie within --range");
   const baseSamples = buildLayoutSampleTimes({
-    duration,
+    duration: end - start,
     samples: options.samples,
-    at: options.at
-  });
+    at: selected.map((t) => t - start)
+  }).map((t) => t + start);
+  return { inRange, baseSamples };
+}
+async function buildSampleGrid(driver, options) {
+  const duration = await driver.getDuration();
+  const { inRange, baseSamples } = layoutSamplesInRange(options, duration);
   const transitions = options.atTransitions ? buildTransitionSampleTimes({
     duration,
-    boundaries: await driver.getTransitionBoundaries(),
+    boundaries: (await driver.getTransitionBoundaries()).filter(inRange),
     cap: options.maxTransitionSamples
   }) : { times: [], dropped: 0 };
-  const captionSamples = options.captionZone ? gateSampleTimes(duration, options.captionZone.seek, 1) : [];
-  const frameSamples = options.frameCheck ? gateSampleTimes(duration, options.frameCheck.seek, 0.5) : [];
-  const auditSamples = mergeSampleTimes(baseSamples, transitions.times);
-  const layoutSamples = mergeSampleTimes(auditSamples, captionSamples, frameSamples);
+  const captionSamples = gateSamplesInRange(
+    "--caption-zone",
+    options.captionZone ? gateSampleTimes(duration, options.captionZone.seek, 1) : [],
+    inRange,
+    options.range
+  );
+  const frameSamples = gateSamplesInRange(
+    "--frame-check",
+    options.frameCheck ? gateSampleTimes(duration, options.frameCheck.seek, 0.5) : [],
+    inRange,
+    options.range
+  );
+  transitions.times = transitions.times.filter(inRange);
+  const auditSamples = mergeSampleTimes(baseSamples, transitions.times).filter(inRange);
+  const layoutSamples = mergeSampleTimes(auditSamples, captionSamples, frameSamples).filter(
+    inRange
+  );
   if (layoutSamples.length === 0) {
     throw new Error("Could not determine composition duration \u2014 no layout samples run");
   }
@@ -462,7 +508,7 @@ async function collectGridSamples(driver, options, grid, motion) {
       collected.screenshots.push({ time, pngBase64: capture.pngBase64 });
     }
   }
-  await collectMotionOverlapSamples(driver, grid, collected);
+  await collectMotionOverlapSamples(driver, grid, collected, options.range);
   return collected;
 }
 var OVERLAP_SAMPLE_FPS = 8;
@@ -478,9 +524,11 @@ function buildOverlapSampleTimes(duration) {
     Array.from({ length: count }, (_, index) => Math.round(index * step * 1e3) / 1e3)
   );
 }
-async function collectMotionOverlapSamples(driver, grid, collected) {
+async function collectMotionOverlapSamples(driver, grid, collected, range) {
   const baseTimes = new Set(grid.layoutSamples);
-  for (const time of buildOverlapSampleTimes(grid.duration)) {
+  const overlapTimes = buildOverlapSampleTimes(range ? range[1] - range[0] : grid.duration);
+  const shiftedTimes = range ? mergeSampleTimes(overlapTimes.map((time) => time + range[0])) : overlapTimes;
+  for (const time of shiftedTimes) {
     if (baseTimes.has(time)) continue;
     await driver.seekGeometry(time);
     collected.layoutIssues.push(...await driver.collectOverlap(time));
@@ -875,7 +923,11 @@ function annotationBoxesFrom(issues) {
 async function runAuditGrid(driver, options, motion) {
   await driver.initialize(options.contrast);
   const grid = await buildSampleGrid(driver, options);
-  const plan = await planMotionSampling(driver, motion, grid.duration);
+  const plan = await planMotionSampling(
+    driver,
+    options.range ? { kind: "none" } : motion,
+    grid.duration
+  );
   const seekLoopStart = Date.now();
   const collected = await collectGridSamples(driver, options, grid, plan);
   const seekLoopMs = Date.now() - seekLoopStart;
@@ -889,7 +941,7 @@ async function runAuditGrid(driver, options, motion) {
     motionIssues = [...motionIssues, ...await driver.anchorMotionIssues(evaluated)];
   }
   const userPicked = new Set(grid.userPickedSamples);
-  const sweepFindings = detectSweepStatic(
+  const sweepFindings = options.range ? [] : detectSweepStatic(
     grid.duration,
     collected.layoutStateSignatures.filter((sample) => !userPicked.has(sample.time)),
     motionIssues,
@@ -901,6 +953,22 @@ async function runAuditGrid(driver, options, motion) {
   );
   const offPivotFindings = detectOffPivotRotation(collected.indicatorFrames);
   const contrast = buildContrastResults(collected.contrastEntries);
+  if (options.components?.length) {
+    if (!driver.matchComponents)
+      throw new Error("Component filtering unavailable in this check driver");
+    const findings = [
+      ...collected.layoutIssues,
+      ...sweepFindings,
+      ...rotationFindings,
+      ...offPivotFindings,
+      ...motionIssues,
+      ...contrast.findings
+    ];
+    const matches = await driver.matchComponents(options.components, findings);
+    findings.forEach((finding, i) => {
+      finding.componentMatch = matches[i];
+    });
+  }
   return {
     duration: grid.duration,
     layoutSamples: grid.layoutSamples,
@@ -1116,8 +1184,9 @@ function buildLintSection(result) {
   return { ...section(findings), filesScanned: result.results.length };
 }
 function buildReport(options, lint, browser, motion, extraMotionFindings, snapshotFiles, hdrPromotion = null, hdrInspection = "available") {
-  const layout = shapeLayoutSection(browser.layoutIssues, browser, options);
-  const shapedMotion = shapeLayoutFindings(browser.motionIssues, options);
+  const shaping = options.components?.length ? { ...options, maxIssues: Number.MAX_SAFE_INTEGER } : options;
+  const layout = shapeLayoutSection(browser.layoutIssues, browser, shaping);
+  const shapedMotion = shapeLayoutFindings(browser.motionIssues, shaping);
   const motionFindings = [...shapedMotion.findings, ...extraMotionFindings];
   const runtime = section(browser.runtimeFindings);
   const motionSection = section(motionFindings);
@@ -1133,7 +1202,7 @@ function buildReport(options, lint, browser, motion, extraMotionFindings, snapsh
     layout,
     motion: {
       ...motionSection,
-      enabled: motion.kind !== "none",
+      enabled: motion.kind !== "none" && !options.range,
       specPath: motion.kind === "none" ? void 0 : motion.path,
       samples: browser.motionSampleCount
     },
@@ -1154,7 +1223,7 @@ function buildReport(options, lint, browser, motion, extraMotionFindings, snapsh
   };
   trackCheckReport({
     contrastGate: options.contrast,
-    motionGate: motion.kind !== "none",
+    motionGate: motion.kind !== "none" && !options.range,
     captionZoneGate: options.captionZone !== void 0,
     frameCheckGate: options.frameCheck !== void 0,
     snapshotsGate: options.snapshots,
@@ -1177,6 +1246,35 @@ function buildReport(options, lint, browser, motion, extraMotionFindings, snapsh
     exitCode: checkExitCode(report),
     runId: getRunId()
   });
+  return filterComponentReport(report, options);
+}
+function filterComponentReport(report, options) {
+  if (!options.range && !options.components?.length) return report;
+  {
+    report.scope = {
+      range: options.range,
+      components: options.components,
+      hiddenFindings: 0,
+      notes: [
+        "Static lint and unscoped runtime failures remain project-wide.",
+        ...options.range ? [
+          "Whole-timeline motion assertions and frozen-sweep detection are skipped for range checks."
+        ] : []
+      ]
+    };
+    for (const group of [report.layout, report.motion, report.contrast]) {
+      const before = group.findings.length;
+      group.findings = group.findings.filter((f) => f.componentMatch !== false);
+      report.scope.hiddenFindings += before - group.findings.length;
+      if (group !== report.contrast && group.findings.length > options.maxIssues) {
+        group.findings = group.findings.slice(0, options.maxIssues);
+        report.scope.notes.push(
+          "Selected findings exceed --max-issues; increase it to see the remainder."
+        );
+        if (group === report.layout) report.layout.truncated = true;
+      }
+    }
+  }
   return report;
 }
 function shapeLayoutSection(issues, browser, options) {
@@ -1292,7 +1390,7 @@ function resolveMotionSpec(projectDir) {
   };
 }
 async function runBrowserCheck(project, options, motion) {
-  const module = await import("./checkBrowser-3N23I56J.js");
+  const module = await import("./checkBrowser-PRDR6XBY.js");
   return module.runBrowserCheck(project, options, motion, runAuditGrid);
 }
 async function writeSnapshot(projectDir, index, time, pngBase64) {
@@ -1304,7 +1402,7 @@ async function writeSnapshot(projectDir, index, time, pngBase64) {
   return join("snapshots", filename);
 }
 async function captureFindingCrops(project, options, requests) {
-  const module = await import("./checkBrowser-3N23I56J.js");
+  const module = await import("./checkBrowser-PRDR6XBY.js");
   return module.captureFindingCrops(project, options, requests);
 }
 var DEFAULT_DEPENDENCIES2 = {
@@ -1325,7 +1423,13 @@ var examples = [
 ];
 var DEFAULT_COMMAND_DEPENDENCIES = {
   resolveProject,
-  runPipeline: runCheckPipeline,
+  async runPipeline(project, options) {
+    const report = await runCheckPipeline(project, options);
+    const images = (files) => files.map((file) => resolve(project.dir, file));
+    reportArtifacts("check", "frame", images(report.snapshots.files));
+    reportArtifacts("check", "finding", images(report.snapshots.findingFiles));
+    return report;
+  },
   withMeta
 };
 var CHECK_COMMAND_ARGS = {
@@ -1336,6 +1440,14 @@ var CHECK_COMMAND_ARGS = {
     description: "Number of midpoint samples across the duration (default: 9)",
     default: "9"
   },
+  range: {
+    type: "string",
+    description: "Runtime sample interval in global seconds: start,end. Static lint remains project-wide."
+  },
+  components: {
+    type: "string",
+    description: "CSS selector list: filter findings involving these components or descendants; preserve full-check status."
+  },
   at: {
     type: "string",
     description: "Comma-separated timestamps in seconds (e.g., --at 1.5,4,7.25)"
@@ -1423,7 +1535,11 @@ function createCheckCommand(dependencies = DEFAULT_COMMAND_DEPENDENCIES) {
         if (!asJson) {
           console.log(`${c.accent("\u25C6")}  Checking ${c.accent(project.name)}`);
         }
-        const report = await dependencies.runPipeline(project, options);
+        const report = await withProjectLock(
+          project.dir,
+          "check",
+          () => dependencies.runPipeline(project, options)
+        );
         if (asJson) {
           console.log(JSON.stringify(dependencies.withMeta(report), null, 2));
         } else {
@@ -1448,6 +1564,8 @@ function parseCheckOptions(args) {
   const maxTransitionSamples = positiveInteger(args["max-transition-samples"], 0);
   return {
     samples: positiveInteger(args.samples, DEFAULT_CHECK_OPTIONS.samples),
+    range: parseCheckRange(args.range),
+    components: typeof args.components === "string" ? [args.components] : void 0,
     at: parseAt(args.at),
     atTransitions: args["at-transitions"] === true,
     maxTransitionSamples: maxTransitionSamples > 0 ? maxTransitionSamples : void 0,
@@ -1465,6 +1583,14 @@ function parseCheckOptions(args) {
     browserGpuMode: resolveLocalBrowserGpuMode(args["browser-gpu"])
   };
 }
+function parseCheckRange(value) {
+  if (value === void 0) return void 0;
+  const parts = String(value).split(/[,:]/);
+  const start = Number(parts[0]), end = Number(parts[1]);
+  if (parts.length !== 2 || parts.some((p) => !p.trim()) || !Number.isFinite(start) || !Number.isFinite(end) || start < 0 || end <= start)
+    throw new Error("Invalid --range: use non-negative start,end with end > start");
+  return [start, end];
+}
 var CAPTION_ZONE_FIELDS = /* @__PURE__ */ new Set(["x0", "y0", "x1", "y1", "severity", "seek"]);
 var FRAME_CHECK_FIELDS = /* @__PURE__ */ new Set(["severity", "seek", "tol"]);
 var LAYOUT_FIELDS = /* @__PURE__ */ new Set(["proseCoverageFloor"]);
@@ -1622,6 +1748,12 @@ function nonNegativeNumber(value, fallback) {
   return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
 }
 function printHumanReport(report) {
+  if (report.scope) {
+    console.log(
+      `Scope: ${report.scope.range ? report.scope.range.join("\u2013") + "s" : "full timeline"}; ${report.scope.hiddenFindings} findings hidden by component filter. Counts/status include hidden findings.`
+    );
+    for (const note of report.scope.notes) console.log(note);
+  }
   printSection("Lint", report.lint);
   if (report.browserSkipped) {
     console.log();
@@ -1638,10 +1770,13 @@ function printHumanReport(report) {
   const label = report.ok ? c.success("Check passed") : c.error("Check failed");
   console.log(`${report.ok ? c.success("\u25C7") : c.error("\u25C7")}  ${label}`);
 }
+function isEmptySection(section2) {
+  return section2.findings.length === 0 && section2.errorCount + section2.warningCount + section2.infoCount === 0;
+}
 function printSection(title, section2) {
   console.log();
   console.log(c.bold(title));
-  if (section2.findings.length === 0) {
+  if (isEmptySection(section2)) {
     console.log(`  ${c.success("\u25C7")} 0 errors, 0 warnings`);
     return;
   }
@@ -1651,7 +1786,7 @@ function printSection(title, section2) {
 function printLayoutSection(title, section2) {
   console.log();
   console.log(c.bold(title));
-  if (section2.findings.length === 0) {
+  if (isEmptySection(section2)) {
     console.log(`  ${c.success("\u25C7")} 0 issues across ${section2.samples.length} sample(s)`);
   } else {
     for (const finding of section2.findings) {
@@ -1674,7 +1809,7 @@ function printContrastSection(report) {
     console.log(`  ${c.dim("\u25C7")} skipped`);
     return;
   }
-  if (section2.findings.length === 0) {
+  if (isEmptySection(section2)) {
     console.log(
       `  ${c.success("\u25C7")} ${section2.passed}/${section2.checked} text checks pass WCAG AA`
     );
@@ -1725,6 +1860,7 @@ export {
   createCheckCommand,
   check_default as default,
   examples,
+  parseCheckRange,
   parseFrameCheck,
   parseLayout
 };