office-tools/docs/FORMAT-SUPPORT.md

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/.docm/.dotx/.dotm	Paginated sections, text, lists, tables, images, shapes, charts, headers/footers, comments, selection and find
Office Open XML spreadsheet	.xlsx/.xlsm/.xltx/.xltm	Sheets, cached values/formulas, styles, merges, frozen panes, images, charts, comments, navigation and find
Office Open XML presentation	.pptx/.pptm/.potx/.potm/.ppsx/.ppsm	Slides/masters, text, shapes, images, tables, charts, notes, selection, navigation and find
OpenDocument text	.odt	Semantic headings, runs, inherited styles, tables, images, metadata, comments and foot/endnotes
OpenDocument spreadsheet	.ods	Typed/cached values, formulas, repeats, merges, row/column defaults, visibility, annotations and paged rows
OpenDocument presentation	.odp	Page geometry, positioned/transformed shapes, groups, tables, packaged images, notes and 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.

The input boundary also identifies RTF, older OpenOffice .sxw/.sxc/.sxi, flat OpenDocument .fodt/.fods/.fodp, renamed OLE Compound Files and invalid non-ZIP packages. It explains the required conversion instead of passing them to a ZIP or XML successor parser.

Export paths

• Save exact copy downloads the original immutable File for every format.
• ODT exports plain semantic text; ODS exports the active sheet's cached display values as bounded UTF-8 CSV; ODP exports a text slide/notes outline.
• ODF inspection JSON excludes embedded asset bytes while retaining asset identities, sizes, styles, metadata and the bounded semantic structure.
• Derived exports are intentionally not advertised as round-trip replacements.

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.