import type { SubtitleDocument, SubtitleEvent, TextSegment, InlineStyle } from '../../../core/types.ts' import { formatTime } from './time.ts' /** * Options for TTML serialization */ export interface TTMLSerializeOptions { /** Include XML namespace declarations (default: true) */ xmlns?: boolean /** Include head section with styles and regions (default: true) */ includeHead?: boolean /** Time format - 'clock' for HH:MM:SS.mmm or 'offset' for seconds (default: 'clock') */ format?: 'clock' | 'offset' } /** * Serialize subtitle document to TTML format * * @param doc - Subtitle document to serialize * @param opts - Serialization options * @returns TTML formatted string * * @example * ```ts * const ttml = toTTML(doc, { * xmlns: true, * includeHead: true, * format: 'clock' * }) * ``` */ export function toTTML(doc: SubtitleDocument, opts: TTMLSerializeOptions = {}): string { const { xmlns = true, includeHead = true, format = 'clock' } = opts const lines: string[] = [] // XML declaration lines.push('') // Root element if (xmlns) { lines.push('') } else { lines.push('') } // Head section if (includeHead) { lines.push(' ') // Styling section const styles = extractStyles(doc) if (styles.length > 0) { lines.push(' ') for (const style of styles) { lines.push(` ${style}`) } lines.push(' ') } // Layout section (regions) const regions = extractRegions(doc) if (regions.length > 0) { lines.push(' ') for (const region of regions) { lines.push(` ${region}`) } lines.push(' ') } lines.push(' ') } // Body section lines.push(' ') lines.push(' ') for (const event of doc.events) { const p = serializeEvent(event, format) lines.push(` ${p}`) } lines.push(' ') lines.push(' ') lines.push('') return lines.join('\n') } function extractStyles(doc: SubtitleDocument): string[] { const styles: string[] = [] const seenStyles = new Set() // Extract unique styles from document for (const [name, style] of doc.styles.entries()) { if (seenStyles.has(name)) continue seenStyles.add(name) const attrs: string[] = [] attrs.push(`xml:id="${escapeXml(name)}"`) if (style.fontName) { attrs.push(`tts:fontFamily="${escapeXml(style.fontName)}"`) } if (style.fontSize) { attrs.push(`tts:fontSize="${style.fontSize}px"`) } if (style.bold) { attrs.push(`tts:fontWeight="bold"`) } if (style.italic) { attrs.push(`tts:fontStyle="italic"`) } if (style.underline || style.strikeout) { const decorations = [] if (style.underline) decorations.push('underline') if (style.strikeout) decorations.push('line-through') attrs.push(`tts:textDecoration="${decorations.join(' ')}"`) } // Colors (convert from ABGR to #RRGGBB) if (style.primaryColor) { const color = formatColor(style.primaryColor) attrs.push(`tts:color="${color}"`) } if (style.backColor) { const color = formatColor(style.backColor) attrs.push(`tts:backgroundColor="${color}"`) } styles.push(`