hyperframes 0.8.150 → 0.8.152

package/dist/{check-3HFISKDB.js → check-NUZ62LIW.js}

@@ -5,14 +5,24 @@ var require = __hf_createRequire(import.meta.url);
 var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
+  pngDimensions,
+  reportArtifacts,
+  withProjectLock
+} from "./chunk-57GN6KWT.js";
+import {
+  checkSnapshotDirectory,
   rectToBbox
-} from "./chunk-WBLXWOYK.js";
+} from "./chunk-XSEGMQYA.js";
+import {
+  captureArtifactRevision
+} from "./chunk-KCFF4ENE.js";
+import "./chunk-7TASSBN2.js";
 import {
   loadProducer
-} from "./chunk-6QB7F2II.js";
+} from "./chunk-3E4OCOC5.js";
 import {
   trackLintRun
-} from "./chunk-73RBX2E7.js";
+} from "./chunk-3DZBQ7MH.js";
 import {
   assertionTargets,
   buildLayoutSampleTimes,
@@ -31,46 +41,49 @@ import {
   mergeSampleTimes,
   parseAt,
   readMotionSpec
-} from "./chunk-FPAT5HTI.js";
-import "./chunk-S5F26DUL.js";
+} from "./chunk-BYJYQWEX.js";
+import "./chunk-GQETH4PE.js";
 import "./chunk-XUHOIDKG.js";
-import "./chunk-A6ZO4BX7.js";
+import "./chunk-XEFFJRYX.js";
 import "./chunk-X7MTZ4T2.js";
-import "./chunk-UAIUVPZE.js";
+import "./chunk-SWCSL6WS.js";
 import "./chunk-FH7WODJH.js";
-import "./chunk-AXPNVC3N.js";
-import "./chunk-423DJVX2.js";
+import "./chunk-4UMKAUZI.js";
+import "./chunk-PKO2EWO7.js";
 import "./chunk-WPNE5NEP.js";
-import "./chunk-UVVI2NJQ.js";
-import "./chunk-ZNHAJCEA.js";
-import "./chunk-FJWEYVEM.js";
-import "./chunk-XXPYZBZ3.js";
-import "./chunk-EL5QVJEG.js";
-import "./chunk-AIJS74LG.js";
+import "./chunk-HBCRRCTX.js";
+import "./chunk-PRXAOZWZ.js";
+import "./chunk-C6TPGUWD.js";
+import {
+  recordArtifacts
+} from "./chunk-7FYFEXD2.js";
+import "./chunk-XINGD6MS.js";
+import "./chunk-FFDC5OWV.js";
 import {
   resolveProject
-} from "./chunk-NFQY7EIC.js";
+} from "./chunk-IBYC3VUA.js";
 import "./chunk-K2FLNJVB.js";
+import "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-AKYQGZLU.js";
+} from "./chunk-EVTHG34H.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-XQMEGSHG.js";
+import "./chunk-D6RJXQLD.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-BLRJKBKP.js";
-import "./chunk-M6UDJ2E7.js";
-import "./chunk-OQ7XMM3S.js";
+import "./chunk-QESSGUKX.js";
+import "./chunk-6Z4YJ5Q3.js";
+import "./chunk-3HPJM5IQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-374QQGBQ.js";
+import "./chunk-5CS4T6C6.js";
 import {
   trackCheckReport,
   trackCommandFailure
-} from "./chunk-3UAIVF4L.js";
-import "./chunk-6KWA3XPS.js";
+} from "./chunk-H2SGM2V2.js";
+import "./chunk-KZ3L3W4Q.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-XBSPQ52S.js";
 import {
@@ -94,26 +107,26 @@ import "./chunk-TJSTGSAW.js";
 import "./chunk-Q5X2B5WT.js";
 import {
   withMeta
-} from "./chunk-AFRXL75S.js";
+} from "./chunk-YYEYOFHW.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-I6DATIHC.js";
+import "./chunk-IZIRIDJH.js";
 import "./chunk-EOVYQ3IG.js";
 import "./chunk-AMKC3AXA.js";
 import {
   extractMediaMetadata,
   findHdrAutoPromotion
-} from "./chunk-5NAYNDBT.js";
-import "./chunk-WLIUULZQ.js";
+} from "./chunk-EXH6L2XZ.js";
+import "./chunk-RN5I2DP5.js";
 import "./chunk-NE55C6S5.js";
 import "./chunk-JYVGYKXG.js";
