hyperframes 0.7.75 → 0.7.77

package/dist/cli.js

@@ -50,7 +50,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = true ? "0.7.75" : "0.0.0-dev";
+    VERSION = true ? "0.7.77" : "0.0.0-dev";
   }
 });
 
@@ -88675,57 +88675,15 @@ var init_system = __esm({
   }
 });
 
-// src/telemetry/client.ts
+// src/telemetry/transport.ts
 import { spawn as spawn5 } from "child_process";
 import { randomUUID as randomUUID3 } from "crypto";
-function shouldTrack() {
-  if (telemetryEnabled !== null) return telemetryEnabled;
-  if (process.env["HYPERFRAMES_NO_TELEMETRY"] === "1" || process.env["DO_NOT_TRACK"] === "1") {
-    telemetryEnabled = false;
-    return false;
-  }
-  if (isDevMode()) {
-    telemetryEnabled = false;
-    return false;
-  }
-  if (!POSTHOG_API_KEY.startsWith("phc_")) {
-    telemetryEnabled = false;
-    return false;
-  }
-  const config = readConfig();
-  telemetryEnabled = config.telemetryEnabled;
-  return telemetryEnabled;
-}
-function trackEvent(event, properties = {}, distinctId) {
-  if (!shouldTrack()) return;
-  const sys = getSystemMeta();
+function enqueue(event, properties, distinctId) {
   eventQueue.push({
     uuid: randomUUID3(),
     event,
     distinctId,
-    properties: {
-      ...properties,
-      cli_version: VERSION,
-      os: process.platform,
-      arch: process.arch,
-      node_version: process.version,
-      os_release: sys.os_release,
-      cpu_count: sys.cpu_count,
-      cpu_model: sys.cpu_model ?? void 0,
-      cpu_speed: sys.cpu_speed ?? void 0,
-      memory_total_mb: sys.memory_total_mb,
-      is_docker: sys.is_docker,
-      is_ci: sys.is_ci,
-      ci_name: sys.ci_name ?? void 0,
-      is_wsl: sys.is_wsl,
-      is_tty: sys.is_tty,
-      sandbox_runtime: sys.sandbox_runtime ?? void 0,
-      agent_runtime: sys.agent_runtime ?? void 0,
-      // New-agent discovery signals — populated only when agent_runtime is null.
-      agent_hint: sys.agent_hint ?? void 0,
-      term_program: sys.term_program ?? void 0,
-      agent_env_hints: sys.agent_env_hints ?? void 0
-    },
+    properties,
     timestamp: (/* @__PURE__ */ new Date()).toISOString()
   });
 }
@@ -88778,6 +88736,68 @@ function flushSync() {
   } catch {
   }
 }
