@bendyline/squisq 1.4.1 → 1.5.1

package/dist/chunk-A4O7GIWE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/Doc.ts","../src/schemas/Media.ts","../src/schemas/themeCompile.ts"],"sourcesContent":["/**\n * Doc Schema\n *\n * Defines the JSON format for AI-scriptable visual docs that accompany\n * audio narration. A Doc describes a sequence of animated blocks\n * with text overlays, images, and transitions synchronized to audio.\n *\n * The format is designed to be:\n * 1. AI-generatable - Claude can create scripts from article content\n * 2. Browser-renderable - SVG + CSS animations (ES2015 compatible)\n * 3. Video-exportable - Frame-by-frame capture via Playwright\n *\n * Timing: Blocks are timed to match narration audio segments. Each article\n * has 3-6 MP3 files (intro + sections), and blocks are grouped by segment.\n */\n\nimport type { Transition } from './Transitions.js';\nexport type { Transition, TransitionType, TransitionDirection } from './Transitions.js';\n\n// ============================================\n// Core Types\n// ============================================\n\n/**\n * A directed connection from one block to another.\n *\n * Populated from a heading's Pandoc-style `{connectsTo=…}` attribute\n * (e.g. `## Step 1 {#step1 connectsTo=foo:flow,bar}`). Each item is\n * `target` or `target:type`. Used by diagram-style layouts that draw\n * edges between blocks.\n */\nexport interface BlockConnection {\n  /** Target block id (matches another block's `id`). */\n  target: string;\n  /** Optional connection type/label (e.g., \"flow\", \"requires\"). */\n  type?: string;\n}\n\n/**\n * Configuration for the Start/resting block shown before playback begins.\n */\nexport interface StartBlockConfig {\n  /** Hero image path (relative to article media). When omitted, a theme-driven background is used. */\n  heroSrc?: string;\n  /** Alt text for the hero image */\n  heroAlt?: string;\n  /** Title to display over the hero */\n  title: string;\n  /** Optional subtitle */\n  subtitle?: string;\n  /** Ambient motion for the hero image */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n  /** Photo credit / artist name for the hero image */\n  heroCredit?: string;\n  /** License identifier for the hero image */\n  heroLicense?: string;\n}\n\n/**\n * A structural problem detected while converting or validating a document.\n *\n * Diagnostics ride on `Doc.diagnostics` so any consumer — the editor, the\n * CLI `validate` command, or an agent re-parsing its own output — gets the\n * same feedback without watching the console. Conversion never throws for\n * content problems; it degrades gracefully and records a diagnostic.\n */\nexport interface DocDiagnostic {\n  /** `error` = the author's intent could not be honored (e.g. unparseable\n   *  data fence); `warning` = something looks wrong but rendering proceeds\n   *  with a fallback (e.g. unknown template name); `info` = nothing is\n   *  broken, but the author may want to know (e.g. a redundant annotation). */\n  severity: 'error' | 'warning' | 'info';\n  /** Stable machine-readable code (e.g. `unknown-template`, `duplicate-id`,\n   *  `unresolved-connection`, `data-fence-parse`, `missing-asset`). */\n  code: string;\n  /** Human-readable description, including a suggestion when one exists. */\n  message: string;\n  /** Id of the block the problem belongs to, when attributable. */\n  blockId?: string;\n  /** 1-based line number in the markdown source, when known. */\n  line?: number;\n}\n\n/**\n * A complete visual doc for an article.\n */\nexport interface Doc {\n  /** Article ID this doc belongs to */\n  articleId: string;\n\n  /** Total duration in seconds (sum of all audio segments) */\n  duration: number;\n\n  /** Ordered list of blocks */\n  blocks: Block[];\n\n  /** Audio track configuration */\n  audio: AudioTrack;\n\n  /** Caption track for closed captions (generated by postprocess-doc) */\n  captions?: CaptionTrack;\n\n  /**\n   * Start/resting block shown before playback begins.\n   * Displays hero image with title - acts as a \"poster\" for the doc.\n   * The player shows this until the user starts playback.\n   */\n  startBlock?: StartBlockConfig;\n\n  /**\n   * Persistent layers rendered on every block (behind and/or on top of content).\n   * Used for consistent branding overlays, background gradients, etc.\n   */\n  persistentLayers?: import('./BlockTemplates.js').PersistentLayerConfig;\n\n  /**\n   * Optional theme identifier. Resolved at render time via `resolveTheme()`.\n   * When omitted, the renderer uses the default theme ('documentary').\n   */\n  themeId?: string;\n\n  /** Optional metadata */\n  meta?: {\n    generatedAt?: string;\n    generatedBy?: string;\n    version?: number;\n  };\n\n  /**\n   * YAML frontmatter from the source markdown.\n   * Carries rendering hints like `document-render-as` and custom metadata.\n   */\n  frontmatter?: Record<string, unknown>;\n\n  /**\n   * User-defined block templates inlined into this doc.\n   *\n   * Populated from the markdown frontmatter key\n   * `squisq-custom-templates`. The template-expansion pipeline\n   * (`expandDocBlocks` in `doc/templates/index.ts`) merges these into\n   * the registry before walking blocks, so a heading annotated\n   * `{[myhero]}` resolves against a doc-defined template named `myhero`.\n   *\n   * Library templates (stored in localStorage on the editor side) are\n   * NOT auto-loaded here — applying a library template to a block\n   * copies its definition into this list so the doc remains\n   * self-sufficient for SSR and export.\n   */\n  customTemplates?: import('./CustomTemplates.js').CustomTemplateDefinition[];\n\n  /**\n   * User-defined themes inlined into this doc.\n   *\n   * The theme analog of {@link Doc.customTemplates}. Populated from the\n   * markdown frontmatter key `squisq-custom-themes`. Exactly one is active\n   * at a time — selected by id via `squisq-theme` / {@link Doc.themeId},\n   * the doc-level counterpart of a block's `{[name]}` template annotation —\n   * but the payload is a list so a doc can carry a small catalog and stay\n   * self-sufficient for SSR / export. `resolveThemeForDoc(doc, id)` resolves\n   * against this list first (pure, doc-scoped) before built-ins, mirroring\n   * how `buildRegistry` resolves custom templates.\n   */\n  customThemes?: import('./Theme.js').Theme[];\n\n  /**\n   * Structural problems found while building this doc (unknown templates,\n   * unparseable data fences, duplicate ids, unresolved connections, …).\n   * Populated by `markdownToDoc()`; extended by `validateMarkdownDoc()`.\n   * Absent when the document is clean.\n   */\n  diagnostics?: DocDiagnostic[];\n\n  /**\n   * Document-spanning timed media (e.g. a full-length narration MP3/MP4),\n   * authored as a media annotation in the preamble (before the first\n   * heading) with `anchor=document`. Each clip is timed from the document\n   * start and may play across every block. See `resolveMediaSchedule`.\n   */\n  documentMedia?: import('./Media.js').MediaClip[];\n}\n\n/**\n * A single block in the doc.\n *\n * Blocks can be flat (audio-synced timeline) or nested (markdown-driven hierarchy).\n * When derived from markdown, a block corresponds to a heading section:\n * - `sourceHeading` references the original MarkdownHeading node\n * - `contents` holds the body markdown between this heading and the next\n * - `children` holds sub-heading blocks (e.g., H2s under an H1)\n *\n * Four adjacent fields carry template information — do not confuse them:\n * - `template` — the *resolved* template id this block renders with.\n * - `templateOverrides` — raw `{[…]}` inline params (always strings).\n * - `templateData` — structured inputs from a data fence / GFM table\n *   (parsed types, not strings).\n * - `sourceAnnotation.template` — the raw *requested* template name for a\n *   standalone-annotation block (before alias resolution).\n * Merge order at render time: template defaults → `templateData` →\n * `templateOverrides`.\n */\nexport interface Block {\n  /** Unique identifier for this block.\n   *  Defaults to a slug derived from the heading text. May be overridden by\n   *  a Pandoc-style `{#custom-id}` attribute on the heading. */\n  id: string;\n\n  /** When this block appears (seconds from start).\n   *  Overridden by a heading attribute `startTime=…` when present. */\n  startTime: number;\n\n  /** How long this block is visible (seconds).\n   *  Overridden by a heading attribute `duration=…` when present. */\n  duration: number;\n\n  /** Which audio segment this block belongs to (0-indexed) */\n  audioSegment: number;\n\n  /**\n   * Pre-computed visual layers, rendered back-to-front.\n   *\n   * Optional — template-derived blocks typically omit this and compute\n   * layers on demand via `getLayers()` from `@bendyline/squisq/doc`.\n   * Raw blocks (e.g., hand-crafted by AI) may provide layers directly.\n   */\n  layers?: Layer[];\n\n  /** Entry transition from previous block */\n  transition?: Transition;\n\n  /** Resolved template id this block renders with (see the quartet note above). */\n  template?: string;\n\n  /**\n   * True when `template` was chosen by content-aware auto-picking\n   * (`markdownToDoc`'s `autoTemplates`) rather than authored. Ephemeral:\n   * `docToMarkdown` does not materialize auto-picked templates as heading\n   * annotations, keeping the markdown round-trip lossless.\n   */\n  autoTemplate?: boolean;\n\n  /**\n   * True when this block was produced from a *standalone* `{[templateName …]}`\n   * annotation paragraph in another block's body (rather than from a heading).\n   * Such blocks have no `sourceHeading`; `docToMarkdown` re-emits their\n   * annotation as a synthesized paragraph before their `contents` so the\n   * markdown round-trips. See `annotationBlocks.ts`.\n   *\n   * Presence-marker: only ever `true` (never `false`). Test with\n   * `block.standaloneAnnotation` presence, not as a boolean toggle.\n   */\n  standaloneAnnotation?: true;\n\n  /**\n   * The annotation a standalone block was built from — the raw (un-resolved)\n   * template name and its params, in author order. Round-tripped by\n   * `docToMarkdown` (via `serializeAnnotation`) and read by validation as the\n   * raw requested template name (symmetric with\n   * `sourceHeading.templateAnnotation`). Present only when\n   * `standaloneAnnotation` is true.\n   */\n  sourceAnnotation?: { template?: string; params?: Record<string, string> };\n\n  /**\n   * Display title for template rendering.\n   * Extracted from the sourceHeading when the block is created by markdownToDoc().\n   * Templates like sectionHeader and titleBlock read this for their title layer.\n   */\n  title?: string;\n\n  // ── Markdown-driven hierarchy (optional) ──\n\n  /**\n   * Nested sub-blocks (heading hierarchy).\n   * When a doc is derived from markdown, sub-headings within this\n   * heading's section become child blocks. For example, H2 blocks\n   * under an H1 block appear here.\n   */\n  children?: Block[];\n\n  /**\n   * Markdown body content for this block's section.\n   * Contains the block-level markdown nodes (paragraphs, lists, code,\n   * blockquotes, etc.) that appear between this heading and the next\n   * heading or sub-heading. Empty for pure structural blocks.\n   */\n  contents?: import('../markdown/types.js').MarkdownBlockNode[];\n\n  /**\n   * Reference to the MarkdownHeading node that created this block.\n   * Present when the block was derived from markdown via markdownToDoc().\n   * Enables round-tripping back to markdown and provides heading depth.\n   * Absent for the preamble block (content before the first heading).\n   */\n  sourceHeading?: import('../markdown/types.js').MarkdownHeading;\n\n  /**\n   * Template overrides extracted from a heading's `{[templateName key=value]}`\n   * annotation. Only carries template-specific params (e.g. `colorScheme=blue`).\n   * Block-level metadata lives in `x` / `y` / `connectsTo` / `metadata` and is\n   * sourced from the Pandoc-style `{#id .class key=value}` attribute block instead.\n   */\n  templateOverrides?: Record<string, string>;\n\n  /**\n   * Structured template inputs sourced from the block's body content:\n   * a ```json data / ```yaml data fence under the heading, or — for the\n   * `dataTable` template — the first GFM table in the section. Unlike\n   * `templateOverrides` (always strings), values here keep their parsed\n   * types (arrays, numbers, nested objects). Merge order at render time:\n   * template defaults → `templateData` → `templateOverrides`.\n   */\n  templateData?: Record<string, unknown>;\n\n  // ── Block-level metadata from Pandoc-style `{#id .class key=value}` ──\n\n  /**\n   * X coordinate for diagram-style positioning (in author-defined units).\n   * Sourced from a heading attribute `x=…`.\n   */\n  x?: number;\n\n  /**\n   * Y coordinate for diagram-style positioning (in author-defined units).\n   * Sourced from a heading attribute `y=…`.\n   */\n  y?: number;\n\n  /**\n   * Outgoing connections to other blocks, by id. Sourced from a heading\n   * attribute `connectsTo=target1,target2:type,target3`.\n   */\n  connectsTo?: BlockConnection[];\n\n  /**\n   * CSS-style class tokens from a heading's Pandoc attribute (e.g. `{.important .v2}`).\n   * Parsed and stored; downstream consumers may use them for styling or filtering.\n   */\n  classes?: string[];\n\n  /**\n   * Free-form metadata for heading attribute keys outside the typed registry\n   * (anything that isn't `x` / `y` / `connectsTo` / `startTime` / `duration`).\n   * Values are raw strings exactly as authored.\n   */\n  metadata?: Record<string, string>;\n\n  /**\n   * Timed media clips attached to this block, authored as body-level\n   * `{[audio …]}` / `{[video …]}` annotations. Each clip is timed relative\n   * to this block's `startTime` (via `startAt`) and optionally spills past\n   * the block's end. See `MediaClip` / `resolveMediaSchedule`.\n   */\n  media?: import('./Media.js').MediaClip[];\n}\n\n// ============================================\n// Layer Types\n// ============================================\n\n/**\n * A visual element within a block.\n * Layers are composited back-to-front (first layer is background).\n */\nexport type Layer =\n  | ImageLayer\n  | TextLayer\n  | ShapeLayer\n  | PathLayer\n  | MapLayer\n  | VideoLayer\n  | TableLayer;\n\ninterface BaseLayer {\n  /** Unique identifier for this layer */\n  id: string;\n\n  /** Position and size */\n  position: Position;\n\n  /** Animation to apply */\n  animation?: Animation;\n}\n\n/**\n * Photographic treatment applied to an image layer — a theme-level \"grade\"\n * so the same photo looks native in every theme. Rendered as CSS filter\n * functions, which behave identically in the browser player and headless\n * frame capture (video/still export).\n */\nexport interface ImageTreatment {\n  /**\n   * mono: desaturate toward archival black & white.\n   * duotone: single-hue tint (hue taken from `color`).\n   * warm / cool: gentle temperature grade.\n   */\n  type: 'none' | 'mono' | 'duotone' | 'warm' | 'cool';\n  /** Blend strength 0..1. Default 0.6. */\n  strength?: number;\n  /** Duotone tint color (themes default this to their primary). */\n  color?: string;\n}\n\n/**\n * Image layer - displays an image with optional Ken Burns effect.\n */\nexport interface ImageLayer extends BaseLayer {\n  type: 'image';\n  content: {\n    /** Path to image file (relative to article media dir) */\n    src: string;\n    /** Alt text for accessibility */\n    alt: string;\n    /** How to fit image in bounds */\n    fit?: 'cover' | 'contain' | 'fill';\n    /** Photo credit / artist name */\n    credit?: string;\n    /** License identifier (e.g., 'CC BY-SA 4.0') */\n    license?: string;\n    /** Theme-derived photographic grade (see ImageTreatment). */\n    treatment?: ImageTreatment;\n    /** Gaussian blur radius in px (background/atmosphere imagery). */\n    blur?: number;\n  };\n}\n\n/**\n * Text layer - displays text with styling.\n */\nexport interface TextLayer extends BaseLayer {\n  type: 'text';\n  content: {\n    /**\n     * Plain text (supports \\n for line breaks). Source of truth for plain\n     * consumers — PDF/markdown export, search, accessibility — and the SVG\n     * `<text>` fallback. When `html` is set, this is its plain-text\n     * projection and must be kept in sync.\n     */\n    text: string;\n    /**\n     * Optional sanitized **inline** HTML for rich formatting (bold/italic/\n     * links, and — for layout textboxes — headings/lists). When present the\n     * renderer draws it via `<foreignObject>` instead of SVG `<text>`. Treated\n     * as untrusted and re-sanitized at render time. See `RichTextLayer` in\n     * `@bendyline/squisq-react`.\n     */\n    html?: string;\n    /** Text styling */\n    style: TextStyle;\n  };\n}\n\n/**\n * A two-stop linear gradient fill, shared by shape/path fills and text\n * backgrounds. When present it overrides the solid `fill` color.\n *\n * `angle` is in degrees: 0 = top→bottom, 90 = left→right, increasing\n * clockwise. Defaults to 0. Rendered as an SVG `<linearGradient>` in\n * objectBoundingBox units so it scales with the layer's box.\n */\nexport interface LinearGradient {\n  from: string;\n  to: string;\n  angle?: number;\n}\n\n/** Border line style, mapped to an SVG stroke-dasharray by the renderer. */\nexport type BorderStyle = 'solid' | 'dashed' | 'dotted';\n\n/**\n * Shape layer - simple geometric shapes for visual accents.\n */\n/**\n * Repeating SVG pattern fill for a shape (dots, grid, diagonal lines).\n * Rendered as a native `<pattern>` def — fully vector and export-safe.\n */\nexport interface ShapePattern {\n  kind: 'dots' | 'grid' | 'diagonal';\n  /** Pattern ink color. */\n  color: string;\n  /** Tile size in px (default 24). */\n  size?: number;\n  /** Pattern opacity 0–1 (default 1; tint via a translucent color or this). */\n  opacity?: number;\n}\n\n/**\n * Procedural filter applied to a shape. `noise` renders static film grain\n * via SVG feTurbulence — deliberately not animated so frame capture and\n * the live player agree.\n */\nexport interface ShapeFilter {\n  type: 'noise';\n  /** feTurbulence base frequency (default 0.8 — fine grain). */\n  baseFrequency?: number;\n  /** Grain opacity 0–1 (default 0.05). */\n  opacity?: number;\n}\n\nexport interface ShapeLayer extends BaseLayer {\n  type: 'shape';\n  content: {\n    /** Shape type */\n    shape: 'rect' | 'circle' | 'line';\n    /** Fill color (CSS color or 'none') */\n    fill?: string;\n    /** Fill opacity 0–1 (applies to solid and gradient fills). */\n    fillOpacity?: number;\n    /** Gradient fill; overrides `fill` when set. */\n    gradient?: LinearGradient;\n    /** Repeating pattern fill; overrides `fill`/`gradient` when set. */\n    pattern?: ShapePattern;\n    /** Procedural filter (film grain). */\n    filter?: ShapeFilter;\n    /** Stroke color */\n    stroke?: string;\n    /** Stroke width in pixels */\n    strokeWidth?: number;\n    /** Border line style (solid/dashed/dotted). Default solid. */\n    borderStyle?: BorderStyle;\n    /** Corner radius for rect */\n    borderRadius?: number;\n  };\n}\n\n/**\n * End-of-line marker style for a path/connector endpoint.\n * `arrow` is a filled triangle (the classic arrowhead); `open` is a stroked\n * V; `diamond`/`circle`/`square` are filled glyphs; `none` draws nothing.\n */\nexport type MarkerStyle = 'none' | 'arrow' | 'open' | 'diamond' | 'circle' | 'square';\n\n/**\n * Path layer - renders an SVG `<path>` for arbitrary curves, connectors,\n * arrows, or filled regions. Used by the diagram template for edges\n * between nodes, the drawing template for non-rect/circle/line shapes, and\n * available to any template that needs a custom geometry.\n *\n * The `position` field carries the layer's bounding box (so animations\n * and clipping work the same as for other layers), but the actual\n * geometry is encoded in the `d` attribute using absolute SVG path\n * coordinates relative to the block viewport.\n */\nexport interface PathLayer extends BaseLayer {\n  type: 'path';\n  content: {\n    /** SVG path `d` attribute (e.g. \"M 10 10 L 90 90\"). Absolute viewBox coords. */\n    d: string;\n    /**\n     * Named shape kind (e.g. `'diamond'`, `'star'`, `'arrow-right'`) for\n     * path layers that represent one of Squisq's standard shapes. When\n     * set, the renderer re-derives `d` from the layer's `position` box\n     * (resolved against the viewport) instead of using the stored `d` —\n     * so the shape moves, resizes, and adapts to any aspect ratio like\n     * the native rect/circle/line layers do. Plain paths (connectors,\n     * freehand) leave this unset and keep their absolute `d`.\n     */\n    shapeKind?: string;\n    /** Stroke color (default: theme text color). */\n    stroke?: string;\n    /** Stroke width in pixels (default: 2). */\n    strokeWidth?: number;\n    /** Optional fill color (default: 'none' — pure connectors). */\n    fill?: string;\n    /** Fill opacity 0–1 (applies to solid and gradient fills). */\n    fillOpacity?: number;\n    /** Gradient fill; overrides `fill` when set. */\n    gradient?: LinearGradient;\n    /**\n     * Border line style (solid/dashed/dotted). A convenience over\n     * `dasharray` for named shapes; when set the renderer derives the\n     * dash pattern from it (scaled by stroke width).\n     */\n    borderStyle?: BorderStyle;\n    /** Optional stroke dash pattern (SVG `stroke-dasharray` syntax). */\n    dasharray?: string;\n    /**\n     * Legacy arrowhead flag. Prefer `startMarker`/`endMarker`. When those are\n     * unset, `'end'`/`'start'`/`'both'` render a filled-triangle arrowhead.\n     */\n    arrow?: 'none' | 'end' | 'start' | 'both';\n    /** Marker at the path start (overrides `arrow`). Default: derived from `arrow`. */\n    startMarker?: MarkerStyle;\n    /** Marker at the path end (overrides `arrow`). Default: derived from `arrow`. */\n    endMarker?: MarkerStyle;\n  };\n}\n\n/**\n * Map layer - displays a geographic map with optional markers.\n *\n * Maps are rendered as composite tile images from free tile providers.\n * Supported styles use open-source/free tiles requiring attribution.\n */\nexport interface MapLayer extends BaseLayer {\n  type: 'map';\n  content: {\n    /** Center coordinates for the map */\n    center: {\n      lat: number;\n      lng: number;\n    };\n    /** Zoom level (0-18, typically 8-14 for doc blocks) */\n    zoom: number;\n    /** Map tile style */\n    style: MapTileStyle;\n    /** Optional markers to display on the map */\n    markers?: MapMarker[];\n    /** Pre-rendered static image path (for video export reliability) */\n    staticSrc?: string;\n    /** Show attribution text (default: true) */\n    showAttribution?: boolean;\n  };\n}\n\n/**\n * Video layer - displays a short video clip, always muted (narration provides audio).\n *\n * Rendered via an HTML5 <video> element inside <foreignObject>, similar to how\n * ImageLayer uses <img> for Ken Burns effects. clipStart/clipEnd define the window\n * within the source video to play. During Playwright frame capture (seekTo mode),\n * the video is seeked programmatically rather than playing in real time.\n */\nexport interface VideoLayer extends BaseLayer {\n  type: 'video';\n  content: {\n    /** Path to video file (relative to article media dir) */\n    src: string;\n    /** Path to poster frame (shown before video loads / during seek) */\n    posterSrc?: string;\n    /** Alt text for accessibility */\n    alt: string;\n    /** How to fit video in bounds */\n    fit?: 'cover' | 'contain' | 'fill';\n    /** Start time within the source video (seconds) */\n    clipStart: number;\n    /** End time within the source video (seconds) */\n    clipEnd: number;\n    /** Total source video duration (for validation) */\n    sourceDuration?: number;\n    /**\n     * Seconds into the owning block before this video begins playing\n     * (the block-relative `startAt`). Default 0 — plays from block start.\n     */\n    startAt?: number;\n    /**\n     * When true, the video keeps playing past the block's end (the\n     * playback scheduler re-homes it to the player level). Default false.\n     */\n    spillover?: boolean;\n    /** Video credit / artist name */\n    credit?: string;\n    /** License identifier (e.g., 'CC BY-SA 4.0') */\n    license?: string;\n  };\n}\n\n/**\n * Table layer - renders a data table with themed styling.\n * Uses foreignObject inside SVG for HTML-based table layout.\n */\nexport interface TableLayer extends BaseLayer {\n  type: 'table';\n  content: {\n    /** Header cell values */\n    headers: string[];\n    /** Data rows (array of cell value arrays) */\n    rows: string[][];\n    /** Per-column alignment */\n    align?: (('left' | 'right' | 'center') | null)[];\n    /** Visual styling */\n    style: TableLayerStyle;\n  };\n}\n\n/**\n * Styling options for a TableLayer.\n */\nexport interface TableLayerStyle {\n  /** Header row background color */\n  headerBackground: string;\n  /** Header row text color */\n  headerColor: string;\n  /** Body cell background color */\n  cellBackground: string;\n  /** Body cell text color */\n  cellColor: string;\n  /** Border/divider color */\n  borderColor: string;\n  /** Font size in pixels */\n  fontSize: number;\n  /** Font family */\n  fontFamily?: string;\n  /** Header font family (falls back to fontFamily) */\n  headerFontFamily?: string;\n  /** Corner radius for the table container */\n  borderRadius?: number;\n}\n\n/**\n * Available map tile styles from free/open-source providers.\n */\nexport type MapTileStyle =\n  | 'terrain' // OpenTopoMap - topographic/terrain (default)\n  | 'satellite' // ESRI World Imagery\n  | 'road' // OpenStreetMap standard\n  | 'toner' // Stadia Toner (high contrast B&W)\n  | 'watercolor'; // Stadia Watercolor (artistic)\n\n/**\n * A marker to display on the map.\n */\nexport interface MapMarker {\n  /** Marker latitude */\n  lat: number;\n  /** Marker longitude */\n  lng: number;\n  /** Optional label text */\n  label?: string;\n  /** Marker color (CSS color, default: #ef4444) */\n  color?: string;\n  /** Marker icon type */\n  icon?: 'pin' | 'circle' | 'star';\n}\n\n// ============================================\n// Position & Styling\n// ============================================\n\n/**\n * Position and dimensions for a layer.\n * Values can be pixels (number) or percentages (string like \"50%\").\n */\nexport interface Position {\n  /** X position (pixels or percentage) */\n  x: number | string;\n  /** Y position (pixels or percentage) */\n  y: number | string;\n  /** Width (pixels or percentage) */\n  width?: number | string;\n  /** Height (pixels or percentage) */\n  height?: number | string;\n  /** Anchor point for positioning */\n  anchor?: 'center' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';\n}\n\n/**\n * Text styling options.\n */\nexport interface TextStyle {\n  /** Font size in pixels */\n  fontSize: number;\n  /** Font family (defaults to system sans-serif) */\n  fontFamily?: string;\n  /** Font weight */\n  fontWeight?: 'normal' | 'bold';\n  /** Font style. Also the inherited baseline for rich `content.html`. */\n  fontStyle?: 'normal' | 'italic';\n  /** Text color (CSS color) */\n  color: string;\n  /** Horizontal text alignment within the layer's position box. */\n  textAlign?: 'left' | 'center' | 'right';\n  /**\n   * Vertical alignment of the text within the layer's position box.\n   * Requires a `position.height` to have an effect. When omitted, the\n   * vertical baseline is derived from `position.anchor` (legacy behavior).\n   */\n  verticalAlign?: 'top' | 'middle' | 'bottom';\n  /** Line height multiplier */\n  lineHeight?: number;\n  /** Add drop shadow for readability over images */\n  shadow?: boolean;\n  /** Background color for text box */\n  background?: string;\n  /** Background opacity 0–1 (applies to solid and gradient backgrounds). */\n  backgroundOpacity?: number;\n  /** Gradient background; overrides `background` when set. */\n  backgroundGradient?: LinearGradient;\n  /** Border (stroke) color for the text box. */\n  borderColor?: string;\n  /** Border width in pixels. A border renders when > 0 and a color is set. */\n  borderWidth?: number;\n  /** Border line style (solid/dashed/dotted). Default solid. */\n  borderStyle?: BorderStyle;\n  /** Padding around text (pixels) */\n  padding?: number;\n  /** Maximum number of lines before truncation (adds \"...\" to last line) */\n  maxLines?: number;\n}\n\n// ============================================\n// Animation & Transitions\n// ============================================\n\n/**\n * Animation to apply to a layer.\n */\nexport interface Animation {\n  /** Animation type */\n  type: AnimationType;\n  /** Duration in seconds (defaults to layer's block duration) */\n  duration?: number;\n  /** Delay before animation starts (seconds) */\n  delay?: number;\n  /** CSS easing function */\n  easing?: string;\n  /** For Ken Burns: zoom direction */\n  direction?: 'in' | 'out';\n  /** For pan animations: pan direction */\n  panDirection?: 'left' | 'right' | 'up' | 'down';\n}\n\n/**\n * Available animation types.\n */\nexport type AnimationType =\n  | 'none'\n  | 'fadeIn'\n  | 'fadeOut'\n  | 'slowZoom' // Slow zoom with optional pan\n  | 'zoomIn'\n  | 'zoomOut'\n  | 'panLeft'\n  | 'panRight'\n  | 'typewriter'; // Text appears letter by letter\n\n// ============================================\n// Audio Configuration\n// ============================================\n\n/**\n * Audio track configuration.\n * Articles have multiple MP3 segments (intro + sections).\n */\nexport interface AudioTrack {\n  /** Audio segments in playback order */\n  segments: AudioSegment[];\n}\n\n// ============================================\n// Captions\n// ============================================\n\n/**\n * A single word with precise timing, used for word-level highlighting\n * in social-style captions. Populated from TTS timing data when available.\n */\nexport interface CaptionWord {\n  /** The word text */\n  text: string;\n  /** Start time in seconds (relative to doc start) */\n  startTime: number;\n  /** End time in seconds */\n  endTime: number;\n}\n\n/**\n * A single caption phrase to display during playback.\n */\nexport interface CaptionPhrase {\n  /** The text to display */\n  text: string;\n  /** Start time in seconds (relative to doc start) */\n  startTime: number;\n  /** End time in seconds */\n  endTime: number;\n  /** Which audio segment this caption belongs to (0-indexed) */\n  audioSegment: number;\n  /**\n   * Optional per-word timing from TTS timing data.\n   * When present, enables precise word-level highlighting in social\n   * caption style. When absent, word timing is interpolated evenly\n   * across the phrase duration.\n   */\n  words?: CaptionWord[];\n}\n\n/**\n * Caption track for a doc.\n */\nexport interface CaptionTrack {\n  /** Caption phrases in chronological order */\n  phrases: CaptionPhrase[];\n  /** When the captions were generated. Optional so that conversion stays\n   *  deterministic — `markdownToDoc()` only sets it when the caller\n   *  supplies a timestamp via `captionsGeneratedAt`. */\n  generatedAt?: string;\n  /** Algorithm version for regeneration detection */\n  version: number;\n}\n\n/**\n * A single audio segment (one MP3 file).\n */\nexport interface AudioSegment {\n  /** Path to MP3 file (relative to article media dir) */\n  src: string;\n  /** Segment name (e.g., \"intro\", \"history\") */\n  name: string;\n  /** Duration in seconds */\n  duration: number;\n  /** Start time in overall timeline (calculated) */\n  startTime: number;\n}\n\n// ============================================\n// Audio Timing Data (from TTS)\n// ============================================\n\n/**\n * A single word-level timing bookmark from TTS synthesis.\n * Used for precise audio-to-content mapping and word-level caption sync.\n */\nexport interface AudioBookmark {\n  /** Unique identifier (e.g., \"word-0\", \"word-1\") */\n  id: string;\n  /** Timestamp in seconds from audio start */\n  time: number;\n  /** Character offset in the source text */\n  charOffset: number;\n  /** The word text at this position */\n  textFragment?: string;\n}\n\n/**\n * Timing data for an audio segment, typically from a `.timing.json` file\n * generated alongside TTS audio. Contains the source text and per-word\n * timing bookmarks for precise content matching and caption sync.\n */\nexport interface AudioTimingData {\n  /** The normalized plain text that was synthesized */\n  sourceText: string;\n  /** Word-level timing bookmarks */\n  bookmarks: AudioBookmark[];\n  /** Total audio duration in seconds */\n  duration: number;\n}\n\n// ============================================\n// Helper Functions\n// ============================================\n\n/**\n * Calculate total duration from audio segments.\n */\nexport function calculateDuration(audio: AudioTrack): number {\n  return audio.segments.reduce((sum, seg) => sum + seg.duration, 0);\n}\n\n/**\n * Find which audio segment is playing at a given time.\n */\nexport function getSegmentAtTime(audio: AudioTrack, time: number): number {\n  let elapsed = 0;\n  for (let i = 0; i < audio.segments.length; i++) {\n    elapsed += audio.segments[i].duration;\n    if (time < elapsed) return i;\n  }\n  return audio.segments.length - 1;\n}\n\n/**\n * Find which block should be visible at a given time.\n */\nexport function getBlockAtTime(blocks: Block[], time: number): Block | null {\n  for (let i = blocks.length - 1; i >= 0; i--) {\n    const block = blocks[i];\n    if (time >= block.startTime && time < block.startTime + block.duration) {\n      return block;\n    }\n  }\n  return blocks[0] || null;\n}\n\n/**\n * Find the caption phrase that should be displayed at a given time.\n */\nexport function getCaptionAtTime(\n  captions: CaptionTrack | undefined,\n  time: number,\n): CaptionPhrase | null {\n  if (!captions || !captions.phrases.length) return null;\n\n  for (const phrase of captions.phrases) {\n    if (time >= phrase.startTime && time < phrase.endTime) {\n      return phrase;\n    }\n  }\n  return null;\n}\n","/**\n * Media-clip timing model.\n *\n * An additive layer on top of the legacy sequential `Doc.audio.segments[]`\n * narration track. A {@link MediaClip} is a piece of audio or video whose\n * timing is expressed *relative to its parent block* (or the whole document),\n * with an optional `startAt` offset and an optional `spillover` past the\n * block's end. {@link resolveMediaSchedule} flattens these into absolute,\n * doc-timeline `ScheduledClip`s that playback and export consume.\n *\n * Authoring: a body-level `{[audio …]}` / `{[video …]}` annotation inside a\n * block becomes a `block.media` clip; the same annotation in the preamble\n * (before the first heading) with `anchor=document` becomes a\n * `doc.documentMedia` clip that spans the whole timeline.\n */\n\nimport type { Block, Doc } from './Doc.js';\n\n/**\n * A timed piece of media attached to a block (or the document).\n */\nexport interface MediaClip {\n  /** Stable id (for React keys and timeline selection). */\n  id: string;\n  /** Source path (mp3/mp4/…), relative to the article media dir. */\n  src: string;\n  kind: 'audio' | 'video';\n  /**\n   * Seconds from the parent block's start when this clip begins. For an\n   * `anchor='document'` clip, seconds from the document start. Default 0.\n   */\n  startAt: number;\n  /** Source in-point within the file (seconds). Default 0. */\n  clipStart?: number;\n  /** Source out-point within the file (seconds). Default: file/block end. */\n  clipEnd?: number;\n  /**\n   * When false (default) the clip stops at its block's end. When true it\n   * keeps playing past the block boundary until the clip itself finishes.\n   * Ignored for `anchor='document'` clips (they already span the timeline).\n   */\n  spillover?: boolean;\n  /**\n   * `'block'` (default) — timed relative to the parent block. `'document'` —\n   * timed relative to the document start and able to span every block.\n   */\n  anchor: 'block' | 'document';\n  /**\n   * 1-based source line of the authoring annotation, when derived from\n   * markdown. Enables round-tripping edits (e.g. the timeline editor rewriting\n   * `startAt`) back to the exact line. Absent for programmatically built clips.\n   */\n  sourceLine?: number;\n}\n\n/**\n * A {@link MediaClip} resolved to absolute document-timeline coordinates.\n * Produced by {@link resolveMediaSchedule}; consumed by the playback\n * scheduler and the MP4 export.\n */\nexport interface ScheduledClip {\n  id: string;\n  src: string;\n  kind: 'audio' | 'video';\n  /** Absolute doc-timeline second the clip starts. */\n  absoluteStart: number;\n  /** Absolute doc-timeline second the clip ends (exclusive). */\n  absoluteEnd: number;\n  /** Source in-point to seek to at `absoluteStart`. */\n  sourceIn: number;\n  anchor: 'block' | 'document';\n  /** Owning block id for block-anchored clips (for video re-homing/export). */\n  blockId?: string;\n  /** 1-based source line of the authoring annotation, when known. */\n  sourceLine?: number;\n}\n\n/** Depth-first flatten of the block tree (local copy to avoid a doc-layer dep). */\nfunction flatten(blocks: Block[], out: Block[] = []): Block[] {\n  for (const b of blocks) {\n    out.push(b);\n    if (b.children && b.children.length > 0) flatten(b.children, out);\n  }\n  return out;\n}\n\n/** Played length of a clip when known from its in/out points, else null. */\nfunction clipLength(clip: MediaClip): number | null {\n  if (clip.clipEnd == null) return null;\n  return Math.max(0, clip.clipEnd - (clip.clipStart ?? 0));\n}\n\n/**\n * Base playback span ignoring media — the larger of the audio-segment sum\n * and the last block's end. Document clips that don't pin a length run to\n * this point.\n */\nfunction baseTimelineEnd(doc: Doc): number {\n  const blockEnd = flatten(doc.blocks).reduce(\n    (max, b) => Math.max(max, b.startTime + b.duration),\n    0,\n  );\n  return Math.max(doc.duration ?? 0, blockEnd);\n}\n\n/**\n * Flatten every block clip and document clip into absolute-timed\n * `ScheduledClip`s. Pure — depends only on `doc`.\n */\nexport function resolveMediaSchedule(doc: Doc): ScheduledClip[] {\n  const out: ScheduledClip[] = [];\n  const docEnd = baseTimelineEnd(doc);\n\n  for (const block of flatten(doc.blocks)) {\n    const blockEnd = block.startTime + block.duration;\n    for (const clip of block.media ?? []) {\n      const start = block.startTime + clip.startAt;\n      const len = clipLength(clip);\n      let end: number;\n      if (clip.spillover) {\n        // Continue past the block; fall back to the block end when the\n        // played length is unknown (no clipEnd authored).\n        end = len != null ? start + len : blockEnd;\n      } else {\n        end = len != null ? Math.min(start + len, blockEnd) : blockEnd;\n      }\n      out.push({\n        id: clip.id,\n        src: clip.src,\n        kind: clip.kind,\n        absoluteStart: start,\n        absoluteEnd: Math.max(start, end),\n        sourceIn: clip.clipStart ?? 0,\n        anchor: 'block',\n        blockId: block.id,\n        ...(clip.sourceLine != null ? { sourceLine: clip.sourceLine } : {}),\n      });\n    }\n  }\n\n  for (const clip of doc.documentMedia ?? []) {\n    const start = clip.startAt;\n    const len = clipLength(clip);\n    const end = len != null ? start + len : docEnd;\n    out.push({\n      id: clip.id,\n      src: clip.src,\n      kind: clip.kind,\n      absoluteStart: start,\n      absoluteEnd: Math.max(start, end),\n      sourceIn: clip.clipStart ?? 0,\n      anchor: 'document',\n      ...(clip.sourceLine != null ? { sourceLine: clip.sourceLine } : {}),\n    });\n  }\n\n  return out;\n}\n\n/**\n * Total playback duration including any media that spills past the last\n * block (or audio segment). Export uses this for the frame count and the\n * player for its effective timeline length.\n */\nexport function getDocPlaybackDuration(doc: Doc): number {\n  const base = baseTimelineEnd(doc);\n  const mediaEnd = resolveMediaSchedule(doc).reduce((max, c) => Math.max(max, c.absoluteEnd), 0);\n  return Math.max(base, mediaEnd);\n}\n","/**\n * Theme Compilation\n *\n * Turns a partial Theme (typically authored by the customizer panel from\n * a few seed colors and preset choices) into a complete, validated Theme\n * by:\n *\n *   1. Filling unspecified fields from a hardcoded `STARTER_THEME`.\n *   2. Deriving missing color slots from `seedColors` via OKLCh math.\n *   3. Validating the result.\n *\n * Built-in themes ship as fully-specified Theme JSON and skip this step.\n */\n\nimport type {\n  Theme,\n  DeepPartial,\n  ThemeColorPalette,\n  ThemeColorScheme,\n  ThemeSeedColors,\n  FontFamily,\n} from './Theme.js';\nimport { THEME_SCHEMA_VERSION, createTheme } from './Theme.js';\nimport { assertTheme } from './themeValidator.js';\nimport {\n  oklchLighten,\n  oklchDarken,\n  oklchSetChroma,\n  pickContrastingText,\n  relativeLuminance,\n} from './colorUtils.js';\n\n/** Internal default theme used to fill in fields the customizer doesn't expose. */\nconst STARTER_BODY_FONT: FontFamily = { stackId: 'system-sans' };\nconst STARTER_TITLE_FONT: FontFamily = { stackId: 'system-serif' };\nconst STARTER_MONO_FONT: FontFamily = { stackId: 'system-mono' };\n\nconst STARTER_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\nexport const STARTER_THEME: Theme = {\n  schemaVersion: THEME_SCHEMA_VERSION,\n  id: 'custom',\n  name: 'Custom Theme',\n  description: 'Customizer starter — gets overridden by user choices.',\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    bodyFont: STARTER_BODY_FONT,\n    titleFont: STARTER_TITLE_FONT,\n    monoFont: STARTER_MONO_FONT,\n    titleWeight: 'bold',\n  },\n  style: {\n    textShadow: true,\n    overlayOpacity: 0.45,\n    animationSpeed: 1.0,\n    borderRadius: 6,\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: STARTER_COLOR_SCHEMES,\n};\n\n/**\n * Derive a full `ThemeColorPalette` from `seedColors`, with any explicit\n * `partialColors` taking precedence over derived values. Background and\n * text are guessed from luminance when the user gave only a primary.\n */\nexport function deriveColorPalette(\n  seeds: ThemeSeedColors,\n  partialColors: Partial<ThemeColorPalette> = {},\n  opts: { contrast?: 'subtle' | 'balanced' | 'high' } = {},\n): ThemeColorPalette {\n  const spread = opts.contrast === 'high' ? 0.22 : opts.contrast === 'subtle' ? 0.08 : 0.15;\n\n  const primary = seeds.primary;\n  const secondary = seeds.secondary ?? oklchSetChroma(oklchLighten(primary, 0.05), 0.5);\n  const accent = seeds.accent ?? oklchLighten(primary, spread);\n\n  // Decide light vs dark surface from the explicit background, the seed background,\n  // or default to dark.\n  const bgSeed = partialColors.background ?? seeds.background;\n  let background: string;\n  if (bgSeed) {\n    background = bgSeed;\n  } else {\n    // Pick a dark or light background that contrasts with primary\n    background = relativeLuminance(primary) > 0.5 ? '#0a0a0a' : '#1a202c';\n  }\n  const isLightSurface = relativeLuminance(background) > 0.5;\n\n  const backgroundLight =\n    partialColors.backgroundLight ??\n    (isLightSurface ? oklchDarken(background, 0.04) : oklchLighten(background, 0.04));\n\n  const text =\n    partialColors.text ?? seeds.text ?? pickContrastingText(background, '#f7fafc', '#1a202c');\n  const textMuted =\n    partialColors.textMuted ??\n    (isLightSurface ? oklchLighten(text, 0.25) : oklchDarken(text, 0.25));\n\n  const highlight = partialColors.highlight ?? accent;\n  const warning = partialColors.warning ?? '#fc8181';\n\n  return {\n    primary: partialColors.primary ?? primary,\n    secondary: partialColors.secondary ?? secondary,\n    background,\n    backgroundLight,\n    text,\n    textMuted,\n    highlight,\n    warning,\n  };\n}\n\n/** Map a contrast preset to numeric spread used by `deriveColorPalette`. */\nexport type ContrastPreset = 'subtle' | 'balanced' | 'high';\n\nexport interface CompileOptions {\n  /** Contrast level for OKLCh derivation (default 'balanced'). */\n  contrast?: ContrastPreset;\n  /**\n   * Base theme to inherit from. When provided, the partial is deep-merged\n   * over this theme instead of the neutral `STARTER_THEME`, so the compiled\n   * theme inherits the base's render style, color schemes, typography, and\n   * persistent layers — and only the fields the user changed are overridden.\n   * The base's id is recorded on the result as `basedOn`.\n   */\n  base?: Theme;\n}\n\n/**\n * Compile a partial Theme into a complete one. Fills missing fields from\n * the base (`opts.base` when given, else `STARTER_THEME`), derives missing\n * color slots from `seedColors` (when present), and validates the result.\n */\nexport function compileTheme(partial: DeepPartial<Theme>, opts: CompileOptions = {}): Theme {\n  // Step 1: deep-merge over the base (a chosen theme, or the neutral starter)\n  const base = opts.base ?? STARTER_THEME;\n  const merged = createTheme(base, partial);\n  merged.schemaVersion = THEME_SCHEMA_VERSION;\n  // Record which theme this was derived from so a customizer can re-inherit.\n  if (opts.base && !merged.basedOn) merged.basedOn = opts.base.id;\n\n  // Step 1b: typography fonts are discriminated unions ({stackId} | {custom}),\n  // so deep-merge would leave stale keys from the starter when the partial\n  // switches form. Replace each font wholesale when explicitly provided.\n  const partialTypography = partial.typography;\n  if (partialTypography) {\n    if (partialTypography.titleFont !== undefined) {\n      merged.typography.titleFont = partialTypography.titleFont as FontFamily;\n    }\n    if (partialTypography.bodyFont !== undefined) {\n      merged.typography.bodyFont = partialTypography.bodyFont as FontFamily;\n    }\n    if (partialTypography.monoFont !== undefined) {\n      merged.typography.monoFont = partialTypography.monoFont as FontFamily;\n    }\n  }\n\n  // Step 1c: colorSchemes is a map the user edits wholesale (add / remove\n  // accents). Deep-merge can't delete keys, so replace it outright when the\n  // partial provides it — mirroring the font replacement above. This lets a\n  // removed accent actually disappear rather than lingering from the base.\n  if (partial.colorSchemes !== undefined) {\n    merged.colorSchemes = partial.colorSchemes as Record<string, ThemeColorScheme>;\n  }\n\n  // Step 2: derive missing color slots from seeds, if present\n  if (merged.seedColors) {\n    const partialColors = (partial.colors ?? {}) as Partial<ThemeColorPalette>;\n    merged.colors = deriveColorPalette(merged.seedColors, partialColors, {\n      contrast: opts.contrast,\n    });\n  }\n\n  // Step 3: validate\n  return assertTheme(merged, `compiled theme \"${merged.id}\"`);\n}\n\n/**\n * Parse a JSON string into a validated Theme. Throws on invalid input.\n */\nexport function parseTheme(json: string): Theme {\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(json);\n  } catch (err: unknown) {\n    const msg = err instanceof Error ? err.message : String(err);\n    throw new Error(`Invalid theme JSON: ${msg}`);\n  }\n  return assertTheme(parsed, 'parsed theme');\n}\n\n/**\n * Serialize a Theme to a stable, pretty-printed JSON string. Round-trips\n * cleanly through `parseTheme`.\n */\nexport function serializeTheme(theme: Theme): string {\n  return JSON.stringify(theme, null, 2);\n}\n"],"mappings":";;;;;;;;;;;;AAg7BO,SAAS,kBAAkB,OAA2B;AAC3D,SAAO,MAAM,SAAS,OAAO,CAAC,KAAK,QAAQ,MAAM,IAAI,UAAU,CAAC;AAClE;AAKO,SAAS,iBAAiB,OAAmB,MAAsB;AACxE,MAAI,UAAU;AACd,WAAS,IAAI,GAAG,IAAI,MAAM,SAAS,QAAQ,KAAK;AAC9C,eAAW,MAAM,SAAS,CAAC,EAAE;AAC7B,QAAI,OAAO,QAAS,QAAO;AAAA,EAC7B;AACA,SAAO,MAAM,SAAS,SAAS;AACjC;AAKO,SAAS,eAAe,QAAiB,MAA4B;AAC1E,WAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,UAAM,QAAQ,OAAO,CAAC;AACtB,QAAI,QAAQ,MAAM,aAAa,OAAO,MAAM,YAAY,MAAM,UAAU;AACtE,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,OAAO,CAAC,KAAK;AACtB;AAKO,SAAS,iBACd,UACA,MACsB;AACtB,MAAI,CAAC,YAAY,CAAC,SAAS,QAAQ,OAAQ,QAAO;AAElD,aAAW,UAAU,SAAS,SAAS;AACrC,QAAI,QAAQ,OAAO,aAAa,OAAO,OAAO,SAAS;AACrD,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;;;AC94BA,SAAS,QAAQ,QAAiB,MAAe,CAAC,GAAY;AAC5D,aAAW,KAAK,QAAQ;AACtB,QAAI,KAAK,CAAC;AACV,QAAI,EAAE,YAAY,EAAE,SAAS,SAAS,EAAG,SAAQ,EAAE,UAAU,GAAG;AAAA,EAClE;AACA,SAAO;AACT;AAGA,SAAS,WAAW,MAAgC;AAClD,MAAI,KAAK,WAAW,KAAM,QAAO;AACjC,SAAO,KAAK,IAAI,GAAG,KAAK,WAAW,KAAK,aAAa,EAAE;AACzD;AAOA,SAAS,gBAAgB,KAAkB;AACzC,QAAM,WAAW,QAAQ,IAAI,MAAM,EAAE;AAAA,IACnC,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,YAAY,EAAE,QAAQ;AAAA,IAClD;AAAA,EACF;AACA,SAAO,KAAK,IAAI,IAAI,YAAY,GAAG,QAAQ;AAC7C;AAMO,SAAS,qBAAqB,KAA2B;AAC9D,QAAM,MAAuB,CAAC;AAC9B,QAAM,SAAS,gBAAgB,GAAG;AAElC,aAAW,SAAS,QAAQ,IAAI,MAAM,GAAG;AACvC,UAAM,WAAW,MAAM,YAAY,MAAM;AACzC,eAAW,QAAQ,MAAM,SAAS,CAAC,GAAG;AACpC,YAAM,QAAQ,MAAM,YAAY,KAAK;AACrC,YAAM,MAAM,WAAW,IAAI;AAC3B,UAAI;AACJ,UAAI,KAAK,WAAW;AAGlB,cAAM,OAAO,OAAO,QAAQ,MAAM;AAAA,MACpC,OAAO;AACL,cAAM,OAAO,OAAO,KAAK,IAAI,QAAQ,KAAK,QAAQ,IAAI;AAAA,MACxD;AACA,UAAI,KAAK;AAAA,QACP,IAAI,KAAK;AAAA,QACT,KAAK,KAAK;AAAA,QACV,MAAM,KAAK;AAAA,QACX,eAAe;AAAA,QACf,aAAa,KAAK,IAAI,OAAO,GAAG;AAAA,QAChC,UAAU,KAAK,aAAa;AAAA,QAC5B,QAAQ;AAAA,QACR,SAAS,MAAM;AAAA,QACf,GAAI,KAAK,cAAc,OAAO,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,MACnE,CAAC;AAAA,IACH;AAAA,EACF;AAEA,aAAW,QAAQ,IAAI,iBAAiB,CAAC,GAAG;AAC1C,UAAM,QAAQ,KAAK;AACnB,UAAM,MAAM,WAAW,IAAI;AAC3B,UAAM,MAAM,OAAO,OAAO,QAAQ,MAAM;AACxC,QAAI,KAAK;AAAA,MACP,IAAI,KAAK;AAAA,MACT,KAAK,KAAK;AAAA,MACV,MAAM,KAAK;AAAA,MACX,eAAe;AAAA,MACf,aAAa,KAAK,IAAI,OAAO,GAAG;AAAA,MAChC,UAAU,KAAK,aAAa;AAAA,MAC5B,QAAQ;AAAA,MACR,GAAI,KAAK,cAAc,OAAO,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,IACnE,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAOO,SAAS,uBAAuB,KAAkB;AACvD,QAAM,OAAO,gBAAgB,GAAG;AAChC,QAAM,WAAW,qBAAqB,GAAG,EAAE,OAAO,CAAC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,WAAW,GAAG,CAAC;AAC7F,SAAO,KAAK,IAAI,MAAM,QAAQ;AAChC;;;ACvIA,IAAM,oBAAgC,EAAE,SAAS,cAAc;AAC/D,IAAM,qBAAiC,EAAE,SAAS,eAAe;AACjE,IAAM,oBAAgC,EAAE,SAAS,cAAc;AAE/D,IAAM,wBAA0D;AAAA,EAC9D,MAAM,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAAA,EAC1D,OAAO,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAAA,EAC3D,QAAQ,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAAA,EAC5D,KAAK,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAAA,EACzD,QAAQ,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAAA,EAC5D,MAAM,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAC5D;AAEO,IAAM,gBAAuB;AAAA,EAClC,eAAe;AAAA,EACf,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,aAAa;AAAA,EACb,QAAQ;AAAA,IACN,SAAS;AAAA,IACT,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,iBAAiB;AAAA,IACjB,MAAM;AAAA,IACN,WAAW;AAAA,IACX,WAAW;AAAA,IACX,SAAS;AAAA,EACX;AAAA,EACA,YAAY;AAAA,IACV,UAAU;AAAA,IACV,WAAW;AAAA,IACX,UAAU;AAAA,IACV,aAAa;AAAA,EACf;AAAA,EACA,OAAO;AAAA,IACL,YAAY;AAAA,IACZ,gBAAgB;AAAA,IAChB,gBAAgB;AAAA,IAChB,cAAc;AAAA,EAChB;AAAA,EACA,aAAa;AAAA,IACX,MAAM;AAAA,IACN,sBAAsB;AAAA,IACtB,uBAAuB;AAAA,IACvB,eAAe;AAAA,IACf,mBAAmB,EAAE,MAAM,QAAQ,UAAU,IAAI;AAAA,EACnD;AAAA,EACA,cAAc;AAChB;AAOO,SAAS,mBACd,OACA,gBAA4C,CAAC,GAC7C,OAAsD,CAAC,GACpC;AACnB,QAAM,SAAS,KAAK,aAAa,SAAS,OAAO,KAAK,aAAa,WAAW,OAAO;AAErF,QAAM,UAAU,MAAM;AACtB,QAAM,YAAY,MAAM,aAAa,eAAe,aAAa,SAAS,IAAI,GAAG,GAAG;AACpF,QAAM,SAAS,MAAM,UAAU,aAAa,SAAS,MAAM;AAI3D,QAAM,SAAS,cAAc,cAAc,MAAM;AACjD,MAAI;AACJ,MAAI,QAAQ;AACV,iBAAa;AAAA,EACf,OAAO;AAEL,iBAAa,kBAAkB,OAAO,IAAI,MAAM,YAAY;AAAA,EAC9D;AACA,QAAM,iBAAiB,kBAAkB,UAAU,IAAI;AAEvD,QAAM,kBACJ,cAAc,oBACb,iBAAiB,YAAY,YAAY,IAAI,IAAI,aAAa,YAAY,IAAI;AAEjF,QAAM,OACJ,cAAc,QAAQ,MAAM,QAAQ,oBAAoB,YAAY,WAAW,SAAS;AAC1F,QAAM,YACJ,cAAc,cACb,iBAAiB,aAAa,MAAM,IAAI,IAAI,YAAY,MAAM,IAAI;AAErE,QAAM,YAAY,cAAc,aAAa;AAC7C,QAAM,UAAU,cAAc,WAAW;AAEzC,SAAO;AAAA,IACL,SAAS,cAAc,WAAW;AAAA,IAClC,WAAW,cAAc,aAAa;AAAA,IACtC;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAuBO,SAAS,aAAa,SAA6B,OAAuB,CAAC,GAAU;AAE1F,QAAM,OAAO,KAAK,QAAQ;AAC1B,QAAM,SAAS,YAAY,MAAM,OAAO;AACxC,SAAO,gBAAgB;AAEvB,MAAI,KAAK,QAAQ,CAAC,OAAO,QAAS,QAAO,UAAU,KAAK,KAAK;AAK7D,QAAM,oBAAoB,QAAQ;AAClC,MAAI,mBAAmB;AACrB,QAAI,kBAAkB,cAAc,QAAW;AAC7C,aAAO,WAAW,YAAY,kBAAkB;AAAA,IAClD;AACA,QAAI,kBAAkB,aAAa,QAAW;AAC5C,aAAO,WAAW,WAAW,kBAAkB;AAAA,IACjD;AACA,QAAI,kBAAkB,aAAa,QAAW;AAC5C,aAAO,WAAW,WAAW,kBAAkB;AAAA,IACjD;AAAA,EACF;AAMA,MAAI,QAAQ,iBAAiB,QAAW;AACtC,WAAO,eAAe,QAAQ;AAAA,EAChC;AAGA,MAAI,OAAO,YAAY;AACrB,UAAM,gBAAiB,QAAQ,UAAU,CAAC;AAC1C,WAAO,SAAS,mBAAmB,OAAO,YAAY,eAAe;AAAA,MACnE,UAAU,KAAK;AAAA,IACjB,CAAC;AAAA,EACH;AAGA,SAAO,YAAY,QAAQ,mBAAmB,OAAO,EAAE,GAAG;AAC5D;AAKO,SAAS,WAAW,MAAqB;AAC9C,MAAI;AACJ,MAAI;AACF,aAAS,KAAK,MAAM,IAAI;AAAA,EAC1B,SAAS,KAAc;AACrB,UAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,UAAM,IAAI,MAAM,uBAAuB,GAAG,EAAE;AAAA,EAC9C;AACA,SAAO,YAAY,QAAQ,cAAc;AAC3C;AAMO,SAAS,eAAe,OAAsB;AACnD,SAAO,KAAK,UAAU,OAAO,MAAM,CAAC;AACtC;","names":[]}

