@bendyline/squisq 1.5.2 → 2.0.1

package/dist/chunk-MMPBOUK7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/Doc.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   * Transform provenance: the source block id this block was derived\n   * from (see `BaseTemplateBlock.sourceBlockId`). Present on blocks a\n   * transform produced; lets a persisted transformed Doc keep its typed\n   * link back to the source content.\n   */\n  sourceBlockId?: string;\n  /** All source block ids when this block summarizes several. */\n  sourceBlockIds?: string[];\n  /** Char offset of the extraction inside the source block's plain text. */\n  sourceCharOffset?: 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 `materializeBlockLayers()` 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  | TreeLayer;\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    /** Marker at the path start. */\n    startMarker?: MarkerStyle;\n    /** Marker at the path end. */\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 * One node in a `TreeLayer` — a JSON-serializable hierarchy item (mirrors\n * the treeview codec's `TreeItem`). Rendered as an indented filesystem-style\n * row with a folder/file icon and connector rails.\n */\nexport interface TreeLayerItem {\n  id: string;\n  label: string;\n  /** True renders a folder (container) icon; else a file (leaf) icon. */\n  isDir?: boolean;\n  /** Trailing comment shown muted after the label. */\n  comment?: string;\n  children: TreeLayerItem[];\n}\n\n/**\n * A hierarchical treeview rendered as interactive HTML inside a\n * `<foreignObject>` (like `TableLayer`): folder/file icons, connector\n * rails, and collapse chevrons. Interactive (collapse/expand) in the live\n * React player; captured fully-expanded and static in frame/PDF export.\n */\nexport interface TreeLayer extends BaseLayer {\n  type: 'tree';\n  content: {\n    items: TreeLayerItem[];\n    style: TreeLayerStyle;\n  };\n}\n\n/** Styling options for a TreeLayer. */\nexport interface TreeLayerStyle {\n  /** Leaf (file) row text color. */\n  rowColor: string;\n  /** Container (folder) row text color. */\n  dirColor: string;\n  /** Connector rail / branch color. */\n  connectorColor: string;\n  /** Icon color. */\n  iconColor: string;\n  /** Muted comment color. */\n  commentColor: string;\n  /** Font size in pixels. */\n  fontSize: number;\n  /** Row label font family. */\n  fontFamily?: string;\n  /** Monospace font for the connector rails. */\n  monoFontFamily?: string;\n  /** Indent step per depth level, in pixels. */\n  indentPx: number;\n  /** FontAwesome icon token for containers (default `folder`). */\n  folderIcon?: string;\n  /** FontAwesome icon token for leaves (default `file`). */\n  fileIcon?: string;\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 * 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  deriveScale,\n  isHex,\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/**\n * Expand one accent color into a full `{bg, text, accent}` color scheme via\n * the OKLCh scale — dark saturated bg, light readable text, the picked accent.\n * Falls back to a neutral scheme when the input isn't a valid hex. Shared by\n * the editor's accent list and file-import theme inference so both derive\n * identical schemes from the same accent.\n */\nexport function accentToColorScheme(accent: string): ThemeColorScheme {\n  if (!isHex(accent)) return { bg: '#1a202c', text: '#e2e8f0', accent: '#63b3ed' };\n  const scale = deriveScale(accent, 0.3);\n  return { bg: scale.darker2, text: scale.lighter2, accent: scale.base };\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":";;;;;;;;;;;;;;AA++BO,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;;;ACx/BA,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;AASO,SAAS,oBAAoB,QAAkC;AACpE,MAAI,CAAC,MAAM,MAAM,EAAG,QAAO,EAAE,IAAI,WAAW,MAAM,WAAW,QAAQ,UAAU;AAC/E,QAAM,QAAQ,YAAY,QAAQ,GAAG;AACrC,SAAO,EAAE,IAAI,MAAM,SAAS,MAAM,MAAM,UAAU,QAAQ,MAAM,KAAK;AACvE;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-LDQ2HJIX.js → chunk-PXLVXTLW.js}

@@ -2,18 +2,22 @@ import {
   extractContent,
   mapElementToBlock,
   stripMarkdown
-} from "./chunk-TQWLI6S2.js";
-import {
-  SeededRandom,
-  hashString
-} from "./chunk-FVTQSNR7.js";
+} from "./chunk-Q7LROV2H.js";
 import {
+  cloneAndFreezeData,
   isTemplateBlock
-} from "./chunk-DLXZMS5K.js";
+} from "./chunk-5J4HKRJF.js";
 import {
   extractPlainText,
   getChildren
-} from "./chunk-HWVFJAAH.js";
+} from "./chunk-AMIR72JP.js";
+import {
+  estimateTimeFromText
+} from "./chunk-3E5F2XMR.js";
+import {
+  SeededRandom,
+  hashString
+} from "./chunk-FVTQSNR7.js";
 
 // src/transform/styles/documentary.ts
 var documentaryStyle = {
@@ -98,34 +102,139 @@ var minimalStyle = {
 };
 
 // src/transform/registry.ts
-var TRANSFORM_STYLES = {
-  [documentaryStyle.id]: documentaryStyle,
-  [magazineStyle.id]: magazineStyle,
-  [dataDrivenStyle.id]: dataDrivenStyle,
-  [narrativeStyle.id]: narrativeStyle,
-  [minimalStyle.id]: minimalStyle
-};
-var STYLE_ALIASES = {
-  dataDriven: "data-driven"
-};
-var registeredStyles = /* @__PURE__ */ new Map();
+var TRANSFORM_STYLES = Object.freeze({
+  [documentaryStyle.id]: cloneAndFreezeData(documentaryStyle),
+  [magazineStyle.id]: cloneAndFreezeData(magazineStyle),
+  [dataDrivenStyle.id]: cloneAndFreezeData(dataDrivenStyle),
+  [narrativeStyle.id]: cloneAndFreezeData(narrativeStyle),
+  [minimalStyle.id]: cloneAndFreezeData(minimalStyle)
+});
 var DEFAULT_TRANSFORM_STYLE_ID = "documentary";
-function registerTransformStyle(style) {
-  registeredStyles.set(style.id, style);
+var EXTRACTION_TYPES = /* @__PURE__ */ new Set([
+  "stat",
+  "date",
+  "quote",
+  "comparison",
+  "fact",
+  "impactLine",
+  "list",
+  "definition"
+]);
+var TRANSITION_STYLES = /* @__PURE__ */ new Set(["cut", "fade", "dissolve", "mixed"]);
+function validateTransformStyle(style) {
+  const candidate = style;
+  const fail = (message) => {
+    throw new TypeError(`Invalid transform style: ${message}`);
+  };
+  for (const key of ["id", "name", "description"]) {
+    if (typeof candidate[key] !== "string" || !candidate[key].trim()) {
+      fail(`${key} must be a non-empty string`);
+    }
+  }
+  for (const key of ["minConfidence", "transformRatio"]) {
+    const value = candidate[key];
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0 || value > 1) {
+      fail(`${key} must be a finite number between 0 and 1`);
+    }
+  }
+  if (!Array.isArray(candidate.preferredTypes) || candidate.preferredTypes.some((type) => !EXTRACTION_TYPES.has(type))) {
+    fail("preferredTypes contains an unknown extraction type");
+  }
+  if (!Array.isArray(candidate.colorSchemes) || candidate.colorSchemes.length === 0 || candidate.colorSchemes.some((scheme) => typeof scheme !== "string" || !scheme)) {
+    fail("colorSchemes must contain at least one non-empty string");
+  }
+  for (const key of ["insertSectionHeaders", "interleaveImages"]) {
+    if (typeof candidate[key] !== "boolean") fail(`${key} must be a boolean`);
+  }
+  const blocks = candidate.blocksPerSection;
+  if (!blocks || !Number.isInteger(blocks.max) || blocks.max < 1) {
+    fail("blocksPerSection.max must be a positive integer");
+  }
+  if (typeof candidate.transitionStyle !== "string" || !TRANSITION_STYLES.has(candidate.transitionStyle)) {
+    fail("transitionStyle must be cut, fade, dissolve, or mixed");
+  }
+  const templateMap = candidate.templateMap;
+  if (templateMap !== void 0) {
+    if (!templateMap || typeof templateMap !== "object" || Array.isArray(templateMap)) {
+      fail("templateMap must be an object");
+    }
+    for (const [type, template] of Object.entries(templateMap)) {
+      if (!EXTRACTION_TYPES.has(type) || typeof template !== "string" || !template) {
+        fail("templateMap must map known extraction types to non-empty template names");
+      }
+    }
+  }
+  if (candidate.suggestedThemeId !== void 0 && (typeof candidate.suggestedThemeId !== "string" || !candidate.suggestedThemeId)) {
+    fail("suggestedThemeId must be a non-empty string");
+  }
+  const pacingValue = candidate.pacing;
+  if (pacingValue !== void 0) {
+    if (!pacingValue || typeof pacingValue !== "object" || Array.isArray(pacingValue)) {
+      fail("pacing must be an object");
+    }
+    const pacing = pacingValue;
+    for (const key of ["intro", "outro"]) {
+      if (pacing[key] !== void 0 && typeof pacing[key] !== "boolean") {
+        fail(`pacing.${key} must be a boolean`);
+      }
+    }
+  }
+  const budget = candidate.budget;
+  if (candidate.budget !== void 0 && (!budget || typeof budget !== "object" || Array.isArray(budget))) {
+    fail("budget must be an object");
+  }
+  if (budget && budget.slidesPerMinute !== void 0) {
+    const value = budget.slidesPerMinute;
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+      fail("budget.slidesPerMinute must be a positive finite number");
+    }
+  }
 }
