import type { Page, Route } from 'playwright-core'; /* utils/platformFontMap.data.d.ts */ /** * AUTO-GENERATED in html2pptx — synced copy; do not edit by hand. * Source of truth: html2pptx/docs/css_generic_font_os_map_simplified.csv */ interface PlatformFontMappingEntry { primary: string; fallbacks: string[]; } type PlatformFontOsMap = Record>>; declare const GENERIC_FONT_OS_MAP: PlatformFontOsMap; /* utils/platformFontMap.d.ts */ /** PPTX target platforms with full mapping tables. */ export type PlatformTarget = 'win' | 'mac' | 'ios' | 'android' | 'linux'; /** Default platform when callers omit `platform` (programmatic API). */ export declare const DEFAULT_PLATFORM_TARGET: PlatformTarget; export type PlatformFontLang = 'sc' | 'tc' | 'jp' | 'kr' | 'ar' | 'he' | 'latin'; /** CSS generic font-family keywords (each may map to a different OS font). */ export type GenericFontName = 'serif' | 'sans-serif' | 'monospace' | 'cursive' | 'fantasy' | 'system-ui' | 'ui-serif' | 'ui-sans-serif' | 'ui-monospace' | 'math'; /** Collapsed family category for script-slot logic (sans vs serif vs mono, etc.). */ export type GenericFontKind = 'serif' | 'sans' | 'monospace' | 'cursive' | 'fantasy' | 'math'; export interface PlatformFontContext { platform: PlatformTarget; } export declare function genericNameFromToken(token: string): GenericFontName | undefined; export declare function genericKindFromToken(token: string): GenericFontKind | undefined; export declare function isGenericFontToken(token: string): boolean; export declare function isPlatformFontContextActive(ctx?: PlatformFontContext): ctx is PlatformFontContext; export declare function getPlatformFontMappingByName(genericName: GenericFontName, ctx: PlatformFontContext, lang?: PlatformFontLang): PlatformFontMappingEntry; export declare function getPlatformFontMapping(kind: GenericFontKind, ctx: PlatformFontContext, lang?: PlatformFontLang): PlatformFontMappingEntry; /** Primary PPTX font for a CSS generic token on the target platform/locale. */ export declare function getPlatformMappedFontByToken(token: string, ctx: PlatformFontContext, lang?: PlatformFontLang): string | undefined; /** Primary PPTX font for a collapsed kind (uses canonical generic_name). */ export declare function getPlatformMappedFont(kind: GenericFontKind, ctx: PlatformFontContext, lang?: PlatformFontLang): string; /** Primary + fallback stack as a CSS-like comma-separated list. */ export declare function getPlatformMappedFontStack(kind: GenericFontKind, ctx: PlatformFontContext, lang?: PlatformFontLang): string; export declare function isGenericSansToken(token: string): boolean; export declare function isGenericSerifToken(token: string): boolean; /** Last generic kind in stack wins (CSS fallback order). */ export declare function detectStackGenericKind(fontFamily: string | undefined): GenericFontKind | undefined; /** Last generic token name in stack wins (preserves sans-serif vs system-ui distinction). */ export declare function detectStackGenericName(fontFamily: string | undefined): GenericFontName | undefined; export declare function stackHasNamedFont(fontFamily: string | undefined): boolean; export declare function replaceGenericFontTokensInStack(fontFamily: string, ctx: PlatformFontContext, lang?: PlatformFontLang): string; /** * Merge specified + computed font stacks and apply platform generic mapping. */ export declare function resolveFontFamilyForPlatform(computedFamily: string | undefined, specifiedFamily: string | undefined, ctx: PlatformFontContext, lang?: PlatformFontLang): string; /** Map Node.js `process.platform` to a PPTX font-mapping target. */ export declare function detectCurrentPlatformTarget(): PlatformTarget; export declare function buildPlatformFontContext(options?: { platform?: PlatformTarget; }): PlatformFontContext; export { GENERIC_FONT_OS_MAP, type PlatformFontMappingEntry }; /* utils/embedFonts.index.d.ts */ /** * Auto-generated by src/bin/build-embed-font-index.ts * Source: ../../fonts/fonts-index.ts * Do not edit manually. */ declare const EMBED_FONT_INDEX_META: { readonly fontCount: 11298; readonly familyCount: 7221; readonly searchKeyCount: 20650; readonly familyAliasCount: 10; readonly extraSearchAliasCount: 10; readonly timestamp: "2026-07-08T06:54:22.903Z"; }; declare const EMBED_FONT_SEARCH_INDEX: Readonly>; /* utils/embedFonts.d.ts */ export { EMBED_FONT_INDEX_META }; export interface FontEmbedMatch { /** Font family name used in the presentation */ used: string; /** Matched family name in the cloud embed font library */ matchedFamily: string; } export interface FontEmbedProbeResult { matched: FontEmbedMatch[]; unmatched: string[]; indexMeta: typeof EMBED_FONT_INDEX_META; } /** Match a single font-family token or stack against the embed font library. */ export declare function matchEmbeddableFont(fontNameOrStack: string): string | null; /** Probe which presentation font families can be embedded from the cloud library. */ export declare function probeEmbeddableFonts(usedFamilies: string[]): FontEmbedProbeResult; /* utils/diagnostics.d.ts */ /** * Structured conversion diagnostics (DH-P0-009). * * A Diagnostic is the stable, machine-readable form of every issue html2deck * surfaces during a conversion. rule_id stays semantically stable across patch * versions so callers can branch on it. */ type DiagnosticSeverity = 'error' | 'warning' | 'info'; interface Diagnostic { rule_id: string; severity: DiagnosticSeverity; /** Slide id or 1-based index, when applicable. */ slide_id?: string | null; /** Caller-declared element identity, when applicable. */ element_id?: string | null; message: string; /** Suggested remediation. */ recovery?: string | null; } /** Minimum rule families html2deck guarantees (DH-P0-009). */ declare const RULE_IDS: { readonly IDENTITY_MISSING: "HTML2DECK_IDENTITY_MISSING"; readonly IDENTITY_DUPLICATE: "HTML2DECK_IDENTITY_DUPLICATE"; readonly IDENTITY_NOT_EXPORTED: "HTML2DECK_IDENTITY_NOT_EXPORTED"; readonly KIND_AMBIGUOUS: "HTML2DECK_KIND_AMBIGUOUS"; readonly KIND_UNSUPPORTED: "HTML2DECK_KIND_UNSUPPORTED"; readonly STYLE_UNSUPPORTED: "HTML2DECK_STYLE_UNSUPPORTED"; readonly RESOURCE_REMOTE_BLOCKED: "HTML2DECK_REMOTE_RESOURCE_BLOCKED"; readonly RESOURCE_MISSING: "HTML2DECK_RESOURCE_MISSING"; readonly RESOURCE_ESCAPED: "HTML2DECK_RESOURCE_ESCAPED"; readonly BROWSER_UNAVAILABLE: "HTML2DECK_BROWSER_UNAVAILABLE"; readonly BROWSER_CRASHED: "HTML2DECK_BROWSER_CRASHED"; readonly BROWSER_TIMEOUT: "HTML2DECK_BROWSER_TIMEOUT"; readonly FONT_MISSING: "HTML2DECK_FONT_MISSING"; readonly FONT_FALLBACK: "HTML2DECK_FONT_FALLBACK"; readonly RASTER_FALLBACK: "HTML2DECK_RASTER_FALLBACK"; readonly GEOMETRY_INVALID: "HTML2DECK_GEOMETRY_INVALID"; readonly GEOMETRY_UNSTABLE: "HTML2DECK_GEOMETRY_UNSTABLE"; readonly OOXML_WRITE_FAILURE: "HTML2DECK_OOXML_WRITE_FAILURE"; readonly OOXML_REOPEN_FAILURE: "HTML2DECK_OOXML_REOPEN_FAILURE"; readonly MAPPING_CLOSURE_FAILURE: "HTML2DECK_MAPPING_CLOSURE_FAILURE"; readonly OUTPUT_EXISTS: "HTML2DECK_OUTPUT_EXISTS"; readonly ANIMATION_UNMAPPED: "HTML2DECK_ANIMATION_UNMAPPED"; readonly IFRAME_INSPECT_FAILED: "HTML2DECK_IFRAME_INSPECT_FAILED"; readonly IFRAME_NESTED_TOO_DEEP: "HTML2DECK_IFRAME_NESTED_TOO_DEEP"; readonly IFRAME_PARENT_COUPLED: "HTML2DECK_IFRAME_PARENT_COUPLED"; }; /** * Error thrown for hard failures. Carries a primary Diagnostic plus optional * additional diagnostics so callers can still harvest structured info from a * thrown ConversionError. */ declare class ConversionError extends Error { readonly primary: Diagnostic; readonly diagnostics: Diagnostic[]; constructor(primary: Diagnostic, additional?: Diagnostic[]); /** True when at least one diagnostic is severity 'error'. */ get hasErrors(): boolean; } /** * Mutable collector that dedupes diagnostics by (rule_id, element_id, message) * and exposes helpers to push standard families. Keeps api.ts terse. */ declare class DiagnosticsCollector { private readonly items; private readonly seen; private key; push(d: Diagnostic): void; pushMany(ds: Diagnostic[]): void; add(ruleId: string, severity: DiagnosticSeverity, message: string, opts?: Partial): void; list(): readonly Diagnostic[]; get count(): number; get errorCount(): number; get warningCount(): number; get infoCount(): number; toJSON(): Diagnostic[]; } /* conversion-report.d.ts */ export type ElementTypeCounts = Record; export interface SlideElementStats { index: number; total: number; byType: ElementTypeCounts; } export interface ConversionElementStats { total: number; byType: ElementTypeCounts; slides: SlideElementStats[]; } export interface ConversionFontStats { families: string[]; variants: UsedFontDescriptor[]; /** Probe result against the cloud embed font library (../../fonts/fonts-index.ts) */ embed?: FontEmbedProbeResult; } export interface SimplifiedElementEntry { slide: number; type: string; tag: string; method: RasterMethod; reason: RasterReason; x: number; y: number; width: number; height: number; } export interface SlideSimplifiedStats { index: number; total: number; byReason: Record; } export interface ConversionSimplifiedStats { total: number; byMethod: Record; byReason: Record; slides: SlideSimplifiedStats[]; items: SimplifiedElementEntry[]; } export interface ConversionStats { elements: ConversionElementStats; fonts: ConversionFontStats; simplified: ConversionSimplifiedStats; } export interface ConversionReport { version: 1; generatedAt: string; input: string[]; output: string; format: string; mode: string; slideCount: number; elements: ConversionElementStats; fonts: ConversionFontStats; simplified: ConversionSimplifiedStats; viewport?: { width: number; height: number; }; platform?: string; durationMs?: number; } export declare function buildElementStats(slidesMap: Map): ConversionElementStats; export declare function buildSimplifiedStats(slidesMap: Map): ConversionSimplifiedStats; export declare function buildFontStats(usedFontsMap: Map): ConversionFontStats; export declare function buildConversionReport(params: { input: string[]; output: string; format: string; mode: string; slideCount: number; stats: ConversionStats; viewport?: { width: number; height: number; }; platform?: string; durationMs?: number; }): ConversionReport; export declare const EMPTY_CONVERSION_STATS: ConversionStats; export type MappingMode = 'native' | 'vector' | 'raster' | 'ignored' | 'unsupported'; export interface ElementGeometry { x: number; y: number; w: number; h: number; unit: 'inch' | 'px'; } export interface ElementReportRecord { element_id: string | null; kind: string; mapping_mode: MappingMode; object_ref: string | null; geometry: ElementGeometry; warnings: Diagnostic[]; } export interface SlideReport { slide_id: string; index: number; elements: ElementReportRecord[]; } export interface ConversionReportSummary { native: number; vector: number; raster: number; ignored: number; unsupported: number; } export interface Html2DeckConversionReport { schema_version: 1; engine: { name: string; version: string; }; status: 'succeeded' | 'failed'; slides: SlideReport[]; summary: ConversionReportSummary; diagnostics: Diagnostic[]; } /** * Mutable collector used by the generator to build the per-element report. */ export declare class ReportCollector { readonly slides: SlideReport[]; readonly diagnostics: Diagnostic[]; /** Number of elements excluded before reaching the generator (ignored). */ ignoredCount: number; startSlide(slideId: string, index: number): void; addElement(record: ElementReportRecord): void; build(engineName: string, engineVersion: string, status: 'succeeded' | 'failed'): Html2DeckConversionReport; } /** * Recompute the summary counts from per-element records (DH-P0-003). * * The summary is always derivable from `slides[].elements[].mapping_mode` plus * the ignored count, so callers can verify the report was not tampered with * and strict-mode gates can re-check after any post-processing. */ export declare function recomputeSummary(report: Html2DeckConversionReport, ignoredCount?: number): ConversionReportSummary; /* charts/types.d.ts */ type NativeChartLibrary = 'echarts' | 'highcharts' | 'plotly' | 'chartjs'; interface CapturedChartRecord { id: string; library: NativeChartLibrary; elementSelector?: string; tag?: string; x: number; y: number; width: number; height: number; raw: any; } type NativeChartKind = 'line' | 'area' | 'bar' | 'column' | 'stackedBar' | 'stackedColumn' | 'pie' | 'doughnut' | 'scatter' | 'bubble' | 'radar' | 'mixed'; interface NativeChartPoint { label?: string; value: number; x?: string | number; y?: number; size?: number; color?: string; lineColor?: string; lineWidth?: number; } interface NativeChartSeries { name?: string; type?: NativeChartKind; axisKey?: 'x' | 'x2' | 'y' | 'y2'; values: number[]; labels?: string[]; points?: NativeChartPoint[]; color?: string; colors?: string[]; fillColor?: string; smooth?: boolean; markerSize?: number; markerColor?: string; markerLineColor?: string; markerLineWidth?: number; lineColor?: string; lineWidth?: number; lineDash?: number[]; stack?: string; fillOpacity?: number; } interface NativeChartLineSeriesStyle { lineColor?: string; lineWidthPt?: number; markerSize?: number; markerColor?: string; markerLineColor?: string; smooth?: boolean; lineDash?: number[]; } interface NativeChartAxis { categories?: string[]; min?: number; max?: number; title?: string; titleColor?: string; titleFontSize?: number; titleRotate?: number; labelColor?: string; labelFontSize?: number; lineColor?: string; lineWidth?: number; gridColor?: string; gridWidth?: number; gridStyle?: 'solid' | 'dash' | 'dot' | 'none'; hidden?: boolean; majorUnit?: number; lineShow?: boolean; } interface NativeChartLegend { show?: boolean; position?: 'b' | 'l' | 'r' | 't' | 'tr'; color?: string; fontSize?: number; } interface NativeChartDataLabels { show?: boolean; showValue?: boolean; showPercent?: boolean; position?: string; color?: string; fontSize?: number; formatCode?: string; } interface NativeChartInfo { id: string; library: NativeChartLibrary; kind: NativeChartKind; series: NativeChartSeries[]; categories?: string[]; xAxis?: NativeChartAxis; yAxis?: NativeChartAxis; yAxis2?: NativeChartAxis; legend?: NativeChartLegend; title?: string; showTitle?: boolean; titleColor?: string; titleFontSize?: number; chartColors?: string[]; transparentBackground?: boolean; backgroundColor?: string; backgroundBorderColor?: string; backgroundBorderWidth?: number; plotBackgroundColor?: string; plotBorderColor?: string; plotBorderWidth?: number; stacked?: boolean; holeSize?: number; chartColorsOpacity?: number; dataLabels?: NativeChartDataLabels; warnings?: string[]; } interface PptxChartDefinition { chartType: string | any[]; data: any[]; options: any; warnings?: string[]; } /* utils/resource-policy.d.ts */ /** * Resource loading policy for Playwright and PPTX media validation (DH-P0-007). * * Caller controls network access and local file roots. Blocked, missing, and * escaped resources are reported as structured diagnostics instead of being * silently allowed or denied. */ type ResourcePolicyMode = 'local' | 'remote'; interface DocumentUrlInfo { documentUrl: string; mode: ResourcePolicyMode; } /** Structured per-resource diagnostic. */ interface ResourceDiagnostic { rule_id: string; severity: 'error' | 'warning' | 'info'; url: string; message: string; recovery?: string; } /** * Caller-controlled resource policy. */ interface ResourcePolicy { /** 'deny' blocks http://, https://, ws://, wss://. Default: 'allow' (backward compat). */ network?: 'deny' | 'allow'; /** Local file roots that file:// subresources may load from. Empty = only the document itself. */ allowedRoots?: string[]; /** When false, reject symlinks and '..' traversal. Default: false. */ followSymlinks?: boolean; /** Allow remote fonts. Defaults to network policy. */ allowRemoteFonts?: boolean; /** Allow remote images. Defaults to network policy. */ allowRemoteImages?: boolean; /** Allow remote scripts. Defaults to network policy. */ allowRemoteScripts?: boolean; /** Allow remote styles. Defaults to network policy. */ allowRemoteStyles?: boolean; } interface ResourcePolicyOptions { /** Legacy shorthand: when true, allow all file:// subresources (no route blocking). */ allowLocalResources?: boolean; /** Explicit policy. When present, takes precedence over allowLocalResources. */ policy?: ResourcePolicy; /** Diagnostics collector (pushed to by the route handler). */ diagnostics?: ResourceDiagnostic[]; } /** * Resolve how the HTML document will be loaded. */ declare function resolveDocumentUrl(inputPath: string): DocumentUrlInfo; /** * Normalize file:// URLs for stable comparison across platforms. */ declare function normalizeFileUrl(url: string): string; /** * Whether a subresource request should be allowed under the active policy. * Pushes a diagnostic for every denial. */ declare function isResourceRequestAllowed(requestUrl: string, documentUrl: string, policy: Required>, diagnostics: ResourceDiagnostic[], kind: 'font' | 'image' | 'script' | 'style' | 'other'): boolean; /** * Playwright route handler enforcing the resource policy. */ declare function createPlaywrightRouteHandler(documentUrl: string, policy: Required>, diagnostics: ResourceDiagnostic[]): (route: Route) => Promise; /** * Register resource policy route on a Playwright page (call before goto). */ declare function setupResourcePolicyOnPage(page: Page, inputPath: string, options?: ResourcePolicyOptions): Promise; /** * Validate that a URL returns a valid image (not 404 HTML, etc.) */ declare function validateImageUrl(url: string): Promise; type ResolvedImageSource = { kind: 'data'; data: string; } | { kind: 'path'; path: string; }; /** * Resolve an image URL for pptxgenjs. * Keeps the original http:// or https:// URL (no protocol upgrade). * Call ensurePptxgenAllowsHttp() before write so pptxgenjs can fetch http://. */ declare function resolveImageSourceForPptx(url: string): Promise; /** * Validate inline data:image/... URLs. */ declare function validateDataImageUrl(dataUrl: string): boolean; /* animation/normalize.d.ts */ /** Parsed first/last keyframe geometry, produced browser-side. */ interface KeyframeSnapshot { opacity: number | null; translateXPx: number; translateYPx: number; scaleX: number; scaleY: number; rotateDeg: number; /** Frame touched properties outside opacity/transform (e.g. color, width). */ hasNonMotionProps: boolean; } /** Raw CSS animation capture for one element (browser-side). */ interface CssAnimationRaw { name: string; durationMs: number; delayMs: number; /** null = infinite */ iterationCount: number | null; first: KeyframeSnapshot; last: KeyframeSnapshot; } /** Intercepted anime.js animate()/timeline.add() call (browser-side). */ interface AnimeCallRaw { durationMs?: number; delayMs?: number; /** Unknown easing/delay shapes are captured verbatim for diagnostics. */ staggered?: boolean; params: Record; } /** Parse "600" | "600ms" | "0.6s" into milliseconds. */ declare function parseTimeMs(raw: string | undefined | null): number | undefined; /** Map declared trigger words onto PPTX triggers; undefined when absent/unknown. */ declare function normalizeTrigger(raw: string | undefined | null): AnimationTrigger | undefined; /** Normalize a declared `data-animation` effect string. */ declare function normalizeDeclaredEffect(raw: string): NormalizedAnimationEffect; /** * Infer the entrance effect from first/last @keyframes frames. * Returns 0..2 effects: fade combined with a single-axis motion is emitted as * two entries played in parallel; anything more complex is `unmapped`. */ declare function normalizeCssAnimation(raw: CssAnimationRaw): NormalizedAnimationEffect[]; /** Infer effects from one intercepted anime.js call. */ declare function normalizeAnimeParams(call: AnimeCallRaw): NormalizedAnimationEffect[]; interface BuildAnimationsInput { declared?: { effect: string; durationMs?: number; delayMs?: number; trigger?: string; }; css?: CssAnimationRaw; animeCalls?: AnimeCallRaw[]; options?: AnimationConversionOptions; } interface BuiltAnimations { animations: ElementAnimation[]; /** One entry per source animation that could not be mapped. */ unmapped: { source: ElementAnimation['source']; raw: string; reason: string; }[]; } /** * Merge all capture sources for one element into a single animation list. * An explicit declaration wins over css/animejs captures for the same element * (authors use it to override ambient animations). */ declare function buildElementAnimations(input: BuildAnimationsInput): BuiltAnimations; /** True when the snapshot carries no motion (used to skip trivial captures). */ declare function isTrivialKeyframes(first: KeyframeSnapshot, last: KeyframeSnapshot): boolean; /* types.d.ts */ /** * Type definitions for HTML to PPTX converter */ export interface ConversionOptions { /** Single HTML/SVG input file */ input?: string; /** Multiple HTML/SVG input files — processed in order, merged into one PPTX */ inputs?: string[]; slideSelector?: string; /** * Convert supported JS chart-library instances to editable native PPT charts. * Requires a commercial license locally (Free keeps canvas raster). Default: licensed ? true : false. */ nativeCharts?: boolean; /** * Decompose SVG into editable shapes. Requires commercial license locally * (Free keeps SVG-as-image / screenshot). Default: licensed ? true : false. */ decomposeSvg?: boolean; /** Path to a signed `.lic` (also: HTML2DECK_LICENSE / --license). */ licensePath?: string; /** * Force Free or Licensed engine behavior and skip license-file lookup. * Omit to follow the license on disk. Used by benchmarks and tests. */ entitlement?: 'free' | 'licensed'; /** * Embed matched fonts into the PPTX (Licensed local only; Free embeds Font Awesome only). * Default: licensed ? true : false. Uses the remote font library (cached under * ~/.deckflow/html2deck/fonts) unless local fontsPath + fontsIndexPath override. */ embedFonts?: boolean; /** * Local font library root (offline override). When set with fontsIndexPath, * skips the remote font service. */ fontsPath?: string; /** * Local font registry index JSON (offline override). When set with fontsPath, * skips the remote font service. */ fontsIndexPath?: string; /** * Remote fonts-index.json URL for Licensed embedding. * Default / env: FONTS_INDEX_URL → https://slave-01.slide.im/_files/fonts/fonts-index.json */ fontsIndexUrl?: string; /** CSS selector matching runtime/navigation elements to exclude from conversion (DH-P0-005). */ excludeSelector?: string; /** Attribute name carrying a stable per-slide id (default: data-slide-id) (DH-P0-005). */ slideIdAttribute?: string; /** Attribute name carrying a stable element identity (default: data-element-id) (DH-P0-001). */ identityAttribute?: string; splitByHeight?: boolean; /** Auto-detect multi-slide containers in one HTML file (default true). */ autoDetectSlides?: boolean; /** * Browser viewport width in pixels. * When omitted (with height), auto-detected from HTML (`meta[name=deck-size]`, * `--deck|page|slide|canvas-width/height`, `meta[name=viewport]` numeric width, * stage JSON, fixed slide-host px, local linked CSS) or SVG viewBox; else 1280. */ viewportWidth?: number; /** * Browser viewport height in pixels. * When omitted (with width), auto-detected from source; else 720. */ viewportHeight?: number; /** Allow loading local file:// subresources in Playwright (default: false). */ allowLocalResources?: boolean; /** * Explicit network/local resource policy (DH-P0-007). Takes precedence over * allowLocalResources when present. */ resourcePolicy?: ResourcePolicy; /** Target PPTX platform for generic font mapping; script/lang is auto-detected from text. */ platform?: PlatformTarget; /** Suppress non-essential console.log / console.warn output. */ quiet?: boolean; /** * Caller-controlled browser launch / injection (DH-P0-006). * Pass `executablePath` to reuse a host Chromium, `userDataDir` for a persistent * profile (defaults to a per-process temp dir), or `browser`/`browserContext` to * inject an existing Playwright instance the loader will not close. */ browser?: { executablePath?: string; userDataDir?: string; headless?: boolean; args?: string[]; browser?: import('playwright-core').Browser; browserContext?: import('playwright-core').BrowserContext; }; /** * Strict-mode gates (DH-P0-003). When `strict` is present the conversion * rejects silent degradation: missing identities, raster fallbacks, * unsupported elements, remote resources and missing fonts become hard * failures (ConversionError) instead of warnings. */ strict?: StrictConversionOptions; /** * Entrance-animation export (default: enabled). Animations are captured from * `data-animation*` declarations, CSS @keyframes, class-gated opacity/transform * transitions (e.g. `.is-entered`), and intercepted anime.js calls, then mapped * onto the stable native PPTX subset (p:timing). Animations outside that subset * keep the frozen end-state and emit HTML2DECK_ANIMATION_UNMAPPED diagnostics. * Pass `false` to disable. */ animations?: boolean | AnimationConversionOptions; /** * Slide-to-slide transition effects (OOXML `p:transition`) — distinct from * element entrance animations above. * * - `undefined` / `true` / `'random'`: each slide gets its own randomly * chosen catalog effect (default) * - effect name string (e.g. `'fade'`): that effect on every slide * - comma-separated names (e.g. `'fade,push,wipe'`): cycle through the list * - `false` / `'none'`: disable slide transitions * - object: `{ effect?, effects?, speed?, seed?, enabled? }` */ slideTransitions?: boolean | string | SlideTransitionOptions; /** * How to handle `