@bendyline/squisq 1.2.1 → 1.2.2

package/dist/chunk-53TZ2UTL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/themeLibrary.ts"],"sourcesContent":["/**\n * Built-in Theme Library\n *\n * Ships 8 curated themes covering documentary, editorial, minimal, and\n * cinematic styles. Each theme is fully JSON-serializable.\n *\n * Usage:\n * ```ts\n * import { THEMES, resolveTheme } from '@bendyline/squisq/schemas';\n *\n * const theme = resolveTheme('minimalist'); // look up by id\n * const theme = THEMES.documentary;         // direct access\n * ```\n */\n\nimport type { Theme, ThemeColorScheme } from './Theme.js';\n\n// ============================================\n// Shared constants\n// ============================================\n\n// ── Font stacks ──────────────────────────────────────────────────\n// Each stack lists the recommended Google Font first (works when the\n// wrapping site loads it), then degrades to safe system fonts.\n// Squisq itself does NOT load Google Fonts.\n\n/** System fonts only — no external dependencies. */\nconst SYSTEM_SANS = 'system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif';\nconst SYSTEM_SERIF = 'Georgia, \"Times New Roman\", serif';\nconst SYSTEM_MONO = 'Consolas, \"Courier New\", monospace';\n\n/** Theme-specific stacks with Google Font leads. */\nconst PLAYFAIR = '\"Playfair Display\", Georgia, serif';\nconst SOURCE_SERIF = '\"Source Serif 4\", \"PT Serif\", Georgia, serif';\nconst INTER = '\"Inter\", \"Segoe UI\", Roboto, sans-serif';\nconst OSWALD = '\"Oswald\", Impact, \"Arial Black\", sans-serif';\nconst ROBOTO = '\"Roboto\", \"Segoe UI\", Arial, sans-serif';\nconst MERRIWEATHER = '\"Merriweather\", Georgia, serif';\nconst LORA = '\"Lora\", \"Merriweather\", Georgia, serif';\nconst JETBRAINS_MONO = '\"JetBrains Mono\", \"Fira Code\", Consolas, monospace';\nconst IBM_PLEX_SANS = '\"IBM Plex Sans\", \"Segoe UI\", Roboto, sans-serif';\nconst DM_SERIF = '\"DM Serif Display\", Georgia, serif';\nconst DM_SANS = '\"DM Sans\", \"Segoe UI\", Roboto, sans-serif';\nconst CORMORANT = '\"Cormorant Garamond\", Garamond, Georgia, serif';\nconst CRIMSON = '\"Crimson Text\", Georgia, serif';\nconst PT_SERIF = '\"PT Serif\", Georgia, serif';\n\n/** Standard 6-scheme set used by the documentary theme (migrated from old COLOR_SCHEMES). */\nconst CLASSIC_COLOR_SCHEMES: Record<string, ThemeColorScheme> = {\n  blue: { bg: '#1a365d', text: '#63b3ed', accent: '#90cdf4' },\n  green: { bg: '#22543d', text: '#9ae6b4', accent: '#68d391' },\n  purple: { bg: '#44337a', text: '#d6bcfa', accent: '#b794f4' },\n  red: { bg: '#742a2a', text: '#fc8181', accent: '#feb2b2' },\n  orange: { bg: '#744210', text: '#fbd38d', accent: '#f6ad55' },\n  teal: { bg: '#234e52', text: '#81e6d9', accent: '#4fd1c5' },\n};\n\n// ============================================\n// 1. Standard (default — safe system fonts, no external dependencies)\n// ============================================\n\nconst standard: Theme = {\n  id: 'standard',\n  name: 'Standard',\n  description: 'Clean and safe. System fonts only — no external font dependencies.',\n  colors: {\n    primary: '#3182ce',\n    secondary: '#4a5568',\n    background: '#1a202c',\n    backgroundLight: '#2d3748',\n    text: '#f7fafc',\n    textMuted: '#a0aec0',\n    highlight: '#4299e1',\n    warning: '#fc8181',\n  },\n  typography: {\n    bodyFontFamily: SYSTEM_SANS,\n    titleFontFamily: SYSTEM_SERIF,\n    monoFontFamily: SYSTEM_MONO,\n    titleWeight: 'bold',\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.45,\n    animationSpeed: 1.0,\n  },\n  renderStyle: {\n    name: 'standard',\n    defaultTextAnimation: 'fadeIn',\n    defaultImageAnimation: 'slowZoom',\n    ambientMotion: true,\n    defaultTransition: { type: 'fade', duration: 0.7 },\n  },\n  colorSchemes: CLASSIC_COLOR_SCHEMES,\n  persistentLayers: {\n    bottomLayers: [\n      {\n        template: 'gradientBackground',\n        config: { type: 'gradientBackground', preset: 'dark-vignette' },\n      },\n    ],\n  },\n};\n\n// ============================================\n// 2. Documentary\n// ============================================\n\nconst documentary: Theme = {\n  id: 'documentary',\n  name: 'Documentary',\n  description: 'Classic dark cinematic look with elegant serif typography.',\n  colors: {\n    primary: '#3d5a80',\n    secondary: '#63b3ed',\n    background: '#1a202c',\n    backgroundLight: '#2d3748',\n    text: '#ffffff',\n    textMuted: '#a0aec0',\n    highlight: '#63b3ed',\n    warning: '#fc8181',\n  },\n  typography: {\n    bodyFontFamily: SOURCE_SERIF,\n    titleFontFamily: PLAYFAIR,\n    titleWeight: 'bold',\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.5,\n    animationSpeed: 1.0,\n  },\n  renderStyle: {\n    name: 'documentary',\n    defaultTextAnimation: 'fadeIn',\n    defaultImageAnimation: 'slowZoom',\n    ambientMotion: true,\n    defaultTransition: { type: 'fade', duration: 0.8 },\n  },\n  colorSchemes: CLASSIC_COLOR_SCHEMES,\n  persistentLayers: {\n    bottomLayers: [\n      {\n        template: 'gradientBackground',\n        config: { type: 'gradientBackground', preset: 'dark-vignette' },\n      },\n    ],\n  },\n};\n\n// ============================================\n// 2. Minimalist\n// ============================================\n\nconst minimalist: Theme = {\n  id: 'minimalist',\n  name: 'Minimalist',\n  description: 'Clean near-white background with sans-serif type and minimal animation.',\n  colors: {\n    primary: '#2d3748',\n    secondary: '#4a5568',\n    background: '#f7fafc',\n    backgroundLight: '#edf2f7',\n    text: '#1a202c',\n    textMuted: '#718096',\n    highlight: '#3182ce',\n    warning: '#e53e3e',\n  },\n  typography: {\n    bodyFontFamily: INTER,\n    titleFontFamily: INTER,\n    titleWeight: 'bold',\n    lineHeight: 1.6,\n  },\n  style: {\n    textShadow: false,\n    overlayOpacity: 0.3,\n    animationSpeed: 1.2,\n    borderRadius: 8,\n  },\n  renderStyle: {\n    name: 'minimalist',\n    defaultTextAnimation: 'fadeIn',\n    ambientMotion: false,\n    defaultTransition: { type: 'fade', duration: 0.6 },\n    templateHints: {\n      titleBlock: { showAccentLine: false },\n    },\n  },\n  colorSchemes: {\n    blue: { bg: '#ebf8ff', text: '#2b6cb0', accent: '#3182ce' },\n    green: { bg: '#f0fff4', text: '#276749', accent: '#38a169' },\n    purple: { bg: '#faf5ff', text: '#553c9a', accent: '#805ad5' },\n    red: { bg: '#fff5f5', text: '#c53030', accent: '#e53e3e' },\n    orange: { bg: '#fffaf0', text: '#c05621', accent: '#dd6b20' },\n    teal: { bg: '#e6fffa', text: '#285e61', accent: '#319795' },\n  },\n};\n\n// ============================================\n// 3. Bold\n// ============================================\n\nconst bold: Theme = {\n  id: 'bold',\n  name: 'Bold',\n  description: 'High-contrast black with vivid accents and dramatic animations.',\n  colors: {\n    primary: '#e53e3e',\n    secondary: '#ed8936',\n    background: '#000000',\n    backgroundLight: '#1a1a1a',\n    text: '#ffffff',\n    textMuted: '#cbd5e0',\n    highlight: '#f6e05e',\n    warning: '#fc8181',\n  },\n  typography: {\n    bodyFontFamily: ROBOTO,\n    titleFontFamily: OSWALD,\n    titleWeight: 'bold',\n    titleScale: 1.15,\n    bodyScale: 1.0,\n    titleLineHeight: 1.1,\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.6,\n    animationSpeed: 0.8,\n  },\n  renderStyle: {\n    name: 'bold',\n    defaultTextAnimation: 'zoomIn',\n    defaultImageAnimation: 'slowZoom',\n    ambientMotion: true,\n    defaultTransition: { type: 'dissolve', duration: 0.5 },\n    templateHints: {\n      statHighlight: { entrance: 'dramatic' },\n      fullBleedQuote: { entrance: 'dramatic' },\n    },\n  },\n  colorSchemes: {\n    blue: { bg: '#1a202c', text: '#63b3ed', accent: '#90cdf4' },\n    green: { bg: '#1a202c', text: '#48bb78', accent: '#68d391' },\n    purple: { bg: '#1a202c', text: '#b794f4', accent: '#d6bcfa' },\n    red: { bg: '#1a202c', text: '#fc8181', accent: '#feb2b2' },\n    orange: { bg: '#1a202c', text: '#f6ad55', accent: '#fbd38d' },\n    teal: { bg: '#1a202c', text: '#4fd1c5', accent: '#81e6d9' },\n  },\n};\n\n// ============================================\n// 4. Morning Light\n// ============================================\n\nconst morningLight: Theme = {\n  id: 'morning-light',\n  name: 'Morning Light',\n  description: 'Warm light background with dark text and gentle serif typography.',\n  colors: {\n    primary: '#744210',\n    secondary: '#975a16',\n    background: '#faf8f5',\n    backgroundLight: '#f5f0eb',\n    text: '#2d3748',\n    textMuted: '#718096',\n    highlight: '#dd6b20',\n    warning: '#c53030',\n  },\n  typography: {\n    bodyFontFamily: LORA,\n    titleFontFamily: MERRIWEATHER,\n    titleWeight: 'bold',\n    lineHeight: 1.7,\n  },\n  style: {\n    textShadow: false,\n    overlayOpacity: 0.35,\n    animationSpeed: 1.1,\n    borderRadius: 4,\n  },\n  renderStyle: {\n    name: 'morning-light',\n    defaultTextAnimation: 'fadeIn',\n    ambientMotion: false,\n    defaultTransition: { type: 'fade', duration: 1.0 },\n  },\n  colorSchemes: {\n    blue: { bg: '#ebf8ff', text: '#2c5282', accent: '#4299e1' },\n    green: { bg: '#f0fff4', text: '#22543d', accent: '#48bb78' },\n    purple: { bg: '#faf5ff', text: '#44337a', accent: '#9f7aea' },\n    red: { bg: '#fff5f5', text: '#9b2c2c', accent: '#fc8181' },\n    orange: { bg: '#fffaf0', text: '#744210', accent: '#ed8936' },\n    teal: { bg: '#e6fffa', text: '#234e52', accent: '#38b2ac' },\n  },\n};\n\n// ============================================\n// 5. Tech Dark\n// ============================================\n\nconst techDark: Theme = {\n  id: 'tech-dark',\n  name: 'Tech Dark',\n  description: 'True black with neon cyan/green accents and monospace titles.',\n  colors: {\n    primary: '#00e5ff',\n    secondary: '#00e676',\n    background: '#0a0a0a',\n    backgroundLight: '#1a1a2e',\n    text: '#e0e0e0',\n    textMuted: '#9e9e9e',\n    highlight: '#00e5ff',\n    warning: '#ff5252',\n  },\n  typography: {\n    bodyFontFamily: IBM_PLEX_SANS,\n    titleFontFamily: JETBRAINS_MONO,\n    monoFontFamily: JETBRAINS_MONO,\n    titleWeight: 'bold',\n    titleScale: 0.9,\n    lineHeight: 1.5,\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.55,\n    animationSpeed: 0.9,\n    borderRadius: 2,\n  },\n  renderStyle: {\n    name: 'tech-dark',\n    defaultTextAnimation: 'typewriter',\n    defaultImageAnimation: 'slowZoom',\n    ambientMotion: true,\n    defaultTransition: { type: 'dissolve', duration: 0.4 },\n    templateHints: {\n      statHighlight: { entrance: 'dramatic' },\n    },\n  },\n  colorSchemes: {\n    blue: { bg: '#0d1b2a', text: '#00b0ff', accent: '#40c4ff' },\n    green: { bg: '#0d1b0d', text: '#00e676', accent: '#69f0ae' },\n    purple: { bg: '#1a0d2e', text: '#d500f9', accent: '#ea80fc' },\n    red: { bg: '#2e0d0d', text: '#ff5252', accent: '#ff8a80' },\n    orange: { bg: '#2e1a0d', text: '#ff9100', accent: '#ffab40' },\n    teal: { bg: '#0d2e2e', text: '#1de9b6', accent: '#64ffda' },\n  },\n};\n\n// ============================================\n// 6. Magazine\n// ============================================\n\nconst magazine: Theme = {\n  id: 'magazine',\n  name: 'Magazine',\n  description: 'Rich editorial palette with mixed serif/sans typography and slide transitions.',\n  colors: {\n    primary: '#c53030',\n    secondary: '#2b6cb0',\n    background: '#1a202c',\n    backgroundLight: '#2d3748',\n    text: '#f7fafc',\n    textMuted: '#cbd5e0',\n    highlight: '#ed8936',\n    warning: '#fc8181',\n  },\n  typography: {\n    bodyFontFamily: DM_SANS,\n    titleFontFamily: DM_SERIF,\n    titleWeight: 'bold',\n    titleScale: 1.05,\n    lineHeight: 1.5,\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.45,\n    animationSpeed: 1.0,\n    borderRadius: 6,\n  },\n  renderStyle: {\n    name: 'magazine',\n    defaultTextAnimation: 'fadeIn',\n    defaultImageAnimation: 'slowZoom',\n    ambientMotion: true,\n    defaultTransition: { type: 'slideLeft', duration: 0.7 },\n  },\n  colorSchemes: {\n    blue: { bg: '#1a365d', text: '#90cdf4', accent: '#63b3ed' },\n    green: { bg: '#1c4532', text: '#9ae6b4', accent: '#68d391' },\n    purple: { bg: '#322659', text: '#d6bcfa', accent: '#b794f4' },\n    red: { bg: '#63171b', text: '#feb2b2', accent: '#fc8181' },\n    orange: { bg: '#652b19', text: '#fbd38d', accent: '#f6ad55' },\n    teal: { bg: '#1d4044', text: '#81e6d9', accent: '#4fd1c5' },\n  },\n};\n\n// ============================================\n// 7. Cinematic\n// ============================================\n\nconst cinematic: Theme = {\n  id: 'cinematic',\n  name: 'Cinematic',\n  description: 'Ultra-dark with moody gradients, gold accents, and slow dissolve transitions.',\n  colors: {\n    primary: '#d69e2e',\n    secondary: '#b7791f',\n    background: '#0a0f1a',\n    backgroundLight: '#1a202c',\n    text: '#f7fafc',\n    textMuted: '#a0aec0',\n    highlight: '#ecc94b',\n    warning: '#fc8181',\n  },\n  typography: {\n    bodyFontFamily: CRIMSON,\n    titleFontFamily: CORMORANT,\n    titleWeight: 'bold',\n    lineHeight: 1.5,\n    titleLineHeight: 1.2,\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.55,\n    animationSpeed: 1.2,\n  },\n  renderStyle: {\n    name: 'cinematic',\n    defaultTextAnimation: 'fadeIn',\n    defaultImageAnimation: 'slowZoom',\n    ambientMotion: true,\n    defaultTransition: { type: 'dissolve', duration: 1.2 },\n    templateHints: {\n      titleBlock: { showAccentLine: true },\n    },\n  },\n  colorSchemes: {\n    blue: { bg: '#0d1b2a', text: '#90cdf4', accent: '#63b3ed' },\n    green: { bg: '#0d1b14', text: '#9ae6b4', accent: '#68d391' },\n    purple: { bg: '#1a0d2e', text: '#d6bcfa', accent: '#b794f4' },\n    red: { bg: '#2a0d0d', text: '#fc8181', accent: '#feb2b2' },\n    orange: { bg: '#2a1a0d', text: '#fbd38d', accent: '#f6ad55' },\n    teal: { bg: '#0d2a2a', text: '#81e6d9', accent: '#4fd1c5' },\n  },\n  persistentLayers: {\n    bottomLayers: [\n      {\n        template: 'gradientBackground',\n        config: { type: 'gradientBackground', preset: 'radial-dark' },\n      },\n    ],\n  },\n};\n\n// ============================================\n// 8. Warm Earth\n// ============================================\n\nconst warmEarth: Theme = {\n  id: 'warm-earth',\n  name: 'Warm Earth',\n  description: 'Natural warm tones with earthy browns and terracotta accents.',\n  colors: {\n    primary: '#9c4221',\n    secondary: '#c05621',\n    background: '#1c1410',\n    backgroundLight: '#2d241e',\n    text: '#faf5f0',\n    textMuted: '#c4a882',\n    highlight: '#dd6b20',\n    warning: '#e53e3e',\n  },\n  typography: {\n    bodyFontFamily: PT_SERIF,\n    titleFontFamily: PT_SERIF,\n    titleWeight: 'bold',\n    lineHeight: 1.6,\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.5,\n    animationSpeed: 1.1,\n  },\n  renderStyle: {\n    name: 'warm-earth',\n    defaultTextAnimation: 'fadeIn',\n    defaultImageAnimation: 'panLeft',\n    ambientMotion: true,\n    defaultTransition: { type: 'fade', duration: 0.9 },\n  },\n  colorSchemes: {\n    blue: { bg: '#2a1f14', text: '#90cdf4', accent: '#63b3ed' },\n    green: { bg: '#1e2a14', text: '#9ae6b4', accent: '#68d391' },\n    purple: { bg: '#2a142a', text: '#d6bcfa', accent: '#b794f4' },\n    red: { bg: '#2a1414', text: '#fc8181', accent: '#feb2b2' },\n    orange: { bg: '#2a1e0a', text: '#fbd38d', accent: '#f6ad55' },\n    teal: { bg: '#142a28', text: '#81e6d9', accent: '#4fd1c5' },\n  },\n  persistentLayers: {\n    bottomLayers: [\n      {\n        template: 'gradientBackground',\n        config: { type: 'gradientBackground', preset: 'earth-tones' },\n      },\n    ],\n  },\n};\n\n// ============================================\n// Theme Library\n// ============================================\n\n/**\n * All built-in themes, keyed by id.\n */\nexport const THEMES: Record<string, Theme> = {\n  standard,\n  documentary,\n  minimalist,\n  bold,\n  'morning-light': morningLight,\n  'tech-dark': techDark,\n  magazine,\n  cinematic,\n  'warm-earth': warmEarth,\n};\n\n/** The default theme id. */\nexport const DEFAULT_THEME_ID = 'standard';\n\n/** The default theme (standard — safe system fonts, no external dependencies). */\nexport const DEFAULT_THEME: Theme = standard;\n\n/**\n * Resolve a theme by id. Returns the default theme when `id` is\n * undefined or not found in the library.\n */\nexport function resolveTheme(id: string | undefined): Theme {\n  if (id && id in THEMES) return THEMES[id];\n  return DEFAULT_THEME;\n}\n\n/**\n * Get all available theme ids.\n */\nexport function getAvailableThemes(): string[] {\n  return Object.keys(THEMES);\n}\n\n/**\n * Get a summary of all themes (id + name + description) for theme pickers.\n */\nexport function getThemeSummaries(): Array<{ id: string; name: string; description?: string }> {\n  return Object.values(THEMES).map((t) => ({\n    id: t.id,\n    name: t.name,\n    description: t.description,\n  }));\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-QWVRN6I4.js → chunk-7GF6RDED.js}

