miriad-viz 0.13.2 → 0.13.4

package/dist-cli/{from-curation-chain-4DRH35PM.js → chunk-4UVZ4276.js}

@@ -8,6 +8,23 @@ import {
 // src/cli/from-curation-chain.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { resolve } from "path";
+var MAX_VIZ_SPEED = 10;
+function validateNarrationGaps(narration) {
+  const errors = [];
+  for (let i = 0; i < narration.length - 1; i++) {
+    const current = narration[i];
+    const next = narration[i + 1];
+    const gap = next.progress - current.progress;
+    const minGap = current.clipDuration / MAX_VIZ_SPEED;
+    if (gap < minGap) {
+      const suggestedProgress = (current.progress + minGap).toFixed(1);
+      errors.push(
+        `"${current.id}" (${current.clipDuration.toFixed(1)}s clip) needs gap \u2265 ${minGap.toFixed(1)} but only has ${gap.toFixed(1)} before "${next.id}" \u2014 move "${next.id}" to at least progress ${suggestedProgress}`
+      );
+    }
+  }
+  return errors;
+}
 var DEFAULT_PAUSE_SEC = 0.5;
 var DEFAULT_LEAD_IN_SEC = 1;
 var DEFAULT_TAIL_OUT_SEC = 2;
@@ -16,6 +33,13 @@ function deriveTimingFromCuration(curation, script) {
   if (narration.length === 0) {
     throw new Error("viz-curation.json has no narration lines");
   }
+  const overlapErrors = validateNarrationGaps(narration);
+  if (overlapErrors.length > 0) {
+    throw new Error(
+      `Narration overlap: ${overlapErrors.length} line${overlapErrors.length > 1 ? "s" : ""} too close together (max vizSpeed: ${MAX_VIZ_SPEED}x):
+${overlapErrors.join("\n")}`
+    );
+  }
   const scriptMap = new Map(script.lines.map((l) => [l.id, l]));
   const lines = [];
   let wallClock = DEFAULT_LEAD_IN_SEC;
@@ -52,6 +76,23 @@ function deriveTimingFromCuration(curation, script) {
     lines
   };
 }
+var PILL_PROGRESS_TOLERANCE = 1;
+function validateQuotePillSync(curation) {
+  const errors = [];
+  const { narration, pills } = curation;
+  for (const line of narration) {
+    if (line.type !== "quote") continue;
+    const hasMatchingPill = pills.some(
+      (pill) => pill.speaker === line.speaker && Math.abs(pill.progress - line.progress) <= PILL_PROGRESS_TOLERANCE
+    );
+    if (!hasMatchingPill) {
+      errors.push(
+        `${line.id} is a quote line at progress ${line.progress} but has no pill for speaker '${line.speaker}' \u2014 add a pill or keep the auto-generated anchor`
+      );
+    }
+  }
+  return errors;
+}
 function runFromCurationChain(dataDir) {
   const curationPath = resolve(dataDir, "viz-curation.json");
   const scriptPath = resolve(dataDir, "script.json");
@@ -83,6 +124,14 @@ function runFromCurationChain(dataDir) {
     const message = err instanceof Error ? err.message : String(err);
     return { success: false, error: `Invalid script.json: ${message}` };
   }
+  const pillErrors = validateQuotePillSync(curation);
+  if (pillErrors.length > 0) {
+    return {
+      success: false,
+      error: `Quote-pill sync errors:
+${pillErrors.map((e) => `  \u2022 ${e}`).join("\n")}`
+    };
+  }
   let timing;
   try {
     timing = deriveTimingFromCuration(curation, script);
@@ -112,7 +161,11 @@ function runFromCurationChain(dataDir) {
   ].join("\n");
   return { success: true, timingPath, previewTable };
 }
+
 export {
+  MAX_VIZ_SPEED,
+  validateNarrationGaps,
   deriveTimingFromCuration,
+  validateQuotePillSync,
   runFromCurationChain
 };

package/dist-cli/from-curation-chain-7YL3EAVT.js

@@ -0,0 +1,16 @@
+import {
+  MAX_VIZ_SPEED,
+  deriveTimingFromCuration,
+  runFromCurationChain,
+  validateNarrationGaps,
+  validateQuotePillSync
+} from "./chunk-4UVZ4276.js";
+import "./chunk-SKRQW7PY.js";
+import "./chunk-BD2KEZI4.js";
+export {
+  MAX_VIZ_SPEED,
+  deriveTimingFromCuration,
+  runFromCurationChain,
+  validateNarrationGaps,
+  validateQuotePillSync
+};

package/dist-cli/index.js

@@ -1948,7 +1948,7 @@ async function main() {
     case "transform": {
       const { projectDir, progress } = requireProject();
       const { parseDuration } = await import("./parse-duration-NVLCEFAF.js");
-      const { runTransform } = await import("./transform-YZF6PA3N.js");
+      const { runTransform } = await import("./transform-3OMHFHM7.js");
       const padding = {};
       if (typeof flags["pad-start"] === "string") {
         padding.padStartMs = parseDuration(flags["pad-start"]);
@@ -1964,7 +1964,7 @@ async function main() {
       const port = typeof flags.port === "string" ? Number.parseInt(flags.port, 10) : void 0;
       if (flags["from-curation"] === true) {
         const dataDir = resolve3(projectDir, progress.project.dataDir);
-        const { runFromCurationChain } = await import("./from-curation-chain-4DRH35PM.js");
+        const { runFromCurationChain } = await import("./from-curation-chain-7YL3EAVT.js");
         console.log("\n\u{1F517} Running from-curation chain: curation \u2192 timing \u2192 transform \u2192 preview\n");
         const chainResult = runFromCurationChain(dataDir);
         if (!chainResult.success) {
@@ -1976,7 +1976,7 @@ async function main() {
           console.log("");
           console.log(chainResult.previewTable);
         }
-        const { runTransform } = await import("./transform-YZF6PA3N.js");
+        const { runTransform } = await import("./transform-3OMHFHM7.js");
         await runTransform({ projectDir, progress });
         const { runPreview: runPreview2 } = await import("./preview-7AGBBMPI.js");
         await runPreview2({ projectDir, progress, port, noOpen: flags["no-open"] === true });
@@ -1996,7 +1996,7 @@ async function main() {
           console.log("");
           console.log(chainResult.previewTable);
         }
-        const { runTransform } = await import("./transform-YZF6PA3N.js");
+        const { runTransform } = await import("./transform-3OMHFHM7.js");
         await runTransform({ projectDir, progress });
         const { runPreview: runPreview2 } = await import("./preview-7AGBBMPI.js");
         await runPreview2({ projectDir, progress, port, noOpen: flags["no-open"] === true });

package/dist-cli/{transform-YZF6PA3N.js → transform-3OMHFHM7.js}

@@ -18,9 +18,13 @@ import {
   markInProgress,
   writeProgress
 } from "./chunk-GLABTDMO.js";
+import {
+  validateNarrationGaps
+} from "./chunk-4UVZ4276.js";
 import {
   TimingFileSchema
 } from "./chunk-SKRQW7PY.js";
+import "./chunk-BD2KEZI4.js";
 
 // src/cli/guided/steps/transform.ts
 import { resolve as resolve2 } from "path";
@@ -719,8 +723,18 @@ function runPipeline(dataDir, outDir, options) {
   }
   const curationPath = resolve(dataDir, "viz-curation.json");
   if (existsSync(curationPath)) {
+    const curationRaw = JSON.parse(readFileSync(curationPath, "utf-8"));
+    const narration = curationRaw?.narration ?? [];
+    if (narration.length > 0) {
+      const gapErrors = validateNarrationGaps(narration);
+      if (gapErrors.length > 0) {
+        throw new Error(
+          `Narration overlap in viz-curation.json \u2014 ${gapErrors.length} line${gapErrors.length > 1 ? "s" : ""} too close:
+${gapErrors.join("\n")}`
+        );
+      }
+    }
     try {
-      const curationRaw = JSON.parse(readFileSync(curationPath, "utf-8"));
       const pills = curationRaw?.pills ?? [];
       if (pills.length > 0 && vizData.timeRange.durationMs > 0) {
         const { start, durationMs } = vizData.timeRange;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miriad-viz",
-  "version": "0.13.2",
+  "version": "0.13.4",
   "repository": {
     "type": "git",
     "url": "https://github.com/snorrees/miriad-viz.git"