-import "./chunk-PCWOSS7G.js";
-import "./chunk-CEND6BLF.js";
+import "./chunk-5ERVRJMV.js";
+import "./chunk-S3RCK56N.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
-import "./chunk-LFNQDTSH.js";
+import "./chunk-VYKPBRCB.js";
 import "./chunk-OFQWTKPW.js";
 import "./chunk-DPVXBVLL.js";
 import "./chunk-T76PLPD6.js";
@@ -123,16 +136,16 @@ import "./chunk-TWWSYAKJ.js";
 import {
   lintProject,
   shouldBlockRender
-} from "./chunk-JDB65PPT.js";
+} from "./chunk-YOEGUBBY.js";
 import {
   resolveProjectRelativeSrc
 } from "./chunk-IWFLMU2N.js";
-import "./chunk-APDLWWFG.js";
+import "./chunk-3VGU2SH7.js";
 import "./chunk-VAS6HQX3.js";
 import "./chunk-3RM2ETQT.js";
 import "./chunk-BSQ7XANM.js";
 import "./chunk-SDYDNHEE.js";
-import "./chunk-2PSPARWP.js";
+import "./chunk-TYXH3EKP.js";
 import "./chunk-IXLUTE6N.js";
 import {
   normalizeErrorMessage
@@ -140,13 +153,18 @@ import {
 import "./chunk-3GXQPCJC.js";
 import "./chunk-M2WBOQ2Q.js";
 
+// src/commands/check.ts
+import { randomUUID } from "crypto";
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join2, 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-UQP2VXN6.js");
+  const { bundleToSingleHtml } = await import("./compiler-NCN6PTVH.js");
   return bundleToSingleHtml(projectDir);
 }
 async function collectBundledRenderMedia(html) {
@@ -255,22 +273,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 +519,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 +535,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 +934,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 +952,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 +964,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 +1195,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 +1213,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 +1234,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 +1257,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,19 +1401,19 @@ function resolveMotionSpec(projectDir) {
   };
 }
 async function runBrowserCheck(project, options, motion) {
-  const module = await import("./checkBrowser-MXBDNZJB.js");
+  const module = await import("./checkBrowser-MSTVEL4V.js");
   return module.runBrowserCheck(project, options, motion, runAuditGrid);
 }
 async function writeSnapshot(projectDir, index, time, pngBase64) {
-  const snapshotDir = join(projectDir, "snapshots");
+  const snapshotDir = checkSnapshotDirectory(projectDir);
   mkdirSync(snapshotDir, { recursive: true });
   const filename = `frame-${String(index).padStart(2, "0")}-at-${time.toFixed(1)}s.png`;
   const path = join(snapshotDir, filename);
   writeFileSync(path, Buffer.from(pngBase64, "base64"));
-  return join("snapshots", filename);
+  return relative(projectDir, path);
 }
 async function captureFindingCrops(project, options, requests) {
-  const module = await import("./checkBrowser-MXBDNZJB.js");
+  const module = await import("./checkBrowser-MSTVEL4V.js");
   return module.captureFindingCrops(project, options, requests);
 }
 var DEFAULT_DEPENDENCIES2 = {
@@ -1325,9 +1434,86 @@ var examples = [
 ];
 var DEFAULT_COMMAND_DEPENDENCIES = {
   resolveProject,
-  runPipeline: runCheckPipeline,
+  async runPipeline(project, options) {
+    const capture = await captureArtifactRevision(project.dir).catch(warnNotRecorded);
+    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));
+    if (!capture) return report;
+    try {
+      return { ...report, saved: await saveCheckReport(project, options, report, capture) };
+    } catch (error) {
+      warnNotRecorded(error);
+      return report;
+    }
+  },
   withMeta
 };
