@bendyline/squisq 1.4.1 → 1.5.1

package/dist/{chunk-WMOI7FN3.js.map → chunk-UY7KGQ5R.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/recommend/templates.ts"],"sourcesContent":["/**\n * Block template recommendations.\n *\n * Given a slice of markdown block nodes (the body underneath a heading),\n * profile the content for image / video / quote / list / table / date /\n * stat signals, then map that profile to the set of templates that make\n * sense for the block. Used by the editor's template picker to surface a\n * \"Recommended for this block\" section above the full template list.\n */\n\nimport { extractPlainText, findNodesByType, walkMarkdownTree } from '../markdown/utils.js';\nimport type {\n  HtmlElement,\n  HtmlNode,\n  MarkdownBlockNode,\n  MarkdownHtmlBlock,\n  MarkdownNode,\n} from '../markdown/types.js';\n\nexport interface BlockContentProfile {\n  hasImage: boolean;\n  imageCount: number;\n  hasVideo: boolean;\n  hasBlockquote: boolean;\n  hasList: boolean;\n  hasTable: boolean;\n  hasDate: boolean;\n  hasNumberHighlight: boolean;\n  wordCount: number;\n}\n\nexport interface RecommendationResult {\n  recommended: string[];\n  rest: string[];\n}\n\nconst EMPTY_PROFILE: BlockContentProfile = Object.freeze({\n  hasImage: false,\n  imageCount: 0,\n  hasVideo: false,\n  hasBlockquote: false,\n  hasList: false,\n  hasTable: false,\n  hasDate: false,\n  hasNumberHighlight: false,\n  wordCount: 0,\n});\n\nconst DATE_PATTERNS: RegExp[] = [\n  /\\b(January|February|March|April|May|June|July|August|September|October|November|December)\\s+(\\d{1,2},?\\s+)?\\d{4}\\b/i,\n  /\\b\\d{1,2}\\s+(January|February|March|April|May|June|July|August|September|October|November|December)\\s+\\d{4}\\b/i,\n  /\\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Sept|Oct|Nov|Dec)\\.?\\s+\\d{1,2},?\\s+\\d{4}\\b/i,\n  /\\b\\d{4}-\\d{2}-\\d{2}\\b/,\n  /\\b\\d{1,2}\\/\\d{1,2}\\/\\d{2,4}\\b/,\n  /\\bQ[1-4]\\s+\\d{4}\\b/,\n  /\\b\\d{4}s\\b/,\n  /\\b\\d{1,2}(st|nd|rd|th)\\s+century\\b/i,\n];\n\n/**\n * Matches a \"highlight number\" — a prominent figure suitable for a Stat\n * Highlight block. Qualifies on any of:\n *   - currency prefix:   `$2.3M`, `€500`, `¥1,234`\n *   - unit suffix:       `50%`, `100 years`, `5×`, `2.3M`\n *   - standalone large:  `1,234`, `5000`, `12,345`\n * Plain small numbers (`42`) intentionally don't qualify.\n */\nconst NUMBER_HIGHLIGHT_RE =\n  /(?:[$€£¥]\\s?\\d+(?:[.,]\\d+)*(?:\\s?(?:[MBK]|million|billion|thousand))?|\\d+(?:[.,]\\d+)*\\s?(?:%|‰|x|×|[MBK]|million|billion|thousand|percent|years?|days?|hours?)|\\d{3,}(?:[.,]\\d+)*)/i;\n\nconst VIDEO_HOST_RE = /(youtube\\.com|youtu\\.be|vimeo\\.com|wistia\\.|loom\\.com)/i;\n\nfunction htmlElementsByTag(root: MarkdownNode, tagNames: Set<string>): HtmlElement[] {\n  const blocks = findNodesByType<MarkdownHtmlBlock>(root, 'htmlBlock');\n  // Inline HTML (htmlInline) also carries htmlChildren; include both.\n  const inline = findNodesByType<MarkdownNode>(root, 'htmlInline') as Array<\n    MarkdownNode & { htmlChildren?: HtmlNode[] }\n  >;\n  const out: HtmlElement[] = [];\n  const visit = (n: HtmlNode): void => {\n    if (n.type === 'htmlElement') {\n      if (tagNames.has(n.tagName.toLowerCase())) out.push(n);\n      for (const c of n.children) visit(c);\n    }\n  };\n  for (const b of blocks) for (const c of b.htmlChildren) visit(c);\n  for (const i of inline) {\n    if (Array.isArray(i.htmlChildren)) for (const c of i.htmlChildren) visit(c);\n  }\n  return out;\n}\n\n/**\n * Walk a slice of block nodes and summarize what kinds of content it\n * contains. Cheap to run — no markdown parsing, just AST traversal.\n */\nexport function profileBlockContents(nodes: MarkdownBlockNode[]): BlockContentProfile {\n  if (!nodes || nodes.length === 0) return { ...EMPTY_PROFILE };\n\n  let imageCount = 0;\n  let hasBlockquote = false;\n  let hasList = false;\n  let hasTable = false;\n\n  const plainParts: string[] = [];\n\n  for (const node of nodes) {\n    imageCount += findNodesByType(node, 'image').length;\n    imageCount += findNodesByType(node, 'imageReference').length;\n    if (findNodesByType(node, 'blockquote').length > 0) hasBlockquote = true;\n    if (findNodesByType(node, 'list').length > 0) hasList = true;\n    if (findNodesByType(node, 'table').length > 0) hasTable = true;\n    plainParts.push(extractPlainText(node));\n  }\n\n  // HTML embeds: <img>, <video>, <iframe src=…video host>\n  const root: MarkdownNode = { type: 'document', children: nodes };\n  const imgTags = htmlElementsByTag(root, new Set(['img']));\n  imageCount += imgTags.length;\n\n  const videoTags = htmlElementsByTag(root, new Set(['video', 'iframe', 'source']));\n  let hasVideo = false;\n  for (const el of videoTags) {\n    if (el.tagName.toLowerCase() === 'video') {\n      hasVideo = true;\n      break;\n    }\n    const src = el.attributes.src || el.attributes.href || '';\n    if (VIDEO_HOST_RE.test(src)) {\n      hasVideo = true;\n      break;\n    }\n  }\n\n  // Link-only video embeds (markdown link to a known video host).\n  if (!hasVideo) {\n    const links = findNodesByType<MarkdownNode & { url?: string }>(root, 'link');\n    for (const link of links) {\n      if (link.url && VIDEO_HOST_RE.test(link.url)) {\n        hasVideo = true;\n        break;\n      }\n    }\n  }\n\n  const plainText = plainParts.join(' ').trim();\n  const wordCount = plainText ? plainText.split(/\\s+/).length : 0;\n\n  let hasDate = false;\n  for (const re of DATE_PATTERNS) {\n    if (re.test(plainText)) {\n      hasDate = true;\n      break;\n    }\n  }\n\n  // Number highlight: a paragraph that's mostly a single prominent figure.\n  let hasNumberHighlight = false;\n  walkMarkdownTree(root, (n) => {\n    if (hasNumberHighlight) return true;\n    if (n.type !== 'paragraph') return;\n    const text = extractPlainText(n).trim();\n    if (!text) return true;\n    const m = text.match(NUMBER_HIGHLIGHT_RE);\n    if (!m) return true;\n    // Paragraph qualifies when its word count is small AND a prominent\n    // number occupies a meaningful chunk of it. Keeps \"the company grew\n    // 50% last year\" from triggering, but accepts \"$2.3M raised\".\n    const words = text.split(/\\s+/).length;\n    if (words <= 8) hasNumberHighlight = true;\n    return true;\n  });\n\n  return {\n    hasImage: imageCount > 0,\n    imageCount,\n    hasVideo,\n    hasBlockquote,\n    hasList,\n    hasTable,\n    hasDate,\n    hasNumberHighlight,\n    wordCount,\n  };\n}\n\n// ── Recommendation rules ───────────────────────────────────────────\n\nconst UNIVERSAL_DEFAULTS = ['title', 'sectionHeader', 'factCard', 'twoColumn'];\n\n/**\n * Given a content profile, return the canonical template-name list that\n * should appear in the \"Recommended\" bucket. Caller is responsible for\n * preserving deduplication / ordering when intersecting with the full\n * template list (see {@link recommendTemplatesForBlock}).\n */\nfunction recommendedNamesForProfile(profile: BlockContentProfile): string[] {\n  const names = new Set<string>();\n  let anyContentSignal = false;\n\n  if (profile.hasImage) {\n    anyContentSignal = true;\n    names.add('imageWithCaption');\n    names.add('leftFeature');\n    names.add('rightFeature');\n    if (profile.imageCount >= 2) names.add('photoGrid');\n  }\n\n  if (profile.hasVideo) {\n    anyContentSignal = true;\n    names.add('videoWithCaption');\n    if (profile.hasBlockquote) names.add('videoPullQuote');\n  }\n\n  if (profile.hasBlockquote) {\n    anyContentSignal = true;\n    names.add('quote');\n    names.add('pullQuote');\n    names.add('fullBleedQuote');\n  }\n\n  if (profile.hasList) {\n    anyContentSignal = true;\n    names.add('list');\n  }\n\n  if (profile.hasTable) {\n    anyContentSignal = true;\n    names.add('dataTable');\n    names.add('comparisonBar');\n  }\n\n  if (profile.hasDate) {\n    anyContentSignal = true;\n    names.add('dateEvent');\n  }\n\n  if (profile.hasNumberHighlight) {\n    anyContentSignal = true;\n    names.add('statHighlight');\n  }\n\n  if (anyContentSignal) {\n    // Universal pair only — keep recommended focused.\n    names.add('title');\n    names.add('sectionHeader');\n  } else {\n    for (const n of UNIVERSAL_DEFAULTS) names.add(n);\n  }\n\n  return Array.from(names);\n}\n\n/**\n * Split a flat list of template names into a \"Recommended\" bucket\n * (matches the active block's content profile) and a \"rest\" bucket\n * (everything else). Both buckets preserve the input ordering of\n * `allNames`, so the visual layout stays predictable as templates are\n * added.\n */\nexport function recommendTemplatesForBlock(\n  profile: BlockContentProfile,\n  allNames: readonly string[],\n): RecommendationResult {\n  const desired = new Set(recommendedNamesForProfile(profile));\n  const recommended: string[] = [];\n  const rest: string[] = [];\n  for (const name of allNames) {\n    if (desired.has(name)) recommended.push(name);\n    else rest.push(name);\n  }\n  return { recommended, rest };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/recommend/templates.ts"],"sourcesContent":["/**\n * Block template recommendations.\n *\n * Given a slice of markdown block nodes (the body underneath a heading),\n * profile the content for image / video / quote / list / table / date /\n * stat signals, then map that profile to the set of templates that make\n * sense for the block. Used by the editor's template picker to surface a\n * \"Recommended for this block\" section above the full template list.\n */\n\nimport { extractPlainText, findNodesByType, walkMarkdownTree } from '../markdown/utils.js';\nimport type {\n  HtmlElement,\n  HtmlNode,\n  MarkdownBlockNode,\n  MarkdownHtmlBlock,\n  MarkdownNode,\n} from '../markdown/types.js';\n\nexport interface BlockContentProfile {\n  hasImage: boolean;\n  imageCount: number;\n  hasVideo: boolean;\n  hasBlockquote: boolean;\n  hasList: boolean;\n  hasTable: boolean;\n  hasDate: boolean;\n  hasNumberHighlight: boolean;\n  wordCount: number;\n}\n\nexport interface RecommendationResult {\n  recommended: string[];\n  rest: string[];\n}\n\nconst EMPTY_PROFILE: BlockContentProfile = Object.freeze({\n  hasImage: false,\n  imageCount: 0,\n  hasVideo: false,\n  hasBlockquote: false,\n  hasList: false,\n  hasTable: false,\n  hasDate: false,\n  hasNumberHighlight: false,\n  wordCount: 0,\n});\n\nconst DATE_PATTERNS: RegExp[] = [\n  /\\b(January|February|March|April|May|June|July|August|September|October|November|December)\\s+(\\d{1,2},?\\s+)?\\d{4}\\b/i,\n  /\\b\\d{1,2}\\s+(January|February|March|April|May|June|July|August|September|October|November|December)\\s+\\d{4}\\b/i,\n  /\\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Sept|Oct|Nov|Dec)\\.?\\s+\\d{1,2},?\\s+\\d{4}\\b/i,\n  /\\b\\d{4}-\\d{2}-\\d{2}\\b/,\n  /\\b\\d{1,2}\\/\\d{1,2}\\/\\d{2,4}\\b/,\n  /\\bQ[1-4]\\s+\\d{4}\\b/,\n  /\\b\\d{4}s\\b/,\n  /\\b\\d{1,2}(st|nd|rd|th)\\s+century\\b/i,\n];\n\n/**\n * Matches a \"highlight number\" — a prominent figure suitable for a Stat\n * Highlight block. Qualifies on any of:\n *   - currency prefix:   `$2.3M`, `€500`, `¥1,234`\n *   - unit suffix:       `50%`, `100 years`, `5×`, `2.3M`\n *   - standalone large:  `1,234`, `5000`, `12,345`\n * Plain small numbers (`42`) intentionally don't qualify.\n */\nconst NUMBER_HIGHLIGHT_RE =\n  /(?:[$€£¥]\\s?\\d+(?:[.,]\\d+)*(?:\\s?(?:[MBK]|million|billion|thousand))?|\\d+(?:[.,]\\d+)*\\s?(?:%|‰|x|×|[MBK]|million|billion|thousand|percent|years?|days?|hours?)|\\d{3,}(?:[.,]\\d+)*)/i;\n\nconst VIDEO_HOST_RE = /(youtube\\.com|youtu\\.be|vimeo\\.com|wistia\\.|loom\\.com)/i;\n\nfunction htmlElementsByTag(root: MarkdownNode, tagNames: Set<string>): HtmlElement[] {\n  const blocks = findNodesByType<MarkdownHtmlBlock>(root, 'htmlBlock');\n  // Inline HTML (htmlInline) also carries htmlChildren; include both.\n  const inline = findNodesByType<MarkdownNode>(root, 'htmlInline') as Array<\n    MarkdownNode & { htmlChildren?: HtmlNode[] }\n  >;\n  const out: HtmlElement[] = [];\n  const visit = (n: HtmlNode): void => {\n    if (n.type === 'htmlElement') {\n      if (tagNames.has(n.tagName.toLowerCase())) out.push(n);\n      for (const c of n.children) visit(c);\n    }\n  };\n  for (const b of blocks) for (const c of b.htmlChildren) visit(c);\n  for (const i of inline) {\n    if (Array.isArray(i.htmlChildren)) for (const c of i.htmlChildren) visit(c);\n  }\n  return out;\n}\n\n/**\n * Walk a slice of block nodes and summarize what kinds of content it\n * contains. Cheap to run — no markdown parsing, just AST traversal.\n */\nexport function profileBlockContents(nodes: MarkdownBlockNode[]): BlockContentProfile {\n  if (!nodes || nodes.length === 0) return { ...EMPTY_PROFILE };\n\n  let imageCount = 0;\n  let hasBlockquote = false;\n  let hasList = false;\n  let hasTable = false;\n\n  const plainParts: string[] = [];\n\n  for (const node of nodes) {\n    imageCount += findNodesByType(node, 'image').length;\n    imageCount += findNodesByType(node, 'imageReference').length;\n    if (findNodesByType(node, 'blockquote').length > 0) hasBlockquote = true;\n    if (findNodesByType(node, 'list').length > 0) hasList = true;\n    if (findNodesByType(node, 'table').length > 0) hasTable = true;\n    plainParts.push(extractPlainText(node));\n  }\n\n  // HTML embeds: <img>, <video>, <iframe src=…video host>\n  const root: MarkdownNode = { type: 'document', children: nodes };\n  const imgTags = htmlElementsByTag(root, new Set(['img']));\n  imageCount += imgTags.length;\n\n  const videoTags = htmlElementsByTag(root, new Set(['video', 'iframe', 'source']));\n  let hasVideo = false;\n  for (const el of videoTags) {\n    if (el.tagName.toLowerCase() === 'video') {\n      hasVideo = true;\n      break;\n    }\n    const src = el.attributes.src || el.attributes.href || '';\n    if (VIDEO_HOST_RE.test(src)) {\n      hasVideo = true;\n      break;\n    }\n  }\n\n  // Link-only video embeds (markdown link to a known video host).\n  if (!hasVideo) {\n    const links = findNodesByType<MarkdownNode & { url?: string }>(root, 'link');\n    for (const link of links) {\n      if (link.url && VIDEO_HOST_RE.test(link.url)) {\n        hasVideo = true;\n        break;\n      }\n    }\n  }\n\n  const plainText = plainParts.join(' ').trim();\n  const wordCount = plainText ? plainText.split(/\\s+/).length : 0;\n\n  let hasDate = false;\n  for (const re of DATE_PATTERNS) {\n    if (re.test(plainText)) {\n      hasDate = true;\n      break;\n    }\n  }\n\n  // Number highlight: a paragraph that's mostly a single prominent figure.\n  let hasNumberHighlight = false;\n  walkMarkdownTree(root, (n) => {\n    if (hasNumberHighlight) return true;\n    if (n.type !== 'paragraph') return;\n    const text = extractPlainText(n).trim();\n    if (!text) return true;\n    const m = text.match(NUMBER_HIGHLIGHT_RE);\n    if (!m) return true;\n    // Paragraph qualifies when its word count is small AND a prominent\n    // number occupies a meaningful chunk of it. Keeps \"the company grew\n    // 50% last year\" from triggering, but accepts \"$2.3M raised\".\n    const words = text.split(/\\s+/).length;\n    if (words <= 8) hasNumberHighlight = true;\n    return true;\n  });\n\n  return {\n    hasImage: imageCount > 0,\n    imageCount,\n    hasVideo,\n    hasBlockquote,\n    hasList,\n    hasTable,\n    hasDate,\n    hasNumberHighlight,\n    wordCount,\n  };\n}\n\n// ── Recommendation rules ───────────────────────────────────────────\n\nconst UNIVERSAL_DEFAULTS = ['title', 'sectionHeader', 'factCard', 'twoColumn'];\n\n/**\n * Given a content profile, return the canonical template-name list that\n * should appear in the \"Recommended\" bucket. Caller is responsible for\n * preserving deduplication / ordering when intersecting with the full\n * template list (see {@link recommendTemplatesForBlock}).\n */\nfunction recommendedNamesForProfile(profile: BlockContentProfile): string[] {\n  const names = new Set<string>();\n  let anyContentSignal = false;\n\n  if (profile.hasImage) {\n    anyContentSignal = true;\n    names.add('imageWithCaption');\n    names.add('leftFeature');\n    names.add('rightFeature');\n    if (profile.imageCount >= 2) names.add('photoGrid');\n  }\n\n  if (profile.hasVideo) {\n    anyContentSignal = true;\n    names.add('videoWithCaption');\n    if (profile.hasBlockquote) names.add('videoPullQuote');\n  }\n\n  if (profile.hasBlockquote) {\n    anyContentSignal = true;\n    names.add('quote');\n    names.add('pullQuote');\n    names.add('fullBleedQuote');\n  }\n\n  if (profile.hasList) {\n    anyContentSignal = true;\n    names.add('list');\n  }\n\n  if (profile.hasTable) {\n    anyContentSignal = true;\n    names.add('dataTable');\n    names.add('comparisonBar');\n  }\n\n  if (profile.hasDate) {\n    anyContentSignal = true;\n    names.add('dateEvent');\n  }\n\n  if (profile.hasNumberHighlight) {\n    anyContentSignal = true;\n    names.add('statHighlight');\n  }\n\n  if (anyContentSignal) {\n    // Universal pair only — keep recommended focused.\n    names.add('title');\n    names.add('sectionHeader');\n  } else {\n    for (const n of UNIVERSAL_DEFAULTS) names.add(n);\n  }\n\n  return Array.from(names);\n}\n\n/**\n * Deterministic single-template choice for an unannotated heading block,\n * from strong content signals only. Returns `undefined` when no signal is\n * decisive — the caller keeps its structural default (`sectionHeader`).\n *\n * Precedence favors the most specific/structured content: a table beats\n * an image beats a blockquote beats a stat-looking line. `blockIndex`\n * alternates left/right feature composition for single-image blocks so a\n * run of image sections doesn't stack the same layout.\n *\n * Used by `markdownToDoc`'s auto template picking (see its `autoTemplates`\n * option); the multi-candidate `recommendTemplatesForBlock` below serves\n * the editor's template-picker UI instead.\n */\nexport function pickAutoTemplate(profile: BlockContentProfile, blockIndex = 0): string | undefined {\n  if (profile.hasTable) return 'dataTable';\n  if (profile.imageCount >= 2) return 'photoGrid';\n  if (profile.hasImage) return blockIndex % 2 === 0 ? 'leftFeature' : 'rightFeature';\n  if (profile.hasBlockquote) return 'quote';\n  if (profile.hasNumberHighlight) return 'statHighlight';\n  if (profile.hasList) return 'list';\n  return undefined;\n}\n\n/**\n * Split a flat list of template names into a \"Recommended\" bucket\n * (matches the active block's content profile) and a \"rest\" bucket\n * (everything else). Both buckets preserve the input ordering of\n * `allNames`, so the visual layout stays predictable as templates are\n * added.\n */\nexport function recommendTemplatesForBlock(\n  profile: BlockContentProfile,\n  allNames: readonly string[],\n): RecommendationResult {\n  const desired = new Set(recommendedNamesForProfile(profile));\n  const recommended: string[] = [];\n  const rest: string[] = [];\n  for (const name of allNames) {\n    if (desired.has(name)) recommended.push(name);\n    else rest.push(name);\n  }\n  return { recommended, rest };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-3E5F2XMR.js → chunk-VWUFZ6ZG.js}

@@ -118,12 +118,39 @@ function estimateNarrationDuration(text, wordsPerSecond = DEFAULT_WORDS_PER_SECO
   return spokenWords / wordsPerSecond;
 }
 
+// src/timing/readingTime.ts
+var DEFAULT_READING_WPM = 200;
+function estimateReadingTime(text, options) {
+  const configuredWpm = options?.wordsPerMinute;
+  const wpm = typeof configuredWpm === "number" && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;
+  const words = text.split(/\s+/).filter((w) => w.length > 0).length;
+  const minutes = words / wpm;
+  return {
+    words,
+    minutes,
+    seconds: Math.round(minutes * 60)
+  };
+}
+function estimateNarrationTime(text, options) {
+  const providedWps = options?.wordsPerSecond;
+  const wps = typeof providedWps === "number" && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;
+  const spokenWords = countSpokenWords(text);
+  const totalSeconds = spokenWords / wps;
+  return {
+    spokenWords,
+    minutes: totalSeconds / 60,
+    seconds: Math.round(totalSeconds)
+  };
+}
+
 export {
   DEFAULT_WORDS_PER_SECOND,
   estimateSpokenWordCount,
   countSpokenWords,
   estimateTimeFromText,
   calculatePrefixDuration,
-  estimateNarrationDuration
+  estimateNarrationDuration,
+  estimateReadingTime,
+  estimateNarrationTime
 };
-//# sourceMappingURL=chunk-3E5F2XMR.js.map
+//# sourceMappingURL=chunk-VWUFZ6ZG.js.map

package/dist/chunk-VWUFZ6ZG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/timing/narrationTiming.ts","../src/timing/readingTime.ts"],"sourcesContent":["/**\n * Narration timing estimation.\n *\n * Estimates how long text takes to speak aloud, accounting for:\n * - Numbers spoken as multiple words (e.g., \"1910\" → \"nineteen ten\")\n * - Pauses at commas\n * - Year pronunciation conventions (1000–2099)\n *\n * Ported from qualla-internal's AudioTiming.ts (pure functions, no Node.js deps).\n */\n\n/** Numbers are spoken more slowly than regular words (1.3× multiplier). */\nconst NUMBER_SPEAKING_MULTIPLIER = 1.3;\n\n/** Comma pause in \"word equivalents\" — speakers pause ~0.3 words at commas. */\nconst COMMA_PAUSE_PENALTY = 0.3;\n\n/** Default speaking rate in words per second (~150 WPM). */\nexport const DEFAULT_WORDS_PER_SECOND = 2.5;\n\n/**\n * Estimate how many \"spoken word equivalents\" a single token represents.\n * Numbers get expanded (e.g., \"175,000\" → ~5 words × 1.3 multiplier).\n */\nexport function estimateSpokenWordCount(token: string): number {\n  const cleaned = token.replace(/,/g, '');\n  const num = parseFloat(cleaned);\n\n  if (isNaN(num) || !isFinite(num)) {\n    return 1; // Not a number — count as 1 word\n  }\n\n  return estimateNumberWordCount(cleaned, num) * NUMBER_SPEAKING_MULTIPLIER;\n}\n\n/**\n * Raw word count for a number (before the speaking multiplier).\n */\nfunction estimateNumberWordCount(cleaned: string, num: number): number {\n  // Handle decimals: \"3.14\" → words(\"3\") + \"point\" + 2 digits\n  if (cleaned.includes('.')) {\n    const [whole, decimal] = cleaned.split('.');\n    const wholeNum = parseFloat(whole) || 0;\n    return estimateNumberWordCount(whole, wholeNum) + 1 + decimal.length;\n  }\n\n  const absNum = Math.abs(num);\n  let words = num < 0 ? 1 : 0; // \"negative\" / \"minus\"\n\n  if (absNum === 0) return 1; // \"zero\"\n\n  // Years (1000–2099) are spoken as two two-digit groups:\n  // \"1910\" → \"nineteen ten\", \"2024\" → \"twenty twenty-four\"\n  if (absNum >= 1000 && absNum <= 2099 && Number.isInteger(absNum)) {\n    const yearStr = absNum.toString();\n    if (yearStr.length === 4) {\n      const firstTwo = parseInt(yearStr.slice(0, 2));\n      const lastTwo = parseInt(yearStr.slice(2));\n\n      // First part\n      if (firstTwo >= 10 && firstTwo <= 19) {\n        words += 1;\n      } else if (firstTwo >= 20 && firstTwo <= 99) {\n        words += firstTwo % 10 === 0 ? 1 : 2;\n      } else {\n        words += 2; // \"two thousand\"\n      }\n\n      // Second part\n      if (lastTwo === 0) {\n        if (firstTwo >= 10 && firstTwo <= 99 && firstTwo !== 20) {\n          words += 1; // \"hundred\"\n        }\n      } else if (lastTwo >= 1 && lastTwo <= 9) {\n        words += 2; // \"oh five\"\n      } else if (lastTwo >= 10 && lastTwo <= 19) {\n        words += 1;\n      } else {\n        words += lastTwo % 10 === 0 ? 1 : 2;\n      }\n\n      return Math.max(words, 2);\n    }\n  }\n\n  // General number handling — each magnitude group adds words\n  let remaining = absNum;\n\n  if (remaining >= 1_000_000_000) {\n    const billions = Math.floor(remaining / 1_000_000_000);\n    words += estimateNumberWordCount(String(billions), billions);\n    words += 1; // \"billion\"\n    remaining %= 1_000_000_000;\n  }\n\n  if (remaining >= 1_000_000) {\n    const millions = Math.floor(remaining / 1_000_000);\n    words += estimateNumberWordCount(String(millions), millions);\n    words += 1; // \"million\"\n    remaining %= 1_000_000;\n  }\n\n  if (remaining >= 1_000) {\n    const thousands = Math.floor(remaining / 1_000);\n    words += estimateNumberWordCount(String(thousands), thousands);\n    words += 1; // \"thousand\"\n    remaining %= 1_000;\n  }\n\n  if (remaining >= 100) {\n    words += 2; // digit + \"hundred\"\n    remaining %= 100;\n  }\n\n  if (remaining >= 1) {\n    if (remaining >= 20) {\n      words += remaining % 10 === 0 ? 1 : 2;\n    } else {\n      words += 1; // 1–19\n    }\n  }\n\n  return Math.max(words, 1);\n}\n\n/**\n * Count \"spoken word equivalents\" in a block of text,\n * expanding numbers and adding comma pauses.\n */\nexport function countSpokenWords(text: string): number {\n  const tokens = text.split(/\\s+/).filter((w) => w.length > 0);\n  let count = 0;\n\n  for (const token of tokens) {\n    // Strip punctuation only at token boundaries so internal punctuation\n    // (e.g., decimals like \"3.14\" or digit-grouping commas \"1,000\") is preserved.\n    const stripped = token.replace(/^[.,!?;:'\"()[\\]{}]+|[.,!?;:'\"()[\\]{}]+$/g, '');\n    count += estimateSpokenWordCount(stripped);\n\n    // Count only punctuation commas for pauses: exclude digit-grouping commas\n    // (i.e., commas with digits on both sides, like in \"1,234\").\n    let punctuationCommaCount = 0;\n    for (let i = 0; i < token.length; i++) {\n      if (token[i] === ',') {\n        const prev = i > 0 ? token[i - 1] : '';\n        const next = i < token.length - 1 ? token[i + 1] : '';\n        const prevIsDigit = prev >= '0' && prev <= '9';\n        const nextIsDigit = next >= '0' && next <= '9';\n        if (!(prevIsDigit && nextIsDigit)) {\n          punctuationCommaCount++;\n        }\n      }\n    }\n    count += punctuationCommaCount * COMMA_PAUSE_PENALTY;\n  }\n\n  return count;\n}\n\n/**\n * Estimate audio time at a character offset using word-proportion mapping.\n *\n * Given the full source text and a character position, returns the\n * estimated time (in seconds) at which that position would be spoken.\n *\n * @param text - Full source text\n * @param charOffset - Character offset to estimate timing for\n * @param totalDuration - Total audio duration in seconds\n * @returns Estimated time in seconds\n */\nexport function estimateTimeFromText(\n  text: string,\n  charOffset: number,\n  totalDuration: number,\n): number {\n  const textBefore = text.slice(0, charOffset);\n  const spokenWordsBefore = countSpokenWords(textBefore);\n  const totalSpokenWords = countSpokenWords(text);\n\n  if (totalSpokenWords === 0) return 0;\n  return (spokenWordsBefore / totalSpokenWords) * totalDuration;\n}\n\n/**\n * Estimate how long a spoken prefix adds to audio duration.\n *\n * When audio includes a spoken title or header before the main content,\n * this calculates the extra duration to offset timing calculations.\n *\n * @param prefix - Prefix text (e.g., an article title spoken before the body)\n * @param wordsPerSecond - Speaking rate (default: 2.5)\n * @returns Estimated duration in seconds\n */\nexport function calculatePrefixDuration(\n  prefix: string,\n  wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n  if (!prefix) return 0;\n\n  const words = prefix.split(/\\s+/).filter((w) => w.length > 0);\n  const newlineCount = (prefix.match(/\\n\\n/g) || []).length;\n  const pauseTime = newlineCount * 0.5;\n\n  return words.length / wordsPerSecond + pauseTime;\n}\n\n/**\n * Estimate narration duration for a block of text.\n *\n * @param text - The text to estimate\n * @param wordsPerSecond - Speaking rate (default: 2.5, i.e. ~150 WPM)\n * @returns Duration in seconds\n */\nexport function estimateNarrationDuration(\n  text: string,\n  wordsPerSecond: number = DEFAULT_WORDS_PER_SECOND,\n): number {\n  const spokenWords = countSpokenWords(text);\n  return spokenWords / wordsPerSecond;\n}\n","/**\n * Reading time estimation.\n *\n * Estimates how long it takes to read text silently vs. narrate it aloud.\n * Uses configurable words-per-minute rates.\n */\n\nimport { countSpokenWords, DEFAULT_WORDS_PER_SECOND } from './narrationTiming.js';\n\n/** Default silent reading rate (adults average ~200–250 WPM). */\nconst DEFAULT_READING_WPM = 200;\n\n/** Result of a reading-time estimate. */\nexport interface ReadingTimeEstimate {\n  /** Number of words (plain word count, not spoken equivalents). */\n  words: number;\n  /** Estimated minutes (decimal). */\n  minutes: number;\n  /** Estimated seconds (rounded). */\n  seconds: number;\n}\n\n/** Options for reading-time estimation. */\nexport interface ReadingTimeOptions {\n  /** Words per minute for silent reading (default: 200). */\n  wordsPerMinute?: number;\n}\n\n/**\n * Estimate silent reading time for a block of text.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Word count + time estimate\n */\nexport function estimateReadingTime(\n  text: string,\n  options?: ReadingTimeOptions,\n): ReadingTimeEstimate {\n  const configuredWpm = options?.wordsPerMinute;\n  const wpm =\n    typeof configuredWpm === 'number' && configuredWpm > 0 ? configuredWpm : DEFAULT_READING_WPM;\n  const words = text.split(/\\s+/).filter((w) => w.length > 0).length;\n  const minutes = words / wpm;\n\n  return {\n    words,\n    minutes,\n    seconds: Math.round(minutes * 60),\n  };\n}\n\n/** Result of a narration-time estimate. */\nexport interface NarrationTimeEstimate {\n  /** Spoken word equivalents (numbers expanded, comma pauses added). */\n  spokenWords: number;\n  /** Estimated minutes (decimal). */\n  minutes: number;\n  /** Estimated seconds (rounded). */\n  seconds: number;\n}\n\n/** Options for narration-time estimation. */\nexport interface NarrationTimeOptions {\n  /** Words per second for narration (default: 2.5 ≈ 150 WPM). */\n  wordsPerSecond?: number;\n}\n\n/**\n * Estimate narration (spoken) time for a block of text.\n *\n * Unlike silent reading, this accounts for numbers being spoken as\n * multiple words and pauses at commas.\n *\n * @param text - The text to estimate\n * @param options - Optional configuration\n * @returns Spoken word equivalents + time estimate\n */\nexport function estimateNarrationTime(\n  text: string,\n  options?: NarrationTimeOptions,\n): NarrationTimeEstimate {\n  const providedWps = options?.wordsPerSecond;\n  const wps =\n    typeof providedWps === 'number' && providedWps > 0 ? providedWps : DEFAULT_WORDS_PER_SECOND;\n  const spokenWords = countSpokenWords(text);\n  const totalSeconds = spokenWords / wps;\n\n  return {\n    spokenWords,\n    minutes: totalSeconds / 60,\n    seconds: Math.round(totalSeconds),\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-ZLQKNOZQ.js

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-ZLQKNOZQ.js.map

package/dist/chunk-ZLQKNOZQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/doc/index.d.ts

@@ -1,5 +1,5 @@
-export { AccentLayout, AudioSegmentTiming, CoverBlockInput, DEFAULT_LAYOUT, DocStylePreset, ExpandDocBlocksOptions, MarkdownToDocOptions, RenderContext, TEMPLATE_ALIASES, adjustY, comparisonBar, countBlocks, coverBlock, createAccentLayers, dataTable, dateEvent, definitionCard, docToMarkdown, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, factCard, flattenBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, leftFeature, listBlock, mapBlock, markdownToDoc, photoGrid, pullQuote, quoteBlock, resolveAudioMapping, resolveColorScheme, resolveTemplateName, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shouldUseShadow, statHighlight, templateRegistry, themedFontSize, titleBlock, twoColumn, videoPullQuote, videoWithCaption } from '../story/index.js';
-export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BHjJ0Qx6.js';
-export { t as DocBlock, E as LayoutHints, R as PersistentLayerConfig, _ as RenderStyle, a9 as TemplateBlock, aa as TemplateContext, af as Theme, ag as ThemeColorPalette, ah as ThemeColorScheme, ak as ThemeStyle, al as ThemeTypography, ar as VIEWPORT_PRESETS, av as ViewportConfig, aw as ViewportOrientation, ax as ViewportPreset, aB as createTemplateContext, aG as getLayoutHints, aK as getTwoColumnPositions, aL as getViewport, aM as getViewportOrientation, aO as isTemplateBlock, aS as scaledFontSize } from '../Doc-BeSeH2iX.js';
-import '../types-BdZkdJ3z.js';
-import '../ContentContainer-DNx460y8.js';
+export { AccentLayout, AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, CONTAINER_TEMPLATES, ClipBox, ConnectorRouting, CoverBlockInput, DEFAULT_LAYOUT, DataFenceParseResult, DeriveTemplateInputsOptions, DiagramEdge, DiagramLayout, DiagramLayoutOptions, DiagramNodePosition, DocStylePreset, DrawingConnector, DrawingLayout, DrawingLayoutOptions, DrawingShape, DrawingShapeKind, ExpandDocBlocksOptions, ExtractedTableData, FirstImage, InputCoercion, LayoutLayerDefaults, LayoutLayersResult, MarkdownToDocOptions, MarkdownValidationResult, PATH_SHAPE_KINDS, RenderContext, RuntimeTemplateRegistry, SHAPE_NAMES, TEMPLATE_ALIASES, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TemplateInputDescriptor, TemplateMetadata, TemplateParamFinding, ValidateOptions, adjustY, applyRenderStyleToLayers, buildRegistry, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, countBlocks, coverBlock, createAccentLayers, cssFilterForTreatment, dataTable, dateEvent, decodeLayersFromFrontmatter, definitionCard, deriveTemplateInputs, diagramBlock, docToMarkdown, drawingBlock, encodeLayersForFrontmatter, expandCoverBlock, expandDocBlocks, expandPersistentLayers, expandTemplateBlock, extractBlockquoteText, extractBodyPlainText, extractFirstImage, extractImages, extractListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstTable, flattenBlocks, flattenRenderableBlocks, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockDepth, getDefaultAnimation, getDefaultAnimationDuration, getDocStyleConfig, getLayers, getOverlayOpacity, getPersistentLayersFromTheme, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isContainerTemplate, isDataFence, isShapeName, layoutBlock, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, mapBlock, markdownToDoc, markerPath, normalizeShapeKind, parseDataFence, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionHeader, shapePath, shouldUseShadow, statHighlight, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, titleBlock, twoColumn, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter } from '../story/index.js';
+export { D as DEFAULT_THEME, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-CehcJhzz.js';
+export { z as DocBlock, G as FRONTMATTER_CUSTOM_TEMPLATES_KEY, H as FRONTMATTER_CUSTOM_THEMES_KEY, U as LayoutHints, a5 as PersistentLayerConfig, af as RenderStyle, at as TemplateBlock, au as TemplateContext, az as Theme, aA as ThemeColorPalette, aB as ThemeColorScheme, aE as ThemeStyle, aF as ThemeTypography, aJ as VIEWPORT_PRESETS, aN as ViewportConfig, aO as ViewportOrientation, aP as ViewportPreset, aU as createTemplateContext, a_ as getLayoutHints, b2 as getTwoColumnPositions, b3 as getViewport, b4 as getViewportOrientation, b6 as isTemplateBlock, bb as scaledFontSize } from '../Doc-BBVGq1_9.js';
+import '../types-DlAZ7MW4.js';
+import '../ContentContainer-BXUlIf18.js';

package/dist/doc/index.js

@@ -1,21 +1,48 @@
 import {
+  BASE_INPUT_DESCRIPTORS,
+  CONTAINER_TEMPLATES,
   DEFAULT_LAYOUT,
+  SHAPE_NAMES,
   TEMPLATE_ALIASES,
+  TEMPLATE_INPUT_DESCRIPTORS,
+  TEMPLATE_METADATA,
   adjustY,
+  applyRenderStyleToLayers,
+  buildRegistry,
+  coerceTemplateParams,
   comparisonBar,
+  computeDiagramLayout,
+  computeDrawingLayout,
+  computeLayoutLayers,
   countBlocks,
   coverBlock,
   createAccentLayers,
+  cssFilterForTreatment,
   dataTable,
   dateEvent,
+  decodeLayersFromFrontmatter,
   definitionCard,
+  deriveTemplateInputs,
+  diagramBlock,
   docToMarkdown,
+  drawingBlock,
+  encodeLayersForFrontmatter,
   expandCoverBlock,
   expandDocBlocks,
   expandPersistentLayers,
   expandTemplateBlock,
+  extractBlockquoteText,
+  extractBodyPlainText,
+  extractFirstImage,
+  extractImages,
+  extractListItems,
+  extractTableData,
+  extractTableFromContents,
   factCard,
+  fallbackBlockLayers,
+  findFirstTable,
   flattenBlocks,
+  flattenRenderableBlocks,
   fullBleedQuote,
   getAccentLayout,
   getAnimationProgress,
@@ -27,21 +54,35 @@ import {
   getDocStyleConfig,
   getLayers,
   getOverlayOpacity,
+  getPersistentLayersFromTheme,
   getTemplateHint,
   getThemeFont,
   getTransitionClass,
   hasTemplate,
   imageWithCaption,
+  isContainerTemplate,
+  isDataFence,
+  isShapeName,
+  layoutBlock,
   leftFeature,
+  lintTemplateParams,
   listBlock,
   mapBlock,
   markdownToDoc,
+  normalizeShapeKind,
+  parseDataFence,
+  parseYamlSubset,
   photoGrid,
   pullQuote,
   quoteBlock,
+  readCustomTemplatesFromFrontmatter,
+  readCustomThemesFromFrontmatter,
+  replaceDataFence,
   resolveAudioMapping,
   resolveColorScheme,
+  resolvePersistentLayers,
   resolveTemplateName,
+  resolveThemeForDoc,
   rightFeature,
   scaleAnimationDuration,
   scoreTextSimilarity,
@@ -49,18 +90,42 @@ import {
   shouldUseShadow,
   statHighlight,
   templateRegistry,
+  themeWantsAmbientMotion,
+  themedEntrance,
   themedFontSize,
+  themedImageTreatment,
+  themedScrim,
+  themedSurfaceGradient,
   titleBlock,
   twoColumn,
+  validateMarkdownDoc,
+  validateMarkdownSource,
   videoPullQuote,
-  videoWithCaption
-} from "../chunk-KSWJR66U.js";
+  videoWithCaption,
+  wrapWithPersistentLayers,
+  writeCustomTemplatesToFrontmatter,
+  writeCustomThemesToFrontmatter
+} from "../chunk-LH7I6SH7.js";
+import "../chunk-UY7KGQ5R.js";
+import "../chunk-V543AI2F.js";
+import "../chunk-FVTQSNR7.js";
+import {
+  PATH_SHAPE_KINDS,
+  clipEndpoints,
+  clipPoint,
+  connectorPath,
+  lineStyleDasharray,
+  markerPath,
+  shapePath
+} from "../chunk-RUDYOTA6.js";
 import {
   DEFAULT_THEME,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+  FRONTMATTER_CUSTOM_THEMES_KEY,
   getAvailableThemes,
   getThemeSummaries,
   resolveTheme
-} from "../chunk-B4EEON3N.js";
+} from "../chunk-KKNUBQ6Y.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -70,31 +135,66 @@ import {
   getViewportOrientation,
   isTemplateBlock,
   scaledFontSize2 as scaledFontSize
-} from "../chunk-5WFRKURX.js";
-import "../chunk-H3AXU4MJ.js";
-import "../chunk-4X3JQXNM.js";
-import "../chunk-3E5F2XMR.js";
+} from "../chunk-DLXZMS5K.js";
+import "../chunk-TEEEILMP.js";
+import "../chunk-HWVFJAAH.js";
+import "../chunk-DBS6RIFL.js";
+import "../chunk-QE7TWGVT.js";
+import "../chunk-VWUFZ6ZG.js";
 export {
+  BASE_INPUT_DESCRIPTORS,
+  CONTAINER_TEMPLATES,
   DEFAULT_LAYOUT,
   DEFAULT_THEME,
+  FRONTMATTER_CUSTOM_TEMPLATES_KEY,
+  FRONTMATTER_CUSTOM_THEMES_KEY,
+  PATH_SHAPE_KINDS,
+  SHAPE_NAMES,
   TEMPLATE_ALIASES,
+  TEMPLATE_INPUT_DESCRIPTORS,
+  TEMPLATE_METADATA,
   VIEWPORT_PRESETS,
   adjustY,
+  applyRenderStyleToLayers,
+  buildRegistry,
+  clipEndpoints,
+  clipPoint,
+  coerceTemplateParams,
   comparisonBar,
+  computeDiagramLayout,
+  computeDrawingLayout,
+  computeLayoutLayers,
+  connectorPath,
   countBlocks,
   coverBlock,
   createAccentLayers,
   createTemplateContext,
+  cssFilterForTreatment,
   dataTable,
   dateEvent,
+  decodeLayersFromFrontmatter,
   definitionCard,
+  deriveTemplateInputs,
+  diagramBlock,
   docToMarkdown,
+  drawingBlock,
+  encodeLayersForFrontmatter,
   expandCoverBlock,
   expandDocBlocks,
   expandPersistentLayers,
   expandTemplateBlock,
+  extractBlockquoteText,
+  extractBodyPlainText,
+  extractFirstImage,
+  extractImages,
+  extractListItems,
+  extractTableData,
+  extractTableFromContents,
   factCard,
+  fallbackBlockLayers,
+  findFirstTable,
   flattenBlocks,
+  flattenRenderableBlocks,
   fullBleedQuote,
   getAccentLayout,
   getAnimationProgress,
@@ -108,6 +208,7 @@ export {
   getLayers,
   getLayoutHints,
   getOverlayOpacity,
+  getPersistentLayersFromTheme,
   getTemplateHint,
   getThemeFont,
   getThemeSummaries,
@@ -117,30 +218,56 @@ export {
   getViewportOrientation,
   hasTemplate,
   imageWithCaption,
+  isContainerTemplate,
+  isDataFence,
+  isShapeName,
   isTemplateBlock,
+  layoutBlock,
   leftFeature,
+  lineStyleDasharray,
+  lintTemplateParams,
   listBlock,
   mapBlock,
   markdownToDoc,
+  markerPath,
+  normalizeShapeKind,
+  parseDataFence,
+  parseYamlSubset,
   photoGrid,
   pullQuote,
   quoteBlock,
+  readCustomTemplatesFromFrontmatter,
+  readCustomThemesFromFrontmatter,
+  replaceDataFence,
   resolveAudioMapping,
   resolveColorScheme,
+  resolvePersistentLayers,
   resolveTemplateName,
   resolveTheme,
+  resolveThemeForDoc,
   rightFeature,
   scaleAnimationDuration,
   scaledFontSize,
   scoreTextSimilarity,
   sectionHeader,
+  shapePath,
   shouldUseShadow,
   statHighlight,
   templateRegistry,
+  themeWantsAmbientMotion,
+  themedEntrance,
   themedFontSize,
+  themedImageTreatment,
+  themedScrim,
+  themedSurfaceGradient,
   titleBlock,
   twoColumn,
+  validateMarkdownDoc,
+  validateMarkdownSource,
   videoPullQuote,
-  videoWithCaption
+  videoWithCaption,
+  wrapWithPersistentLayers,
+  writeCustomTemplatesToFrontmatter,
+  writeCustomThemesToFrontmatter
 };
 //# sourceMappingURL=index.js.map

package/dist/generate/index.d.ts

@@ -1,7 +1,7 @@
 import { E as ExtractedElement } from '../contentExtractor-BNfVJV2U.js';
 export { C as ComparisonData, D as DateData, a as DefinitionData, b as ExtractionOptions, c as ExtractionResult, d as ExtractionType, F as FactData, I as ImpactLineData, L as ListData, Q as QuoteData, S as StatData, e as extractContent, s as stripMarkdown } from '../contentExtractor-BNfVJV2U.js';
-import { j as ColorScheme, A as AccentImage, a9 as TemplateBlock, s as Doc, a as AccentPosition } from '../Doc-BeSeH2iX.js';
-import '../types-BdZkdJ3z.js';
+import { m as ColorScheme, A as AccentImage, at as TemplateBlock } from '../Doc-BBVGq1_9.js';
+import '../types-DlAZ7MW4.js';
 
 /**
  * Template Mapper
@@ -25,75 +25,4 @@ interface MapOptions {
  */
 declare function mapElementToBlock(element: ExtractedElement, options: MapOptions): TemplateBlock;
 
-/**
- * Slideshow Generator
- *
- * Turns plain text + optional images into a complete squisq `Doc`.
- *
- * Pipeline:
- * 1. Strip markdown (if needed)
- * 2. Extract compelling content (stats, dates, quotes, …)
- * 3. Estimate narration timing
- * 4. Map extractions → template blocks
- * 5. Interleave image slides
- * 6. Return a ready-to-render `Doc`
- */
-
-/** A Doc variant whose blocks are TemplateBlocks (no startTime required). */
-type SlideshowDoc = Omit<Doc, 'blocks'> & {
-    blocks: TemplateBlock[];
-};
-/** Image metadata passed to the generator. */
-interface SlideshowImage {
-    /** Image source path or URL. */
-    src: string;
-    /** Alt text for accessibility. */
-    alt?: string;
-    /** Photo credit. */
-    credit?: string;
-    /** License identifier. */
-    license?: string;
-}
-/** Options for `generateSlideshow`. */
-interface SlideshowOptions {
-    /** Deterministic seed (default: hash of the text). */
-    seed?: number;
-    /** Title slide text. Omit to skip the title slide. */
-    title?: string;
-    /** Subtitle for the title slide. */
-    subtitle?: string;
-    /** Explicit total duration in seconds. When omitted, estimated from text. */
-    duration?: number;
-    /** Target number of content slides (default: 5–8, auto-scaled). */
-    targetSlides?: number;
-    /** Color schemes to rotate (default: ['blue','green','purple','orange','red']). */
-    colorSchemes?: ColorScheme[];
-    /** Ambient motions to rotate on images. */
-    ambientMotions?: Array<'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight'>;
-    /** Accent positions to rotate on text slides. */
-    accentPositions?: AccentPosition[];
-    /** Minimum slide duration in seconds (default: 4). */
-    minSlideDuration?: number;
-    /** Maximum slide duration in seconds (default: 15). */
-    maxSlideDuration?: number;
-    /** Theme identifier to embed in the Doc. */
-    themeId?: string;
-    /** Whether the input text is markdown (default: false). */
-    isMarkdown?: boolean;
-    /** Minimum extraction confidence (default: 0.3). */
-    minConfidence?: number;
-}
-/**
- * Generate a slideshow `Doc` from text and optional images.
- *
- * ```ts
- * const doc = generateSlideshow(articleText, myImages, {
- *   title: 'Mount Rainier',
- *   themeId: 'documentary',
- * });
- * // doc is a complete Doc ready for DocPlayer / LinearDocView
- * ```
- */
-declare function generateSlideshow(text: string, images?: SlideshowImage[], options?: SlideshowOptions): SlideshowDoc;
-
-export { ExtractedElement, type MapOptions, type SlideshowDoc, type SlideshowImage, type SlideshowOptions, generateSlideshow, mapElementToBlock };
+export { ExtractedElement, type MapOptions, mapElementToBlock };

package/dist/generate/index.js

@@ -1,16 +1,11 @@
-import {
-  generateSlideshow
-} from "../chunk-MYIH7FWD.js";
+import "../chunk-ET53IIEP.js";
 import {
   extractContent,
   mapElementToBlock,
   stripMarkdown
-} from "../chunk-FR2RBTKO.js";
-import "../chunk-FVTQSNR7.js";
-import "../chunk-3E5F2XMR.js";
+} from "../chunk-TQWLI6S2.js";
 export {
   extractContent,
-  generateSlideshow,
   mapElementToBlock,
   stripMarkdown
 };

package/dist/icons/index.d.ts

@@ -1,28 +1,5 @@
-/**
- * iconData.ts — GENERATED FILE
- *
- * FontAwesome Free icon catalog. Run `node scripts/generate-icon-data.mjs`
- * to regenerate after bumping @fortawesome/fontawesome-free.
- *
- * Entry count: 2141
- * Generated:   2026-05-14T03:38:13.863Z
- */
-type IconFamily = 'brands' | 'solid' | 'regular';
-interface IconEntry {
-    /** Icon name without the `fa-` prefix (e.g. `github`). */
-    name: string;
-    /** Family bucket — drives the `fa-brands` / `fa-solid` / `fa-regular` class. */
-    family: IconFamily;
-    /** Human display label (used by the picker tooltip). */
-    label: string;
-    /** Lowercase, space-joined search keywords. */
-    keywords: string;
-    /** FontAwesome Private-Use-Area codepoint as a hex string (e.g. `'f09b'`).
-     *  Use `String.fromCodePoint(parseInt(unicode, 16))` to get the rendered
-     *  glyph when the FA font is loaded. */
-    unicode: string;
-}
-declare const ICONS: IconEntry[];
+import { a as IconEntry } from '../inlineIconMarker-CiE8Hlvz.js';
+export { I as ICONS, b as IconFamily, c as IconTextRun, h as hasIconMarker, i as iconClass, d as iconMarker, s as splitIconMarkers, e as stripIconMarkers } from '../inlineIconMarker-CiE8Hlvz.js';
 
 /**
  * Icon Resolver
@@ -84,4 +61,4 @@ interface IconSuggestion {
  */
 declare function suggestIcons(query: string, limit?: number): IconSuggestion[];
 
-export { ICONS, type IconEntry, type IconFamily, type IconSuggestion, canonicalIconToken, iconGlyph, looksLikeIconToken, resolveIcon, suggestIcons };
+export { IconEntry, type IconSuggestion, canonicalIconToken, iconGlyph, looksLikeIconToken, resolveIcon, suggestIcons };

package/dist/icons/index.js

@@ -1,3 +1,11 @@
+import "../chunk-PGGGKYWG.js";
+import {
+  hasIconMarker,
+  iconClass,
+  iconMarker,
+  splitIconMarkers,
+  stripIconMarkers
+} from "../chunk-2UQOHYE2.js";
 import {
   ICONS,
   canonicalIconToken,
@@ -9,9 +17,14 @@ import {
 export {
   ICONS,
   canonicalIconToken,
+  hasIconMarker,
+  iconClass,
   iconGlyph,
+  iconMarker,
   looksLikeIconToken,
   resolveIcon,
+  splitIconMarkers,
+  stripIconMarkers,
   suggestIcons
 };
 //# sourceMappingURL=index.js.map

package/dist/icons/inlineIconMarker.d.ts

@@ -0,0 +1 @@
+export { c as IconTextRun, h as hasIconMarker, i as iconClass, d as iconMarker, s as splitIconMarkers, e as stripIconMarkers } from '../inlineIconMarker-CiE8Hlvz.js';

package/dist/icons/inlineIconMarker.js

@@ -0,0 +1,15 @@
+import {
+  hasIconMarker,
+  iconClass,
+  iconMarker,
+  splitIconMarkers,
+  stripIconMarkers
+} from "../chunk-2UQOHYE2.js";
+export {
+  hasIconMarker,
+  iconClass,
+  iconMarker,
+  splitIconMarkers,
+  stripIconMarkers
+};
+//# sourceMappingURL=inlineIconMarker.js.map

package/dist/icons/inlineIconMarker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/imageEdit/index.d.ts

@@ -1,9 +1,9 @@
-import { a as ImageEditDoc, b as ImageEditLayer } from '../ImageEditDoc-BTIvw0oq.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-BTIvw0oq.js';
-import { C as ContentContainer } from '../ContentContainer-DNx460y8.js';
+import { a as ImageEditDoc, b as ImageEditLayer } from '../ImageEditDoc-FuyGtt6o.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-FuyGtt6o.js';
+import { C as ContentContainer } from '../ContentContainer-BXUlIf18.js';
 import { V as Version, C as CoalesceOptions, P as PrunePolicy } from '../types-D98li1gV.js';
-import '../Doc-BeSeH2iX.js';
-import '../types-BdZkdJ3z.js';
+import '../Doc-BBVGq1_9.js';
+import '../types-DlAZ7MW4.js';
 
 /**
  * Pure helpers for constructing and mutating {@link ImageEditDoc} values.
@@ -212,5 +212,11 @@ interface ImageEditExportOptions {
  * layers are read from `container` and inlined as data URLs.
  */
 declare function exportImageEditDoc(doc: ImageEditDoc, container: ContentContainer, options?: ImageEditExportOptions): Promise<Blob>;
+/**
+ * Build the standalone SVG string that mirrors the canvas + layers. Exposed
+ * for tests (the raster step needs a browser); shape/text/path layers don't
+ * touch `container`, only image layers do (to inline asset bytes).
+ */
+declare function buildSvgString(doc: ImageEditDoc, container: ContentContainer): Promise<string>;
 
-export { IMAGE_EDIT_ASSETS_PREFIX, IMAGE_EDIT_DEFAULT_BASENAME, IMAGE_EDIT_STATE_FILENAME, IMAGE_EDIT_VERSIONS_PREFIX, ImageEditDoc, type ImageEditExportFormat, type ImageEditExportOptions, ImageEditLayer, ImageEditVersionManager, type ImageEditVersionManagerOptions, type RevertImageEditOptions, type SaveImageEditVersionOptions, type SaveImageEditVersionResult, addLayer, buildImageEditVersionPath, coalesceImageEditVersions, createEmptyImageEditDoc, exportImageEditDoc, listImageEditVersions, parseImageEditVersionPath, pruneImageEditVersions, readImageEditDoc, readImageEditVersion, readImageEditVersionText, removeLayer, reorderLayer, revertToImageEditVersion, saveImageEditVersion, setCanvas, touch, updateLayer, writeImageEditDoc };
+export { IMAGE_EDIT_ASSETS_PREFIX, IMAGE_EDIT_DEFAULT_BASENAME, IMAGE_EDIT_STATE_FILENAME, IMAGE_EDIT_VERSIONS_PREFIX, ImageEditDoc, type ImageEditExportFormat, type ImageEditExportOptions, ImageEditLayer, ImageEditVersionManager, type ImageEditVersionManagerOptions, type RevertImageEditOptions, type SaveImageEditVersionOptions, type SaveImageEditVersionResult, addLayer, buildImageEditVersionPath, buildSvgString, coalesceImageEditVersions, createEmptyImageEditDoc, exportImageEditDoc, listImageEditVersions, parseImageEditVersionPath, pruneImageEditVersions, readImageEditDoc, readImageEditVersion, readImageEditVersionText, removeLayer, reorderLayer, revertToImageEditVersion, saveImageEditVersion, setCanvas, touch, updateLayer, writeImageEditDoc };