@bendyline/squisq 2.13.12 → 2.13.13

package/dist/{chunk-QJQQO3K4.js → chunk-CTT4XAGO.js}

@@ -5900,6 +5900,12 @@ function formatChartValue(value, unit) {
   }
   return unit ? `${text} ${unit}` : text;
 }
+function formatChartDataValue(value, unit) {
+  if (!Number.isFinite(value) || Math.abs(value) >= 1e4) return formatChartValue(value, unit);
+  const sign = value < 0 ? "-" : "";
+  const text = `${sign}${Math.abs(value).toLocaleString("en-US", { maximumFractionDigits: 2 })}`;
+  return unit ? `${text} ${unit}` : text;
+}
 function trimTrailingZero(text) {
   return text.replace(/\.0$/, "");
 }
@@ -6425,7 +6431,7 @@ function paintBars(paint) {
   } = paint;
   const scale = valueTicks("bar", data, input);
   const labelGap = axisFontSize * 0.6;
-  const labelWidthPx = (value) => formatChartValue(value, input.unit).length * axisFontSize * CHART_CHAR_WIDTH_EM;
+  const labelWidthPx = (value) => formatChartDataValue(value, input.unit).length * axisFontSize * CHART_CHAR_WIDTH_EM;
   const showValueLabels = input.showValues === true && !(input.stacked === true);
   const reservedForLabels = showValueLabels ? data.series.flatMap((series) => series.values).filter((v) => v !== null).reduce((max, v) => Math.max(max, labelWidthPx(v)), 0) + labelGap : 0;
   const axisWidth = Math.max(20, frame2.plot.width - reservedForLabels);