package/dist/{chunk-5WFRKURX.js → chunk-DLXZMS5K.js}

@@ -128,6 +128,8 @@ function isTemplateBlock(block) {
 }
 function createTemplateContext(theme, blockIndex, totalBlocks, viewport = VIEWPORT_PRESETS.landscape) {
   const orientation = getViewportOrientation(viewport);
+  const overrides = theme.renderStyle.layoutOverrides;
+  const baseLayout = getLayoutHints(orientation);
   return {
     theme,
     blockIndex,
@@ -135,7 +137,7 @@ function createTemplateContext(theme, blockIndex, totalBlocks, viewport = VIEWPO
     viewport,
     fontScale: calculateFontScale(viewport),
     orientation,
-    layout: getLayoutHints(orientation)
+    layout: overrides ? { ...baseLayout, ...overrides } : baseLayout
   };
 }
 function scaledFontSize2(basePx, context, isTitle = false) {
@@ -162,4 +164,4 @@ export {
   scaledFontSize2,
   isPersistentLayerTemplate
 };
-//# sourceMappingURL=chunk-5WFRKURX.js.map
+//# sourceMappingURL=chunk-DLXZMS5K.js.map

package/dist/chunk-DLXZMS5K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/Viewport.ts","../src/schemas/LayoutStrategy.ts","../src/schemas/BlockTemplates.ts"],"sourcesContent":["/**\n * Viewport Configuration\n *\n * Defines viewport dimensions for doc rendering across different aspect ratios.\n * Templates use this configuration to adapt their layouts appropriately.\n *\n * Supported aspect ratios:\n * - landscape (16:9) - Default, standard video/presentation format\n * - portrait (9:16) - Vertical video, mobile stories\n * - square (1:1) - Social media posts\n * - standard (4:3) - Legacy presentation format\n */\n\n/**\n * Viewport configuration for doc rendering.\n */\nexport interface ViewportConfig {\n  /** Canonical width in virtual pixels */\n  width: number;\n  /** Canonical height in virtual pixels */\n  height: number;\n  /** Human-readable name for debugging/display */\n  name: string;\n}\n\n/**\n * Standard viewport presets for common aspect ratios.\n */\nexport const VIEWPORT_PRESETS = {\n  /** 16:9 landscape (default, 1080p) */\n  landscape: { width: 1920, height: 1080, name: '16:9 Landscape' },\n  /** 9:16 portrait (vertical video, stories) */\n  portrait: { width: 1080, height: 1920, name: '9:16 Portrait' },\n  /** 1:1 square (social media) */\n  square: { width: 1080, height: 1080, name: '1:1 Square' },\n  /** 4:3 standard (legacy) */\n  standard: { width: 1440, height: 1080, name: '4:3 Standard' },\n} as const;\n\n/**\n * Viewport preset name.\n */\nexport type ViewportPreset = keyof typeof VIEWPORT_PRESETS;\n\n/**\n * Viewport orientation derived from aspect ratio.\n */\nexport type ViewportOrientation = 'landscape' | 'portrait' | 'square';\n\n/**\n * Get a viewport configuration from a preset name or return the config if already a ViewportConfig.\n */\nexport function getViewport(viewport: ViewportPreset | ViewportConfig): ViewportConfig {\n  if (typeof viewport === 'string') {\n    return VIEWPORT_PRESETS[viewport];\n  }\n  return viewport;\n}\n\n/**\n * Calculate font scale factor for a viewport.\n * Based on diagonal pixels relative to 1080p landscape reference.\n * This ensures text remains readable across different viewport sizes.\n */\nconst REFERENCE_DIAGONAL = Math.sqrt(1920 * 1920 + 1080 * 1080); // ~2203\n\nexport function calculateFontScale(viewport: ViewportConfig): number {\n  const currentDiagonal = Math.sqrt(\n    viewport.width * viewport.width + viewport.height * viewport.height,\n  );\n  return currentDiagonal / REFERENCE_DIAGONAL;\n}\n\n/**\n * Determine if viewport is landscape, portrait, or square.\n */\nexport function getViewportOrientation(viewport: ViewportConfig): ViewportOrientation {\n  const ratio = viewport.width / viewport.height;\n  // Allow small tolerance for \"square\" classification\n  if (Math.abs(ratio - 1) < 0.05) return 'square';\n  return ratio > 1 ? 'landscape' : 'portrait';\n}\n\n/**\n * Get aspect ratio as a string (e.g., \"16:9\", \"9:16\", \"1:1\").\n */\nexport function getAspectRatioString(viewport: ViewportConfig): string {\n  const gcd = (a: number, b: number): number => (b === 0 ? a : gcd(b, a % b));\n  const divisor = gcd(viewport.width, viewport.height);\n  return `${viewport.width / divisor}:${viewport.height / divisor}`;\n}\n","/**\n * Layout Strategy\n *\n * Provides orientation-specific layout hints for slide templates.\n * Templates use these hints to position content appropriately for\n * different aspect ratios (landscape, portrait, square).\n *\n * Key adaptations by orientation:\n * - Portrait: Larger relative text, stacked layouts instead of side-by-side\n * - Square: Balanced layout with moderate adjustments\n * - Landscape: Default/reference layout\n */\n\nimport type { ViewportOrientation, ViewportConfig } from './Viewport.js';\nimport { calculateFontScale } from './Viewport.js';\n\n/**\n * Layout hints for template positioning based on orientation.\n */\nexport interface LayoutHints {\n  /** Primary content Y position (percentage string, e.g., \"35%\") */\n  primaryY: string;\n  /** Secondary content Y position (percentage string) */\n  secondaryY: string;\n  /** Tertiary/detail Y position (percentage string) */\n  tertiaryY: string;\n  /** Title font size multiplier (relative to base) */\n  titleScale: number;\n  /** Body text font size multiplier (relative to base) */\n  bodyScale: number;\n  /** Two-column: left X position (percentage string) */\n  columnLeftX: string;\n  /** Two-column: right X position (percentage string) */\n  columnRightX: string;\n  /** Two-column in portrait: top Y position for stacked layout */\n  columnTopY: string;\n  /** Two-column in portrait: bottom Y position for stacked layout */\n  columnBottomY: string;\n  /** Whether two-column should stack vertically */\n  stackColumns: boolean;\n  /** Max text width (percentage string) for wrapping */\n  maxTextWidth: string;\n  /** Horizontal padding from edges (percentage string) */\n  horizontalPadding: string;\n  /** Caption position Y for imageWithCaption (percentage string) */\n  captionY: string;\n  /** Caption font size multiplier */\n  captionScale: number;\n}\n\n/**\n * Layout configurations by orientation.\n */\nconst LAYOUT_CONFIGS: Record<ViewportOrientation, LayoutHints> = {\n  landscape: {\n    primaryY: '35%',\n    secondaryY: '55%',\n    tertiaryY: '75%',\n    titleScale: 1.0,\n    bodyScale: 1.0,\n    columnLeftX: '25%',\n    columnRightX: '75%',\n    columnTopY: '35%',\n    columnBottomY: '65%',\n    stackColumns: false,\n    maxTextWidth: '80%',\n    horizontalPadding: '10%',\n    captionY: '85%',\n    captionScale: 1.0,\n  },\n  portrait: {\n    // Content positioned higher for thumb-reach zone on mobile\n    primaryY: '25%',\n    secondaryY: '42%',\n    tertiaryY: '58%',\n    // Titles scale down for narrower width; body text scales up to fill vertical space\n    titleScale: 0.7,\n    bodyScale: 1.5,\n    // Stacked columns instead of side-by-side\n    columnLeftX: '50%',\n    columnRightX: '50%',\n    columnTopY: '30%',\n    columnBottomY: '55%',\n    stackColumns: true,\n    // Wider relative to viewport to use available space\n    maxTextWidth: '90%',\n    horizontalPadding: '5%',\n    captionY: '75%',\n    captionScale: 0.85,\n  },\n  square: {\n    primaryY: '30%',\n    secondaryY: '50%',\n    tertiaryY: '70%',\n    titleScale: 0.85,\n    bodyScale: 0.9,\n    columnLeftX: '25%',\n    columnRightX: '75%',\n    columnTopY: '35%',\n    columnBottomY: '65%',\n    stackColumns: false,\n    maxTextWidth: '85%',\n    horizontalPadding: '7.5%',\n    captionY: '82%',\n    captionScale: 0.9,\n  },\n};\n\n/**\n * Get layout hints for a given orientation.\n */\nexport function getLayoutHints(orientation: ViewportOrientation): LayoutHints {\n  return LAYOUT_CONFIGS[orientation];\n}\n\n/**\n * Calculate a scaled font size based on viewport and layout hints.\n *\n * @param basePx - Base font size in pixels (designed for 1920x1080)\n * @param viewport - Target viewport configuration\n * @param orientation - Viewport orientation\n * @param isTitle - Whether this is title text (uses titleScale) or body (uses bodyScale)\n */\nexport function scaledFontSize(\n  basePx: number,\n  viewport: ViewportConfig,\n  orientation: ViewportOrientation,\n  isTitle: boolean = false,\n): number {\n  const fontScale = calculateFontScale(viewport);\n  const layout = getLayoutHints(orientation);\n  const typeScale = isTitle ? layout.titleScale : layout.bodyScale;\n  return Math.round(basePx * fontScale * typeScale);\n}\n\n/**\n * Get position for two-column layout based on orientation.\n * Returns { left: {x, y}, right: {x, y} } positions.\n */\nexport function getTwoColumnPositions(orientation: ViewportOrientation): {\n  left: { x: string; y: string };\n  right: { x: string; y: string };\n} {\n  const layout = getLayoutHints(orientation);\n\n  if (layout.stackColumns) {\n    // Portrait: stack vertically\n    return {\n      left: { x: '50%', y: layout.columnTopY },\n      right: { x: '50%', y: layout.columnBottomY },\n    };\n  }\n\n  // Landscape/square: side by side\n  return {\n    left: { x: layout.columnLeftX, y: '50%' },\n    right: { x: layout.columnRightX, y: '50%' },\n  };\n}\n\n/**\n * Get safe text bounds for a given orientation.\n * Returns margins to keep text away from edges.\n */\nexport function getSafeTextBounds(orientation: ViewportOrientation): {\n  left: string;\n  right: string;\n  top: string;\n  bottom: string;\n} {\n  const layout = getLayoutHints(orientation);\n  return {\n    left: layout.horizontalPadding,\n    right: layout.horizontalPadding,\n    top: '10%',\n    bottom: '10%',\n  };\n}\n","/**\n * Block Templates Schema\n *\n * Defines a template system for AI-generated doc blocks. Instead of\n * specifying low-level layers, positions, and animations, AI can use\n * high-level templates like \"title\" or \"statHighlight\" with simple\n * content parameters.\n *\n * Templates are expanded into full Block structures at render time,\n * ensuring consistent styling and reducing AI generation errors.\n *\n * Template Types:\n * - title: Doc intro with title + subtitle\n * - sectionHeader: Colored section divider\n * - statHighlight: Big number/stat with description\n * - quote: Large centered quote\n * - factCard: Key fact with explanation\n * - twoColumn: Side-by-side comparison\n * - dateEvent: Timeline-style date + description\n * - imageWithCaption: Image with text overlay\n */\n\nimport type { Layer, Block, Transition, MapTileStyle, MapMarker, MarkerStyle } from './Doc.js';\nimport type { ViewportConfig, ViewportOrientation } from './Viewport.js';\nimport type { LayoutHints } from './LayoutStrategy.js';\nimport type { Theme } from './Theme.js';\nimport { VIEWPORT_PRESETS, getViewportOrientation, calculateFontScale } from './Viewport.js';\nimport { getLayoutHints, scaledFontSize as scaleFontSize } from './LayoutStrategy.js';\n\n/**\n * Name of a color scheme defined in the active theme's `colorSchemes` map.\n * Templates reference schemes by name (e.g. 'blue', 'green') and the theme\n * resolves them to actual colors at render time via `resolveColorScheme()`.\n */\nexport type ColorScheme = string;\n\n/**\n * Default font family for doc text.\n * PT Serif provides a classic, readable appearance for documentary-style content.\n * Used as a fallback in TextLayer when no font is specified.\n */\nexport const DEFAULT_DOC_FONT = 'system-ui, -apple-system, \"Segoe UI\", Roboto, sans-serif';\n\n/**\n * Default font family for titles.\n */\nexport const DEFAULT_TITLE_FONT = 'Georgia, \"Times New Roman\", serif';\n\n// ============================================\n// Accent Image System\n// ============================================\n\n/**\n * Position options for accent images on text-based blocks.\n * Accents are tasteful image additions that complement rather than overwhelm text.\n */\nexport type AccentPosition =\n  | 'left-strip' // Vertical strip on left (25-30% width), text shifts right\n  | 'right-strip' // Vertical strip on right (25-30% width), text shifts left\n  | 'bottom-strip' // Horizontal strip at bottom (25-30% height), text shifts up\n  | 'corner-inset'; // Small inset image in corner with vignette edge\n\n/**\n * Accent image configuration for text-based blocks.\n * When present, the template adjusts layout to accommodate the image tastefully.\n */\nexport interface AccentImage {\n  /** Path to image file (relative to article media dir) */\n  src: string;\n  /** Alt text for accessibility */\n  alt: string;\n  /** Where to position the accent image */\n  position: AccentPosition;\n  /** Ambient motion effect (subtle Ken Burns) */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n  /** Photo credit / artist name */\n  credit?: string;\n  /** License identifier (e.g., 'CC BY-SA 4.0') */\n  license?: string;\n}\n\n// ============================================\n// Template Input Types\n// ============================================\n\n/**\n * Base properties shared by all template blocks.\n */\ninterface BaseTemplateBlock {\n  /** Unique block ID */\n  id: string;\n  /** Block duration in seconds */\n  duration: number;\n  /** Which audio segment this block belongs to */\n  audioSegment: number;\n  /** Entry transition */\n  transition?: Transition;\n  /** Show doc's bottom layers (default: true) */\n  useBottomLayer?: boolean;\n  /** Show doc's top layers (default: true) */\n  useTopLayer?: boolean;\n  /**\n   * Start time within the audio segment when this content is spoken.\n   * Used to sync the block appearance with the narration.\n   * If not provided, blocks are distributed evenly across the segment.\n   */\n  sourceStartTime?: number;\n  /**\n   * Duration of the spoken content this block represents.\n   * Used with sourceStartTime to precisely position the block.\n   */\n  sourceDuration?: number;\n  /**\n   * Per-block override for the theme's photographic image grade\n   * (`theme.style.imageTreatment`). `'none'` opts this block's imagery out;\n   * a treatment type forces that grade regardless of the theme.\n   */\n  imageTreatment?: 'none' | 'mono' | 'duotone' | 'warm' | 'cool';\n}\n\n/**\n * Title block - doc intro with large title and subtitle.\n */\nexport interface TitleBlockInput extends BaseTemplateBlock {\n  template: 'title';\n  /** Main title text */\n  title: string;\n  /** Subtitle or tagline (supports \\n for line breaks) */\n  subtitle?: string;\n  /** Background color (defaults to theme primary) */\n  backgroundColor?: string;\n}\n\n/**\n * Section header - section title card with optional background image.\n * Displays the section title prominently, optionally over an image.\n */\nexport interface SectionHeaderInput extends BaseTemplateBlock {\n  template: 'sectionHeader';\n  /** Section title */\n  title: string;\n  /** Color scheme for the section (used for fallback background) */\n  colorScheme?: ColorScheme;\n  /** Optional background image path */\n  imageSrc?: string;\n  /** Alt text for background image */\n  imageAlt?: string;\n  /** Ambient motion for background image */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n}\n\n/**\n * Stat highlight - big number with description and optional detail.\n */\nexport interface StatHighlightInput extends BaseTemplateBlock {\n  template: 'statHighlight';\n  /** The statistic (e.g., \"89%\", \"2x\", \"7 miles\") */\n  stat: string;\n  /** Description of what the stat means */\n  description: string;\n  /** Additional detail or context */\n  detail?: string;\n  /** Color scheme for the stat */\n  colorScheme?: ColorScheme;\n  /** Optional accent image to complement the text */\n  accentImage?: AccentImage;\n}\n\n/**\n * Quote block - large centered quote text.\n */\nexport interface QuoteBlockInput extends BaseTemplateBlock {\n  template: 'quote';\n  /** The quote text (supports \\n for line breaks) */\n  quote: string;\n  /** Attribution (author, source) */\n  attribution?: string;\n  /** Optional accent image to complement the text */\n  accentImage?: AccentImage;\n}\n\n/**\n * Fact card - key fact with explanation.\n */\nexport interface FactCardInput extends BaseTemplateBlock {\n  template: 'factCard';\n  /** The main fact or statement */\n  fact: string;\n  /** Explanation or context */\n  explanation: string;\n  /** Optional source citation */\n  source?: string;\n  /** Optional accent image to complement the text */\n  accentImage?: AccentImage;\n}\n\n/**\n * Two column - side-by-side comparison.\n */\nexport interface TwoColumnInput extends BaseTemplateBlock {\n  template: 'twoColumn';\n  /** Left column content */\n  left: {\n    label: string;\n    sublabel?: string;\n  };\n  /** Right column content */\n  right: {\n    label: string;\n    sublabel?: string;\n  };\n  /** Optional header above columns */\n  header?: string;\n  /** Color schemes for left and right */\n  leftColor?: ColorScheme;\n  rightColor?: ColorScheme;\n}\n\n/**\n * Date event - timeline-style date with description.\n */\nexport interface DateEventInput extends BaseTemplateBlock {\n  template: 'dateEvent';\n  /** The date (e.g., \"July 14, 1974\") */\n  date: string;\n  /** Description of what happened (supports \\n) */\n  description: string;\n  /** Optional footer text */\n  footer?: string;\n  /** Mood: 'neutral', 'somber', 'celebratory' */\n  mood?: 'neutral' | 'somber' | 'celebratory';\n  /** Optional accent image to complement the text */\n  accentImage?: AccentImage;\n}\n\n/**\n * Image with caption - background image with text overlay.\n */\nexport interface ImageWithCaptionInput extends BaseTemplateBlock {\n  template: 'imageWithCaption';\n  /** Path to image file */\n  imageSrc: string;\n  /** Alt text for accessibility */\n  imageAlt: string;\n  /** Caption text */\n  caption?: string;\n  /** Caption position */\n  captionPosition?: 'bottom' | 'top' | 'center';\n  /** Ambient motion effect: slow zoom or pan for visual interest */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n  /** When true, style caption as a title (larger, centered, prominent) */\n  isTitle?: boolean;\n  /** Optional subtitle shown below the title (only when isTitle is true) */\n  subtitle?: string;\n  /** Photo credit / artist name */\n  imageCredit?: string;\n  /** License identifier (e.g., 'CC BY-SA 4.0') */\n  imageLicense?: string;\n}\n\n/**\n * Shared fields for left/right feature blocks. A \"feature\" pairs an\n * image on one side of the block with a title and body paragraph on\n * the other — a common editorial layout for product highlights,\n * profile callouts, or section intros.\n */\ninterface FeatureInputBase extends BaseTemplateBlock {\n  /** Path to the feature image. */\n  imageSrc: string;\n  /** Alt text for accessibility. */\n  imageAlt?: string;\n  /**\n   * Explicit display width of the image, in pixels (typically pulled\n   * from a `<img width>` attribute when the WYSIWYG editor resized it).\n   * When set, the renderer treats the image as a sized asset and\n   * centers it inside its half with padding instead of stretching it\n   * to fill the cell.\n   */\n  imageWidth?: number;\n  /** Explicit display height of the image, in pixels. */\n  imageHeight?: number;\n  /** Heading / title text shown next to the image. */\n  title?: string;\n  /** Body text shown below the title. */\n  body?: string;\n}\n\n/**\n * Left feature — image on the left, title + body stacked on the right.\n */\nexport interface LeftFeatureInput extends FeatureInputBase {\n  template: 'leftFeature';\n}\n\n/**\n * Right feature — image on the right, title + body stacked on the left.\n */\nexport interface RightFeatureInput extends FeatureInputBase {\n  template: 'rightFeature';\n}\n\n/**\n * Map block - geographic map showing article location.\n *\n * Displays a map centered on given coordinates with optional title,\n * caption, and markers. Great for establishing geographic context.\n * See docs/MAP_TILES.md for available tile styles and attribution.\n */\nexport interface MapBlockInput extends BaseTemplateBlock {\n  template: 'map';\n  /** Map center coordinates */\n  center: {\n    lat: number;\n    lng: number;\n  };\n  /** Zoom level (4-16, typically 8-12 for regional context) */\n  zoom: number;\n  /** Map tile style (default: 'terrain') */\n  mapStyle?: MapTileStyle;\n  /** Optional title overlay at top */\n  title?: string;\n  /** Optional caption at bottom */\n  caption?: string;\n  /** Optional markers to show on map */\n  markers?: MapMarker[];\n  /** Ambient motion effect: slow zoom or pan for visual interest */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n  /** Pre-rendered static image path (set by prerender-maps command) */\n  staticSrc?: string;\n}\n\n/**\n * Full-bleed quote - dramatic short text filling the viewport.\n * Like a movie title card. For short, punchy sentences < 60 chars.\n */\nexport interface FullBleedQuoteInput extends BaseTemplateBlock {\n  template: 'fullBleedQuote';\n  /** Short dramatic text (< 60 chars recommended) */\n  text: string;\n  /** Color scheme for text tint */\n  colorScheme?: ColorScheme;\n}\n\n/**\n * List block - 3-5 items stacked vertically with subtle numbering.\n * Good for enumerations like \"things to see\" or \"key features\".\n */\nexport interface ListBlockInput extends BaseTemplateBlock {\n  template: 'list';\n  /** List items (3-5 recommended) */\n  items: string[];\n  /** Optional header above the list */\n  title?: string;\n  /** Color scheme for numbering accents */\n  colorScheme?: ColorScheme;\n  /** Optional accent image */\n  accentImage?: AccentImage;\n}\n\n/**\n * Photo grid - 2-4 images in a tiled layout.\n * Used when multiple images are available for visual variety.\n */\nexport interface PhotoGridInput extends BaseTemplateBlock {\n  template: 'photoGrid';\n  /** Images to display (2-4) */\n  images: { src: string; alt: string; credit?: string; license?: string }[];\n  /** Optional caption below the grid */\n  caption?: string;\n  /** Ambient motion effect for the largest image */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n}\n\n/**\n * Definition card - dictionary-style term with definition.\n * Large term at top, definition below, optional origin note.\n */\nexport interface DefinitionCardInput extends BaseTemplateBlock {\n  template: 'definitionCard';\n  /** The term being defined */\n  term: string;\n  /** The definition text */\n  definition: string;\n  /** Optional etymology or origin note */\n  origin?: string;\n  /** Color scheme for term accent */\n  colorScheme?: ColorScheme;\n  /** Optional accent image */\n  accentImage?: AccentImage;\n}\n\n/**\n * Comparison bar - two horizontal bars showing relative numeric values.\n * Good for side-by-side numeric comparisons with visual weight.\n */\nexport interface ComparisonBarInput extends BaseTemplateBlock {\n  template: 'comparisonBar';\n  /** Left bar label */\n  leftLabel: string;\n  /** Left bar numeric value */\n  leftValue: number;\n  /** Right bar label */\n  rightLabel: string;\n  /** Right bar numeric value */\n  rightValue: number;\n  /** Unit label (e.g., \"km\", \"people\") */\n  unit?: string;\n  /** Color scheme */\n  colorScheme?: ColorScheme;\n}\n\n/**\n * Pull quote - quote text over a full-bleed background image with dark overlay.\n * Cinematic alternative to quoteBlock when a high-quality image is available.\n */\nexport interface PullQuoteInput extends BaseTemplateBlock {\n  template: 'pullQuote';\n  /** Quote text */\n  text: string;\n  /** Optional attribution */\n  attribution?: string;\n  /** Background image (fills entire viewport) */\n  backgroundImage: { src: string; alt: string; credit?: string; license?: string };\n  /** Ambient motion for background image */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n}\n\n/**\n * Video with caption - background video clip with text overlay.\n * Plays a short clip from a source video, always muted (narration is the audio track).\n * Mirrors ImageWithCaptionInput but with video-specific fields.\n */\nexport interface VideoWithCaptionInput extends BaseTemplateBlock {\n  template: 'videoWithCaption';\n  /** Path to video file */\n  videoSrc: string;\n  /** Path to poster frame (shown before video loads) */\n  posterSrc?: string;\n  /** Alt text for accessibility */\n  videoAlt: string;\n  /** Start time within source video (seconds) */\n  clipStart: number;\n  /** End time within source video (seconds) */\n  clipEnd: number;\n  /** Source video total duration (for validation) */\n  sourceDuration?: number;\n  /** Caption text overlay */\n  caption?: string;\n  /** Caption position */\n  captionPosition?: 'bottom' | 'top' | 'center';\n  /** Video credit / artist name */\n  videoCredit?: string;\n  /** License identifier */\n  videoLicense?: string;\n}\n\n/**\n * Video pull quote - quote text over a video clip background with dark overlay.\n * Cinematic alternative to pullQuote when a video clip is available.\n */\nexport interface VideoPullQuoteInput extends BaseTemplateBlock {\n  template: 'videoPullQuote';\n  /** Quote text */\n  text: string;\n  /** Optional attribution */\n  attribution?: string;\n  /** Background video clip */\n  backgroundVideo: {\n    src: string;\n    posterSrc?: string;\n    alt: string;\n    clipStart: number;\n    clipEnd: number;\n    credit?: string;\n    license?: string;\n  };\n}\n\n/**\n * Diagram block - renders child headings as a node-and-edge diagram.\n *\n * Unlike other templates, the diagram template reads its content from\n * the parent block's `children` (passed via `context.children`) — each\n * child heading becomes a node, positioned by its `x`/`y` and connected\n * by its `connectsTo`. Per-diagram options on this input control overall\n * appearance; per-node data lives on the child blocks themselves.\n */\nexport interface DiagramBlockInput extends BaseTemplateBlock {\n  template: 'diagram';\n  /** Optional diagram title displayed above the canvas. */\n  title?: string;\n  /** Color scheme for nodes and edges. */\n  colorScheme?: ColorScheme;\n  /** Node shape style (default: 'rounded'). */\n  nodeShape?: 'rounded' | 'rect' | 'pill';\n  /** Edge routing (default: 'curved'). */\n  edgeStyle?: 'curved' | 'straight' | 'orthogonal';\n  /** Marker at each edge's start (default: 'none'). */\n  startStyle?: MarkerStyle;\n  /** Marker at each edge's end (default: 'arrow'). */\n  endStyle?: MarkerStyle;\n  /** Edge line style (default: 'solid'). */\n  lineStyle?: 'solid' | 'dashed' | 'dotted';\n}\n\n/**\n * Free-form 2D canvas block (`layout`). Like `drawing`/`diagram`, the\n * `layout` template is a children-driven container: each child heading is\n * one absolutely-positioned layer (`{[text …]}` / `{[rectangle …]}` /\n * `{[image …]}`), read from `context.children`. A text box's content is the\n * child's body markdown. Backed by the `layoutBlock` template.\n *\n * (Legacy documents stored layers as a base64-JSON `layers=` param on the\n * heading; the editor auto-migrates those to child sub-blocks on first edit.)\n */\nexport interface RawLayersInput extends BaseTemplateBlock {\n  template: 'layout';\n}\n\n/**\n * Drawing block — renders child headings as free-form shapes on a canvas.\n *\n * Like `diagram`, the drawing template reads its content from the parent\n * block's `children` (passed via `context.children`). Each child heading\n * is a shape: its `{[shape …]}` annotation names the primitive\n * (`rectangle`/`rect`, `circle`, `line`, `arrow`, `path`, `text`) and\n * carries geometry/style as params; its `{#id}` makes it referenceable;\n * its heading text is the shape label and its body text an optional\n * sublabel. Connectors (`line`/`arrow` with `from`/`to`) join shapes by id.\n *\n * Coordinates are author-defined units; the template fits the bounding box\n * of all shapes to the viewport (same scaling as `diagram`), so authors\n * don't have to think in absolute pixels.\n *\n * Legacy drawings authored visually persist their `Layer[]` as a base64\n * `layers=\"…\"` Pandoc param instead of children; the template decodes and\n * returns those directly when no children are present (see `drawingBlock`).\n */\nexport interface DrawingBlockInput extends BaseTemplateBlock {\n  template: 'drawing';\n  /** Optional title displayed above the canvas. */\n  title?: string;\n  /** Color scheme for shapes that don't pin their own fill/stroke. */\n  colorScheme?: ColorScheme;\n  /** Default fill for shapes that don't specify one (default: 'none'). */\n  fill?: string;\n  /** Default stroke for shapes that don't specify one (default: theme text). */\n  stroke?: string;\n}\n\n/**\n * Data table - renders a themed table with headers and rows.\n * Ideal for structured data, comparisons, and reference information.\n */\nexport interface DataTableInput extends BaseTemplateBlock {\n  template: 'dataTable';\n  /** Optional title displayed above the table */\n  title?: string;\n  /** Header cell values */\n  headers: string[];\n  /** Data rows (array of cell value arrays) */\n  rows: string[][];\n  /** Per-column alignment */\n  align?: (('left' | 'right' | 'center') | null)[];\n  /** Color scheme for the table header */\n  colorScheme?: ColorScheme;\n}\n\n/**\n * Union of all template block types.\n */\nexport type TemplateBlock =\n  | TitleBlockInput\n  | SectionHeaderInput\n  | StatHighlightInput\n  | QuoteBlockInput\n  | FactCardInput\n  | TwoColumnInput\n  | DateEventInput\n  | ImageWithCaptionInput\n  | LeftFeatureInput\n  | RightFeatureInput\n  | MapBlockInput\n  | FullBleedQuoteInput\n  | ListBlockInput\n  | PhotoGridInput\n  | DefinitionCardInput\n  | ComparisonBarInput\n  | PullQuoteInput\n  | VideoWithCaptionInput\n  | VideoPullQuoteInput\n  | DataTableInput\n  | DiagramBlockInput\n  | DrawingBlockInput\n  | RawLayersInput;\n\n/**\n * A block can be either a raw Block or a TemplateBlock.\n */\nexport type DocBlock = Block | TemplateBlock;\n\n/**\n * Check if a block is a template block.\n */\nexport function isTemplateBlock(block: DocBlock): block is TemplateBlock {\n  return 'template' in block && typeof block.template === 'string';\n}\n\n// ============================================\n// Template Function Type\n// ============================================\n\n/**\n * Template context passed to template functions.\n * Includes viewport information for multi-aspect ratio support.\n */\nexport interface TemplateContext {\n  /** Full theme (colors, typography, style, renderStyle, colorSchemes) */\n  theme: Theme;\n  /** Block index in the doc */\n  blockIndex: number;\n  /** Total number of blocks */\n  totalBlocks: number;\n  /** Target viewport configuration */\n  viewport: ViewportConfig;\n  /** Computed font scale factor for this viewport */\n  fontScale: number;\n  /** Viewport orientation (landscape, portrait, square) */\n  orientation: ViewportOrientation;\n  /** Layout hints for this orientation */\n  layout: LayoutHints;\n  /**\n   * The block's direct children (set by `getLayers` when the block has\n   * `children`). Most templates ignore this; aggregate templates like\n   * `diagram` consume it to render each child as part of their output.\n   */\n  children?: Block[];\n  /**\n   * The source block being expanded. Used by user-defined custom\n   * templates so the token resolver can substitute `{title}`,\n   * `{content}`, `{children}`, and `{image:N}` against the block's\n   * data at render time. Built-in templates ignore this and rely on\n   * their typed `input` parameters instead.\n   */\n  block?: Block;\n}\n\n/**\n * Create a template context with viewport-derived values.\n */\nexport function createTemplateContext(\n  theme: Theme,\n  blockIndex: number,\n  totalBlocks: number,\n  viewport: ViewportConfig = VIEWPORT_PRESETS.landscape,\n): TemplateContext {\n  const orientation = getViewportOrientation(viewport);\n  // Theme renderStyle may override individual layout hints (e.g. a theme\n  // that wants a lower primaryY across every template).\n  const overrides = theme.renderStyle.layoutOverrides;\n  const baseLayout = getLayoutHints(orientation);\n  return {\n    theme,\n    blockIndex,\n    totalBlocks,\n    viewport,\n    fontScale: calculateFontScale(viewport),\n    orientation,\n    layout: overrides ? { ...baseLayout, ...overrides } : baseLayout,\n  };\n}\n\n/**\n * Calculate a scaled font size for the given context.\n * Use this in templates to ensure text scales appropriately.\n *\n * @param basePx - Base font size in pixels (designed for 1920x1080)\n * @param context - Template context with viewport info\n * @param isTitle - Whether this is title text (larger scale) or body text\n */\nexport function scaledFontSize(\n  basePx: number,\n  context: TemplateContext,\n  isTitle: boolean = false,\n): number {\n  return scaleFontSize(basePx, context.viewport, context.orientation, isTitle);\n}\n\n/**\n * Template function signature.\n * Takes template input and returns layers array.\n */\nexport type TemplateFunction<T extends TemplateBlock> = (\n  input: T,\n  context: TemplateContext,\n) => Layer[];\n\n/**\n * Registry of all template functions.\n */\nexport type TemplateRegistry = {\n  [K in TemplateBlock['template']]: TemplateFunction<Extract<TemplateBlock, { template: K }>>;\n};\n\n// ============================================\n// Persistent Layer System\n// ============================================\n\n/**\n * Configuration for persistent doc-wide layers.\n * Bottom layers render behind all block content, top layers on top.\n */\nexport interface PersistentLayerConfig {\n  /** Layers rendered behind all block content */\n  bottomLayers?: PersistentLayer[];\n  /** Layers rendered on top of all block content */\n  topLayers?: PersistentLayer[];\n}\n\n/**\n * A persistent layer - either a template or raw Layer.\n */\nexport type PersistentLayer = PersistentLayerTemplate | Layer;\n\n/**\n * Check if a persistent layer is a template.\n */\nexport function isPersistentLayerTemplate(\n  layer: PersistentLayer,\n): layer is PersistentLayerTemplate {\n  return 'template' in layer && typeof layer.template === 'string';\n}\n\n/**\n * Template-based persistent layer for easy configuration.\n */\nexport interface PersistentLayerTemplate {\n  template: PersistentLayerTemplateType;\n  config: PersistentLayerTemplateConfig;\n}\n\n/**\n * Available persistent layer template types.\n */\nexport type PersistentLayerTemplateType =\n  | 'solidBackground' // Solid color fill\n  | 'gradientBackground' // CSS gradient or preset\n  | 'imageBackground' // Blurred/faded hero image\n  | 'patternBackground' // Subtle pattern (dots, grid, diagonal, noise/grain)\n  | 'vignette' // Soft radial edge darkening (top layer)\n  | 'ambientGradient' // Slowly drifting surface gradient (bottom layer)\n  | 'titleCaption' // Article title in corner\n  | 'cornerBranding' // Logo or text badge\n  | 'progressIndicator'; // Bar/dots showing position\n\n/**\n * Union of all persistent layer template configs.\n */\nexport type PersistentLayerTemplateConfig =\n  | SolidBackgroundConfig\n  | GradientBackgroundConfig\n  | ImageBackgroundConfig\n  | PatternBackgroundConfig\n  | VignetteConfig\n  | AmbientGradientConfig\n  | TitleCaptionConfig\n  | CornerBrandingConfig\n  | ProgressIndicatorConfig;\n\n// ============================================\n// Background Layer Configs\n// ============================================\n\n/**\n * Solid color background.\n */\nexport interface SolidBackgroundConfig {\n  type: 'solidBackground';\n  /** CSS color value */\n  color: string;\n}\n\n/**\n * Gradient background (CSS gradient or preset).\n */\nexport interface GradientBackgroundConfig {\n  type: 'gradientBackground';\n  /** Custom CSS gradient string */\n  gradient?: string;\n  /** Preset gradient name */\n  preset?: 'dark-vignette' | 'radial-dark' | 'warm-sunset' | 'cool-blue' | 'earth-tones';\n}\n\n/**\n * Image background (blurred/faded hero image).\n */\nexport interface ImageBackgroundConfig {\n  type: 'imageBackground';\n  /** Path to image file */\n  src: string;\n  /** Blur radius in pixels (0-20) */\n  blur?: number;\n  /** Opacity (0-1) */\n  opacity?: number;\n  /** Ambient motion effect */\n  ambientMotion?: 'zoomIn' | 'zoomOut' | 'panLeft' | 'panRight';\n}\n\n/**\n * Pattern background (subtle repeating pattern).\n */\nexport interface PatternBackgroundConfig {\n  type: 'patternBackground';\n  /** Pattern type */\n  pattern: 'dots' | 'grid' | 'diagonal' | 'noise';\n  /** Pattern color */\n  color?: string;\n  /** Pattern opacity (0-1) */\n  opacity?: number;\n  /** Pattern scale multiplier */\n  scale?: number;\n}\n\n/**\n * Soft radial vignette (top layer) — transparent center darkening toward\n * the frame edges. The classic film-look framing device.\n */\nexport interface VignetteConfig {\n  type: 'vignette';\n  /** Edge darkness 0-1 (default 0.3). */\n  strength?: number;\n  /** Vignette color (default black). */\n  color?: string;\n}\n\n/**\n * Slowly drifting surface gradient (bottom layer). Colors default to the\n * theme's surface family at expansion time.\n */\nexport interface AmbientGradientConfig {\n  type: 'ambientGradient';\n  /** Gradient start color. */\n  from?: string;\n  /** Gradient end color. */\n  to?: string;\n  /** Drift loop duration in seconds (default 40). */\n  duration?: number;\n}\n\n// ============================================\n// Overlay Layer Configs\n// ============================================\n\n/**\n * Title caption overlay (article title in corner).\n */\nexport interface TitleCaptionConfig {\n  type: 'titleCaption';\n  /** Title text */\n  title: string;\n  /** Subtitle text (e.g., short URL like \"qual..la/slug\") */\n  subtitle?: string;\n  /** Position on screen */\n  position: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';\n  /** Font size in pixels (default: 18) */\n  fontSize?: number;\n  /** Show thumbnail alongside title */\n  showThumbnail?: boolean;\n  /** Thumbnail image path */\n  thumbnailSrc?: string;\n}\n\n/**\n * Corner branding overlay (logo or text badge).\n */\nexport interface CornerBrandingConfig {\n  type: 'cornerBranding';\n  /** Text content or image path */\n  content: string;\n  /** Position on screen */\n  position: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';\n  /** Whether content is an image path (vs text) */\n  isImage?: boolean;\n}\n\n/**\n * Progress indicator overlay (bar or dots showing position).\n */\nexport interface ProgressIndicatorConfig {\n  type: 'progressIndicator';\n  /** Indicator style */\n  style: 'bar' | 'dots' | 'fraction';\n  /** Position on screen */\n  position: 'bottom' | 'top';\n  /** Indicator color */\n  color?: string;\n}\n"],"mappings":"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","names":["scaledFontSize"]}

package/dist/chunk-ET53IIEP.js

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

package/dist/chunk-ET53IIEP.js.map

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

package/dist/chunk-HWVFJAAH.js

@@ -0,0 +1,362 @@
+// src/markdown/htmlParse.ts
+import { fromHtml } from "hast-util-from-html";
+var HAST_PROP_TO_ATTR = {
+  className: "class",
+  htmlFor: "for",
+  httpEquiv: "http-equiv",
+  acceptCharset: "accept-charset"
+};
+var VOID_ELEMENTS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "param",
+  "source",
+  "track",
+  "wbr"
+]);
+function propertyToAttribute(prop) {
+  if (HAST_PROP_TO_ATTR[prop]) return HAST_PROP_TO_ATTR[prop];
+  if (prop.length > 4 && prop.startsWith("data") && prop[4] >= "A" && prop[4] <= "Z") {
+    return "data-" + prop.slice(4).replace(/[A-Z]/g, (m) => "-" + m.toLowerCase()).replace(/^-/, "");
+  }
+  if (prop.length > 4 && prop.startsWith("aria") && prop[4] >= "A" && prop[4] <= "Z") {
+    return "aria-" + prop.slice(4).replace(/[A-Z]/g, (m) => "-" + m.toLowerCase()).replace(/^-/, "");
+  }
+  return prop.toLowerCase();
+}
+function convertHastProperties(properties) {
+  const attrs = {};
+  for (const [key, value] of Object.entries(properties)) {
+    if (value === false || value === void 0 || value === null) continue;
+    const attrName = propertyToAttribute(key);
+    if (value === true) {
+      attrs[attrName] = "";
+    } else if (Array.isArray(value)) {
+      attrs[attrName] = value.join(" ");
+    } else {
+      attrs[attrName] = String(value);
+    }
+  }
+  return attrs;
+}
+function hastChildrenToNodes(children) {
+  const result = [];
+  for (const child of children) {
+    const node = hastNodeToHtmlNode(child);
+    if (node) result.push(node);
+  }
+  return result;
+}
+function hastNodeToHtmlNode(node) {
+  switch (node.type) {
+    case "element": {
+      const tagName = node.tagName;
+      const properties = node.properties ?? {};
+      const children = node.children ?? [];
+      return {
+        type: "htmlElement",
+        tagName,
+        attributes: convertHastProperties(properties),
+        children: hastChildrenToNodes(children),
+        selfClosing: VOID_ELEMENTS.has(tagName) && children.length === 0
+      };
+    }
+    case "text":
+      return {
+        type: "htmlText",
+        value: node.value
+      };
+    case "comment":
+      return {
+        type: "htmlComment",
+        value: node.value
+      };
+    case "doctype":
+      return null;
+    default:
+      return null;
+  }
+}
+function parseHtmlToNodes(html) {
+  if (!html || !html.trim()) return [];
+  try {
+    const tree = fromHtml(html, { fragment: true });
+    return hastChildrenToNodes(tree.children);
+  } catch {
+    return [{ type: "htmlText", value: html }];
+  }
+}
+function escapeHtmlAttr(value) {
+  return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function stringifyNode(node) {
+  switch (node.type) {
+    case "htmlElement": {
+      const attrs = Object.entries(node.attributes).map(([k, v]) => v === "" ? k : `${k}="${escapeHtmlAttr(v)}"`).join(" ");
+      const open = attrs ? `<${node.tagName} ${attrs}>` : `<${node.tagName}>`;
+      if (node.selfClosing) return open;
+      const inner = node.children.map(stringifyNode).join("");
+      return `${open}${inner}</${node.tagName}>`;
+    }
+    case "htmlText":
+      return node.value;
+    case "htmlComment":
+      return `<!--${node.value}-->`;
+  }
+}
+function stringifyHtmlNodes(nodes) {
+  return nodes.map(stringifyNode).join("");
+}
+
+// src/markdown/utils.ts
+function getChildren(node) {
+  if ("children" in node && Array.isArray(node.children)) {
+    return node.children;
+  }
+  return [];
+}
+function walkMarkdownTree(node, visitor, parent) {
+  const skip = visitor(node, parent);
+  if (skip === true) return;
+  const children = getChildren(node);
+  for (const child of children) {
+    walkMarkdownTree(child, visitor, node);
+  }
+}
+function findNodesByType(root, type) {
+  const results = [];
+  walkMarkdownTree(root, (node) => {
+    if (node.type === type) {
+      results.push(node);
+    }
+  });
+  return results;
+}
+function extractPlainText(node) {
+  if ("value" in node && typeof node.value === "string") {
+    return node.value;
+  }
+  const children = getChildren(node);
+  const separator = node.type === "list" || node.type === "listItem" ? "\n" : "";
+  return children.map(extractPlainText).join(separator);
+}
+function countNodes(node) {
+  let count = 1;
+  const children = getChildren(node);
+  for (const child of children) {
+    count += countNodes(child);
+  }
+  return count;
+}
+function parseFrontmatter(yaml) {
+  if (!yaml || !yaml.trim()) return null;
+  const result = {};
+  const lines = yaml.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const colonIdx = trimmed.indexOf(":");
+    if (colonIdx < 1) continue;
+    const key = trimmed.slice(0, colonIdx).trim();
+    let value = trimmed.slice(colonIdx + 1).trim();
+    if (value === "|" || value === "|-") {
+      const keyIndent = line.length - line.trimStart().length;
+      const blockLines = [];
+      let j = i + 1;
+      for (; j < lines.length; j++) {
+        const bl = lines[j];
+        if (bl.trim() === "") {
+          blockLines.push("");
+          continue;
+        }
+        const indent = bl.length - bl.trimStart().length;
+        if (indent <= keyIndent) break;
+        blockLines.push(bl);
+      }
+      i = j - 1;
+      while (blockLines.length > 0 && blockLines[blockLines.length - 1] === "") {
+        blockLines.pop();
+      }
+      let commonIndent = Infinity;
+      for (const bl of blockLines) {
+        if (bl === "") continue;
+        commonIndent = Math.min(commonIndent, bl.length - bl.trimStart().length);
+      }
+      if (!isFinite(commonIndent)) commonIndent = 0;
+      result[key] = blockLines.map((bl) => bl === "" ? "" : bl.slice(commonIndent)).join("\n");
+      continue;
+    }
+    if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+      value = value.slice(1, -1);
+    }
+    if (value === "true") {
+      result[key] = true;
+    } else if (value === "false") {
+      result[key] = false;
+    } else if (value !== "" && !isNaN(Number(value))) {
+      result[key] = Number(value);
+    } else {
+      result[key] = value;
+    }
+  }
+  return Object.keys(result).length > 0 ? result : null;
+}
+function formatBlockScalar(value) {
+  const body = value.split("\n").map((line) => line === "" ? "" : `  ${line}`).join("\n");
+  return `|-
+${body}`;
+}
+var FRONTMATTER_BLOCK_RE = /^---\r?\n([\s\S]*?)\r?\n---(\r?\n)?/;
+function formatFrontmatterValue(value) {
+  if (typeof value === "boolean" || typeof value === "number") return String(value);
+  if (/[\r\n]/.test(value)) return formatBlockScalar(value.replace(/\r\n?/g, "\n"));
+  if (/^[{[]/.test(value) && !/[\r\n]/.test(value)) return value;
+  const needsQuote = /^\s|\s$/.test(value) || /^[!&*?|>%@`]/.test(value) || /[:#]/.test(value) || value === "" || value === "true" || value === "false" || /^-?\d+(\.\d+)?$/.test(value);
+  if (!needsQuote) return value;
+  const escaped = value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+  return `"${escaped}"`;
+}
+function setFrontmatterValues(source, updates) {
+  const updateKeys = Object.keys(updates);
+  if (updateKeys.length === 0) return source;
+  const match = source.match(FRONTMATTER_BLOCK_RE);
+  const handled = /* @__PURE__ */ new Set();
+  if (match) {
+    const inner = match[1];
+    const lines = inner.split(/\r?\n/);
+    const newLines = [];
+    for (const line of lines) {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) {
+        newLines.push(line);
+        continue;
+      }
+      const colonIdx = trimmed.indexOf(":");
+      if (colonIdx < 1) {
+        newLines.push(line);
+        continue;
+      }
+      const key = trimmed.slice(0, colonIdx).trim();
+      if (!Object.prototype.hasOwnProperty.call(updates, key)) {
+        newLines.push(line);
+        continue;
+      }
+      handled.add(key);
+      const next = updates[key];
+      if (next === null || next === void 0) continue;
+      newLines.push(`${key}: ${formatFrontmatterValue(next)}`);
+    }
+    for (const key of updateKeys) {
+      if (handled.has(key)) continue;
+      const next = updates[key];
+      if (next === null || next === void 0) continue;
+      newLines.push(`${key}: ${formatFrontmatterValue(next)}`);
+    }
+    const nonEmpty = newLines.filter((l) => l.trim().length > 0);
+    const rest = source.slice(match[0].length);
+    if (nonEmpty.length === 0) return rest;
+    return `---
+${newLines.join("\n")}
+---
+${rest}`;
+  }
+  const fresh = [];
+  for (const key of updateKeys) {
+    const next = updates[key];
+    if (next === null || next === void 0) continue;
+    fresh.push(`${key}: ${formatFrontmatterValue(next)}`);
+  }
+  if (fresh.length === 0) return source;
+  return `---
+${fresh.join("\n")}
+---
+${source}`;
+}
+function createDocument(...children) {
+  return {
+    type: "document",
+    children
+  };
+}
+function inferDocumentTitle(doc) {
+  const fmTitle = doc.frontmatter?.title;
+  if (typeof fmTitle === "string") {
+    const trimmed = fmTitle.trim();
+    if (trimmed) return trimmed;
+  }
+  let best = null;
+  for (const node of doc.children) {
+    if (node.type !== "heading") continue;
+    const text = extractPlainText(node).trim();
+    if (!text) continue;
+    if (best === null || node.depth < best.depth) {
+      best = { depth: node.depth, text };
+      if (best.depth === 1) break;
+    }
+  }
+  return best?.text;
+}
+function readFrontmatterThemeId(frontmatter) {
+  if (!frontmatter) return void 0;
+  const keys = ["squisq-theme", "themeId", "theme"];
+  for (const key of keys) {
+    const raw = frontmatter[key];
+    if (typeof raw === "string") {
+      const trimmed = raw.trim();
+      if (trimmed) return trimmed;
+    }
+  }
+  return void 0;
+}
+function plainTextFromInlineHtml(html) {
+  const BLOCK = /* @__PURE__ */ new Set([
+    "p",
+    "div",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "li",
+    "blockquote",
+    "pre"
+  ]);
+  const walk = (nodes) => nodes.map((n) => {
+    if (n.type === "htmlText") return n.value;
+    if (n.type !== "htmlElement") return "";
+    const tag = n.tagName.toLowerCase();
+    if (tag === "br") return "\n";
+    const inner = walk(n.children);
+    return BLOCK.has(tag) ? `${inner}
+` : inner;
+  }).join("");
+  return walk(parseHtmlToNodes(html)).replace(/\u00A0/g, " ").replace(/\n{3,}/g, "\n\n").trim();
+}
+
+export {
+  parseHtmlToNodes,
+  stringifyHtmlNodes,
+  getChildren,
+  walkMarkdownTree,
+  findNodesByType,
+  extractPlainText,
+  countNodes,
+  parseFrontmatter,
+  formatBlockScalar,
+  setFrontmatterValues,
+  createDocument,
+  inferDocumentTitle,
+  readFrontmatterThemeId,
+  plainTextFromInlineHtml
+};
+//# sourceMappingURL=chunk-HWVFJAAH.js.map