+var POSTHOG_API_KEY, POSTHOG_HOST, FLUSH_TIMEOUT_MS, eventQueue;
+var init_transport = __esm({
+  "src/telemetry/transport.ts"() {
+    "use strict";
+    init_config();
+    POSTHOG_API_KEY = "phc_zjjbX0PnWxERXrMHhkEJWj9A9BhGVLRReICgsfTMmpx";
+    POSTHOG_HOST = "https://us.i.posthog.com";
+    FLUSH_TIMEOUT_MS = 5e3;
+    eventQueue = [];
+  }
+});
+
+// src/telemetry/client.ts
+function shouldTrack() {
+  if (telemetryEnabled !== null) return telemetryEnabled;
+  if (process.env["HYPERFRAMES_NO_TELEMETRY"] === "1" || process.env["DO_NOT_TRACK"] === "1") {
+    telemetryEnabled = false;
+    return false;
+  }
+  if (isDevMode()) {
+    telemetryEnabled = false;
+    return false;
+  }
+  if (!POSTHOG_API_KEY.startsWith("phc_")) {
+    telemetryEnabled = false;
+    return false;
+  }
+  const config = readConfig();
+  telemetryEnabled = config.telemetryEnabled;
+  return telemetryEnabled;
+}
+function trackEvent(event, properties = {}, distinctId) {
+  if (!shouldTrack()) return;
+  const sys = getSystemMeta();
+  enqueue(
+    event,
+    {
+      ...properties,
+      cli_version: VERSION,
+      os: process.platform,
+      arch: process.arch,
+      node_version: process.version,
+      os_release: sys.os_release,
+      cpu_count: sys.cpu_count,
+      cpu_model: sys.cpu_model ?? void 0,
+      cpu_speed: sys.cpu_speed ?? void 0,
+      memory_total_mb: sys.memory_total_mb,
+      is_docker: sys.is_docker,
+      is_ci: sys.is_ci,
+      ci_name: sys.ci_name ?? void 0,
+      is_wsl: sys.is_wsl,
+      is_tty: sys.is_tty,
+      sandbox_runtime: sys.sandbox_runtime ?? void 0,
+      agent_runtime: sys.agent_runtime ?? void 0,
+      // New-agent discovery signals — populated only when agent_runtime is null.
+      agent_hint: sys.agent_hint ?? void 0,
+      term_program: sys.term_program ?? void 0,
+      agent_env_hints: sys.agent_env_hints ?? void 0
+    },
+    distinctId
+  );
+}
 function showTelemetryNotice() {
   if (!shouldTrack()) return false;
   const config = readConfig();
@@ -88795,7 +88815,7 @@ function showTelemetryNotice() {
   diag.notice();
   return true;
 }
-var POSTHOG_API_KEY, POSTHOG_HOST, FLUSH_TIMEOUT_MS, eventQueue, telemetryEnabled;
+var telemetryEnabled;
 var init_client = __esm({
   "src/telemetry/client.ts"() {
     "use strict";
@@ -88805,10 +88825,8 @@ var init_client = __esm({
     init_diagnostics2();
     init_env();
     init_system();
-    POSTHOG_API_KEY = "phc_zjjbX0PnWxERXrMHhkEJWj9A9BhGVLRReICgsfTMmpx";
-    POSTHOG_HOST = "https://us.i.posthog.com";
-    FLUSH_TIMEOUT_MS = 5e3;
-    eventQueue = [];
+    init_transport();
+    init_transport();
     telemetryEnabled = null;
   }
 });
@@ -89121,11 +89139,10 @@ function trackSkillsInstallSkipped(props) {
   trackEvent("cli skill install skipped", { reason: props.reason });
 }
 function trackRenderFeedback(props) {
-  trackEvent("survey sent", {
-    $survey_id: "render_satisfaction",
-    $survey_response: props.rating,
+  trackEvent("cli_render_feedback", {
+    rating: props.rating,
     rating_scale: FEEDBACK_RATING_SCALE,
-    ...props.comment ? { $survey_response_2: props.comment } : {},
+    ...props.comment ? { comment: props.comment } : {},
     ...props.renderDurationMs !== void 0 ? { render_duration_ms: props.renderDurationMs } : {},
     ...props.doctorSummary ? { doctor_summary: props.doctorSummary } : {},
     ...props.feedbackId ? { feedback_id: props.feedbackId } : {},
@@ -92120,7 +92137,11 @@ function downloadFile(url, dest, options = {}) {
   const timeoutMs = options.timeoutMs ?? DEFAULT_DOWNLOAD_TIMEOUT_MS;
   return new Promise((resolve77, reject) => {
     const follow = (u) => {
+      let activeResponse;
+      let responsePipelineStarted = false;
+      let requestError;
       const request = httpsGet(u, (res) => {
+        activeResponse = res;
         if (res.statusCode === 301 || res.statusCode === 302) {
           const location = res.headers.location;
           if (location) {
@@ -92136,18 +92157,24 @@ function downloadFile(url, dest, options = {}) {
           return;
         }
         const file = createWriteStream2(tmp);
+        responsePipelineStarted = true;
         pipeline2(res, file).then(() => {
           renameSync5(tmp, dest);
           resolve77();
         }).catch((err) => {
           removePartialFile(tmp);
-          reject(err);
+          reject(requestError ?? err);
         });
       });
       request.setTimeout(timeoutMs, () => {
         request.destroy(new Error(`Download timed out after ${timeoutMs}ms`));
       });
       request.on("error", (err) => {
+        if (responsePipelineStarted) {
+          requestError = err;
+          activeResponse?.destroy(err);
+          return;
+        }
         removePartialFile(tmp);
         reject(err);
       });
@@ -105263,6 +105290,14 @@ function bakeVisibilityOnDelete(document2, anim) {
   } catch {
   }
 }
+function resolveReplacementEaseEach(scriptText, request) {
+  if (request.easeEach !== void 0) return request.easeEach;
+  const original = parseGsapScriptAcorn2(scriptText).animations.find(
+    (animation) => animation.id === request.animationId
+  );
+  if (!original?.arcPath?.enabled) return void 0;
+  return original?.keyframes?.easeEach ?? original?.ease;
+}
 async function executeGsapMutation(body, block, respond2, writer) {
   if (writer === "recast") {
     return executeGsapMutationRecast(body, block, respond2);
@@ -105617,7 +105652,8 @@ function executeGsapMutationAcorn(body, block, respond2) {
         body.position,
         body.duration,
         body.keyframes,
-        body.ease
+        body.ease,
+        resolveReplacementEaseEach(block.scriptText, body)
       );
       return added.script;
     }
@@ -105947,7 +105983,8 @@ async function executeGsapMutationRecast(body, block, respond2) {
         body.position,
         body.duration,
         body.keyframes,
-        body.ease
+        body.ease,
+        resolveReplacementEaseEach(block.scriptText, body)
       );
       return added.script;
     }
@@ -125538,6 +125575,14 @@ function isExtractionCacheCompleteSentinelPath(path2) {
   const segments = path2.split("/");
   return segments.length === 3 && segments[0] === "video-frames" && segments[1] !== "" && segments[2] === EXTRACTION_CACHE_COMPLETE_SENTINEL;
 }
+function resolveExtractedVideoOutputDir(planDir, videoId) {
+  const videoRoot = resolve36(planDir, "video-frames");
+  const outputDir = resolve36(videoRoot, videoId);
+  if (outputDir === videoRoot || !outputDir.startsWith(`${videoRoot}${sep10}`)) {
+    throw new PlanV2IntegrityError(`unsafe extracted video id: ${JSON.stringify(videoId)}`);
+  }
+  return outputDir;
+}
 function artifactTargets(path2, videoDependencies) {
   if (path2 === PLAN_AUDIO_RELATIVE_PATH) return { chunks: [], assembler: true };
   if (path2 === "plan.json" || path2 === "meta/chunks.json" || path2 === "meta/encoder.json") {
@@ -125556,7 +125601,7 @@ function artifactTargets(path2, videoDependencies) {
 }
 function listVideoFramePaths(planV1Dir, videos) {
   return videos.extracted.map((video) => {
-    const outputDir = join68(planV1Dir, "video-frames", video.videoId);
+    const outputDir = resolveExtractedVideoOutputDir(planV1Dir, video.videoId);
     const frameNames = readdirSync19(outputDir).sort();
     const framePaths = /* @__PURE__ */ new Map();
     for (const frameName of frameNames) {
@@ -125670,6 +125715,14 @@ function parsePlanVideosJson(value) {
   });
   return { videos, extracted };
 }
+function materializeExtractedVideoDirectories(planDir) {
+  const videosPath = join68(planDir, PLAN_VIDEOS_META_RELATIVE_PATH);
+  if (!existsSync59(videosPath)) return;
+  const videos = parsePlanVideosJson(readJsonFile(videosPath, PLAN_VIDEOS_META_RELATIVE_PATH));
+  for (const video of videos.extracted) {
+    mkdirSync31(resolveExtractedVideoOutputDir(planDir, video.videoId), { recursive: true });
+  }
+}
 function parseChunkSlices(value) {
   if (!Array.isArray(value)) {
     throw new PlanV2IntegrityError("meta/chunks.json must be an array");
@@ -126077,6 +126130,7 @@ function materializePlanV2Target(planV2Dir, target, destinationDir) {
       mkdirSync31(dirname30(destinationPath), { recursive: true });
       copyFileSync8(sourcePath, destinationPath);
     }
+    if (target.role === "chunk") materializeExtractedVideoDirectories(tempDir);
     writeFileSync23(
       join68(tempDir, PLAN_V2_MATERIALIZATION_MARKER),
       canonicalJsonStringify({ manifest, target }),
@@ -138752,7 +138806,7 @@ function createPageDriver(page, setTime) {
       setTime(time);
       await seekCompositionTimeline(page, time, DENSE_GEOMETRY_SEEK_OPTIONS);
     },
-    collectLayout: (time, tolerance) => collectLayout(page, time, tolerance),
+    collectLayout: (time, tolerance, layout2) => collectLayout(page, time, tolerance, layout2),
     collectOverlap: (time) => collectOverlap(page, time),
     collectLayoutGeometry: () => collectLayoutGeometry(page),
     collectRotationSample: (time) => collectRotationSample(page, time),
@@ -138838,7 +138892,7 @@ async function collectTweenBoundaries2(page) {
     return boundaries.filter(Number.isFinite);
   });
 }
-async function collectLayout(page, time, tolerance) {
+async function collectLayout(page, time, tolerance, layout2) {
   const raw = await page.evaluate(
     (options) => {
       const audit = Reflect.get(window, "__hyperframesLayoutAudit");
@@ -138846,7 +138900,11 @@ async function collectLayout(page, time, tolerance) {
       const result = Reflect.apply(audit, window, [options]);
       return Array.isArray(result) ? result : [];
     },
-    { time, tolerance }
+    {
+      time,
+      tolerance,
+      ...typeof layout2?.proseCoverageFloor === "number" ? { proseCoverageFloor: layout2.proseCoverageFloor } : {}
+    }
   );
   return anchorLayoutIssues(page, raw.flatMap(parseLayoutIssue));
 }
@@ -139618,7 +139676,7 @@ async function collectGridSamples(driver, options, grid, motion) {
     await driver.seek(time);
     const issuesAtTime = [];
     if (layoutSet.has(time)) {
-      const layoutIssues = await driver.collectLayout(time, options.tolerance);
+      const layoutIssues = await driver.collectLayout(time, options.tolerance, options.layout);
       collected.layoutIssues.push(...layoutIssues);
       issuesAtTime.push(...layoutIssues);
       collected.geometrySignatures.push(await driver.collectLayoutGeometry());
@@ -139770,13 +139828,63 @@ function hasEnoughRotationSamples(group) {
 function isActuallySpinning(group) {
   return maxAngleSpread(group.map((s2) => s2.angle)) > ROTATION_MIN_ANGLE_SPREAD_DEG;
 }
+function aabbForRotatedRect(elemW, elemH, angleDeg) {
+  const rad = angleDeg * Math.PI / 180;
+  const cosAbs = Math.abs(Math.cos(rad));
+  const sinAbs = Math.abs(Math.sin(rad));
+  return { w: elemW * cosAbs + elemH * sinAbs, h: elemW * sinAbs + elemH * cosAbs };
+}
+function unrotatedSizeFromSample(sample) {
+  const rad = sample.angle * Math.PI / 180;
+  const cosAbs = Math.abs(Math.cos(rad));
+  const sinAbs = Math.abs(Math.sin(rad));
+  const det = cosAbs * cosAbs - sinAbs * sinAbs;
+  if (Math.abs(det) < ROTATION_RIGID_ESTIMATE_MIN_DET) return null;
+  const elemW = (cosAbs * sample.w - sinAbs * sample.h) / det;
+  const elemH = (cosAbs * sample.h - sinAbs * sample.w) / det;
+  if (!(elemW > 0) || !(elemH > 0)) return null;
+  return { w: elemW, h: elemH };
+}
+function aabbMatchesSample(expected, sample) {
+  if (expected.w <= 0 || expected.h <= 0 || sample.w <= 0 || sample.h <= 0) return false;
+  return Math.max(expected.w, sample.w) / Math.min(expected.w, sample.w) <= ROTATION_RIGID_AABB_RATIO && Math.max(expected.h, sample.h) / Math.min(expected.h, sample.h) <= ROTATION_RIGID_AABB_RATIO;
+}
+function isSingularRotationAngle(angleDeg) {
+  const rad = angleDeg * Math.PI / 180;
+  const cosAbs = Math.abs(Math.cos(rad));
+  const sinAbs = Math.abs(Math.sin(rad));
+  return Math.abs(cosAbs * cosAbs - sinAbs * sinAbs) < ROTATION_RIGID_ESTIMATE_MIN_DET;
+}
+function isNearSquareAabb(sample) {
+  if (sample.w <= 0 || sample.h <= 0) return false;
+  return Math.max(sample.w, sample.h) / Math.min(sample.w, sample.h) <= ROTATION_RIGID_AABB_RATIO;
+}
+function fitsSingularPhaseRigidProjection(group) {
+  if (group.length === 0 || !group.every((s2) => isSingularRotationAngle(s2.angle))) return false;
+  if (!group.every(isNearSquareAabb)) return false;
+  const ref2 = group[0];
+  if (!ref2) return false;
+  return group.every((sample) => aabbMatchesSample({ w: ref2.w, h: ref2.h }, sample));
+}
+function fitsOneRigidRectangle(group) {
+  for (const ref2 of group) {
+    const size = unrotatedSizeFromSample(ref2);
+    if (!size) continue;
+    if (group.every(
+      (sample) => aabbMatchesSample(aabbForRotatedRect(size.w, size.h, sample.angle), sample)
+    )) {
+      return true;
+    }
+  }
+  return fitsSingularPhaseRigidProjection(group);
+}
 function isRotationSizeStable(group) {
-  const widths = group.map((s2) => s2.w);
-  const heights = group.map((s2) => s2.h);
-  const minWidth = Math.min(...widths);
-  const minHeight = Math.min(...heights);
-  if (minWidth <= 0 || minHeight <= 0) return false;
-  return Math.max(...widths) / minWidth <= ROTATION_MAX_SIZE_RATIO && Math.max(...heights) / minHeight <= ROTATION_MAX_SIZE_RATIO;
+  if (group.some((s2) => s2.w <= 0 || s2.h <= 0)) return false;
+  const longSides = group.map((s2) => Math.max(s2.w, s2.h));
+  const minLong = Math.min(...longSides);
+  if (minLong <= 0) return false;
+  if (Math.max(...longSides) / minLong > ROTATION_MAX_SIZE_RATIO) return false;
+  return fitsOneRigidRectangle(group);
 }
 function isSizableRotation(group) {
   return median(group.map((s2) => s2.w * s2.h)) >= ROTATION_MIN_MEDIAN_AREA_PX;
@@ -140337,7 +140445,7 @@ async function captureFindingCrops2(project, options, requests) {
   const module = await Promise.resolve().then(() => (init_checkBrowser(), checkBrowser_exports));
   return module.captureFindingCrops(project, options, requests);
 }
-var MOTION_FPS2, MOTION_MAX_SAMPLES2, ZERO_BBOX, FRAME_BREACH_FLOOR_PX, FRAME_BREACH_FLOOR_FRACTION, DEFAULT_CHECK_OPTIONS, OVERLAP_SAMPLE_FPS, OVERLAP_MAX_SAMPLES, SWEEP_STATIC_MIN_DURATION_SEC, ZERO_LAYOUT_RECT, ROTATION_MIN_SAMPLES, ROTATION_MIN_ANGLE_SPREAD_DEG, ROTATION_MAX_SIZE_RATIO, ROTATION_MIN_MEDIAN_AREA_PX, ROTATION_DRIFT_SIZE_FRACTION, ROTATION_DRIFT_VIEWPORT_FRACTION, INDICATOR_MIN_SAMPLES, INDICATOR_MIN_ANGLE_SPREAD_DEG, INDICATOR_MIN_HUB_CIRCLES, INDICATOR_MAX_FIT_RESIDUAL_FRACTION, INDICATOR_MAX_RIGID_LEN_VARIATION, INDICATOR_DRIFT_LENGTH_FRACTION, INDICATOR_MIN_HUB_PRESENCE_FRACTION, MAX_FINDING_CROPS, DEFAULT_DEPENDENCIES;
+var MOTION_FPS2, MOTION_MAX_SAMPLES2, ZERO_BBOX, FRAME_BREACH_FLOOR_PX, FRAME_BREACH_FLOOR_FRACTION, DEFAULT_CHECK_OPTIONS, OVERLAP_SAMPLE_FPS, OVERLAP_MAX_SAMPLES, SWEEP_STATIC_MIN_DURATION_SEC, ZERO_LAYOUT_RECT, ROTATION_MIN_SAMPLES, ROTATION_MIN_ANGLE_SPREAD_DEG, ROTATION_MAX_SIZE_RATIO, ROTATION_RIGID_AABB_RATIO, ROTATION_RIGID_ESTIMATE_MIN_DET, ROTATION_MIN_MEDIAN_AREA_PX, ROTATION_DRIFT_SIZE_FRACTION, ROTATION_DRIFT_VIEWPORT_FRACTION, INDICATOR_MIN_SAMPLES, INDICATOR_MIN_ANGLE_SPREAD_DEG, INDICATOR_MIN_HUB_CIRCLES, INDICATOR_MAX_FIT_RESIDUAL_FRACTION, INDICATOR_MAX_RIGID_LEN_VARIATION, INDICATOR_DRIFT_LENGTH_FRACTION, INDICATOR_MIN_HUB_PRESENCE_FRACTION, MAX_FINDING_CROPS, DEFAULT_DEPENDENCIES;
 var init_checkPipeline = __esm({
   "src/utils/checkPipeline.ts"() {
     "use strict";
@@ -140380,6 +140488,8 @@ var init_checkPipeline = __esm({
     ROTATION_MIN_SAMPLES = 3;
     ROTATION_MIN_ANGLE_SPREAD_DEG = 20;
     ROTATION_MAX_SIZE_RATIO = 1.6;
+    ROTATION_RIGID_AABB_RATIO = 1.15;
+    ROTATION_RIGID_ESTIMATE_MIN_DET = 0.15;
     ROTATION_MIN_MEDIAN_AREA_PX = 2500;
     ROTATION_DRIFT_SIZE_FRACTION = 0.1;
     ROTATION_DRIFT_VIEWPORT_FRACTION = 0.02;
@@ -140407,7 +140517,8 @@ __export(check_exports, {
   createCheckCommand: () => createCheckCommand,
   default: () => check_default,
   examples: () => examples12,
-  parseFrameCheck: () => parseFrameCheck
+  parseFrameCheck: () => parseFrameCheck,
+  parseLayout: () => parseLayout
 });
 function createCheckCommand(dependencies = DEFAULT_COMMAND_DEPENDENCIES) {
   return defineCommand({
@@ -140483,6 +140594,10 @@ function createCheckCommand(dependencies = DEFAULT_COMMAND_DEPENDENCIES) {
       "frame-check": {
         type: "string",
         description: 'Bare --frame-check uses defaults (tol=2px, severity=warning, seek=.5; breach floor=max(120px, 6% of shorter canvas edge)); or pass "severity=error;seek=.25,.75;tol=4" to tune'
+      },
+      layout: {
+        type: "string",
+        description: 'Layout knobs: "proseCoverageFloor=0.05" (0\u20131; default 0.15).'
       }
     },
     async run({ args }) {
@@ -140530,6 +140645,7 @@ function parseCheckOptions(args) {
     snapshots: args.snapshots === true,
     captionZone: parseCaptionZone(args["caption-zone"]),
     frameCheck: parseFrameCheck(args["frame-check"]),
+    layout: parseLayout(args.layout),
     autoProxy: args.proxy
   };
 }
@@ -140558,8 +140674,8 @@ function parseFrameCheckFields(value) {
 }
 function parseFrameCheckTolerance(raw) {
   if (raw === void 0) return void 0;
-  const tol = Number.parseFloat(raw);
-  if (!Number.isFinite(tol) || tol < 0) throw frameCheckError();
+  const tol = parseNumberStrict(raw);
+  if (tol === null || tol < 0) throw frameCheckError();
   return tol;
 }
 function frameCheckError() {
@@ -140567,6 +140683,45 @@ function frameCheckError() {
     'Invalid --frame-check: use bare --frame-check or "severity=warning|error;seek=.25,.75;tol=4" (all fields optional)'
   );
 }
+function parseLayout(value) {
+  if (value === void 0 || value === null || value === false) return void 0;
+  if (value === true || value === "") throw layoutError();
+  if (typeof value !== "string") throw layoutError();
+  const fields = parseLayoutFields(value);
+  const proseCoverageFloor = parseProseCoverageFloor(fields.get("proseCoverageFloor"));
+  if (proseCoverageFloor === void 0) throw layoutError();
+  return { proseCoverageFloor };
+}
+function parseLayoutFields(value) {
+  const fields = /* @__PURE__ */ new Map();
+  for (const part of value.split(";")) {
+    const trimmed = part.trim();
+    if (!trimmed) continue;
+    const separator = trimmed.indexOf("=");
+    if (separator <= 0) throw layoutError();
+    const key2 = trimmed.slice(0, separator).trim();
+    const entry = trimmed.slice(separator + 1).trim();
+    if (!LAYOUT_FIELDS.has(key2) || fields.has(key2)) throw layoutError();
+    fields.set(key2, entry);
+  }
+  return fields;
+}
+function parseProseCoverageFloor(raw) {
+  if (raw === void 0) return void 0;
+  const floor = parseNumberStrict(raw);
+  if (floor === null || floor < 0 || floor > 1) throw layoutError();
+  return floor;
+}
+function layoutError() {
+  return new Error(
+    'Invalid --layout: use "proseCoverageFloor=0.05" with a fraction from 0 to 1 (inclusive)'
+  );
+}
+function parseNumberStrict(raw) {
+  if (raw === "") return null;
+  const value = Number(raw);
+  return Number.isFinite(value) ? value : null;
+}
 function parseCaptionZone(value) {
   if (value === void 0 || value === null) return void 0;
   const fields = parseCaptionFields(captionZoneString(value));
@@ -140618,8 +140773,8 @@ function requiredCaptionFraction(fields, key2) {
 }
 function captionFraction(value) {
   if (value === void 0 || value === "") return null;
-  const parsed = Number(value);
-  return Number.isFinite(parsed) && parsed >= 0 && parsed <= 1 ? parsed : null;
+  const parsed = parseNumberStrict(value);
+  return parsed !== null && parsed >= 0 && parsed <= 1 ? parsed : null;
 }
 function captionSeverity(value) {
   if (value === void 0) return void 0;
@@ -140739,7 +140894,7 @@ function printCounts(section2) {
     `  ${c.dim(`${section2.errorCount} error(s), ${section2.warningCount} warning(s), ${section2.infoCount} info(s)`)}`
   );
 }
-var examples12, DEFAULT_COMMAND_DEPENDENCIES, CAPTION_ZONE_FIELDS, FRAME_CHECK_FIELDS, check_default;
+var examples12, DEFAULT_COMMAND_DEPENDENCIES, CAPTION_ZONE_FIELDS, FRAME_CHECK_FIELDS, LAYOUT_FIELDS, check_default;
 var init_check = __esm({
   "src/commands/check.ts"() {
     "use strict";
@@ -140765,6 +140920,7 @@ var init_check = __esm({
     };
     CAPTION_ZONE_FIELDS = /* @__PURE__ */ new Set(["x0", "y0", "x1", "y1", "severity", "seek"]);
     FRAME_CHECK_FIELDS = /* @__PURE__ */ new Set(["severity", "seek", "tol"]);
+    LAYOUT_FIELDS = /* @__PURE__ */ new Set(["proseCoverageFloor"]);
     check_default = createCheckCommand();
   }
 });