miriad-viz 0.9.0 → 0.9.2

package/dist-cli/chunk-K6N7F6GL.js

@@ -0,0 +1,189 @@
+// src/cli/guided/validate-curated-files.ts
+function validateTimelineEvents(data) {
+  const errors = [];
+  const warnings = [];
+  if (data === null || typeof data !== "object" || !Array.isArray(data.events)) {
+    errors.push("timeline-events.json: `events` must be an array");
+    return { errors, warnings };
+  }
+  const events = data.events;
+  const messageBeanEvents = events.filter((e) => {
+    if (e === null || typeof e !== "object") return false;
+    const type = e.type;
+    return type === "message" || type === "beam";
+  });
+  if (messageBeanEvents.length === 0) {
+    errors.push(
+      "0 message/beam events \u2014 no chat pills will render. Add events with type 'message' or 'beam', fields: { type, t, from, to }."
+    );
+  }
+  const missingT = events.filter((e) => {
+    if (e === null || typeof e !== "object") return true;
+    return !e.t;
+  });
+  if (missingT.length > 0) {
+    warnings.push(
+      `${missingT.length} event(s) missing 't' field (timestamp) \u2014 events without timestamps may not render correctly`
+    );
+  }
+  const messageBeanMissingFields = messageBeanEvents.filter((e) => {
+    const ev = e;
+    return !ev.from || !ev.to;
+  });
+  if (messageBeanMissingFields.length > 0) {
+    warnings.push(
+      `${messageBeanMissingFields.length} message/beam event(s) missing 'from' or 'to' field \u2014 chat pills need both fields to render correctly`
+    );
+  }
+  if (messageBeanEvents.length === 0 && events.length > 0) {
+    const milestoneEvents = events.filter((e) => {
+      if (e === null || typeof e !== "object") return false;
+      return e.type === "milestone";
+    });
+    if (milestoneEvents.length > 0) {
+      warnings.push(
+        "Only milestone events found. Milestones render as markers, NOT chat pills. Add message/beam events for chat pills."
+      );
+    }
+  }
+  return { errors, warnings };
+}
+function validateRetroPageData(data) {
+  const errors = [];
+  const warnings = [];
+  if (data === null || typeof data !== "object") {
+    errors.push("retro-page-data.json: `meta` is missing or not an object");
+    return { errors, warnings };
+  }
+  const d = data;
+  if (d.meta === null || d.meta === void 0 || typeof d.meta !== "object") {
+    errors.push("retro-page-data.json: `meta` is missing or not an object");
+    return { errors, warnings };
+  }
+  const meta = d.meta;
+  if (!meta.title) {
+    errors.push("meta.title is required");
+  }
+  if (!meta.subtitle) {
+    errors.push("meta.subtitle is required");
+  }
+  if (!meta.startDate) {
+    errors.push(
+      "meta.startDate is required \u2014 transform uses this to calculate the project time span"
+    );
+  }
+  if (!meta.endDate) {
+    errors.push(
+      "meta.endDate is required \u2014 transform uses this to calculate the project time span"
+    );
+  }
+  if (!d.teamAssembly || !Array.isArray(d.teamAssembly) || d.teamAssembly.length === 0) {
+    warnings.push("No team assembly entries");
+  } else {
+    const teamAssembly = d.teamAssembly;
+    for (let i = 0; i < teamAssembly.length; i++) {
+      const entry = teamAssembly[i];
+      if (entry === null || typeof entry !== "object") continue;
+      const e = entry;
+      if (!e.agent) {
+        errors.push(`teamAssembly[${i}] missing 'agent' field \u2014 use 'agent', not 'name'`);
+      }
+      if (!e.time) {
+        warnings.push(
+          `teamAssembly[${i}] missing 'time' field \u2014 agent join timestamp will be null`
+        );
+      }
+    }
+  }
+  if (!d.phases || !Array.isArray(d.phases) || d.phases.length === 0) {
+    warnings.push("No phases defined \u2014 timeline will have no phase labels");
+  } else {
+    const phases = d.phases;
+    for (let i = 0; i < phases.length; i++) {
+      const phase = phases[i];
+      if (phase === null || typeof phase !== "object") continue;
+      const p = phase;
+      if (!p.start || !p.end) {
+        warnings.push(`phases[${i}] missing start/end timestamps`);
+      }
+    }
+  }
+  if (!d.milestones || !Array.isArray(d.milestones) || d.milestones.length === 0) {
+    warnings.push("No milestones defined");
+  }
+  if (!d.trustArc || !Array.isArray(d.trustArc) || d.trustArc.length === 0) {
+    warnings.push("No trust arc data");
+  }
+  if (!d.editorialNarration || !Array.isArray(d.editorialNarration) || d.editorialNarration.length === 0) {
+    warnings.push("No editorial narration \u2014 generic phase-based narration will be used");
+  }
+  return { errors, warnings };
+}
+function validateRetroPageQuotes(data) {
+  const errors = [];
+  const warnings = [];
+  if (data === null || typeof data !== "object" || Array.isArray(data)) {
+    errors.push("retro-page-quotes.json: must be an object (not an array or primitive)");
+    return { errors, warnings };
+  }
+  const d = data;
+  const categories = ["good", "bad", "ugly"];
+  const foundCategories = categories.filter(
+    (cat) => Array.isArray(d[cat]) && d[cat].length > 0
+  );
+  if (foundCategories.length === 0) {
+    warnings.push("No quote categories found");
+    return { errors, warnings };
+  }
+  for (const cat of foundCategories) {
+    const entries = d[cat];
+    for (let i = 0; i < entries.length; i++) {
+      const entry = entries[i];
+      if (entry === null || typeof entry !== "object") continue;
+      const e = entry;
+      if (e.speaker !== void 0 && e.author === void 0) {
+        warnings.push(`quotes[${i}] uses 'speaker' \u2014 should be 'author'`);
+      }
+      if (!e.text) {
+        warnings.push(`quotes[${i}] missing 'text' field`);
+      }
+      if (!e.timestamp) {
+        warnings.push(`quotes[${i}] missing 'timestamp' field`);
+      }
+    }
+  }
+  return { errors, warnings };
+}
+function validateCuratedFiles(timelineEvents, retroPageData, retroPageQuotes) {
+  const errors = [];
+  const warnings = [];
+  if (timelineEvents === null) {
+    errors.push("timeline-events.json: could not be read or parsed");
+  } else {
+    const r = validateTimelineEvents(timelineEvents);
+    errors.push(...r.errors);
+    warnings.push(...r.warnings);
+  }
+  if (retroPageData === null) {
+    errors.push("retro-page-data.json: could not be read or parsed");
+  } else {
+    const r = validateRetroPageData(retroPageData);
+    errors.push(...r.errors);
+    warnings.push(...r.warnings);
+  }
+  if (retroPageQuotes === null) {
+    errors.push("retro-page-quotes.json: could not be read or parsed");
+  } else {
+    const r = validateRetroPageQuotes(retroPageQuotes);
+    errors.push(...r.errors);
+    warnings.push(...r.warnings);
+  }
+  return { errors, warnings };
+}
+
+export {
+  validateTimelineEvents,
+  validateRetroPageData,
+  validateRetroPageQuotes,
+  validateCuratedFiles
+};

