ole2Legacy Office files, as typed documents

Parse DOC, XLS, PPT and VSD files into editable TypeScript models and serialize them without losing the bytes you did not touch. No framework or runtime dependencies.

Get started

API reference

GitHub

Checked, typed parsing

parseOle2 returns a discriminated union of CFB, DOC, XLS, PPT and VSD documents. Ask for a specific format with expect and wrong files throw instead of being guessed.

Document models

Edits that preserve the rest

Supported setters validate the edit, change only the targeted bytes and keep unknown records and streams. Unsupported edits throw before anything changes.

Serialization contract

Word, Excel, PowerPoint and Visio

Paragraphs and runs, sheets and cells, slides and shapes, Visio pages and shapes. Publisher files can be inspected.

Format guides

MS-CFB containers

Read and build compound files, resize nested streams in place and read or update SummaryInformation metadata.

Containers

PPT export

Build a binary .ppt from a framework-neutral deck model, including pictures, notes, embedded objects and optional RC4 encryption.

PPT export

Clear support boundaries

Every format has a documented supported subset. The limitations page is the single place that lists what is not covered.

Limitations

Example

import { parseOle2 } from '@christophervr/ole2';

const document = parseOle2(bytes); // CFB | DOC | XLS | PPT | VSD
if (document.kind === 'xls') {
	document.sheets[0]!.cell(1, 0).value = 'Updated';
}
const saved = document.serialize();

See Getting started for installation and the format guides for what each format supports.

ole2Legacy Office files, as typed documents

Checked, typed parsing

Edits that preserve the rest

Word, Excel, PowerPoint and Visio

MS-CFB containers

PPT export

Clear support boundaries

Example ​

Example