@@ -6768,7 +6774,7 @@ function valueLabel(paint, id, value, x, y, animation) {
     type: "text",
     id,
     content: {
-      text: formatChartValue(value, paint.input.unit),
+      text: formatChartDataValue(value, paint.input.unit),
       style: {
         fontSize: paint.axisFontSize,
         fontFamily: paint.bodyFont,
@@ -11954,6 +11960,177 @@ var TEMPLATE_AUTHORING_METADATA = {
   }
 };
 
+// src/doc/templates/authoringGuide.ts
+var CHART = {
+  fields: "title, headers [label, value], rows [[label, value], \u2026] 2\u20136 rows, showValues: true",
+  use: "only values the {source} states"
+};
+var CONCEPT_BUILD = 'build: {mode: "items"} to reveal them as they are spoken';
+var TEMPLATE_GUIDES = {
+  imageWithCaption: {
+    fields: "imageSrc, imageAlt, caption \u2264 90 chars, ambientMotion: zoomIn|zoomOut|panLeft|panRight",
+    use: "a photograph with the narration's idea as caption"
+  },
+  pullQuote: {
+    fields: "text, backgroundImage {src, alt}, ambientMotion",
+    use: "a VERBATIM sentence or clause from the {source} over a photograph"
+  },
+  fullBleedQuote: {
+    fields: "text",
+    use: "a VERBATIM short sentence from the {source}, text only"
+  },
+  factCard: {
+    fields: "fact \u2264 4 words, explanation \u2264 160 chars, accentImage {src, alt, position: left-strip|right-strip}"
+  },
+  dateEvent: {
+    fields: "date, description \u2264 160 chars, mood: neutral|somber|celebratory, accentImage optional",
+    use: "a year or period the {source} states"
+  },
+  statHighlight: {
+    fields: 'stat like "98%" or "36", description \u2264 60 chars, detail \u2264 80 chars, accentImage optional',
+    use: "counts up; the number must be in the {source}"
+  },
+  comparisonBar: {
+    fields: "leftLabel, leftValue, rightLabel, rightValue, unit optional",
+    use: "two quantities the {source} gives in the same unit"
+  },
+  columnChart: CHART,
+  barChart: CHART,
+  pieChart: CHART,
+  timeline: {
+    fields: "title, tracks: [{ id, label, events: [{ id, label: year, position: 0..1 in date order, description \u2264 40 chars, marker: 'diamond' optional }] }]",
+    use: "3\u20137 dated events the {source} states"
+  },
+  diagram: {
+    fields: "title, nodeShape: 'pill', nodes: [{ id, label \u2264 3 words, x, y }] 3\u20136 nodes with x in {0, 280, 560} and y in {0, 160, 320}, edges: [{ source, target, label \u2264 3 words }]",
+    use: "relationships the {source} describes"
+  },
+  list: {
+    fields: "title, items: 2\u20135 short items taken from the {source}'s own words"
+  },
+  photoGrid: {
+    fields: "images: [{src, alt}] \xD7 2\u20134, caption \u2264 90 chars",
+    use: "several related photographs"
+  },
+  map: {
+    fields: "center: {lat, lng}, zoom, mapStyle: 'terrain', title, ambientMotion",
+    use: "where the place is, at its first mention"
+  },
+  sectionHeader: {
+    fields: "title = the section title, imageSrc, imageAlt, ambientMotion",
+    use: "opens a section on a photograph"
+  },
+  cards: {
+    fields: `title, items: ["Label: detail", \u2026] 2\u20134, versus: true for exactly two set against each other, ${CONCEPT_BUILD}`,
+    use: "parallel ideas side by side, such as kinds, causes or features"
+  },
+  process: {
+    fields: `title, items: ["Label: detail", \u2026] 2\u20134 in order, ${CONCEPT_BUILD}`,
+    use: "ordered stages or dated events, drawn as numbered steps joined by arrows"
+  },
+  cycle: {
+    fields: `title, items: ["Label: detail", \u2026] 3\u20135, ${CONCEPT_BUILD}`,
+    use: "stages that repeat in a loop, drawn on a ring"
+  },
+  layers: {
+    fields: `title, items: ["Label: detail", \u2026] 3\u20135 innermost first, ${CONCEPT_BUILD}`,
+    use: "parts nested inside one another, drawn as concentric rings"
+  }
+};
+function guideText(text, wording = {}) {
+  return text.replace(/\{source\}/gu, wording.source ?? "source");
+}
+function templateCatalog(entries, wording = {}) {
+  return entries.map((entry) => {
+    const [name, guide] = typeof entry === "string" ? [entry, TEMPLATE_GUIDES[entry]] : "templates" in entry ? [entry.templates.join(" | "), TEMPLATE_GUIDES[entry.templates[0]]] : [entry.template, entry];
+    const use = guide.use ? ` \u2014 ${guide.use}` : "";
+    return guideText(`- ${name} (${guide.fields})${use}`, wording);
+  });
+}
+var PRESENTATION_LAYOUT_GUIDE = {
+  title: "an opening",
+  divider: "a new topic begins; only the headline shows",
+  statement: "one idea",
+  emphasis: "one striking takeaway; only the headline shows, so keep it under 60 characters",
+  quote: "the headline is one sentence copied word for word from the passage, without quotation marks; only the headline shows",
+  stat: "the passage\u2019s key figure, such as 40% or $3 million, stated in the headline or a point",
+  definition: "the headline is a term and the points define it",
+  list: "2\u20133 points",
+  comparison: "exactly 2 genuinely contrasting points",
+  steps: "2\u20133 ordered actions",
+  image: 'only when the current layout is "image"; the headline is then its caption',
+  cards: "2\u20134 parallel ideas side by side, such as kinds, causes or features",
+  process: "2\u20134 ordered stages or dated events, drawn as numbered steps joined by arrows",
+  cycle: "3\u20135 stages that repeat in a loop, drawn on a ring",
+  layers: "3\u20135 parts nested inside one another, innermost first, such as a core and the layers around it, drawn as concentric rings"
+};
+var DRAWN = ["cards", "process", "cycle", "layers"];
+var NUMBERS = ["statHighlight", "comparisonBar", "columnChart", "barChart", "pieChart"];
+var ACCENTED = [
+  "factCard",
+  "statHighlight",
+  "dateEvent",
+  "quote",
+  "list",
+  "definitionCard"
+];
+var AUTHORING_TRICKS = [
+  {
+    id: "one-idea",
+    text: "One idea per slide: each slide shows what the sentence being spoken is about. Captions and labels restate its idea briefly; they never add a fact."
+  },
+  {
+    id: "numbers-as-numbers",
+    text: "Draw numbers as numbers: one striking quantity \u2192 statHighlight (it counts up); two quantities in one unit \u2192 comparisonBar; three or more values in one unit \u2192 a chart; three to seven dated events \u2192 timeline.",
+    templates: [...NUMBERS, "timeline"]
+  },
+  {
+    id: "ranges",
+    text: 'A range ("3 to 7 miles deep") is not one value: never chart it as a single bar or count up to one end. Write it as the {source} gives it, on a card or in a list.',
+    templates: NUMBERS
+  },
+  {
+    id: "draw-ideas",
+    text: `Slides that draw their ideas explain best: several parallel ideas \u2192 cards, ordered stages \u2192 process, a loop that comes back to its start \u2192 cycle, parts nested inside one another \u2192 layers; prefer them to a list. Write each item as "Label: detail", a label of 1\u20134 words and a detail of at most 70 characters, in the {source}'s own words. For dated events, start each label with its date: a process of dated stages draws as a timeline.`,
+    summary: `Slides that draw their ideas explain best: when the passage has several parallel ideas, ordered stages, a repeating loop or nested parts, choose ${DRAWN.map((layout) => `"${layout}"`).join(", ")} rather than "statement" or "list", and write each of their points (up to 4) as "Label: detail", a label of 1\u20134 words and a detail of at most 70 characters. For dated events, start each label with its date.`,
+    templates: DRAWN
+  },
+  {
+    id: "reveal-as-spoken",
+    text: 'A drawn slide can reveal its items one at a time as the narration says them (build {mode: "items"}). Put the items in the order they are spoken and let each share its key words with the sentence that says it, so every reveal lands on its words.',
+    templates: DRAWN
+  },
+  {
+    id: "chain-not-diagram",
+    text: "A chain \u2014 one thing leads to the next, which leads to the next \u2014 is a process, not a diagram. Keep diagrams for relationships that branch or meet: causes on the left and effects on the right, every edge labelled with the verb the {source} uses, and no edges that cross.",
+    templates: ["diagram", "process"]
+  },
+  {
+    id: "no-empty-frames",
+    text: "A text card on its own is small type on an empty field. Give each factCard, statHighlight, dateEvent, quote, list and definitionCard an accentImage showing what its sentence is about, and alternate the side from card to card.",
+    templates: ACCENTED
+  },
+  {
+    id: "motion-follows-picture",
+    text: "Motion comes from the theme's motion profile; never hand-author animations. On a photograph, choose the ambientMotion the picture suggests \u2014 zoomIn toward a detail, panLeft or panRight along a skyline or coast \u2014 and alternate directions between neighbouring slides.",
+    templates: ["imageWithCaption", "pullQuote", "sectionHeader", "map"]
+  },
+  {
+    id: "vary",
+    text: "Vary the slides: when two templates fit equally well, choose the one not just shown. A long run of photo-and-caption slides is where a narrated story feels static."
+  }
+];
+function authoringTricks(options = {}) {
+  const offered = options.templates ? new Set(options.templates) : void 0;
+  const selected = options.ids ? options.ids.flatMap((id) => AUTHORING_TRICKS.filter((trick) => trick.id === id)) : AUTHORING_TRICKS;
+  return selected.filter(
+    (trick) => !offered || !trick.templates || trick.templates.some((template) => offered.has(template))
+  ).flatMap((trick) => {
+    const text = options.surface === "summary" ? trick.summary : trick.text;
+    return text ? [guideText(text, options.wording)] : [];
+  });
+}
+
 // src/doc/templates/coverBlock.ts
 var COVER_TITLE_BASE_PX = 120;
 var COVER_TITLE_COMFORTABLE_CHARS = 26;
@@ -12566,9 +12743,9 @@ function expandDocBlocks(blocks, options = {}) {
       return expandedBlock;
     });
   }