package/dist-cli/index.js

@@ -1579,6 +1579,7 @@ async function runNext(flags) {
     "audio-approved": flags["audio-approved"] === true || void 0,
     // v2 gate flags
     "script-approved": flags["script-approved"] === true || void 0,
+    "curate-approved": flags["curate-approved"] === true || void 0,
     "voices-approved": flags["voices-approved"] === true || void 0,
     "timing-approved": flags["timing-approved"] === true || void 0,
     "sound-approved": flags["sound-approved"] === true || void 0,
@@ -1597,6 +1598,34 @@ async function runNext(flags) {
     progress.project.dataDir,
     progress.project.outputDir
   );
+  if (flags["curate-approved"]) {
+    const { validateCuratedFiles } = await import("./validate-curated-files-ZLNFHBXT.js");
+    const curateDataDir = resolve3(projectDir, progress.project.dataDir);
+    const tryReadJSON = (filename) => {
+      try {
+        return JSON.parse(readFileSync2(resolve3(curateDataDir, filename), "utf-8"));
+      } catch {
+        return null;
+      }
+    };
+    const validation = validateCuratedFiles(
+      tryReadJSON("timeline-events.json"),
+      tryReadJSON("retro-page-data.json"),
+      tryReadJSON("retro-page-quotes.json")
+    );
+    if (validation.errors.length > 0) {
+      console.log("\n\u2717 Curation validation failed:\n");
+      for (const e of validation.errors) console.log(`  \u2717 ${e}`);
+      for (const w of validation.warnings) console.log(`  \u26A0 ${w}`);
+      console.log("\nFix the errors above and try again.");
+      process.exit(1);
+    }
+    if (validation.warnings.length > 0) {
+      console.log("\n\u26A0 Curation warnings:\n");
+      for (const w of validation.warnings) console.log(`  \u26A0 ${w}`);
+      console.log("");
+    }
+  }
   const result = computeNext(
     progress,
     existingFiles,
@@ -1682,7 +1711,7 @@ async function main() {
     case "transform": {
       const { projectDir, progress } = requireProject();
       const { parseDuration } = await import("./parse-duration-NVLCEFAF.js");
-      const { runTransform } = await import("./transform-SCT5EYPV.js");
+      const { runTransform } = await import("./transform-Z4LA7G44.js");
       const padding = {};
       if (typeof flags["pad-start"] === "string") {
         padding.padStartMs = parseDuration(flags["pad-start"]);
@@ -1710,7 +1739,7 @@ async function main() {
           console.log("");
           console.log(chainResult.previewTable);
         }
-        const { runTransform } = await import("./transform-SCT5EYPV.js");
+        const { runTransform } = await import("./transform-Z4LA7G44.js");
         await runTransform({ projectDir, progress });
         const { runPreview: runPreview2 } = await import("./preview-UUWVOX5Y.js");
         await runPreview2({ projectDir, progress, port, noOpen: flags["no-open"] === true });

package/dist-cli/{transform-SCT5EYPV.js → transform-Z4LA7G44.js}

@@ -1,3 +1,9 @@
+import {
+  TimingFileSchema
+} from "./chunk-SKRQW7PY.js";
+import {
+  validateCuratedFiles
+} from "./chunk-K6N7F6GL.js";
 import {
   buildArtifactData
 } from "./chunk-JITEBF25.js";
@@ -15,9 +21,6 @@ import {
   markInProgress,
   writeProgress
 } from "./chunk-GLABTDMO.js";
-import {
-  TimingFileSchema
-} from "./chunk-SKRQW7PY.js";
 
 // src/cli/guided/steps/transform.ts
 import { resolve as resolve2 } from "path";
@@ -659,6 +662,22 @@ function printDataInventory(summary, warnings) {
 }
 function runPipeline(dataDir, outDir, options) {
   const { sources, warnings } = loadSources(dataDir);
+  const curationValidation = validateCuratedFiles(
+    sources.timelineEvents,
+    sources.retroPageData,
+    sources.retroPageQuotes
+  );
+  if (curationValidation.errors.length > 0) {
+    console.warn("\n\u26A0 Curated file validation issues:\n");
+    for (const e of curationValidation.errors) console.warn(`  \u2717 ${e}`);
+    for (const w of curationValidation.warnings) console.warn(`  \u26A0 ${w}`);
+    console.warn("\n  Transform will continue, but output may be incomplete.");
+    console.warn("  Fix the issues above and re-run for best results.\n");
+  } else if (curationValidation.warnings.length > 0) {
+    console.warn("\n\u26A0 Curated file warnings:\n");
+    for (const w of curationValidation.warnings) console.warn(`  \u26A0 ${w}`);
+    console.warn("");
+  }
   const summary = validateSources(sources);
   printDataInventory(summary, warnings);
   const rawData = transformToRawData(sources);

package/dist-cli/validate-curated-files-ZLNFHBXT.js

@@ -0,0 +1,12 @@
+import {
+  validateCuratedFiles,
+  validateRetroPageData,
+  validateRetroPageQuotes,
+  validateTimelineEvents
+} from "./chunk-K6N7F6GL.js";
+export {
+  validateCuratedFiles,
+  validateRetroPageData,
+  validateRetroPageQuotes,
+  validateTimelineEvents
+};

package/dist-lib/viewer/exports.cjs

@@ -1795,6 +1795,20 @@ function computeTimeLabelWidth(totalHours) {
   return `${totalChars}ch`;
 }
 var MANUAL_SPEEDS = [0.5, 1, 2, 4];
+var MOBILE_BREAKPOINT = 640;
+function useIsMobile(breakpoint = MOBILE_BREAKPOINT) {
+  const [isMobile, setIsMobile] = react.useState(
+    () => typeof window !== "undefined" ? window.innerWidth <= breakpoint : false
+  );
+  react.useEffect(() => {
+    const mql = window.matchMedia(`(max-width: ${breakpoint}px)`);
+    const handler = (e) => setIsMobile(e.matches);
+    setIsMobile(mql.matches);
+    mql.addEventListener("change", handler);
+    return () => mql.removeEventListener("change", handler);
+  }, [breakpoint]);
+  return isMobile;
+}
 function PlayIcon({ size = 14 }) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     "svg",
@@ -1851,6 +1865,20 @@ function SoundOffIcon({ size = 16 }) {
     }
   );
 }
+function ChevronDownIcon({ size = 10 }) {
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    "svg",
+    {
+      width: size,
+      height: size,
+      viewBox: "0 0 24 24",
+      fill: "currentColor",
+      role: "img",
+      "aria-label": "Speed menu",
+      children: /* @__PURE__ */ jsxRuntime.jsx("path", { d: "M7 10l5 5 5-5z" })
+    }
+  );
+}
 function GearIcon({ size = 14 }) {
   return /* @__PURE__ */ jsxRuntime.jsx(
     "svg",
@@ -1878,6 +1906,19 @@ function Footer({
 }) {
   const { progress, playing, speed, toggle, setSpeed, scrub } = playback;
   const lastManualSpeed = react.useRef(1);
+  const isMobile = useIsMobile();
+  const [speedMenuOpen, setSpeedMenuOpen] = react.useState(false);
+  const speedMenuRef = react.useRef(null);
+  react.useEffect(() => {
+    if (!speedMenuOpen) return;
+    const handleClickOutside = (e) => {
+      if (speedMenuRef.current && !speedMenuRef.current.contains(e.target)) {
+        setSpeedMenuOpen(false);
+      }
+    };
+    document.addEventListener("mousedown", handleClickOutside);
+    return () => document.removeEventListener("mousedown", handleClickOutside);
+  }, [speedMenuOpen]);
   const isAuto = hasTimingFile && !muted;
   const handleKeyDown = react.useCallback(
     (e) => {
@@ -1959,10 +2000,69 @@ function Footer({
         step: 1e-3,
         value: progress,
         onChange: (e) => scrub(Number(e.target.value)),
-        style: scrubberStyle
+        style: isMobile ? mobileScrubberStyle : scrubberStyle
       }
     ),
-    /* @__PURE__ */ jsxRuntime.jsxs("div", { style: speedGroupStyle, children: [
+    isMobile ? /* @__PURE__ */ jsxRuntime.jsxs("div", { ref: speedMenuRef, style: speedMenuContainerStyle, children: [
+      /* @__PURE__ */ jsxRuntime.jsxs(
+        "button",
+        {
+          type: "button",
+          onClick: () => setSpeedMenuOpen((v) => !v),
+          style: {
+            ...speedMenuTriggerStyle,
+            color: speedMenuOpen ? "#00e5cc" : "#fff",
+            background: speedMenuOpen ? "rgba(0, 229, 204, 0.12)" : "rgba(255,255,255,0.08)"
+          },
+          title: "Speed",
+          children: [
+            isAuto ? "Auto" : `${speed}\xD7`,
+            /* @__PURE__ */ jsxRuntime.jsx(ChevronDownIcon, {})
+          ]
+        }
+      ),
+      speedMenuOpen && /* @__PURE__ */ jsxRuntime.jsxs("div", { style: speedMenuDropdownStyle, children: [
+        hasTimingFile && /* @__PURE__ */ jsxRuntime.jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => {
+              handleAutoClick();
+              setSpeedMenuOpen(false);
+            },
+            style: {
+              ...speedMenuItemStyle,
+              color: isAuto ? "#00e5cc" : "#fff",
+              fontWeight: isAuto ? 700 : 400
+            },
+            children: [
+              "Auto ",
+              autoSpeedLabel
+            ]
+          }
+        ),
+        MANUAL_SPEEDS.map((s) => /* @__PURE__ */ jsxRuntime.jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => {
+              handleManualSpeed(s);
+              setSpeedMenuOpen(false);
+            },
+            style: {
+              ...speedMenuItemStyle,
+              color: !isAuto && speed === s ? "#00e5cc" : "#fff",
+              fontWeight: !isAuto && speed === s ? 700 : 400
+            },
+            children: [
+              s,
+              "\xD7"
+            ]
+          },
+          s
+        ))
+      ] })
+    ] }) : /* @__PURE__ */ jsxRuntime.jsxs("div", { style: speedGroupStyle, children: [
       hasTimingFile && /* @__PURE__ */ jsxRuntime.jsxs(
         "button",
         {
@@ -2003,7 +2103,7 @@ function Footer({
         s
       ))
     ] }),
-    /* @__PURE__ */ jsxRuntime.jsx("span", { style: { ...timeLabelStyle, width: timeLabelWidth }, children: timeLabel }),
+    !isMobile && /* @__PURE__ */ jsxRuntime.jsx("span", { style: { ...timeLabelStyle, width: timeLabelWidth }, children: timeLabel }),
     hasTimingFile && onToggleMute && /* @__PURE__ */ jsxRuntime.jsx(
       "button",
       {
@@ -2102,6 +2202,54 @@ var muteButtonStyle = {
   minWidth: "32px",
   minHeight: "28px"
 };
+var mobileScrubberStyle = {
+  flex: 1,
+  minWidth: 0,
+  cursor: "pointer",
+  accentColor: "#3b82f6",
+  height: "24px"
+};
+var speedMenuContainerStyle = {
+  position: "relative",
+  flexShrink: 0
+};
+var speedMenuTriggerStyle = {
+  background: "rgba(255,255,255,0.08)",
+  border: "none",
+  borderRadius: "4px",
+  color: "#fff",
+  fontSize: "11px",
+  padding: "4px 6px",
+  cursor: "pointer",
+  display: "flex",
+  alignItems: "center",
+  gap: "2px",
+  minHeight: "28px"
+};
+var speedMenuDropdownStyle = {
+  position: "absolute",
+  bottom: "100%",
+  right: 0,
+  marginBottom: "4px",
+  background: "rgba(0, 0, 0, 0.95)",
+  border: "1px solid rgba(255, 255, 255, 0.15)",
+  borderRadius: "6px",
+  padding: "4px 0",
+  display: "flex",
+  flexDirection: "column",
+  minWidth: "80px",
+  zIndex: 100
+};
+var speedMenuItemStyle = {
+  background: "none",
+  border: "none",
+  color: "#fff",
+  fontSize: "13px",
+  padding: "8px 12px",
+  cursor: "pointer",
+  textAlign: "left",
+  whiteSpace: "nowrap"
+};
 var devButtonStyle = {
   background: "rgba(255,255,255,0.08)",
   border: "none",
@@ -2381,6 +2529,7 @@ function useAudioPlayback({
   const audioCache = react.useRef(/* @__PURE__ */ new Map());
   const activeClipRef = react.useRef(null);
   const prevProgressRef = react.useRef(0);
+  const clipAbortRef = react.useRef(null);
   const baseUrl = audioBaseUrl.endsWith("/") ? audioBaseUrl : `${audioBaseUrl}/`;
   const getAudio = react.useCallback(
     (clipId, audioFile) => {
@@ -2393,21 +2542,67 @@ function useAudioPlayback({
     },
     [baseUrl]
   );
+  const abortActiveClip = react.useCallback(() => {
+    if (clipAbortRef.current) {
+      clipAbortRef.current.abort();
+      clipAbortRef.current = null;
+    }
+  }, []);
   const stopAll = react.useCallback(() => {
+    abortActiveClip();
     for (const audio of audioCache.current.values()) {
       audio.pause();
     }
     activeClipRef.current = null;
-  }, []);
+  }, [abortActiveClip]);
+  const handlePlayError = react.useCallback(
+    (err, audio, signal) => {
+      if (!(err instanceof Error)) {
+        console.warn("Audio play failed:", err);
+        return;
+      }
+      if (err.name === "NotAllowedError") {
+        console.warn("Audio play blocked by autoplay policy \u2014 waiting for user interaction");
+        return;
+      }
+      if (err.name === "NotSupportedError" || err.name === "AbortError") {
+        console.warn(`Audio play failed (${err.name}) \u2014 waiting for canplaythrough to retry`);
+        if (signal.aborted) return;
+        const retryTimeout = setTimeout(() => {
+          cleanup();
+          console.warn("Audio retry timed out after 3s");
+        }, 3e3);
+        const cleanup = () => {
+          clearTimeout(retryTimeout);
+          audio.removeEventListener("canplaythrough", onReady);
+        };
+        const onReady = () => {
+          cleanup();
+          if (signal.aborted) return;
+          audio.play().catch((retryErr) => {
+            console.warn(
+              "Audio retry failed:",
+              retryErr instanceof Error ? retryErr.name : retryErr
+            );
+          });
+        };
+        audio.addEventListener("canplaythrough", onReady, { once: true, signal });
+        return;
+      }
+      console.warn("Audio play failed:", err.name, err.message);
+    },
+    []
+  );
   react.useEffect(() => {
     return () => {
+      abortActiveClip();
       for (const audio of audioCache.current.values()) {
         audio.pause();
         audio.src = "";
       }
       audioCache.current.clear();
     };
-  }, []);
+  }, [abortActiveClip]);
   react.useEffect(() => {
     if (!timingFile) return;
     for (const line of timingFile.lines) {
@@ -2457,9 +2652,10 @@ function useAudioPlayback({
     if (activeClipRef.current !== clipId) {
       stopAll();
       activeClipRef.current = clipId;
+      const controller = new AbortController();
+      clipAbortRef.current = controller;
       audio.currentTime = offsetSec;
-      audio.play().catch(() => {
-      });
+      audio.play().catch((err) => handlePlayError(err, audio, controller.signal));
     } else {
       const progressDelta = Math.abs(progress - prevProgressRef.current);
       const isLikelyScrub = progressDelta > 0.01;
@@ -2470,12 +2666,15 @@ function useAudioPlayback({
         }
       }
       if (audio.paused) {
-        audio.play().catch(() => {
+        const signal = clipAbortRef.current?.signal;
+        audio.play().catch((err) => {
+          if (signal) handlePlayError(err, audio, signal);
+          else console.warn("Audio play failed:", err instanceof Error ? err.name : err);
         });
       }
     }
     prevProgressRef.current = progress;
-  }, [progress, playing, timingFile, getAudio, stopAll]);
+  }, [progress, playing, timingFile, getAudio, stopAll, handlePlayError]);
   return { forceLoadAll };
 }
 var SFX_TRIGGER_WINDOW_SEC = 0.3;