@ironsheet/core
v0.1.0
Published
Lossless TypeScript OOXML workbook engine for editing real XLSX and XLSM files.
Maintainers
Readme
The runtime-neutral workbook engine at the heart of Ironsheet — the lossless TypeScript engine for editing real XLSX and XLSM files without breaking formulas, styles, charts, pivots, macros, or layout.
This package is dependency-free and browser-compatible. It contains the ZIP/OPC/XML primitives, validators, and lossless mutation APIs. Runtime-specific file IO and compression live in the adapter packages:
@ironsheet/node— Node filesystem IO, zlib, safe writes, template rendering.@ironsheet/browser—Blob/File/ArrayBufferandCompressionStreamadapters.
Most applications should install an adapter rather than this package directly.
Install
npm install @ironsheet/coreWhat it does
- Parses and writes OOXML ZIP packages with raw compressed-payload preservation.
- Preserves unknown workbook XML, styles, drawings, charts, pivots, comments, merged cells, defined names, validations, conditional formats, images, and XLSM macro parts.
- Patches cells, ranges, named ranges, tables, images, styles, and more — with Excel-equivalent reference rewriting on row/sheet edits.
- Diffs two workbooks semantically and validates the OOXML package before a write.
Documentation
See the Ironsheet monorepo for the full API guide, capabilities, and design principles.
