Tracker: DOCX/PPTX stabilization backlog (exclude XLSX) #111
Description
Scope
Stabilization work for DOCX and PPTX only. XLSX is explicitly out of scope for this tracker.
Goal
Reduce hard conversion failures first, then improve fidelity and observability.
Priority Order
- Stop hard failures (DOCX)
- DOCX: expose actionable Typst diagnostics for conversion failures #107 DOCX: expose actionable Typst diagnostics for conversion failures
- DOCX: harden Typst codegen with centralized syntax-safe escaping #108 DOCX: harden Typst codegen with centralized syntax-safe escaping
- bug: Typst codegen failures on DOCX math subscripts, radicals, and BiDi text #95 bug: Typst codegen failures on DOCX math subscripts, radicals, and BiDi text
- Make runtime predictable (DOCX)
- DOCX: add native conversion timeout and stage-level telemetry #110 DOCX: add native conversion timeout and stage-level telemetry
- Improve conversion transparency (DOCX/PPTX)
- DOCX/PPTX: add structured fidelity warnings and CLI summaries #109 DOCX/PPTX: add structured fidelity warnings and CLI summaries
- Fix high-impact PPTX style loss
- PPTX: shapes with text discard fill color (TextBox vs Shape branch) #103 PPTX: shapes with text discard fill color (TextBox vs Shape branch)
Definition of Done
- DOCX conversion no longer fails due to known Typst syntax emission patterns.
- Timeout behavior is configurable and stage-aware in library/CLI.
- DOCX/PPTX warning reporting is structured and useful for triage.
- Text-bearing PPTX shapes preserve visual properties needed for slide readability.
Privacy Constraint
Do not include private corpus names, paths, or document content in issues, tests, logs, screenshots, or commit messages.