+function warnNotRecorded(error) {
+  console.warn(`${c.warn("\u26A0")}  Check report was not recorded: ${normalizeErrorMessage(error)}`);
+  return void 0;
+}
+async function saveCheckReport(project, options, report, capture) {
+  const id = randomUUID();
+  const directory = join2(project.dir, ".hyperframes", "artifacts", "checks");
+  mkdirSync2(directory, { recursive: true });
+  const path = join2(directory, `${id}.json`);
+  writeFileSync2(path, JSON.stringify(report, null, 2) + "\n", { flag: "wx" });
+  const reportScope = "scope" in report && typeof report.scope === "object" && report.scope !== null ? report.scope : void 0;
+  const artifacts = [
+    {
+      kind: "check",
+      id,
+      scope: reportScope ? "scoped" : "project",
+      report: resolve(path),
+      metadata: {
+        ok: report.ok,
+        browserSkipped: report.browserSkipped,
+        scope: reportScope,
+        options
+      }
+    }
+  ];
+  for (const [index, image] of report.snapshots.files.entries()) {
+    artifacts.push({
+      kind: "snapshot",
+      id: `${id}-${index}`,
+      scope: "full",
+      image: resolve(project.dir, image),
+      time: report.snapshots.times[index],
+      metadata: {
+        checkId: id,
+        ...pngDimensions(resolve(project.dir, image))
+      }
+    });
+  }
+  const crops = selectFindingCropRequests(report);
+  for (const [index, image] of report.snapshots.findingFiles.entries()) {
+    const crop = crops.find((request) => image.endsWith(request.filename));
+    artifacts.push({
+      kind: "snapshot",
+      id: `${id}-crop-${index}`,
+      scope: "finding",
+      image: resolve(project.dir, image),
+      time: crop?.time,
+      metadata: {
+        checkId: id,
+        finding: crop,
+        ...pngDimensions(resolve(project.dir, image))
+      }
+    });
+  }
+  const [saved] = await recordArtifacts(project.dir, capture, artifacts);
+  if (!saved) throw new Error("no history record was written");
+  reportArtifacts("check", "check-report", [resolve(path)]);
+  return {
+    id: saved.id,
+    revision: saved.revision,
+    report: saved.report,
+    attribution: saved.attribution
+  };
+}
 var CHECK_COMMAND_ARGS = {
   dir: { type: "positional", description: "Project directory", required: false },
   json: { type: "boolean", description: "Output agent-readable JSON", default: false },
@@ -1336,6 +1522,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)"
@@ -1391,7 +1585,7 @@ var CHECK_COMMAND_ARGS = {
   },
   snapshots: {
     type: "boolean",
-    description: "Save the five contrast-pass PNGs under snapshots/",
+    description: "Save contrast-pass PNGs under .hyperframes/artifacts/snapshots/",
     default: false
   },
   "caption-zone": {
@@ -1423,11 +1617,21 @@ 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 {
           printHumanReport(report);
+          if (report.saved) {
+            console.log(`Report: ${report.saved.report}`);
+            console.log(
+              `Revision: ${report.saved.revision ?? "none"} (${report.saved.attribution})`
+            );
+          }
         }
         setCommandExitCode(checkExitCode(report));
       } catch (error) {
@@ -1448,6 +1652,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 +1671,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 +1836,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 +1858,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 +1874,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 +1897,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 +1948,7 @@ export {
   createCheckCommand,
   check_default as default,
   examples,
+  parseCheckRange,
   parseFrameCheck,
   parseLayout
 };