@@ -27,7 +27,8 @@ function extractPlainText(node) {
     return node.value;
   }
   const children = getChildren(node);
-  return children.map(extractPlainText).join("");
+  const separator = node.type === "list" || node.type === "listItem" ? "\n" : "";
+  return children.map(extractPlainText).join(separator);
 }
 function countNodes(node) {
   let count = 1;
@@ -78,4 +79,4 @@ export {
   parseFrontmatter,
   createDocument
 };
-//# sourceMappingURL=chunk-QWVRN6I4.js.map
+//# sourceMappingURL=chunk-7GF6RDED.js.map

package/dist/chunk-7GF6RDED.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/markdown/utils.ts"],"sourcesContent":["/**\n * Markdown Tree Utilities\n *\n * Helper functions for traversing and querying the MarkdownDocument tree.\n * All functions are pure and operate on the JSON node interfaces.\n */\n\nimport type { MarkdownNode, MarkdownDocument } from './types.js';\n\n/**\n * Get the children of any markdown node, if it has children.\n * Returns an empty array for leaf nodes (text, code, break, etc.).\n *\n * This is useful for generic tree walking where you don't want to\n * check the specific node type.\n */\nexport function getChildren(node: MarkdownNode): MarkdownNode[] {\n  if ('children' in node && Array.isArray(node.children)) {\n    return node.children as MarkdownNode[];\n  }\n  return [];\n}\n\n/**\n * Walk the markdown tree depth-first, calling the visitor for each node.\n *\n * The visitor receives the current node and its parent. Return `true`\n * from the visitor to skip the node's children (prune).\n *\n * @param node - The root node to start walking from\n * @param visitor - Called for each node; return true to skip children\n * @param parent - (internal) Parent node\n */\nexport function walkMarkdownTree(\n  node: MarkdownNode,\n  visitor: (node: MarkdownNode, parent?: MarkdownNode) => void | boolean,\n  parent?: MarkdownNode,\n): void {\n  const skip = visitor(node, parent);\n  if (skip === true) return;\n\n  const children = getChildren(node);\n  for (const child of children) {\n    walkMarkdownTree(child, visitor, node);\n  }\n}\n\n/**\n * Find all nodes of a specific type in the tree.\n *\n * @param root - The document or node to search within\n * @param type - The node type to find (e.g., 'heading', 'link', 'text')\n * @returns Array of matching nodes\n *\n * @example\n * ```ts\n * const headings = findNodesByType(doc, 'heading');\n * const links = findNodesByType(doc, 'link');\n * ```\n */\nexport function findNodesByType<T extends MarkdownNode>(root: MarkdownNode, type: T['type']): T[] {\n  const results: T[] = [];\n  walkMarkdownTree(root, (node) => {\n    if (node.type === type) {\n      results.push(node as T);\n    }\n  });\n  return results;\n}\n\n/**\n * Extract all plain text content from a node and its descendants.\n * Concatenates text values, ignoring formatting, links, etc.\n *\n * @param node - The node to extract text from\n * @returns Plain text content\n *\n * @example\n * ```ts\n * const heading = doc.children[0]; // { type: 'heading', children: [{ type: 'text', value: 'Hello' }] }\n * extractPlainText(heading); // 'Hello'\n * ```\n */\nexport function extractPlainText(node: MarkdownNode): string {\n  if ('value' in node && typeof node.value === 'string') {\n    return node.value;\n  }\n\n  const children = getChildren(node);\n  // Preserve boundaries between block-level elements (list items, paragraphs\n  // inside list items, blockquotes) so downstream consumers like caption\n  // splitting can treat each item as a separate phrase.\n  const separator = node.type === 'list' || node.type === 'listItem' ? '\\n' : '';\n  return children.map(extractPlainText).join(separator);\n}\n\n/**\n * Count the total number of nodes in the tree.\n *\n * @param node - The root node\n * @returns Total node count (including the root)\n */\nexport function countNodes(node: MarkdownNode): number {\n  let count = 1;\n  const children = getChildren(node);\n  for (const child of children) {\n    count += countNodes(child);\n  }\n  return count;\n}\n\n/**\n * Parse a YAML frontmatter string into a key-value record.\n *\n * Handles simple `key: value` pairs common in markdown frontmatter.\n * Values are trimmed; quoted strings have their quotes removed.\n * Returns `null` if parsing fails or the input is empty.\n *\n * @param yaml - The raw YAML string (without the `---` delimiters)\n * @returns A record of string keys to parsed values, or null\n */\nexport function parseFrontmatter(yaml: string): Record<string, unknown> | null {\n  if (!yaml || !yaml.trim()) return null;\n\n  const result: Record<string, unknown> = {};\n\n  for (const line of yaml.split('\\n')) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n\n    const colonIdx = trimmed.indexOf(':');\n    if (colonIdx < 1) continue;\n\n    const key = trimmed.slice(0, colonIdx).trim();\n    let value: string | boolean | number = trimmed.slice(colonIdx + 1).trim();\n\n    // Remove surrounding quotes\n    if (\n      (value.startsWith('\"') && value.endsWith('\"')) ||\n      (value.startsWith(\"'\") && value.endsWith(\"'\"))\n    ) {\n      value = value.slice(1, -1);\n    }\n\n    // Parse booleans and numbers\n    if (value === 'true') {\n      result[key] = true;\n    } else if (value === 'false') {\n      result[key] = false;\n    } else if (value !== '' && !isNaN(Number(value))) {\n      result[key] = Number(value);\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return Object.keys(result).length > 0 ? result : null;\n}\n\n/**\n * Create a minimal MarkdownDocument from a list of block nodes.\n * Convenience function for programmatic document construction.\n */\nexport function createDocument(...children: MarkdownDocument['children']): MarkdownDocument {\n  return {\n    type: 'document',\n    children,\n  };\n}\n"],"mappings":";AAgBO,SAAS,YAAY,MAAoC;AAC9D,MAAI,cAAc,QAAQ,MAAM,QAAQ,KAAK,QAAQ,GAAG;AACtD,WAAO,KAAK;AAAA,EACd;AACA,SAAO,CAAC;AACV;AAYO,SAAS,iBACd,MACA,SACA,QACM;AACN,QAAM,OAAO,QAAQ,MAAM,MAAM;AACjC,MAAI,SAAS,KAAM;AAEnB,QAAM,WAAW,YAAY,IAAI;AACjC,aAAW,SAAS,UAAU;AAC5B,qBAAiB,OAAO,SAAS,IAAI;AAAA,EACvC;AACF;AAeO,SAAS,gBAAwC,MAAoB,MAAsB;AAChG,QAAM,UAAe,CAAC;AACtB,mBAAiB,MAAM,CAAC,SAAS;AAC/B,QAAI,KAAK,SAAS,MAAM;AACtB,cAAQ,KAAK,IAAS;AAAA,IACxB;AAAA,EACF,CAAC;AACD,SAAO;AACT;AAeO,SAAS,iBAAiB,MAA4B;AAC3D,MAAI,WAAW,QAAQ,OAAO,KAAK,UAAU,UAAU;AACrD,WAAO,KAAK;AAAA,EACd;AAEA,QAAM,WAAW,YAAY,IAAI;AAIjC,QAAM,YAAY,KAAK,SAAS,UAAU,KAAK,SAAS,aAAa,OAAO;AAC5E,SAAO,SAAS,IAAI,gBAAgB,EAAE,KAAK,SAAS;AACtD;AAQO,SAAS,WAAW,MAA4B;AACrD,MAAI,QAAQ;AACZ,QAAM,WAAW,YAAY,IAAI;AACjC,aAAW,SAAS,UAAU;AAC5B,aAAS,WAAW,KAAK;AAAA,EAC3B;AACA,SAAO;AACT;AAYO,SAAS,iBAAiB,MAA8C;AAC7E,MAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAG,QAAO;AAElC,QAAM,SAAkC,CAAC;AAEzC,aAAW,QAAQ,KAAK,MAAM,IAAI,GAAG;AACnC,UAAM,UAAU,KAAK,KAAK;AAC1B,QAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,EAAG;AAEzC,UAAM,WAAW,QAAQ,QAAQ,GAAG;AACpC,QAAI,WAAW,EAAG;AAElB,UAAM,MAAM,QAAQ,MAAM,GAAG,QAAQ,EAAE,KAAK;AAC5C,QAAI,QAAmC,QAAQ,MAAM,WAAW,CAAC,EAAE,KAAK;AAGxE,QACG,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,KAC3C,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,GAC5C;AACA,cAAQ,MAAM,MAAM,GAAG,EAAE;AAAA,IAC3B;AAGA,QAAI,UAAU,QAAQ;AACpB,aAAO,GAAG,IAAI;AAAA,IAChB,WAAW,UAAU,SAAS;AAC5B,aAAO,GAAG,IAAI;AAAA,IAChB,WAAW,UAAU,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,GAAG;AAChD,aAAO,GAAG,IAAI,OAAO,KAAK;AAAA,IAC5B,OAAO;AACL,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AAEA,SAAO,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AACnD;AAMO,SAAS,kBAAkB,UAA0D;AAC1F,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,EACF;AACF;","names":[]}

package/dist/{chunk-4CRBS35L.js → chunk-CYQHG27J.js}

@@ -157,7 +157,12 @@ var MemoryContentContainer = class {
     return this.files.get(path)?.data ?? null;
   }
   async writeFile(path, data, mimeType) {
-    const buffer = data instanceof ArrayBuffer ? data : data.slice().buffer;
+    let buffer;
+    if (data instanceof ArrayBuffer) {
+      buffer = data;
+    } else {
+      buffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+    }
     this.files.set(path, {
       data: buffer,
       mimeType: mimeType ?? guessMimeType(path)
@@ -289,4 +294,4 @@ export {
   MemoryContentContainer,
   createMediaProviderFromContainer
 };
-//# sourceMappingURL=chunk-4CRBS35L.js.map
+//# sourceMappingURL=chunk-CYQHG27J.js.map

package/dist/chunk-CYQHG27J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/MemoryStorageAdapter.ts","../src/storage/LocalStorageAdapter.ts","../src/storage/LocalForageAdapter.ts","../src/storage/ContentContainer.ts","../src/storage/MediaProviderFromContainer.ts"],"sourcesContent":["/**\n * In-memory storage adapter for testing and SSR environments.\n * Data does not persist across page reloads.\n */\n\nimport type { StorageAdapter } from './Storage.js';\n\nexport class MemoryStorageAdapter implements StorageAdapter {\n  readonly supportsEnumeration = true;\n  private store = new Map<string, string>();\n\n  async get<T>(key: string): Promise<T | null> {\n    const val = this.store.get(key);\n    if (val === undefined) return null;\n    try {\n      return JSON.parse(val) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    this.store.set(key, JSON.stringify(value));\n  }\n\n  async remove(key: string): Promise<void> {\n    this.store.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.store.clear();\n  }\n\n  async keys(): Promise<string[]> {\n    return Array.from(this.store.keys());\n  }\n}\n","/**\n * localStorage adapter for web browsers.\n * Supports a configurable key prefix to namespace stored data.\n */\n\nimport type { StorageAdapter } from './Storage.js';\n\nexport class LocalStorageAdapter implements StorageAdapter {\n  readonly supportsEnumeration = true;\n  private prefix: string;\n\n  constructor(prefix = '') {\n    this.prefix = prefix;\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    try {\n      const raw = localStorage.getItem(this.prefix + key);\n      if (raw === null) return null;\n      return JSON.parse(raw) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    localStorage.setItem(this.prefix + key, JSON.stringify(value));\n  }\n\n  async remove(key: string): Promise<void> {\n    localStorage.removeItem(this.prefix + key);\n  }\n\n  async clear(): Promise<void> {\n    const keysToRemove: string[] = [];\n    for (let i = 0; i < localStorage.length; i++) {\n      const k = localStorage.key(i);\n      if (k && k.startsWith(this.prefix)) {\n        keysToRemove.push(k);\n      }\n    }\n    for (const k of keysToRemove) {\n      localStorage.removeItem(k);\n    }\n  }\n\n  async keys(): Promise<string[]> {\n    const result: string[] = [];\n    for (let i = 0; i < localStorage.length; i++) {\n      const k = localStorage.key(i);\n      if (k && k.startsWith(this.prefix)) {\n        result.push(k.slice(this.prefix.length));\n      }\n    }\n    return result;\n  }\n}\n","/**\n * LocalForage adapter - IndexedDB storage with automatic fallbacks.\n *\n * Uses localforage which provides IndexedDB storage with automatic\n * fallbacks to WebSQL and localStorage. This allows storing much more\n * data than raw localStorage (which is limited to ~5MB).\n *\n * Unlike LocalStorageAdapter, this adapter can store binary data\n * (ArrayBuffer, Blob, Uint8Array) natively without JSON serialization.\n *\n * Ported from qualla-internal/shared/services/StorageAdapters.ts with\n * configurable store name and key prefix.\n */\n\nimport localforage from 'localforage';\nimport type { StorageAdapter } from './Storage.js';\n\nexport interface LocalForageAdapterOptions {\n  /** IndexedDB database name (default: 'squisq') */\n  name?: string;\n  /** IndexedDB object store name (default: 'data') */\n  storeName?: string;\n  /** Key prefix for namespacing (default: '') */\n  prefix?: string;\n  /** Human-readable description (default: 'Squisq storage') */\n  description?: string;\n}\n\nexport class LocalForageAdapter implements StorageAdapter {\n  readonly supportsEnumeration = true;\n  private store: LocalForage;\n  private prefix: string;\n\n  constructor(options: LocalForageAdapterOptions = {}) {\n    const {\n      name = 'squisq',\n      storeName = 'data',\n      prefix = '',\n      description = 'Squisq storage',\n    } = options;\n\n    this.prefix = prefix;\n    this.store = localforage.createInstance({ name, storeName, description });\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    try {\n      const value = await this.store.getItem<T>(this.prefix + key);\n      return value;\n    } catch (e: unknown) {\n      console.warn('[Storage] get (IndexedDB) failed:', key, e);\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    try {\n      await this.store.setItem(this.prefix + key, value);\n    } catch (e: unknown) {\n      console.error('[Storage] set (IndexedDB) failed:', key, e);\n      throw e;\n    }\n  }\n\n  async remove(key: string): Promise<void> {\n    try {\n      await this.store.removeItem(this.prefix + key);\n    } catch (e: unknown) {\n      console.warn('[Storage] remove (IndexedDB) failed:', key, e);\n    }\n  }\n\n  async clear(): Promise<void> {\n    try {\n      if (this.prefix) {\n        // Only remove keys with our prefix\n        const keys = await this.store.keys();\n        const keysToRemove = keys.filter((k) => k.startsWith(this.prefix));\n        await Promise.all(keysToRemove.map((k) => this.store.removeItem(k)));\n      } else {\n        // No prefix — clear the entire store\n        await this.store.clear();\n      }\n    } catch (e: unknown) {\n      console.error('[Storage] clear (IndexedDB) failed:', e);\n    }\n  }\n\n  async keys(): Promise<string[]> {\n    try {\n      const allKeys = await this.store.keys();\n      if (this.prefix) {\n        return allKeys\n          .filter((k) => k.startsWith(this.prefix))\n          .map((k) => k.slice(this.prefix.length));\n      }\n      return allKeys;\n    } catch (e: unknown) {\n      console.warn('[Storage] keys (IndexedDB) failed:', e);\n      return [];\n    }\n  }\n}\n","/**\n * ContentContainer — virtual file system for document containers.\n *\n * A Squisq document is more than just markdown: it's a container of files\n * including the primary markdown document, images, audio, timing data, and\n * other media. ContentContainer provides an abstract async file system\n * interface for reading, writing, and listing these files.\n *\n * Paths are forward-slash separated strings relative to the container root\n * (e.g., 'images/hero.jpg', 'index.md'). No leading slash.\n *\n * Implementations:\n * - MemoryContentContainer — in-memory Map (for zip import, tests, transient use)\n * - SlotContentContainer — backed by IndexedDB slot storage (in the site package)\n */\n\n/**\n * Metadata about a file in a ContentContainer.\n */\nexport interface ContentEntry {\n  /** Relative path within the container (e.g., 'images/hero.jpg') */\n  path: string;\n  /** MIME type (e.g., 'image/jpeg') */\n  mimeType: string;\n  /** File size in bytes */\n  size: number;\n}\n\n/**\n * Abstract async file system for document containers.\n *\n * All paths are forward-slash separated, relative to the container root,\n * with no leading slash. Example: 'images/hero.jpg', 'index.md'.\n */\nexport interface ContentContainer {\n  /** Read a file's binary content. Returns null if the file does not exist. */\n  readFile(path: string): Promise<ArrayBuffer | null>;\n\n  /** Write a file. Creates or overwrites. */\n  writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void>;\n\n  /** Remove a file. No-op if the file does not exist. */\n  removeFile(path: string): Promise<void>;\n\n  /**\n   * List files in the container.\n   * @param prefix — Optional path prefix to filter by (e.g., 'images/')\n   */\n  listFiles(prefix?: string): Promise<ContentEntry[]>;\n\n  /** Check whether a file exists. */\n  exists(path: string): Promise<boolean>;\n\n  /**\n   * Find the primary markdown document path.\n   *\n   * Discovery order: index.md → doc.md → document.md → first *.md at root.\n   * Returns null if no markdown file is found at the root level.\n   */\n  getDocumentPath(): Promise<string | null>;\n\n  /**\n   * Convenience: read the primary markdown document as a UTF-8 string.\n   * Returns null if no markdown file is found.\n   */\n  readDocument(): Promise<string | null>;\n\n  /**\n   * Convenience: write a markdown document.\n   * @param markdown — The markdown content\n   * @param filename — Filename to use (defaults to 'index.md')\n   */\n  writeDocument(markdown: string, filename?: string): Promise<void>;\n}\n\n// ============================================\n// Well-known markdown filenames in priority order\n// ============================================\n\nconst MARKDOWN_PRIORITY = ['index.md', 'doc.md', 'document.md'];\n\n/**\n * Find the primary markdown path from a list of file entries.\n * Exported for reuse by other ContentContainer implementations.\n */\nexport function findDocumentPath(entries: ContentEntry[]): string | null {\n  // Only consider root-level files (no '/' in path)\n  const rootFiles = entries.filter((e) => !e.path.includes('/'));\n\n  for (const name of MARKDOWN_PRIORITY) {\n    if (rootFiles.some((e) => e.path.toLowerCase() === name)) {\n      return name;\n    }\n  }\n\n  // Fallback: first .md file at root\n  const firstMd = rootFiles.find((e) => e.path.toLowerCase().endsWith('.md'));\n  return firstMd?.path ?? null;\n}\n\n// ============================================\n// MemoryContentContainer\n// ============================================\n\ninterface MemoryFile {\n  data: ArrayBuffer;\n  mimeType: string;\n}\n\n/**\n * In-memory ContentContainer backed by a Map.\n *\n * Used for zip import (deserialize into memory), tests, and transient operations.\n */\nexport class MemoryContentContainer implements ContentContainer {\n  private files = new Map<string, MemoryFile>();\n\n  async readFile(path: string): Promise<ArrayBuffer | null> {\n    return this.files.get(path)?.data ?? null;\n  }\n\n  async writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void> {\n    // Copy to a standalone ArrayBuffer. Uint8Array/Buffer may share a larger\n    // backing buffer (e.g., Node's buffer pool), so we must slice to the\n    // exact byte range to avoid storing stale pool data.\n    let buffer: ArrayBuffer;\n    if (data instanceof ArrayBuffer) {\n      buffer = data;\n    } else {\n      buffer = data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength) as ArrayBuffer;\n    }\n    this.files.set(path, {\n      data: buffer,\n      mimeType: mimeType ?? guessMimeType(path),\n    });\n  }\n\n  async removeFile(path: string): Promise<void> {\n    this.files.delete(path);\n  }\n\n  async listFiles(prefix?: string): Promise<ContentEntry[]> {\n    const entries: ContentEntry[] = [];\n    for (const [path, file] of this.files) {\n      if (prefix && !path.startsWith(prefix)) continue;\n      entries.push({\n        path,\n        mimeType: file.mimeType,\n        size: file.data.byteLength,\n      });\n    }\n    return entries;\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.files.has(path);\n  }\n\n  async getDocumentPath(): Promise<string | null> {\n    return findDocumentPath(await this.listFiles());\n  }\n\n  async readDocument(): Promise<string | null> {\n    const docPath = await this.getDocumentPath();\n    if (!docPath) return null;\n    const data = await this.readFile(docPath);\n    if (!data) return null;\n    return new TextDecoder().decode(data);\n  }\n\n  async writeDocument(markdown: string, filename?: string): Promise<void> {\n    const name = filename ?? 'index.md';\n    const data = new TextEncoder().encode(markdown);\n    await this.writeFile(name, data, 'text/markdown');\n  }\n}\n\n// ============================================\n// MIME type guessing\n// ============================================\n\nconst EXTENSION_MIME_MAP: Record<string, string> = {\n  '.md': 'text/markdown',\n  '.txt': 'text/plain',\n  '.json': 'application/json',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.png': 'image/png',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.webp': 'image/webp',\n  '.avif': 'image/avif',\n  '.mp4': 'video/mp4',\n  '.webm': 'video/webm',\n  '.mp3': 'audio/mpeg',\n  '.wav': 'audio/wav',\n  '.ogg': 'audio/ogg',\n  '.css': 'text/css',\n  '.html': 'text/html',\n  '.js': 'application/javascript',\n};\n\nfunction guessMimeType(path: string): string {\n  const dot = path.lastIndexOf('.');\n  if (dot === -1) return 'application/octet-stream';\n  const ext = path.slice(dot).toLowerCase();\n  return EXTENSION_MIME_MAP[ext] ?? 'application/octet-stream';\n}\n","/**\n * MediaProviderFromContainer — bridges ContentContainer to MediaProvider.\n *\n * Creates a MediaProvider that resolves relative paths by reading binary data\n * from a ContentContainer and generating blob URLs. Blob URLs are cached and\n * revoked on dispose().\n *\n * This allows any ContentContainer (memory, slot-backed, zip-loaded) to be\n * used with existing rendering components (DocPlayer, ImageLayer, VideoLayer)\n * that consume MediaProvider.\n */\n\nimport type { MediaProvider, MediaEntry } from '../schemas/MediaProvider.js';\nimport type { ContentContainer } from './ContentContainer.js';\n\n/**\n * Create a MediaProvider backed by a ContentContainer.\n *\n * @param container — The ContentContainer to read/write media from\n * @returns A MediaProvider that resolves paths to blob URLs\n */\nexport function createMediaProviderFromContainer(container: ContentContainer): MediaProvider {\n  const blobUrlCache = new Map<string, string>();\n\n  return {\n    async resolveUrl(relativePath: string): Promise<string> {\n      const cached = blobUrlCache.get(relativePath);\n      if (cached) return cached;\n\n      const data = await container.readFile(relativePath);\n      if (!data) return relativePath;\n\n      const entries = await container.listFiles();\n      const entry = entries.find((e) => e.path === relativePath);\n      const mimeType = entry?.mimeType ?? 'application/octet-stream';\n\n      const blob = new Blob([data], { type: mimeType });\n      const url = URL.createObjectURL(blob);\n      blobUrlCache.set(relativePath, url);\n      return url;\n    },\n\n    async listMedia(): Promise<MediaEntry[]> {\n      const entries = await container.listFiles();\n      return entries\n        .filter((e) => !e.path.toLowerCase().endsWith('.md'))\n        .map((e) => ({\n          name: e.path,\n          mimeType: e.mimeType,\n          size: e.size,\n        }));\n    },\n\n    async addMedia(\n      name: string,\n      data: ArrayBuffer | Blob | Uint8Array,\n      mimeType: string,\n    ): Promise<string> {\n      // Invalidate any cached blob URL for this path before overwriting\n      const cached = blobUrlCache.get(name);\n      if (cached) {\n        URL.revokeObjectURL(cached);\n        blobUrlCache.delete(name);\n      }\n\n      let buffer: ArrayBuffer | Uint8Array;\n      if (data instanceof Blob) {\n        buffer = await data.arrayBuffer();\n      } else {\n        buffer = data;\n      }\n      await container.writeFile(name, buffer, mimeType);\n      return name;\n    },\n\n    async removeMedia(relativePath: string): Promise<void> {\n      const cached = blobUrlCache.get(relativePath);\n      if (cached) {\n        URL.revokeObjectURL(cached);\n        blobUrlCache.delete(relativePath);\n      }\n      await container.removeFile(relativePath);\n    },\n\n    dispose(): void {\n      for (const url of blobUrlCache.values()) {\n        URL.revokeObjectURL(url);\n      }\n      blobUrlCache.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-T6WBC3ND.js → chunk-GAQLMORN.js}

@@ -1,6 +1,6 @@
 import {
   DEFAULT_THEME
-} from "./chunk-TVPKD76V.js";
+} from "./chunk-53TZ2UTL.js";
 import {
   VIEWPORT_PRESETS,
   createTemplateContext,
@@ -11,7 +11,7 @@ import {
 } from "./chunk-QM5PKNPW.js";
 import {
   extractPlainText
-} from "./chunk-QWVRN6I4.js";
+} from "./chunk-7GF6RDED.js";
 import {
   estimateReadingTime
 } from "./chunk-4X3JQXNM.js";
@@ -2459,59 +2459,83 @@ function dataTable(input, context) {
 function coverBlock(input, context) {
   const { heroSrc, heroAlt, title, subtitle, ambientMotion, heroCredit, heroLicense } = input;
   const { theme, layout } = context;
-  const titleFontSize = scaledFontSize(96, context, true);
-  const subtitleFontSize = scaledFontSize(36, context, false);
-  const imageAnimation = mapAmbientMotion(ambientMotion);
-  const layers = [
-    // Full-screen hero image
-    {
-      type: "image",
-      id: "cover-hero",
-      content: {
-        src: heroSrc,
-        alt: heroAlt || title,
-        fit: "cover",
-        credit: heroCredit,
-        license: heroLicense
+  const titleFontSize = scaledFontSize(120, context, true);
+  const subtitleFontSize = scaledFontSize(40, context, false);
+  const layers = [];
+  if (heroSrc) {
+    const imageAnimation = mapAmbientMotion(ambientMotion);
+    layers.push(
+      {
+        type: "image",
+        id: "cover-hero",
+        content: {
+          src: heroSrc,
+          alt: heroAlt || title,
+          fit: "cover",
+          credit: heroCredit,
+          license: heroLicense
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" },
+        animation: imageAnimation
       },
-      position: { x: 0, y: 0, width: "100%", height: "100%" },
-      animation: imageAnimation
-    },
-    // Gradient overlay for text readability - from bottom
-    {
+      {
+        type: "shape",
+        id: "cover-gradient",
+        content: {
+          shape: "rect",
+          fill: "linear-gradient(0deg, rgba(0,0,0,0.8) 0%, rgba(0,0,0,0.4) 40%, rgba(0,0,0,0.1) 70%, transparent 100%)"
+        },
+        position: { x: 0, y: 0, width: "100%", height: "100%" }
+      }
+    );
+  } else {
+    layers.push({
       type: "shape",
-      id: "cover-gradient",
+      id: "cover-bg",
       content: {
         shape: "rect",
-        fill: "linear-gradient(0deg, rgba(0,0,0,0.8) 0%, rgba(0,0,0,0.4) 40%, rgba(0,0,0,0.1) 70%, transparent 100%)"
+        fill: `radial-gradient(ellipse at 50% 40%, ${theme.colors.primary} 0%, ${theme.colors.background} 100%)`
       },
       position: { x: 0, y: 0, width: "100%", height: "100%" }
-    },
-    // Title - positioned lower in the frame to work with hero composition
-    {
-      type: "text",
-      id: "cover-title",
+    });
+    layers.push({
+      type: "shape",
+      id: "cover-accent",
       content: {
-        text: title,
-        style: {
-          fontSize: titleFontSize,
-          fontFamily: getThemeFont(context, "title"),
-          fontWeight: "bold",
-          color: theme.colors.text,
-          textAlign: "center",
-          shadow: true
-        }
+        shape: "rect",
+        fill: "rgba(255, 255, 255, 0.2)"
       },
       position: {
-        x: "50%",
-        y: subtitle ? "70%" : "75%",
-        anchor: "center",
-        width: layout.maxTextWidth
-      },
-      // No animation delay - shown immediately at rest
-      animation: { type: "fadeIn", duration: 0.8 }
-    }
-  ];
+        x: "35%",
+        y: subtitle ? "42%" : "58%",
+        width: "30%",
+        height: "2px"
+      }
+    });
+  }
+  layers.push({
+    type: "text",
+    id: "cover-title",
+    content: {
+      text: title,
+      style: {
+        fontSize: titleFontSize,
+        fontFamily: getThemeFont(context, "title"),
+        fontWeight: "bold",
+        color: theme.colors.text,
+        textAlign: "center",
+        shadow: true
+      }
+    },
+    position: {
+      x: "50%",
+      y: heroSrc ? subtitle ? "70%" : "75%" : subtitle ? layout.primaryY : "50%",
+      anchor: "center",
+      width: layout.maxTextWidth
+    },
+    // No animation delay - shown immediately at rest
+    animation: { type: "fadeIn", duration: 0.8 }
+  });
   if (subtitle) {
     layers.push({
       type: "text",
@@ -2528,7 +2552,7 @@ function coverBlock(input, context) {
       },
       position: {
         x: "50%",
-        y: "82%",
+        y: heroSrc ? "82%" : layout.secondaryY,
         anchor: "center",
         width: layout.maxTextWidth
       },
@@ -3046,7 +3070,7 @@ function markdownToDoc(markdownDoc, options) {
     currentTime += block.duration;
   }
   const captions = phrases.length > 0 ? { phrases, generatedAt: (/* @__PURE__ */ new Date()).toISOString(), version: 1 } : void 0;
-  return {
+  const doc = {
     articleId,
     duration: currentTime,
     blocks: rootBlocks,
@@ -3056,6 +3080,13 @@ function markdownToDoc(markdownDoc, options) {
     ...captions ? { captions } : {},
     ...markdownDoc.frontmatter ? { frontmatter: markdownDoc.frontmatter } : {}
   };
+  if (options?.generateCoverBlock ?? true) {
+    const coverConfig = buildStartBlock(markdownDoc, rootBlocks);
+    if (coverConfig) {
+      doc.startBlock = coverConfig;
+    }
+  }
+  return doc;
 }
 function flattenBlocks(blocks) {
   const result = [];
@@ -3130,6 +3161,31 @@ function splitIntoSentences(text) {
   }
   return merged;
 }
+function findFirstImage(node) {
+  if (node.type === "image") return node;
+  if ("children" in node && Array.isArray(node.children)) {
+    for (const child of node.children) {
+      const found = findFirstImage(child);
+      if (found) return found;
+    }
+  }
+  return void 0;
+}
+function buildStartBlock(markdownDoc, rootBlocks) {
+  const firstH1 = rootBlocks.find((b) => b.sourceHeading?.depth === 1);
+  if (!firstH1) return void 0;
+  const title = firstH1.title ?? extractPlainText(firstH1.sourceHeading);
+  if (!title) return void 0;
+  const subtitle = firstH1.contents?.[0]?.type === "paragraph" ? extractPlainText(firstH1.contents[0]) : void 0;
+  const firstImage = findFirstImage(markdownDoc);
+  const config = {
+    title,
+    ...subtitle ? { subtitle } : {},
+    ...firstImage ? { heroSrc: firstImage.url, heroAlt: firstImage.alt ?? title } : {},
+    ambientMotion: "zoomIn"
+  };
+  return config;
+}
 
 // src/doc/docToMarkdown.ts
 function docToMarkdown(doc) {
@@ -3443,4 +3499,4 @@ export {
   scoreTextSimilarity,
   resolveAudioMapping
 };
-//# sourceMappingURL=chunk-T6WBC3ND.js.map
+//# sourceMappingURL=chunk-GAQLMORN.js.map