Files
office-tools/docs/FORMAT-SUPPORT.md
T

48 lines
2.9 KiB
Markdown

# Format support
Office Tools 0.1.0 targets read-only browser viewing, not editing or
pixel-identical reproduction.
| Family | Extensions | 0.1 viewing coverage |
| ---------------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
| Office Open XML document | `.docx` | Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find |
| Office Open XML spreadsheet | `.xlsx` | Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find |
| Office Open XML presentation | `.pptx` | Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find |
| OpenDocument text | `.odt` | Semantic headings, paragraphs/runs, lists, tables, packaged images, metadata and foot/endnotes |
| OpenDocument spreadsheet | `.ods` | Sheets, typed/cached values, formulas, repeats, merges, annotations, basic safe styling and paged rows |
| OpenDocument presentation | `.odp` | Slide order, positioned text/shapes, groups, tables, packaged images, notes and basic safe styling |
Legacy compound-binary `.doc`, `.xls` and `.ppt` formats are explicitly outside
the first package-reader slice. They require a distinct, bounded parser and must
not be misidentified as their XML successors.
## Never executed
Macros, VBA projects, embedded executables, OLE objects, scripts, remote
templates and automatic external relationships remain inert. Unsupported
content is reported in diagnostics where it can be identified.
## Known boundaries
- Spreadsheet formulas display their saved cached result; Office Tools does not
recalculate them or refresh pivots and external data.
- Presentation animations and transitions are not reproduced. Embedded media
playback is disabled in the first release.
- OLE, ActiveX, VBA and OpenDocument embedded objects remain inert. The ODF
semantic view reports and omits embedded objects such as chart subdocuments.
- OpenDocument slide masters/layouts are identified but not fully reproduced;
uncommon drawing transforms and office-suite-specific layout can be
approximated.
- Fonts are substituted locally. Remote fonts, templates, images and links are
never fetched.
- ODS renders 200 rows at a time and up to 256 columns. Empty full-grid tails
emitted by office suites are deliberately trimmed.
## Safety limits
The source-file limit is 100 MiB. OOXML and ODF packages also enforce expanded
entry, total expanded byte, entry-count and image limits. ODF additionally
bounds compression ratio, XML depth/nodes, text, repeats, cells and assets.
Files that exceed a boundary fail with a visible diagnostic instead of being
partially trusted.