-function unregisterTransformStyle(id) {
-  registeredStyles.delete(id);
+function styleSnapshot(style) {
+  validateTransformStyle(style);
+  return cloneAndFreezeData(style);
 }
-function resolveTransformStyle(id) {
-  const canonical = STYLE_ALIASES[id] ?? id;
-  return registeredStyles.get(canonical) ?? TRANSFORM_STYLES[canonical] ?? TRANSFORM_STYLES[DEFAULT_TRANSFORM_STYLE_ID];
+function normalizeBuiltinStyleId(id) {
+  return id === "dataDriven" ? "data-driven" : id;
 }
-function getTransformStyleIds() {
-  return Array.from(/* @__PURE__ */ new Set([...Object.keys(TRANSFORM_STYLES), ...registeredStyles.keys()]));
+function resolveBuiltinStyle(id) {
+  return TRANSFORM_STYLES[normalizeBuiltinStyleId(id)] ?? TRANSFORM_STYLES[DEFAULT_TRANSFORM_STYLE_ID];
 }
-function getTransformStyleSummaries() {
-  return getTransformStyleIds().map((id) => {
-    const { name, description } = resolveTransformStyle(id);
+function createTransformStyleRegistry(initialStyles = []) {
+  const registeredStyles = /* @__PURE__ */ new Map();
+  const registry = {
+    register(style) {
+      const snapshot = styleSnapshot(style);
+      registeredStyles.set(snapshot.id, snapshot);
+    },
+    unregister(id) {
+      return registeredStyles.delete(id);
+    },
+    get(id) {
+      return registeredStyles.get(id);
+    },
+    list() {
+      return Array.from(registeredStyles.values());
+    }
+  };
+  for (const style of initialStyles) registry.register(style);
+  return Object.freeze(registry);
+}
+function resolveTransformStyle(style, registry) {
+  if (typeof style !== "string") return styleSnapshot(style);
+  return registry?.get(style) ?? resolveBuiltinStyle(style);
+}
+function getTransformStyleIds(registry) {
+  return Array.from(
+    /* @__PURE__ */ new Set([
+      ...Object.keys(TRANSFORM_STYLES),
+      ...registry?.list().map((style) => style.id) ?? []
+    ])
+  );
+}
+function getTransformStyleSummaries(registry) {
+  return getTransformStyleIds(registry).map((id) => {
+    const { name, description } = resolveTransformStyle(id, registry);
     return { id, name, description };
   });
 }
@@ -323,7 +432,8 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
         duration: ab.block.duration > 0 ? Math.min(3, ab.block.duration * 0.2) : 3,
         audioSegment: ab.block.audioSegment,
         title: ab.block.title,
-        colorScheme: config.colorSchemes[colorIndex % config.colorSchemes.length]
+        colorScheme: config.colorSchemes[colorIndex % config.colorSchemes.length],
+        sourceBlockId: ab.block.id
       };
       blocks.push(headerBlock);
       insertedCount++;
@@ -343,13 +453,18 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
         };
         accentPositionIndex++;
       }
+      const slideShare = ab.block.duration > 0 ? ab.block.duration / extractions.length : 6;
+      const offsetInBlock = ab.block.duration > 0 ? estimateTimeFromText(ab.plainText, sel.element.sourcePosition, ab.block.duration) : 0;
       let templateBlock = mapElementToBlock(sel.element, {
         id: `transform-${blockIdCounter++}`,
-        duration: ab.block.duration > 0 ? ab.block.duration / extractions.length : 6,
+        duration: slideShare,
         audioSegment: ab.block.audioSegment,
         colorScheme,
         accentImage,
-        sourceStartTime: sel.element.sourcePosition
+        sourceStartTime: ab.block.startTime + offsetInBlock,
+        sourceDuration: slideShare,
+        sourceBlockId: ab.block.id,
+        sourceCharOffset: sel.element.sourcePosition
       });
       const remapTarget = config.templateMap?.[sel.element.data.type];
       if (remapTarget && remapTarget !== templateBlock.template) {
@@ -380,7 +495,8 @@ function buildBlockSequence(analyzed, selected, config, images, rng) {
           audioSegment: ab.block.audioSegment,
           imageSrc: img.src,
           imageAlt: img.alt ?? "",
-          ambientMotion: rng.pick(AMBIENT_MOTIONS) ?? "zoomIn"
+          ambientMotion: rng.pick(AMBIENT_MOTIONS) ?? "zoomIn",
+          sourceBlockId: ab.block.id
         };
         blocks.push(imageBlock);
         imageIndex++;
@@ -397,7 +513,9 @@ function translateTemplateBlock(block, target) {
     duration: block.duration,
     audioSegment: block.audioSegment,
     sourceStartTime: block.sourceStartTime,
-    sourceDuration: block.sourceDuration
+    sourceDuration: block.sourceDuration,
+    sourceBlockId: block.sourceBlockId,
+    sourceCharOffset: block.sourceCharOffset
   };
   if (block.template === "quote") {
     const quote = block;
@@ -440,6 +558,12 @@ var MAX_BLOCK_DURATION = 20;
 var DEFAULT_BLOCK_DURATION = 6;
 function allocateTiming(blocks, totalDuration) {
   if (blocks.length === 0) return [];
+  const hasAnchors = blocks.some(
+    (b) => isTemplateBlock(b) && typeof b.sourceStartTime === "number"
+  );
+  return hasAnchors ? allocateAnchored(blocks, totalDuration) : allocateRescaled(blocks, totalDuration);
+}
+function allocateRescaled(blocks, totalDuration) {
   const effectiveDuration = totalDuration > 0 ? totalDuration : estimateDefaultDuration(blocks);
   const durations = blocks.map((block) => {
     if (!isTemplateBlock(block) && block.duration > 0) {
@@ -460,27 +584,102 @@ function allocateTiming(blocks, totalDuration) {
   let currentTime = 0;
   const result = [];
   for (let i = 0; i < blocks.length; i++) {
-    const block = blocks[i];
-    const duration = durations[i];
+    result.push(toOutputBlock(blocks[i], currentTime, durations[i]));
+    currentTime += durations[i];
+  }
+  return result;
+}
+var MIN_FLOATING_DURATION = 1;
+function allocateAnchored(blocks, totalDuration) {
+  const entries = blocks.map((block) => {
     if (isTemplateBlock(block)) {
-      const outputBlock = {
-        ...block,
-        startTime: currentTime,
-        duration,
-        title: getTemplateTitle(block)
+      return {
+        block,
+        anchorStart: typeof block.sourceStartTime === "number" ? block.sourceStartTime : null,
+        rawDuration: block.duration > 0 ? block.duration : DEFAULT_BLOCK_DURATION
       };
-      result.push(outputBlock);
+    }
+    return {
+      block,
+      anchorStart: block.startTime,
+      rawDuration: block.duration > 0 ? block.duration : DEFAULT_BLOCK_DURATION
+    };
+  });
+  const starts = new Array(entries.length);
+  let cursor = 0;
+  let seenAnchor = false;
+  let i = 0;
+  while (i < entries.length) {
+    const entry = entries[i];
+    if (entry.anchorStart !== null) {
+      const start = Math.max(cursor, entry.anchorStart);
+      starts[i] = start;
+      const hint = isTemplateBlock(entry.block) ? entry.block.sourceDuration ?? entry.rawDuration : entry.rawDuration;
+      cursor = start + Math.max(MIN_FLOATING_DURATION, hint);
+      seenAnchor = true;
+      i++;
+      continue;
+    }
+    const runStart = i;
+    while (i < entries.length && entries[i].anchorStart === null) i++;
+    const run = entries.slice(runStart, i);
+    const rawSum = run.reduce((sum, e) => sum + e.rawDuration, 0);
+    const nextAnchorStart = i < entries.length ? Math.max(entries[i].anchorStart ?? cursor, cursor) : null;
+    if (nextAnchorStart === null) {
+      let acc = cursor;
+      for (let k = 0; k < run.length; k++) {
+        starts[runStart + k] = acc;
+        acc += run[k].rawDuration;
+      }
+      cursor = acc;
+    } else if (!seenAnchor) {
+      const gap = nextAnchorStart - cursor;
+      let acc = cursor;
+      for (let k = 0; k < run.length; k++) {
+        starts[runStart + k] = acc;
+        acc += rawSum > 0 ? run[k].rawDuration / rawSum * gap : gap / run.length;
+      }
+      cursor = nextAnchorStart;
     } else {
-      result.push({
-        ...block,
-        startTime: currentTime,
-        duration
-      });
+      const gap = Math.max(0, nextAnchorStart - cursor);
+      const scale = rawSum > 0 ? Math.min(1, gap / rawSum) : 0;
+      let acc = Math.max(cursor, nextAnchorStart - rawSum * scale);
+      for (let k = 0; k < run.length; k++) {
+        starts[runStart + k] = acc;
+        acc += run[k].rawDuration * scale;
+      }
+      cursor = nextAnchorStart;
+    }
+  }
+  for (let k = 0; k < starts.length; k++) {
+    const floor = k > 0 ? starts[k - 1] + MIN_FLOATING_DURATION : 0;
+    if (starts[k] < floor) starts[k] = floor;
+  }
+  const result = [];
+  for (let k = 0; k < entries.length; k++) {
+    const entry = entries[k];
+    let duration;
+    if (k + 1 < entries.length) {
+      duration = Math.max(MIN_FLOATING_DURATION, starts[k + 1] - starts[k]);
+    } else {
+      const authored = isTemplateBlock(entry.block) ? entry.block.sourceDuration ?? entry.rawDuration : entry.rawDuration;
+      duration = Math.max(MIN_FLOATING_DURATION, authored, totalDuration - starts[k]);
     }
-    currentTime += duration;
+    result.push(toOutputBlock(entry.block, starts[k], duration));
   }
   return result;
 }
+function toOutputBlock(block, startTime, duration) {
+  if (isTemplateBlock(block)) {
+    return {
+      ...block,
+      startTime,
+      duration,
+      title: getTemplateTitle(block)
+    };
+  }
+  return { ...block, startTime, duration };
+}
 function clampDuration(d) {
   return Math.max(MIN_BLOCK_DURATION, Math.min(MAX_BLOCK_DURATION, d));
 }
@@ -512,8 +711,8 @@ function getTemplateTitle(block) {
 }
 
 // src/transform/applyTransform.ts
-function applyTransform(doc, styleId, options) {
-  const baseConfig = resolveTransformStyle(styleId);
+function applyTransform(doc, style, options) {
+  const baseConfig = resolveTransformStyle(style, options?.registry);
   const config = options?.overrides ? { ...baseConfig, ...options.overrides, id: baseConfig.id } : baseConfig;
   const seed = options?.seed ?? hashString(doc.articleId || "transform");
   const images = options?.images ?? extractDocImages(doc.blocks);
@@ -584,8 +783,7 @@ function firstTitle(doc) {
 
 export {
   DEFAULT_TRANSFORM_STYLE_ID,
-  registerTransformStyle,
-  unregisterTransformStyle,
+  createTransformStyleRegistry,
   resolveTransformStyle,
   getTransformStyleIds,
   getTransformStyleSummaries,
@@ -593,4 +791,4 @@ export {
   analyzeBlocks,
   applyTransform
 };
-//# sourceMappingURL=chunk-LDQ2HJIX.js.map
+//# sourceMappingURL=chunk-PXLVXTLW.js.map