@bendyline/squisq 2.4.3 → 2.5.0

package/dist/{chunk-D6YTLQCL.js → chunk-NBKAXPSX.js}

@@ -34,6 +34,7 @@ function isContainerTemplate(name) {
 var TEMPLATE_TOKEN_NAMES = /* @__PURE__ */ new Set([
   "title",
   "sectionHeader",
+  "bigText",
   "content",
   "statHighlight",
   "quote",
@@ -70,6 +71,180 @@ function isReservedAnnotationToken(token) {
   return TEMPLATE_TOKEN_NAMES.has(resolveTemplateName(token));
 }
 
+// src/markdown/annotationCoercion.ts
+var KNOWN_BLOCK_META_KEYS = {
+  x: "number",
+  y: "number",
+  startTime: "time",
+  duration: "time",
+  connectsTo: "connectionList",
+  transition: "transition",
+  transitionDuration: "time",
+  transitionDirection: "transitionDirection"
+};
+var BLOCK_META_KEY_DESCRIPTORS = [
+  {
+    key: "transition",
+    description: "Block-to-block transition effect",
+    values: TRANSITION_TYPES
+  },
+  {
+    key: "transitionDuration",
+    description: "How long the transition lasts",
+    valueHint: "seconds \u2014 e.g. 0.7, 700ms"
+  },
+  {
+    key: "transitionDirection",
+    description: "Directional variant for the transition",
+    values: TRANSITION_DIRECTIONS
+  },
+  {
+    key: "startTime",
+    description: "Timeline start time of this block",
+    valueHint: "mm:ss or seconds \u2014 e.g. 01:30, 5, 1500ms"
+  },
+  {
+    key: "duration",
+    description: "How long this block lasts",
+    valueHint: "mm:ss or seconds \u2014 e.g. 45, 1500ms"
+  },
+  {
+    key: "x",
+    description: "Horizontal position on the diagram canvas",
+    valueHint: "number \u2014 e.g. 600"
+  },
+  {
+    key: "y",
+    description: "Vertical position on the diagram canvas",
+    valueHint: "number \u2014 e.g. 300"
+  },
+  {
+    key: "connectsTo",
+    description: "Diagram connections to other blocks",
+    valueHint: "comma-separated target or target:type \u2014 e.g. foo,bar:flow"
+  }
+];
+function coerceAnnotationValues(params) {
+  const blockMeta = {};
+  const metadata = {};
+  const warnings = [];
+  let transitionType = null;
+  let transitionDuration;
+  let transitionDirection;
+  for (const [key, raw] of Object.entries(params)) {
+    const kind = KNOWN_BLOCK_META_KEYS[key];
+    if (!kind) {
+      metadata[key] = raw;
+      continue;
+    }
+    if (kind === "number") {
+      const n = parseNumber(raw);
+      if (n == null) {
+        warnings.push(`Invalid number for "${key}": ${JSON.stringify(raw)}`);
+      } else {
+        blockMeta[key] = n;
+      }
+    } else if (kind === "time") {
+      const s = parseTimeSeconds(raw);
+      if (s == null) {
+        warnings.push(`Invalid time for "${key}": ${JSON.stringify(raw)}`);
+      } else if (key === "transitionDuration") {
+        transitionDuration = s;
+      } else {
+        blockMeta[key] = s;
+      }
+    } else if (kind === "connectionList") {
+      const { list, warning } = parseConnectionList(raw);
+      if (warning) warnings.push(`"${key}": ${warning}`);
+      blockMeta.connectsTo = list;
+    } else if (kind === "transition") {
+      const transition = normalizeTransitionType(raw);
+      if (transition == null) {
+        warnings.push(`Invalid transition for "${key}": ${JSON.stringify(raw)}`);
+      } else {
+        transitionType = transition;
+      }
+    } else if (kind === "transitionDirection") {
+      const direction = normalizeTransitionDirection(raw);
+      if (direction == null) {
+        warnings.push(`Invalid transition direction for "${key}": ${JSON.stringify(raw)}`);
+      } else {
+        transitionDirection = direction;
+      }
+    }
+  }
+  if (transitionType) {
+    blockMeta.transition = {
+      type: transitionType,
+      ...transitionDuration !== void 0 ? { duration: transitionDuration } : {},
+      ...transitionDirection !== void 0 ? { direction: transitionDirection } : {}
+    };
+  }
+  return { blockMeta, metadata, warnings };
+}
+function parseNumber(raw) {
+  if (raw.trim() === "") return null;
+  const n = Number(raw);
+  return Number.isFinite(n) ? n : null;
+}
+var TIME_BARE_RE = /^\d+(?:\.\d+)?$/;
+var TIME_MS_RE = /^(\d+(?:\.\d+)?)ms$/;
+var TIME_MMSS_RE = /^(\d+):(\d{1,2})(?:\.(\d+))?$/;
+function parseTimeSeconds(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return null;
+  if (TIME_BARE_RE.test(trimmed)) {
+    const n = Number(trimmed);
+    return Number.isFinite(n) ? n : null;
+  }
+  const msMatch = trimmed.match(TIME_MS_RE);
+  if (msMatch) {
+    const n = Number(msMatch[1]);
+    return Number.isFinite(n) ? n / 1e3 : null;
+  }
+  const mmssMatch = trimmed.match(TIME_MMSS_RE);
+  if (mmssMatch) {
+    const mins = Number(mmssMatch[1]);
+    const secs = Number(mmssMatch[2]);
+    const frac = mmssMatch[3] ? Number(`0.${mmssMatch[3]}`) : 0;
+    if (!Number.isFinite(mins) || !Number.isFinite(secs) || !Number.isFinite(frac)) {
+      return null;
+    }
+    if (secs >= 60) return null;
+    return mins * 60 + secs + frac;
+  }
+  return null;
+}
+function parseConnectionList(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) return { list: [], warning: null };
+  const list = [];
+  let droppedEmpty = false;
+  for (const part of trimmed.split(",")) {
+    const entry = part.trim();
+    if (!entry) {
+      droppedEmpty = true;
+      continue;
+    }
+    const colonIdx = entry.indexOf(":");
+    if (colonIdx < 0) {
+      list.push({ target: entry });
+    } else {
+      const target = entry.slice(0, colonIdx).trim();
+      const type = entry.slice(colonIdx + 1).trim();
+      if (!target) {
+        droppedEmpty = true;
+        continue;
+      }
+      list.push(type ? { target, type } : { target });
+    }
+  }
+  return {
+    list,
+    warning: droppedEmpty ? "dropped empty connection entries" : null
+  };
+}
+
 // src/markdown/sanitize.ts
 var SAFE_LINK_SCHEMES = /* @__PURE__ */ new Set(["http", "https", "mailto", "tel"]);
 var SAFE_MEDIA_SCHEMES = /* @__PURE__ */ new Set(["http", "https", "blob"]);
@@ -313,180 +488,6 @@ function stripUrlSchemeNoise(value) {
   return out;
 }
 
-// src/markdown/annotationCoercion.ts
-var KNOWN_BLOCK_META_KEYS = {
-  x: "number",
-  y: "number",
-  startTime: "time",
-  duration: "time",
-  connectsTo: "connectionList",
-  transition: "transition",
-  transitionDuration: "time",
-  transitionDirection: "transitionDirection"
-};
-var BLOCK_META_KEY_DESCRIPTORS = [
-  {
-    key: "transition",
-    description: "Block-to-block transition effect",
-    values: TRANSITION_TYPES
-  },
-  {
-    key: "transitionDuration",
-    description: "How long the transition lasts",
-    valueHint: "seconds \u2014 e.g. 0.7, 700ms"
-  },
-  {
-    key: "transitionDirection",
-    description: "Directional variant for the transition",
-    values: TRANSITION_DIRECTIONS
-  },
-  {
-    key: "startTime",
-    description: "Timeline start time of this block",
-    valueHint: "mm:ss or seconds \u2014 e.g. 01:30, 5, 1500ms"
-  },
-  {
-    key: "duration",
-    description: "How long this block lasts",
-    valueHint: "mm:ss or seconds \u2014 e.g. 45, 1500ms"
-  },
-  {
-    key: "x",
-    description: "Horizontal position on the diagram canvas",
-    valueHint: "number \u2014 e.g. 600"
-  },
-  {
-    key: "y",
-    description: "Vertical position on the diagram canvas",
-    valueHint: "number \u2014 e.g. 300"
-  },
-  {
-    key: "connectsTo",
-    description: "Diagram connections to other blocks",
-    valueHint: "comma-separated target or target:type \u2014 e.g. foo,bar:flow"
-  }
-];
-function coerceAnnotationValues(params) {
-  const blockMeta = {};
-  const metadata = {};
-  const warnings = [];
-  let transitionType = null;
-  let transitionDuration;
-  let transitionDirection;
-  for (const [key, raw] of Object.entries(params)) {
-    const kind = KNOWN_BLOCK_META_KEYS[key];
-    if (!kind) {
-      metadata[key] = raw;
-      continue;
-    }
-    if (kind === "number") {
-      const n = parseNumber(raw);
-      if (n == null) {
-        warnings.push(`Invalid number for "${key}": ${JSON.stringify(raw)}`);
-      } else {
-        blockMeta[key] = n;
-      }
-    } else if (kind === "time") {
-      const s = parseTimeSeconds(raw);
-      if (s == null) {
-        warnings.push(`Invalid time for "${key}": ${JSON.stringify(raw)}`);
-      } else if (key === "transitionDuration") {
-        transitionDuration = s;
-      } else {
-        blockMeta[key] = s;
-      }
-    } else if (kind === "connectionList") {
-      const { list, warning } = parseConnectionList(raw);
-      if (warning) warnings.push(`"${key}": ${warning}`);
-      blockMeta.connectsTo = list;
-    } else if (kind === "transition") {
-      const transition = normalizeTransitionType(raw);
-      if (transition == null) {
-        warnings.push(`Invalid transition for "${key}": ${JSON.stringify(raw)}`);
-      } else {
-        transitionType = transition;
-      }
-    } else if (kind === "transitionDirection") {
-      const direction = normalizeTransitionDirection(raw);
-      if (direction == null) {
-        warnings.push(`Invalid transition direction for "${key}": ${JSON.stringify(raw)}`);
-      } else {
-        transitionDirection = direction;
-      }
-    }
-  }
-  if (transitionType) {
-    blockMeta.transition = {
-      type: transitionType,
-      ...transitionDuration !== void 0 ? { duration: transitionDuration } : {},
-      ...transitionDirection !== void 0 ? { direction: transitionDirection } : {}
-    };
-  }
-  return { blockMeta, metadata, warnings };
-}
-function parseNumber(raw) {
-  if (raw.trim() === "") return null;
-  const n = Number(raw);
-  return Number.isFinite(n) ? n : null;
-}
-var TIME_BARE_RE = /^\d+(?:\.\d+)?$/;
-var TIME_MS_RE = /^(\d+(?:\.\d+)?)ms$/;
-var TIME_MMSS_RE = /^(\d+):(\d{1,2})(?:\.(\d+))?$/;
-function parseTimeSeconds(raw) {
-  const trimmed = raw.trim();
-  if (!trimmed) return null;
-  if (TIME_BARE_RE.test(trimmed)) {
-    const n = Number(trimmed);
-    return Number.isFinite(n) ? n : null;
-  }
-  const msMatch = trimmed.match(TIME_MS_RE);
-  if (msMatch) {
-    const n = Number(msMatch[1]);
-    return Number.isFinite(n) ? n / 1e3 : null;
-  }
-  const mmssMatch = trimmed.match(TIME_MMSS_RE);
-  if (mmssMatch) {
-    const mins = Number(mmssMatch[1]);
-    const secs = Number(mmssMatch[2]);
-    const frac = mmssMatch[3] ? Number(`0.${mmssMatch[3]}`) : 0;
-    if (!Number.isFinite(mins) || !Number.isFinite(secs) || !Number.isFinite(frac)) {
-      return null;
-    }
-    if (secs >= 60) return null;
-    return mins * 60 + secs + frac;
-  }
-  return null;
-}
-function parseConnectionList(raw) {
-  const trimmed = raw.trim();
-  if (!trimmed) return { list: [], warning: null };
-  const list = [];
-  let droppedEmpty = false;
-  for (const part of trimmed.split(",")) {
-    const entry = part.trim();
-    if (!entry) {
-      droppedEmpty = true;
-      continue;
-    }
-    const colonIdx = entry.indexOf(":");
-    if (colonIdx < 0) {
-      list.push({ target: entry });
-    } else {
-      const target = entry.slice(0, colonIdx).trim();
-      const type = entry.slice(colonIdx + 1).trim();
-      if (!target) {
-        droppedEmpty = true;
-        continue;
-      }
-      list.push(type ? { target, type } : { target });
-    }
-  }
-  return {
-    list,
-    warning: droppedEmpty ? "dropped empty connection entries" : null
-  };
-}
-
 // src/markdown/attrTokens.ts
 var DQ_RUN = `"(?:[^"\\\\]|\\\\.)*"`;
 var SQ_RUN = `'(?:[^'\\\\]|\\\\.)*'`;
@@ -589,13 +590,13 @@ export {
   CONTAINER_TEMPLATES,
   isContainerTemplate,
   isReservedAnnotationToken,
-  sanitizeUrl,
-  sanitizeHtmlNodes,
   KNOWN_BLOCK_META_KEYS,
   BLOCK_META_KEY_DESCRIPTORS,
   coerceAnnotationValues,
   parseNumber,
   parseTimeSeconds,
+  sanitizeUrl,
+  sanitizeHtmlNodes,
   matchTrailingTemplateAnnotation,
   matchTrailingPandocAttr,
   tokenizeAttrTokens,

package/dist/{chunk-AQF5ZYDI.js → chunk-NNL3HHKA.js}

@@ -23,7 +23,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-2HY2ZA7U.js";
+} from "./chunk-GSJEGMKF.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,
@@ -58,7 +58,7 @@ import {
 } from "./chunk-BAOV476U.js";
 import {
   parseMarkdown
-} from "./chunk-7TJJA2RI.js";
+} from "./chunk-6MVWWZHL.js";
 import {
   KNOWN_BLOCK_META_KEYS,
   TEMPLATE_ALIASES,
@@ -66,7 +66,7 @@ import {
   isContainerTemplate,
   resolveTemplateName,
   serializeAnnotation
-} from "./chunk-D6YTLQCL.js";
+} from "./chunk-NBKAXPSX.js";
 import {
   extractPlainText,
   getChildren,
@@ -334,6 +334,112 @@ function cssFilterForTreatment(treatment, blur) {
   return parts.length > 0 ? parts.join(" ") : void 0;
 }
 
+// src/doc/coverSlideSettings.ts
+var COVER_SLIDE_TEMPLATE_OPTIONS = Object.freeze([
+  {
+    id: "cover",
+    label: "Hero cover",
+    description: "The classic Squisq cover with title, subtitle, and optional hero image."
+  },
+  {
+    id: "title",
+    label: "Title",
+    description: "A theme-led title card without a full-bleed image."
+  },
+  {
+    id: "sectionHeader",
+    label: "Section header",
+    description: "A bold section divider using the hero image when one is available."
+  },
+  {
+    id: "imageWithCaption",
+    label: "Image with title",
+    description: "A full-bleed image with the title and subtitle overlaid.",
+    requiresHeroImage: true
+  },
+  {
+    id: "bigText",
+    label: "Big text",
+    description: "The title in gigantic uppercase type on a clean theme surface \u2014 thumbnail-ready."
+  },
+  {
+    id: "bigTextImage",
+    label: "Big text on image",
+    description: "The title in gigantic uppercase type over the hero image, with a contrast bloom behind the text.",
+    requiresHeroImage: true
+  }
+]);
+var COVER_SLIDE_FRONTMATTER_KEYS = Object.freeze({
+  enabled: { canonical: "squisq-cover-slide", legacy: "cover-slide" },
+  template: { canonical: "squisq-cover-template", legacy: "cover-template" },
+  duration: { canonical: "squisq-cover-duration", legacy: "cover-duration" },
+  playback: { canonical: "squisq-cover-playback", legacy: "cover-playback" }
+});
+var DEFAULT_COVER_SLIDE_SETTINGS = Object.freeze({
+  enabled: true,
+  template: "cover",
+  duration: 2,
+  playback: "preroll"
+});
+var MAX_COVER_SLIDE_DURATION_SECONDS = 60;
+function readSetting(frontmatter, keys) {
+  if (!frontmatter) return void 0;
+  return Object.prototype.hasOwnProperty.call(frontmatter, keys.canonical) ? frontmatter[keys.canonical] : frontmatter[keys.legacy];
+}
+function resolveBoolean(value) {
+  if (typeof value === "boolean") return value;
+  if (typeof value !== "string") return void 0;
+  const normalized = value.trim().toLowerCase();
+  if (["true", "yes", "on", "show", "visible"].includes(normalized)) return true;
+  if (["false", "no", "off", "hide", "hidden"].includes(normalized)) return false;
+  return void 0;
+}
+function resolveTemplate(value) {
+  if (typeof value !== "string") return void 0;
+  const normalized = value.trim().toLowerCase().replace(/[_\s-]+/g, "");
+  if (normalized === "cover" || normalized === "hero" || normalized === "managedcover") {
+    return "cover";
+  }
+  if (normalized === "title" || normalized === "titleblock") return "title";
+  if (normalized === "sectionheader" || normalized === "section") return "sectionHeader";
+  if (normalized === "imagewithcaption" || normalized === "imagetitle" || normalized === "fullbleedimage") {
+    return "imageWithCaption";
+  }
+  if (normalized === "bigtextimage" || normalized === "largetextimage" || normalized === "bigtextonimage") {
+    return "bigTextImage";
+  }
+  if (normalized === "bigtext" || normalized === "largetext") return "bigText";
+  return void 0;
+}
+function resolveDuration(value) {
+  const duration = typeof value === "number" ? value : typeof value === "string" && value.trim().length > 0 ? Number(value) : Number.NaN;
+  if (!Number.isFinite(duration) || duration < 0 || duration > MAX_COVER_SLIDE_DURATION_SECONDS) {
+    return void 0;
+  }
+  return duration;
+}
+function resolvePlayback(value) {
+  if (typeof value !== "string") return void 0;
+  const normalized = value.trim().toLowerCase().replace(/[_\s]+/g, "-");
+  if (["overlay", "over", "concurrent", "play-over"].includes(normalized)) return "overlay";
+  if (["preroll", "pre-roll", "delay", "push", "shift"].includes(normalized)) return "preroll";
+  return void 0;
+}
+function resolveCoverSlideSettings(frontmatter, overrides = {}) {
+  const resolved = {
+    enabled: resolveBoolean(readSetting(frontmatter, COVER_SLIDE_FRONTMATTER_KEYS.enabled)) ?? DEFAULT_COVER_SLIDE_SETTINGS.enabled,
+    template: resolveTemplate(readSetting(frontmatter, COVER_SLIDE_FRONTMATTER_KEYS.template)) ?? DEFAULT_COVER_SLIDE_SETTINGS.template,
+    duration: resolveDuration(readSetting(frontmatter, COVER_SLIDE_FRONTMATTER_KEYS.duration)) ?? DEFAULT_COVER_SLIDE_SETTINGS.duration,
+    playback: resolvePlayback(readSetting(frontmatter, COVER_SLIDE_FRONTMATTER_KEYS.playback)) ?? DEFAULT_COVER_SLIDE_SETTINGS.playback
+  };
+  return {
+    enabled: overrides.enabled ?? resolved.enabled,
+    template: overrides.template ?? resolved.template,
+    duration: resolveDuration(overrides.duration) ?? resolved.duration,
+    playback: overrides.playback ?? resolved.playback
+  };
+}
+
 // src/doc/docToMarkdown.ts
 var TRANSITION_PARAM_KEYS = ["transition", "transitionDuration", "transitionDirection"];
 var DEFAULT_TEMPLATE = "sectionHeader";
@@ -681,6 +787,17 @@ var sectionHeader = (input) => {
     mediaBackground: !!s.imageSrc
   };
 };
+var bigText = (input) => {
+  const b = input;
+  const media = b.imageSrc ? { type: "image", src: b.imageSrc, alt: b.imageAlt ?? "" } : void 0;
+  return {
+    kind: "hero",
+    variant: media ? "media" : "title",
+    slots: { title: b.title, media },
+    emphasis: "lead",
+    mediaBackground: !!media
+  };
+};
 var content = (input) => {
   const c = input;
   return {
@@ -965,6 +1082,7 @@ var layout = (input, ctx) => canvasDraft("layout", ctx, input);
 var sectionExtractors = {
   title,
   sectionHeader,
+  bigText,
   content,
   statHighlight,
   quote,
@@ -2025,24 +2143,24 @@ function retimeBlocks(blocks, ctx) {
     const range = ctx.ranges.get(block.id);
     const pinned = getPinnedBlockMeta(block);
     const next = { ...block };
-    if (range && pinned.duration == null && pinned.startTime == null) {
-      next.startTime = ctx.clipStart + range.startSec;
-      next.duration = Math.max(0, range.endSec - range.startSec);
-      ctx.cursor = Math.max(ctx.cursor, next.startTime + next.duration);
-    } else if (range) {
-      const pinnedStart = pinned.startTime ?? block.startTime;
-      const pinnedDuration = pinned.duration ?? block.duration;
-      const narrStart = ctx.clipStart + range.startSec;
+    if (range) {
+      const narrStart = ctx.clipStart + range.startSec + ctx.shift;
       const narrDuration = Math.max(0, range.endSec - range.startSec);
-      if (Math.abs(pinnedStart - narrStart) > PIN_CONFLICT_TOLERANCE_SEC || Math.abs(pinnedDuration - narrDuration) > PIN_CONFLICT_TOLERANCE_SEC) {
+      next.startTime = pinned.startTime ?? narrStart;
+      next.duration = pinned.duration ?? narrDuration;
+      const end = next.startTime + next.duration;
+      ctx.shift = end - (ctx.clipStart + range.endSec);
+      const durationConflict = pinned.duration != null && Math.abs(pinned.duration - narrDuration) > PIN_CONFLICT_TOLERANCE_SEC;
+      const startConflict = pinned.startTime != null && Math.abs(pinned.startTime - narrStart) > PIN_CONFLICT_TOLERANCE_SEC;
+      if (durationConflict || startConflict) {
         ctx.diagnostics.push({
           severity: "info",
           code: "narration-pin-conflict",
-          message: `Block timing is pinned (duration=/startTime=) but the recorded narration says ~${narrDuration.toFixed(1)}s starting at ~${narrStart.toFixed(1)}s. The pin wins; remove it to follow the narration.`,
+          message: `Block timing is pinned (duration=/startTime=) but the recorded narration says ~${narrDuration.toFixed(1)}s starting at ~${narrStart.toFixed(1)}s. The pin wins and later blocks follow it, while the recorded voice keeps its own schedule \u2014 playback drifts from the take past this block. Remove the pin to follow the narration.`,
           blockId: block.id
         });
       }
-      ctx.cursor = Math.max(ctx.cursor, pinnedStart + pinnedDuration);
+      ctx.cursor = Math.max(ctx.cursor, end);
     } else {
       next.startTime = ctx.cursor;
       ctx.cursor += next.duration;
@@ -2068,7 +2186,8 @@ async function applyNarrationTiming(doc, container) {
       clipStart: clip.startAt,
       ranges,
       diagnostics: [],
-      cursor: 0
+      cursor: 0,
+      shift: 0
     };
     const blocks = retimeBlocks(doc.blocks, ctx);
     const duration = Math.max(clip.startAt + timing.duration, ctx.cursor);
@@ -3865,6 +3984,11 @@ export {
   getTransitionClass,
   getAnimationProgress,
   cssFilterForTreatment,
+  COVER_SLIDE_TEMPLATE_OPTIONS,
+  COVER_SLIDE_FRONTMATTER_KEYS,
+  DEFAULT_COVER_SLIDE_SETTINGS,
+  MAX_COVER_SLIDE_DURATION_SECONDS,
+  resolveCoverSlideSettings,
   docToMarkdown,
   resolveThemeForDoc,
   isTemplatedPageBlock,