-  const containsBuilds = blocks.some(hasBlockBuilds);
-  const splitLongBlocks = requestedSplit && !containsBuilds;
-  const mergeShortBlocks = requestedMerge && !containsBuilds;
+  const buildSegments = new Set(
+    blocks.filter(hasBlockBuilds).map((block) => block.audioSegment ?? 0)
+  );
   const blocksBySegment = /* @__PURE__ */ new Map();
   blocks.forEach((block, index) => {
     const segmentIndex = block.audioSegment ?? 0;
@@ -12581,6 +12758,8 @@ function expandDocBlocks(blocks, options = {}) {
   const splitParts = /* @__PURE__ */ new Map();
   for (const [segmentIndex, segmentBlocks] of blocksBySegment) {
     const audioSegment = audioSegments[segmentIndex];
+    const splitLongBlocks = requestedSplit && !buildSegments.has(segmentIndex);
+    const mergeShortBlocks = requestedMerge && !buildSegments.has(segmentIndex);
     if (segmentBlocks.every(({ block }) => block.timelineLocked === true)) {
       for (const { block, originalIndex } of segmentBlocks) {
         const expanded = materializeScheduledBlock(
@@ -12797,7 +12976,9 @@ function expandDocBlocks(blocks, options = {}) {
     }
     expandedBlocks.splice(0, expandedBlocks.length, ...sequenced);
   }
-  return mergeShortBlocks ? expandedBlocks.filter((block) => block && block.duration > 0) : expandedBlocks.filter(Boolean);
+  return requestedMerge ? expandedBlocks.filter(
+    (block) => block && (block.duration > 0 || buildSegments.has(block.audioSegment ?? 0))
+  ) : expandedBlocks.filter(Boolean);
 }
 function getAvailableTemplates() {
   return Object.keys(templateRegistry);
@@ -14133,6 +14314,12 @@ export {
   materializeBlockLayersWithRuntime,
   TEMPLATE_METADATA,
   TEMPLATE_AUTHORING_METADATA,
+  TEMPLATE_GUIDES,
+  guideText,
+  templateCatalog,
+  PRESENTATION_LAYOUT_GUIDE,
+  AUTHORING_TRICKS,
+  authoringTricks,
   coverBlock,
   expandCoverBlock,
   expandDocBlocks,

package/dist/chunk-FCB6JLWB.js

@@ -0,0 +1,125 @@
+// src/transform/grounding.ts
+var NUMBER = /\d[\d,]*(?:\.\d+)?/gu;
+function normalizeGroundingText(text) {
+  return text.toLowerCase().replace(/[‘’ʼ`]/gu, "'").replace(/[“”]/gu, '"').replace(/[–—]/gu, "-").replace(/[^a-z0-9'%\s-]/gu, " ").replace(/\s+/gu, " ").trim();
+}
+function numbersIn(value) {
+  if (typeof value === "number") return Number.isFinite(value) ? [String(value)] : [];
+  return (value.match(NUMBER) ?? []).map((number) => number.replace(/,/gu, ""));
+}
+var UNIT_WORDS = ["one", "two", "three", "four", "five", "six", "seven", "eight", "nine"];
+var TEEN_WORDS = [
+  "ten",
+  "eleven",
+  "twelve",
+  "thirteen",
+  "fourteen",
+  "fifteen",
+  "sixteen",
+  "seventeen",
+  "eighteen",
+  "nineteen"
+];
+var TENS_WORDS = ["twenty", "thirty", "forty", "fifty", "sixty", "seventy", "eighty", "ninety"];
+var NUMBER_WORD = new RegExp(
+  `\\b(?:(${TENS_WORDS.join("|")})(?:[-\\s](${UNIT_WORDS.join("|")}))?|(${[...UNIT_WORDS.slice(1), ...TEEN_WORDS].join("|")}))\\b`,
+  "giu"
+);
+function spelledNumbers(source) {
+  return [...source.matchAll(NUMBER_WORD)].map((match) => {
+    const [, tens, unit, small] = match;
+    const value = small ? [...UNIT_WORDS, ...TEEN_WORDS].indexOf(small.toLowerCase()) + 1 : (TENS_WORDS.indexOf(tens.toLowerCase()) + 2) * 10 + (unit ? UNIT_WORDS.indexOf(unit.toLowerCase()) + 1 : 0);
+    return { value: String(value), index: match.index };
+  });
+}
+function sourceNumbers(source) {
+  return /* @__PURE__ */ new Set([...numbersIn(source), ...spelledNumbers(source).map(({ value }) => value)]);
+}
+function ungroundedNumber(values, source) {
+  const stated = typeof source === "string" ? sourceNumbers(source) : source;
+  const list = Array.isArray(values) ? values : [values];
+  for (const value of list) {
+    const missing = numbersIn(value).find((number) => !stated.has(number));
+    if (missing !== void 0) return missing;
+  }
+  return void 0;
+}
+function groundingSentences(text) {
+  return (text.match(/[^.!?\n]+[.!?]*/gu) ?? []).map((sentence) => sentence.trim()).filter(Boolean);
+}
+function isVerbatimQuote(quote, source, options = {}) {
+  const q = normalizeGroundingText(quote);
+  if (!q) return false;
+  if (normalizeGroundingText(source).includes(q)) return true;
+  const words = q.split(" ").filter((word) => word.length > 1);
+  if (words.length === 0) return false;
+  const minShare = options.minShare ?? 0.9;
+  for (const sentence of options.sentences ?? groundingSentences(source)) {
+    const present = new Set(normalizeGroundingText(sentence).split(" "));
+    const hits = words.filter((word) => present.has(word)).length;
+    if (hits / words.length >= minShare) return true;
+  }
+  return false;
+}
+var COMMON = new Set(
+  "about after also because been before being both could does each from have into just like more most much only other over same should some such than that their them then there these they this those through very what when where which while will with would your ours".split(
+    " "
+  )
+);
+function distinctiveStems(text) {
+  return (text.toLowerCase().replace(/[‘’]/gu, "'").replace(/[“”]/gu, '"').replace(/[‐‑]/gu, "-").replace(/[‒–—―]/gu, " ").match(/[\p{L}\p{N}][\p{L}\p{N}'-]*/gu) ?? []).filter((word) => word.length >= 4 && !COMMON.has(word)).map((word) => word.slice(0, 4));
+}
+function isGroundedParaphrase(text, source, options = {}) {
+  if (ungroundedNumber(text, source) !== void 0) return false;
+  const stems = new Set(distinctiveStems(source));
+  const words = distinctiveStems(text);
+  const minShare = options.minShare ?? 2 / 3;
+  return words.filter((word) => stems.has(word)).length >= Math.ceil(words.length * minShare);
+}
+function restatesHeadline(point, headline) {
+  const title = distinctiveStems(headline);
+  const words = distinctiveStems(point);
+  const shared = words.filter((word) => title.includes(word)).length;
+  return words.length > 0 && shared >= words.length * 0.6 || title.length >= 3 && title.every((word) => words.includes(word));
+}
+var RANGE = /(?:\bbetween\s+(\d[\d,]*(?:\.\d+)?)\s+and\s+(\d[\d,]*(?:\.\d+)?))|(?:(\d[\d,]*(?:\.\d+)?)\s*(?:[-–—]|\bto\b)\s*(\d[\d,]*(?:\.\d+)?))/giu;
+function statedRanges(source) {
+  return [...source.matchAll(RANGE)].map((match) => ({
+    low: (match[1] ?? match[3]).replace(/,/gu, ""),
+    high: (match[2] ?? match[4]).replace(/,/gu, ""),
+    text: match[0],
+    index: match.index
+  }));
+}
+function rangeEndOnly(value, source) {
+  const [number] = numbersIn(value);
+  if (number === void 0) return void 0;
+  const ranges = statedRanges(source);
+  if (ranges.length === 0) return void 0;
+  if (spelledNumbers(source).some((spelled) => spelled.value === number)) return void 0;
+  let first;
+  for (const match of source.matchAll(NUMBER)) {
+    if (match[0].replace(/,/gu, "") !== number) continue;
+    const range = ranges.find(
+      (candidate) => match.index >= candidate.index && match.index < candidate.index + candidate.text.length
+    );
+    if (!range) return void 0;
+    first ?? (first = range);
+  }
+  return first;
+}
+
+export {
+  normalizeGroundingText,
+  numbersIn,
+  spelledNumbers,
+  sourceNumbers,
+  ungroundedNumber,
+  groundingSentences,
+  isVerbatimQuote,
+  distinctiveStems,
+  isGroundedParaphrase,
+  restatesHeadline,
+  statedRanges,
+  rangeEndOnly
+};

package/dist/chunk-L4AFSOT3.js

@@ -0,0 +1,26 @@
+// src/timing/wordTiming.ts
+function wordTimeAt(bookmarks, offset, snap = "containing") {
+  if (snap === "next") return bookmarks.find((word) => word.charOffset >= offset)?.time;
+  let best = bookmarks[0];
+  for (const bookmark of bookmarks) {
+    if (bookmark.charOffset <= offset) best = bookmark;
+    else break;
+  }
+  return best?.time;
+}
+function phraseOffset(timeline, phrase, from = 0) {
+  return phrase ? timeline.sourceText.indexOf(phrase, from) : -1;
+}
+function phraseStartTime(timeline, phrase, options = {}) {
+  const offset = phraseOffset(timeline, phrase, options.from ?? 0);
+  if (offset < 0) return null;
+  const time = wordTimeAt(timeline.bookmarks, offset, options.snap);
+  if (time === void 0) return null;
+  return Math.max(0, time - (options.lead ?? 0));
+}
+
+export {
+  wordTimeAt,
+  phraseOffset,
+  phraseStartTime
+};

package/dist/{chunk-CQSCYJQU.js → chunk-OIQ2GO2O.js}

@@ -9,7 +9,7 @@ import {
   expectedSyllablesAt,
   flattenRenderableBlocks,
   wordPosAtExpectedSyllables
-} from "./chunk-QJQQO3K4.js";
+} from "./chunk-CTT4XAGO.js";
 
 // src/narration/types.ts
 var DEFAULT_FEATURE_CONFIG = Object.freeze({

package/dist/{chunk-IFZZI4XY.js → chunk-TCGGJUKC.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-HKHOFTGM.js";
 import {
   applySavedPresentation
-} from "./chunk-OUSEEUEC.js";
+} from "./chunk-YQQWE4HG.js";
 import {
   SHAPE_NAMES,
   buildChartData,
@@ -32,7 +32,7 @@ import {
   templateRegistry,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-QJQQO3K4.js";
+} from "./chunk-CTT4XAGO.js";
 import {
   ASCII_TREE_VOCAB,
   ASCII_VOCAB,

package/dist/{chunk-OUSEEUEC.js → chunk-YQQWE4HG.js}

@@ -6,7 +6,7 @@ import {
   flattenRenderableBlocks,
   getPinnedBlockMeta,
   markdownToDoc
-} from "./chunk-QJQQO3K4.js";
+} from "./chunk-CTT4XAGO.js";
 import {
   deriveTemplateInputs,
   extractEmbeddedVideos,
@@ -48,6 +48,9 @@ import {
 import {
   parseBuildSpec
 } from "./chunk-P53Z4RYC.js";
+import {
+  wordTimeAt
+} from "./chunk-L4AFSOT3.js";
 import {
   estimateTimeFromText
 } from "./chunk-GHOPHGOK.js";
@@ -2189,6 +2192,55 @@ function createPresentationPlan(doc, hints = defaultPresentationHints()) {
   return { version: 1, sourceText: script.sourceText, origin, beats };
 }
 
+// src/transform/conceptReveal.ts
+var CONCEPT_TEMPLATES = ["cards", "process", "cycle", "layers"];
+function conceptTemplate(template) {
+  return CONCEPT_TEMPLATES.find((name) => name === template);
+}
+function stems(text3) {
+  return (text3.toLowerCase().match(/[\p{L}\p{N}][\p{L}\p{N}'-]*/gu) ?? []).filter((word) => word.length >= 4).map((word) => word.slice(0, 5));
+}
+function matchPointsToSentences(points, sourceText, start, end) {
+  const passage = sourceText.slice(start, end);
+  const sentences = [...passage.matchAll(/[^.!?\n]+[.!?]*/gu)].map((match) => ({
+    offset: start + match.index,
+    words: new Set(stems(match[0]))
+  }));
+  let last = -1;
+  const offsets = [];
+  for (const point of points) {
+    const words = stems(point);
+    let best;
+    for (const sentence of sentences) {
+      const shared = words.filter((word) => sentence.words.has(word)).length;
+      if (shared > (best?.shared ?? 1)) best = { offset: sentence.offset, shared };
+    }
+    if (!best || best.offset < last) return void 0;
+    offsets.push(last = best.offset);
+  }
+  return offsets;
+}
+function conceptBuildSpec() {
+  return { mode: "items", effect: "fadeInUp", previous: "keep" };
+}
+function conceptRevealTiming(template, items, itemTimes, start, end) {
+  const build = conceptBuildSpec();
+  const steps = conceptBuildStepTexts(template, items);
+  if (!itemTimes || itemTimes.length !== steps.length) return { build };
+  const lead = Math.min(0.5, (end - start) / 8);
+  const starts = itemTimes.map(
+    (time) => Math.min(Math.max(0, end - start - 0.1), Math.max(lead, time - start))
+  );
+  starts[0] = Math.min(starts[0], Math.max(lead, Math.min(1, (end - start) / 6)));
+  return {
+    build,
+    buildTiming: {
+      sourceText: buildSourceText(steps.map((text3, index) => ({ id: `build-${index}`, text: text3 }))),
+      starts
+    }
+  };
+}
+
 // src/transform/presentationCompiler.ts
 function compilePresentationPlan(doc, plan) {
   const checked = parsePresentationPlan(plan);
@@ -2260,8 +2312,7 @@ function compilePresentationPlan(doc, plan) {
   const timeAt = (offset) => {
     const marked = markedTime(offset);
     if (marked !== void 0) return marked;
-    if (narration && bookmarks.length)
-      return bookmarks.find((word) => word.charOffset >= offset)?.time ?? duration;
+    if (narration && bookmarks.length) return wordTimeAt(bookmarks, offset, "next") ?? duration;
     return (narration?.startTime ?? 0) + tokensBefore(offset) / Math.max(1, script.tokens.length) * (narration?.duration ?? duration);
   };
   let previous = 0;
@@ -2375,46 +2426,15 @@ function compilePresentationPlan(doc, plan) {
     audio: doc.audio.segments.some((segment) => segment.src) ? doc.audio : { segments: [{ src: "", name: "presentation-clock", startTime: 0, duration }] }
   };
 }
-var CONCEPT_TEMPLATES = ["cards", "process", "cycle", "layers"];
-function conceptTemplate(template) {
-  return CONCEPT_TEMPLATES.find((name) => name === template);
-}
-function stems(text3) {
-  return (text3.toLowerCase().match(/[\p{L}\p{N}][\p{L}\p{N}'-]*/gu) ?? []).filter((word) => word.length >= 4).map((word) => word.slice(0, 5));
-}
 function conceptReveal(template, beat, start, end, sourceText, timeAt) {
-  const build = { mode: "items", effect: "fadeInUp", previous: "keep" };
   const steps = conceptBuildStepTexts(template, beat.points);
-  const passage = sourceText.slice(beat.sourceStart, beat.sourceEnd);
-  const sentences = [...passage.matchAll(/[^.!?\n]+[.!?]*/gu)].map((match) => ({
-    offset: beat.sourceStart + match.index,
-    words: new Set(stems(match[0]))
-  }));
-  let last = -1;
-  const offsets = [];
-  for (const point of beat.points.slice(0, steps.length)) {
-    const words = stems(point);
-    let best;
-    for (const sentence of sentences) {
-      const shared = words.filter((word) => sentence.words.has(word)).length;
-      if (shared > (best?.shared ?? 1)) best = { offset: sentence.offset, shared };
-    }
-    if (!best || best.offset < last) return { build };
-    offsets.push(last = best.offset);
-  }
-  if (offsets.length !== steps.length) return { build };
-  const lead = Math.min(0.5, (end - start) / 8);
-  const starts = offsets.map(
-    (offset) => Math.min(Math.max(0, end - start - 0.1), Math.max(lead, timeAt(offset) - start))
+  const offsets = matchPointsToSentences(
+    beat.points.slice(0, steps.length),
+    sourceText,
+    beat.sourceStart,
+    beat.sourceEnd
   );
-  starts[0] = Math.min(starts[0], Math.max(lead, Math.min(1, (end - start) / 6)));
-  return {
-    build,
-    buildTiming: {
-      sourceText: buildSourceText(steps.map((text3, index) => ({ id: `build-${index}`, text: text3 }))),
-      starts
-    }
-  };
+  return conceptRevealTiming(template, beat.points, offsets?.map(timeAt), start, end);
 }
 function tableFeatureBlock(beat, layout, base, features) {
   const paragraph = (text3) => ({
@@ -2555,6 +2575,11 @@ export {
   transformNarratedSegment,
   collectPresentationMedia,
   createPresentationPlan,
+  CONCEPT_TEMPLATES,
+  conceptTemplate,
+  matchPointsToSentences,
+  conceptBuildSpec,
+  conceptRevealTiming,
   compilePresentationPlan,
   applySavedPresentation
 };